Cloudflare Turnstile
widget- Onde você vê
- Um widget dentro de uma página ou formulário
- O que retorna
- Um token em
cf-turnstile-response - Página CapMonster
- Esta página: Cloudflare Turnstile Solucionador
Última atualização:
| CAPTCHA | Preço (USD) |
|---|---|
$ 1.30 1000 tokens |
Um widget Cloudflare Challenge e um widget Turnstile podem ter a mesma aparência. Um Desafio nem sempre é uma página separada “Só um momento…”: ela pode ser estilizada, incorporada no site ou feita para se parecer com um widget Turnstile normal, então você não pode diferenciá-los pela aparência.
cf-turnstile-responsechallenge-form com __cf_chl_f_tk=cf_clearanceA tabela lista preço, tempo para resolver e taxa de sucesso de resolução para quatro serviços de resolução Cloudflare Turnstile.
| Parâmetro | CapMonster Cloud | 2Captcha | Anti-Captcha | DeathByCaptcha |
|---|---|---|---|---|
Preço por 1000 soluções (de) | $ 1.30 | — | — | — |
Hora de resolver | 6,24 s* | 16,9s | 20,33s | ~13s |
Resolvendo a taxa de sucesso | 99%* | 96% | 96% | 96% |
2Captcha, Anti-Captcha e DeathByCaptcha são marcas registradas de seus respectivos proprietários. CapMonster Cloud não é afiliado a essas entidades. As métricas de desempenho e as comparações de preços são baseadas em dados publicamente disponíveis e benchmarking interno em 30.09.2026.
Teste a estabilidade em seus próprios sites de destino agora mesmo. Não garantimos uma taxa de sucesso de 100%: os tipos de CAPTCHA e a configuração do site de destino podem mudar a qualquer momento.
$0.10
Novos usuários recebem US$ 0,10 em saldo de teste para experimentar CapMonster Cloud.
1. Registre-se em CapMonster Cloud.
2. Envie uma mensagem para o suporte via live chat ou support@capmonster.cloud com o e-mail vinculado à sua conta.
Execute fluxos de inscrição, checkout e formulário em CI/CD com Playwright, Puppeteer ou Selenium em páginas que você possui ou tem permissão para testar.
Verifique se os formulários e endpoints protegidos continuam funcionando após lançamentos e alterações de widget.
Colete dados publicamente disponíveis de páginas abertas que usam Cloudflare Turnstile.
Dê suporte a fluxos de trabalho assistenciais automatizados em sites que dependem de verificações de bot invisible.
Deixe um agente solicitar um token por meio de MCP quando um fluxo de trabalho atingir um captcha.
Use CapMonster Cloud para dados disponíveis publicamente e em sites que você possui ou está autorizado a testar. É proibida a coleta de dados de terceiros por meio de login ou acesso pago sem permissão.
Cloudflare Turnstile verifica os visitantes por meio de sinais do navegador do lado do cliente e avaliação de risco, em vez de quebra-cabeças de imagens. Ele vem em três modos de widget: Managed (recomendado), Non-Interactive e Invisible. CapMonster Cloud lida com todos eles automaticamente — você nunca especifica o modo na tarefa.
Fontes: Cloudflare documentação — Tipos de widget · Começar · Turnstile em desafios Cloudflare
Turnstile escolhe automaticamente entre uma marca non-interactive e uma caixa de seleção com base no nível de risco do visitante. Nenhuma imagem ou texto para decifrar.
Um widget visível com um botão giratório de carregamento. A verificação é executada sem qualquer interação do visitante.
A verificação é executada completamente em segundo plano: nenhum widget e nenhum indicador de carregamento são mostrados.
A página carrega o código de inicialização do widget; Cloudflare retorna o JS necessário e o widget é renderizado.
Com base no modo do widget e nos sinais de risco de Cloudflare, o widget decide se deseja mostrar um desafio interativo.
O callback do lado do cliente recebe um token – de uso único, válido por 300 segundos. Se o widget estiver dentro de <form>, o token também será adicionado automaticamente como o campo oculto cf-turnstile-response.
A página envia o token para o backend com os dados do formulário.
Seu servidor chama Cloudflare's Siteverify API para confirmar o token.
Fontes: Cloudflare documentação — Incorpore o widget · Validar o token
Um token Turnstile é a string que o widget gera após verificar um visitante. O widget o armazena em um campo de formulário oculto chamado cf-turnstile-response e também o passa para o callback do widget. O servidor do site então envia o token para Cloudflare Siteverify API para confirmá-lo.
Propriedades do token, de acordo com a documentação Cloudflare:
Válido por 300 segundos (5 minutos) após a geração.
Uso único: validar uma segunda vez retorna o erro timeout-or-duplicate.
Até 2.048 caracteres.
Validado no servidor através do Siteverify API.
CapMonster Cloud aceita parâmetros captcha, processa-os em seus servidores e retorna um token pronto para uso. Insira este token no formulário para passar na verificação sem interação do usuário.
Nesta fase, você envia sua chave API, tipo de captcha e seus parâmetros. O serviço retorna um taskId exclusivo que você pode usar posteriormente para obter o resultado.
Parâmetros necessários
| Parâmetro | Descrição |
|---|---|
| tipo | TurnstileTask |
| websiteURL | A URL da página onde o captcha é resolvido |
| websiteKey | Turnstile chave do site. Formato: 0x4AAAAAAABUYP0XeMJF0xoy |
Parâmetros opcionais
| Parâmetro | Descrição |
|---|---|
| userAgent | Navegador User-Agent. Recomendado: passe o valor atual suportado por CapMonster Cloud. Você pode obter o valor mais recente em https://capmonster.cloud/api/useragent/actual |
| pageAction | O campo de ação encontrado na função callback quando o captcha é carregado |
| dados | O valor do campo de dados, retirado do parâmetro cData |
| proxyType | http — proxy HTTP/HTTPS normal; https — tente isto se http não funcionar (obrigatório para alguns proxies personalizados); socks4 — proxy SOCKS4; socks5 — proxy SOCKS5 |
| endereço proxy | Endereço IP do proxy (IPv4/IPv6). Proxies transparentes e proxies em máquinas locais não são permitidos |
| proxyPort | Porta proxy |
| proxyLogin | Nome de usuário proxy |
| senha do proxy | Senha proxy |
O mesmo tipo TurnstileTask é usado com e sem proxy.
Ponto final:
https://api.capmonster.cloud/createTaskSolicitação:
{
"clientKey": "API_KEY",
"task": {
"type": "TurnstileTask",
"websiteURL": "https://yourwebsite.com/page-with-turnstile",
"websiteKey": "your-website-key"
}
}Resposta:
{
"errorId": 0,
"taskId": 407533072
}Depois de criar a tarefa, pesquise o status da solução.
Ponto final:
https://api.capmonster.cloud/getTaskResultSolicitação:
{
"clientKey": "API_KEY",
"taskId": 407533072
}Resposta:
{
"errorId": 0,
"status": "ready",
"solution": {
"userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/156.0.0.0 Safari/537.36",
"token": "0.iGX3xsyFCkbGePM3jP4P4khLo6TrLukt8ZzBvwuQOvbC...f61f3082"
}
}| Propriedade | Tipo | Descrição |
|---|---|---|
| ficha | Corda | Use o token em um campo de entrada ou ao chamar uma função callback. |
Insira o token retornado no campo cf-turnstile-response ou passe-o para o callback do widget e envie o formulário em cinco minutos: Cloudflare os tokens expiram após 300 segundos e podem ser validados apenas uma vez. Exemplos de código para Playwright, Puppeteer e Selenium estão no FAQ abaixo.
Para criar uma tarefa Turnstile você precisa de dois valores da página onde o widget é executado: a chave do site (websiteKey) e, se a página definir, o nome da ação (pageAction).
<div class="cf-turnstile" data-sitekey="SITE_KEY"← websiteKey
data-action="ACTION"></div>← pageActionturnstile.render('#container', {
sitekey: 'SITE_KEY',← websiteKey
action: 'ACTION',← pageAction
callback: function (token) { /* ... */ }
});Abra o site com o captcha.
Clique com o botão direito no elemento captcha e escolha Inspect.
Encontre a chave do site. Na aba Elements é o atributo data-sitekey (websiteKey). Uma chave de site Turnstile se parece com 0x4AAAAAAABUYP0XeMJF0xoy.
Encontre a ação: na chamada de renderização do widget (a função callback que é executada quando o captcha é carregado) ou no atributo data-action. A chave do site também pode ser encontrada na função callback. Se a página não definir uma ação, deixe o parâmetro de fora.
Para coletar os valores automaticamente, carregue a página em um navegador headless como Playwright e leia-os no widget renderizado. Exemplos prontos em JavaScript, Python e C# estão na CapMonster Cloud documentação.
Alguns valores mudam toda vez que a página é carregada, então resolva a tarefa logo após coletá-los.
createTask e recuperar o resultado com getTaskResult usando nossas bibliotecas cliente.Para fluxos de trabalho de baixo código, use o nó oficial CapMonster Cloud n8n node.
websiteURL e websiteKey da mesma renderização da página.getTaskResult retornou o status ready e se você pegou solution.token antes de inseri-lo.Erros retornados por Cloudflare Siteverify (timeout-or-duplicate, invalid-input-secret e outros) dizem respeito aos proprietários de sites - consulte “códigos de erro Siteverify” abaixo.
Se você administra o site protegido por Turnstile: verifique os tokens e teste sua configuração
POST https://challenges.cloudflare.com/turnstile/v0/siteverify
secret=YOUR_SECRET_KEY
response=TOKENSe você administra o site, seu servidor valida cada token Turnstile enviando uma solicitação POST para https://challenges.cloudflare.com/turnstile/v0/siteverify. O endpoint aceita application/x-www-form-urlencoded e JSON e sempre retorna JSON. Parâmetros necessários: secret (a chave secreta do seu widget) e response (o token). Opcional: remoteip e idempotency_key. Verifique success e, se você defini-los, também action e hostname na resposta.
Um token é válido por 300 segundos e pode ser validado apenas uma vez. Leia mais no Cloudflare do guia de validação.
Cloudflare fornece chaves de site fictícias e chaves secretas para que você possa testar uma implementação de Turnstile sem desencadear desafios reais. Teste as sitekeys funcionam em qualquer domínio, incluindo localhost, e geram o token fictício XXXX.DUMMY.TOKEN.XXXX. Os tokens fictícios são aceitos apenas por chaves secretas fictícias e as chaves secretas de produção os rejeitam.
<div class="cf-turnstile"
data-sitekey="1x…AA">
</div>
cf-turnstile-response:
"XXXX.DUMMY.TOKEN.XXXX"Sempre passa
Sempre falha
Sempre passa
Sempre falha
Força um desafio interativo
Sempre passa na validação
Sempre falha na validação
Retorna o erro "token já gasto" (tempo limite ou duplicado)
Referência completa de Cloudflare: Turnstile testes.
Quando a validação falha, o Siteverify API de Cloudflare retorna um array error-codes. A tabela abaixo lista cada código e o que ele significa.
{
"success": false,
"error-codes": [
"timeout-or-duplicate"
]
}O parâmetro secreto não foi fornecido
A chave secreta é inválida ou expirou
O parâmetro de resposta (token) não foi fornecido
O token é inválido, malformado ou expirado
A solicitação está malformada
O token já foi validado ou expirou
Ocorreu um erro interno; tente novamente a solicitação
Siteverify pode retornar success: true e seu servidor ainda deverá rejeitar o token se hostname ou action não corresponderem ao que você espera.
Respostas breves sobre a resolução do Cloudflare Turnstile com o CapMonster Cloud: modos, proxies, tokens, testes e erros do Siteverify.
Cloudflare Turnstile é uma alternativa CAPTCHA de Cloudflare que verifica os visitantes por meio de sinais do navegador e avaliação de risco, em vez de quebra-cabeças de imagens. Possui três modos de widget. Managed (recomendado): Cloudflare escolhe entre uma verificação non-interactive e uma caixa de seleção com base no risco do visitante. Non-interactive: um widget visível com um botão giratório de carregamento que nunca requer interação. Invisible: nenhum widget. CapMonster Cloud lida com todos os três automaticamente, portanto você não especifica o modo na tarefa.
Não. TurnstileTask funciona sem proxy e os campos de proxy (proxyType, proxyAddress, proxyPort, proxyLogin, proxyPassword) são opcionais. Um proxy que corresponda à geografia do site de destino pode melhorar os resultados em páginas geosensíveis, por isso vale a pena testar ambas as configurações. Proxies transparentes e proxies em máquinas locais não são permitidos. Sem seu próprio proxy, CapMonster Cloud resolve a tarefa por meio de seus proxies integrados (endereço IP 65.21.190.34).
Abra DevTools, encontre o elemento com o atributo data-sitekey (e data-action, se a página definir uma ação) e copie os valores; uma chave de site Turnstile se parece com 0x4AAAAAAABUYP0XeMJF0xoy. Alguns valores mudam sempre que a página é carregada, portanto, extraia-os antes de criar a tarefa. As instruções passo a passo estão na seção acima.
cf-turnstile-response é o campo de formulário oculto que contém o token Turnstile. O token é válido por 300 segundos (5 minutos) e pode ser validado apenas uma vez; depois disso Siteverify retorna o erro timeout-or-duplicate. Envie o token que você recebeu de CapMonster Cloud imediatamente e solicite um novo para cada envio.
Para inserir um token Turnstile, encontre o campo de resposta oculto (uma entrada chamada cf-turnstile-response) e defina-o como o token recuperado de CapMonster Cloud. Veja como fazer isso nas três estruturas de automação.
Playwright / Puppeteer (Node.js):
const token = "YOUR_TOKEN";
await page.evaluate((t) => {
document.querySelector('[name="cf-turnstile-response"]').value = t;
}, token);
await page.click('#submit-btn');Selenium (Python):
token = "YOUR_TOKEN"
driver.execute_script("document.querySelector('[name=\"cf-turnstile-response\"]').value = arguments[0];", token)
driver.find_element("id", "submit-btn").click()Se o formulário validar o token por meio de uma função callback (o atributo data-callback do widget), chame essa função com o token.
Use as chaves fictícias de Cloudflare. No cliente, defina a chave do site como 1x00000000000000000000AA (sempre passa), 2x00000000000000000000AB (sempre falha) ou 3x00000000000000000000FF (força um desafio interativo); no servidor, use uma chave secreta fictícia como 1x0000000000000000000000000000000AA. Sitekeys fictícias funcionam em qualquer domínio, incluindo localhost, e produzem o token XXXX.DUMMY.TOKEN.XXXX, que apenas chaves secretas fictícias aceitam. A lista completa está na seção test acima.
Siteverify retorna success: false quando o token tem mais de 300 segundos, já foi validado ou a chave secreta está errada, e seu servidor também pode rejeitá-lo se o hostname ou action retornado não corresponder ao que você espera. Verifique a matriz error-codes na resposta e veja a tabela de códigos de erro Siteverify. Solicite um novo token para cada envio e envie-o logo após recebê-lo.
* Não garantimos uma taxa de sucesso de 100%: os tipos de CAPTCHA e a configuração do site de destino podem mudar a qualquer momento. CapMonster Cloud oferece uma alta taxa de sucesso para resolução de Cloudflare Turnstile. Com base no benchmarking mensal interno da equipe CapMonster Cloud. A velocidade real de resolução e a taxa de sucesso variam dependendo do site de destino, da carga do servidor e das condições da rede.
Cloudflare e Turnstile são marcas registradas da Cloudflare, Inc. CapMonster Cloud não é afiliado ou endossado por Cloudflare. O Serviço destina-se a dados disponíveis publicamente, testes de sites próprios ou autorizados, reconhecimento de imagens e acessibilidade. É proibida a coleta de dados de terceiros por meio de login ou acesso pago sem permissão; suas próprias contas não são afetadas. Você determina o status legal dos seus dados antes de começar a trabalhar.