Página de desafio do Cloudflare

A página de desafio do Cloudflare é a página de verificação que bloqueia o site inteiro e exibe “Just a moment…” ou “Verificando seu navegador”. O YesCaptcha abre a página pelo proxy que você informa, passa pela verificação e retorna cookies como cf_clearance, o User-Agent usado, os cabeçalhos da requisição e da resposta e o HTML da página após a verificação. CloudFlareTaskS2 custa 25 pontos (≈ US$3.75 / 1k) por tarefa e CloudFlareTaskS3 custa 20 pontos (≈ US$3.00 / 1k) por tarefa; os dois tipos têm os mesmos parâmetros, resultado e eficácia, e diferem apenas no preço. As tarefas são assíncronas e normalmente levam de 6 a 35 segundos, com grande variação entre sites. Tarefas que falham ou expiram têm reembolso de pontos automático.

POSThttps://api.yescaptcha.com/createTaskEndpoint globalCopiar

POSThttps://cn.yescaptcha.com/createTaskEndpoint ChinaCopiar

Quando usar

• O código-fonte da página contém __cf_chl_rt_tk ou cdn-cgi/challenge-platform e o título é Just a moment...: trata-se da página de desafio. Páginas de verificação que pedem para marcar a caixa “Confirmar que você é humano” também são resolvidas aqui.
• Se há apenas um widget do Cloudflare incorporado em um formulário, é o Turnstile, e não esta página.
• Se, ao usar uma biblioteca como requests, você recebe 403 com “Just a moment…” mas o navegador abre a página normalmente, provavelmente o bloqueio é só pela impressão digital TLS. Use uma biblioteca que imite a impressão digital TLS de um navegador (como curl_cffi); não é necessário resolver o desafio.

Tipos e preços

Tipo de tarefa	Preço	Modo	Observações
CloudFlareTaskS2	US$3.75 / 1k; 25 pontos/tarefa · ¥25 / 1k	Assíncrono	Proxy próprio
CloudFlareTaskS3	US$3.00 / 1k; 20 pontos/tarefa · ¥20 / 1k	Assíncrono	Proxy próprio

Os preços em dólares americanos são estimativas com base em US$1 ≈ ¥6.67; as tarefas são cobradas em pontos.

Parâmetros da requisição

Campo	Tipo	Obrigatório	Descrição
type	string	Sim	Tipo de tarefa; veja "Tipos de tarefa e preços" nesta página
websiteURL	string	Sim	URL completa da página protegida pelo desafio. Deve ser uma URL pública http:// ou https://; endereços IP privados e nomes de host locais ou internos, como localhost, são rejeitados
proxy	string	Sim	Proxy em uma única string: http://user:[email protected]:8080 (proxy HTTP, credenciais opcionais) ou socks5://proxy.example.com:1080 (sem credenciais). Proxies https:// e SOCKS5 com credenciais não são suportados, e endereços locais ou privados são rejeitados. Todas as requisições à página de destino passam por esse proxy
userAgent	string	Não	Normalmente deixe de fora. Apenas um User-Agent do Chrome para desktop no Linux é utilizado; qualquer outro (Windows, macOS, celular, outros navegadores) é ignorado. Use sempre o user_agent do resultado nas requisições seguintes
waitLoad	boolean	Não	O padrão é false. Se true, depois de passar na verificação a tarefa espera a atividade de rede da página se estabilizar antes de retornar, de modo que content inclua mais conteúdo carregado dinamicamente; leva alguns segundos a mais
requiredCookies	array	Não	Nomes dos cookies que devem ser obtidos, como um array de strings, por exemplo ["cf_clearance"]. Se definido, a tarefa só tem sucesso quando todos forem obtidos; caso contrário, retorna ERROR_CAPTCHA_UNSOLVABLE e há reembolso de pontos. Se omitido, a tarefa ainda tenta obter cf_clearance, mas tem sucesso (com cobrança de pontos) com quaisquer outros cookies obtidos; portanto, informe-o explicitamente se precisar de cf_clearance
blockImage	boolean	Não	Se true, as imagens da página de destino não são carregadas (exceto as que a própria verificação do Cloudflare precisa), economizando tráfego do proxy
postData	object	Não	Se definido, é enviado a websiteURL como um POST de formulário HTML comum (application/x-www-form-urlencoded): cada chave é um campo do formulário e os valores são enviados como strings, por exemplo {"name": "hi"}. Deve ser um objeto

Requisitos de proxy

proxy é obrigatório, e todas as requisições para abrir a página de destino passam por ele. O cf_clearance está vinculado ao IP de saída, portanto use o mesmo proxy ao acessar o site depois.

Formato	Suporte
http://user:[email protected]:8080	Sim: proxy HTTP com usuário e senha
http://proxy.example.com:8080	Sim: proxy HTTP sem usuário e senha
socks5://proxy.example.com:1080	Sim: proxy SOCKS5 sem usuário e senha; socks5h:// é tratado como socks5://
socks5://user:[email protected]:1080	Não, retorna ERROR_PROXY_INCORRECT; se precisar de usuário e senha, use um proxy HTTP
https://proxy.example.com:443 ou outros protocolos, ou sem porta	Não, retorna ERROR_PROXY_INCORRECT
Endereços locais, de rede interna ou reservados, como 127.0.0.1, 192.168.x.x, 10.x.x.x, ou domínios que resolvem para eles	Recusado, retorna ERROR_PROXY_BANNED

Verificado na criação da tarefa

Se a URL ou o proxy forem inválidos, createTask retorna o erro imediatamente, sem cobrança de pontos. Se um mesmo proxy falhar ao conectar várias vezes em pouco tempo, por um período as tarefas criadas com ele também retornam ERROR_PROXY_BANNED; troque de proxy ou tente novamente mais tarde.

User-Agent

Em geral, não informe userAgent. A verificação é feita com o Chrome desktop para Linux, então só é usado um User-Agent do Chrome desktop para Linux; qualquer outro (Windows, macOS, celular ou outros navegadores) é ignorado: em nossos testes, a verificação do Cloudflare não passa quando o User-Agent não corresponde ao ambiente real do navegador. Nas requisições seguintes, use sempre o user_agent do resultado.

Exemplo de requisição

POST https://api.yescaptcha.com/createTask

{
  "clientKey": "YOUR_CLIENT_KEY",
  "task": {
    "type": "CloudFlareTaskS3",
    "websiteURL": "https://example.com/",
    "proxy": "http://user:[email protected]:8080",
    "requiredCookies": ["cf_clearance"]
  }
}

• Para usar CloudFlareTaskS2, altere apenas type; o restante permanece igual.
• Com requiredCookies definido como ["cf_clearance"], a tarefa falha e há reembolso de pontos se o cf_clearance não for obtido. Sem esse parâmetro, se a tarefa obtiver outros cookies mas não o cf_clearance, ela ainda é considerada bem-sucedida e os pontos são cobrados.
• Para enviar um formulário, adicione postData, por exemplo {"name": "hi"}; ele é enviado a websiteURL como um formulário POST.

Depois de criar a tarefa, chame getTaskResult a cada 5 segundos, como em qualquer outra tarefa assíncrona; veja getTaskResult.

Resultado

{
  "errorId": 0,
  "status": "ready",
  "solution": {
    "user_agent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/155.0.0.0 Safari/537.36",
    "cookies": {
      "cf_clearance": "Wq3vXk9...-1760860800-1.2.1.1-..."
    },
    "request_headers": {
      "accept-language": "en-US,en;q=0.9",
      "user-agent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/155.0.0.0 Safari/537.36"
    },
    "headers": {
      "content-type": "text/html; charset=UTF-8",
      "server": "cloudflare"
    },
    "content": "<!DOCTYPE html>..."
  }
}

O valor do cookie e os cabeçalhos acima são ilustrativos; use o que a API retornar.

Campo	Tipo	Descrição
cookies	object	Todos os cookies do navegador após passar na verificação (objeto de nome para valor), normalmente incluindo cf_clearance; se você informou requiredCookies, todos eles estarão incluídos. Use-os junto com o user_agent retornado e o proxy que você informou
user_agent	string	O User-Agent que o navegador realmente usou para passar na verificação (Chrome desktop no Linux). O cf_clearance está vinculado a ele, então use-o em todas as requisições seguintes
request_headers	object	Cabeçalhos de requisição que o navegador enviou na última requisição à página de destino; reutilize-os nas requisições seguintes
headers	object	Cabeçalhos de resposta da página de destino após passar na verificação
content	string	Código-fonte HTML da página de destino após passar na verificação

Como usar o resultado

1. Nas requisições seguintes, use ao mesmo tempo os cookies retornados, o user_agent retornado e o mesmo proxy usado ao criar a tarefa. O cf_clearance está vinculado ao User-Agent e ao IP de saída; se qualquer um dos três mudar, a página de desafio volta a aparecer.
2. Envie também os cabeçalhos de request_headers, sempre que possível, e use uma impressão digital TLS compatível com a de um navegador (por exemplo, a opção impersonate do curl_cffi).
3. O cf_clearance tem prazo de validade (definido pelo site de destino; em alguns casos chega a 1 hora). Dentro desse prazo não é preciso passar pelo desafio de novo, mas uma frequência de requisições muito alta pode levar o Cloudflare a bloquear o IP.
4. Se você só precisa do conteúdo da página, use content diretamente, sem fazer outra requisição.

Erros comuns

Erros retornados na criação da tarefa não geram cobrança de pontos; tarefas que falham ou expiram depois de criadas têm reembolso de pontos automático. A API retorna apenas o código de erro e uma descrição genérica; consulte a tabela abaixo para identificar a causa.

Código de erro	Quando é retornado	O que fazer
ERROR_REQUIRED_FIELDS	Na criação da tarefa: falta websiteURL ou proxy	Informe os dois campos obrigatórios
ERROR_ILLEGAL_PARAMETERS	Na criação da tarefa: websiteURL não é uma URL pública iniciada por http:// / https://, postData não é um objeto ou requiredCookies não é um array de strings. Na consulta do resultado: não foi possível resolver o domínio de destino pelo proxy	Corrija os parâmetros; verifique a grafia da URL e se o proxy consegue acessar o site
ERROR_PROXY_INCORRECT	Na criação da tarefa: formato de proxy incorreto, sem porta, proxy https:// ou SOCKS5 com usuário e senha	Use um dos formatos de “Requisitos de proxy”; se precisar de usuário e senha, use um proxy HTTP
ERROR_PROXY_BANNED	Na criação da tarefa: o proxy é um endereço local, de rede interna ou reservado, ou falhou ao conectar várias vezes em pouco tempo. Na consulta do resultado: o Cloudflare do site bloqueou diretamente o IP do proxy (páginas “Sorry, you have been blocked” e “Access denied”)	Troque de proxy; quanto melhor a qualidade do IP, mais fácil é passar
ERROR_PROXY_CONNECT_REFUSED	Não foi possível conectar ao proxy (conexão recusada, domínio do proxy não resolvido) ou a conexão foi recusada ou redefinida ao abrir a página pelo proxy	Verifique o endereço e a porta do proxy e confirme que ele está online e aceita acesso externo; se continuar falhando, troque de proxy
ERROR_PROXY_CONNECT_TIMEOUT	Tempo esgotado ao conectar ao proxy ou ao abrir a página por ele	Use um proxy mais rápido e estável
ERROR_PROXY_NOT_AUTHORISED	Usuário ou senha do proxy incorretos	Verifique o usuário e a senha em proxy; codifique caracteres especiais com URL encoding
ERROR_PROXY_TLS_ERROR	Erro no handshake TLS ao abrir a página pelo proxy	Confirme que o endereço, a porta e o protocolo do proxy estão corretos; se continuar falhando, troque de proxy
ERROR_CAPTCHA_UNSOLVABLE	A verificação não foi aprovada no tempo previsto, a página continuou no desafio após a aprovação ou não foi possível obter o cookie exigido em requiredCookies	Tente novamente com outro proxy; para sites específicos, entre em contato com o suporte
ERROR_NO_SLOT_AVAILABLE	Na criação da tarefa: a fila está cheia. Na consulta do resultado: a tarefa esperou tempo demais na fila sem começar, e os pontos foram reembolsados	Aguarde alguns segundos e crie a tarefa novamente
ERROR_TASK_TIMEOUT	A tarefa não foi concluída no tempo previsto	Crie a tarefa novamente; timeouts repetidos geralmente indicam que o proxy está lento demais

Veja todos os códigos de erro em Códigos de erro.

Relacionados

• Identificar o tipo de captcha: diferença entre a página de desafio e o Turnstile
• Cloudflare Turnstile