Como resolver o Captcha do Cloudflare Turnstile com NodeJS

Emma Foster
Machine Learning Engineer
08-Dec-2025

Visão Geral do Cloudflare Turnstile
O Cloudflare Turnstile oferece uma solução gratuita para substituir os tradicionais CAPTCHAs, proporcionando uma experiência de navegação sem complicações por meio de um snippet de código simples. Ele garante que os visitantes sejam genuínos e evita abusos sem os problemas de privacidade de dados ou a má experiência do usuário associada aos CAPTCHAs convencionais.
Identificando os CAPTCHAs do Cloudflare Turnstile
-
Desafio Não Interativo: O processo ocorre sem interação do usuário. Exemplo: Teste Não Interativo

-
Desafio Mínimo Interativo: Pode envolver ações simples, como clicar em um botão, se o sistema suspeitar que o visitante pode ser um robô. Exemplo: Teste Gerenciado

-
Desafio Invisível: O desafio opera de forma invisível, carregando-se discretamente no HTML da página da web. Exemplo: Teste Invisível

🛠️ Resolvendo o CAPTCHA do Cloudflare Turnstile
⚙️ Pré-requisitos
- NodeJs instalado
- Chave de API do Capsolver
🤖 Passo 1: Instalar Pacotes Necessários
Execute os seguintes comandos para instalar os pacotes necessários:
python
npm i axios
👨💻 Passo 2: Código NodeJS para resolver o CAPTCHA do Cloudflare Turnstile
Aqui está um script de exemplo em JavaScript para realizar a tarefa:
js
const axios = require('axios');
const CAPSOLVER_API_KEY = "sua chave de API";
const PAGE_URL = "site ";
const WEBSITE_KEY = "chave do site";
function solvecf(metadata_action = null, metadata_cdata = null) {
const url = "https://api.capsolver.com/createTask";
const task = {
type: "AntiTurnstileTaskProxyLess",
websiteURL: PAGE_URL,
websiteKey: WEBSITE_KEY,
};
if (metadata_action || metadata_cdata) {
task.metadata = {};
if (metadata_action) {
task.metadata.action = metadata_action;
}
if (metadata_cdata) {
task.metadata.cdata = metadata_cdata;
}
}
const data = {
clientKey: CAPSOLVER_API_KEY,
task: task
};
return axios.post(url, data)
.then(response => {
console.log(response.data);
return response.data.taskId;
});
}
function solutionGet(taskId) {
const url = "https://api.capsolver.com/getTaskResult";
let status = "";
const checkStatus = () => {
const data = { clientKey: CAPSOLVER_API_KEY, taskId: taskId };
return axios.post(url, data)
.then(response => {
console.log(response.data);
status = response.data.status || "";
console.log(status);
if (status === "ready") {
return response.data.solution;
}
return new Promise(resolve => setTimeout(resolve, 2000)).then(checkStatus);
});
};
return checkStatus();
}
async function main() {
try {
const taskId = await solvecf();
const solution = await solutionGet(taskId);
if (solution) {
const user_agent = solution.userAgent;
const token = solution.token;
console.log("User_Agent:", user_agent);
console.log("CAPTCHA do Turnstile resolvido, token:", token);
}
} catch (error) {
console.error("Erro na interação com a API do CAPSOLVER:", error);
}
}
main();
⚠️ Altere estas variáveis
- CAPSOLVER_API_KEY: Obtenha sua chave de API no Painel do Capsolver.
- PAGE_URL: Substitua pela URL do site para o qual deseja resolver o CAPTCHA do CloudFlare Turnstile.
- WEBSITE_KEY: Substitua pela chave do site do site
Como o Captcha do CloudFlare Turnstile Se Apresenta

Ao mesmo tempo, se você quiser testar seus scripts para características de bot, a ferramenta de Detecção de Bot do BrowserScan pode ajudá-lo a identificar e aprimorar o comportamento de bot nos seus scripts.
🔚 Conclusão
O Cloudflare Turnstile oferece uma alternativa leve e amigável à privacidade em comparação com os CAPTCHAs tradicionais, melhorando a experiência do usuário enquanto filtra efetivamente o tráfego automatizado. Com ferramentas como o Capsolver, os desenvolvedores podem contornar programaticamente os desafios do Turnstile para testes, raspagem de dados ou cenários de automação. Ao seguir os passos acima e configurar corretamente os parâmetros da API, você pode integrar rapidamente a resolução do Turnstile ao seu fluxo de trabalho e agilizar as solicitações automatizadas com facilidade.
❓ Perguntas Frequentes
1. O que torna o Cloudflare Turnstile diferente dos CAPTCHAs tradicionais?
O Turnstile se concentra em verificação invisível e sem atrito, sem exigir interação do usuário, oferecendo melhor UX e privacidade em comparação com os CAPTCHAs baseados em imagens clássicos.
2. Preciso de um proxy para resolver o Cloudflare Turnstile com o Capsolver?
Não. O exemplo usa AntiTurnstileTaskProxyLess, o que significa que um proxy não é necessário. No entanto, proxies ainda podem ajudar em tarefas de alta segurança ou alto volume.
3. Como encontro a websiteKey para um CAPTCHA do Turnstile?
Abra a página da web no navegador → Inspecionar → procure por snippet turnstile → o valor de data-sitekey é sua chave do site.
4. Essa metodologia pode ser usada para raspagem ou automação em larga escala?
Sim, mas certifique-se de que seu uso esteja em conformidade com os termos de serviço do site. Para volumes elevados, é recomendado gerenciar atrasos, rotacionar agentes do usuário e usar padrões de solicitação apropriados.
Declaração de Conformidade: As informações fornecidas neste blog são apenas para fins informativos. A CapSolver está comprometida em cumprir todas as leis e regulamentos aplicáveis. O uso da rede CapSolver para atividades ilegais, fraudulentas ou abusivas é estritamente proibido e será investigado. Nossas soluções de resolução de captcha melhoram a experiência do usuário enquanto garantem 100% de conformidade ao ajudar a resolver dificuldades de captcha durante a coleta de dados públicos. Incentivamos o uso responsável de nossos serviços. Para mais informações, visite nossos Termos de Serviço e Política de Privacidade.
Mais

Como resolver o Captcha do Cloudflare Turnstile com NodeJS
Neste artigo, vamos mostrar como resolver o CAPTCHA do Cloudflare Turnstile com NodeJS.

Emma Foster
08-Dec-2025

Como resolver o erro 403 Proibido e os erros 522/1020/1010/1015/1012
Cloudflare é uma rede de entrega de conteúdo (CDN) e serviço de segurança amplamente utilizada que ajuda os sites a mitigar diversos tipos de ameaças, incluindo ataques DDoS e bots abusivos...

Rajinder Singh
08-Dec-2025

Erro do Cloudflare 1006, 1007, 1008 Solução para Resolver | Como Corrigir
Lidando com erros do Cloudflare 1006, 1007 ou 1008? Aprenda soluções práticas para resolver esses bloqueios de acesso e melhorar sua experiência de crawling na web.

Anh Tuan
05-Dec-2025

Como identificar se `action` é necessário para resolver o Cloudflare Turnstile usando a extensão CapSolver
Aprenda a identificar ações para resolução eficaz de captchas cloudflare turnstile. Siga nosso guia passo a passo sobre o uso das ferramentas e técnicas do Capsolver.

Aloísio Vítor
05-Dec-2025

Como automatizar a resolução de desafios do Cloudflare no Selenium
Domine a estratégia definitiva para resolver desafios do Cloudflare no Selenium. Use o Undetected-Chromedriver, o mimetismo comportamental e a API do CapSolver para automação web confiável.

Lucas Mitchell
04-Dec-2025

Como resolver o desafio do Cloudflare com Node.js
Uma olhada em por que o Cloudflare bloqueia scrapers em Node.js e como os desenvolvedores obtêm de forma confiável o cf_clearance para fluxos de dados.

Adélia Cruz
03-Dec-2025

