CAPSOLVER
Blog
Como resolver o Captcha do Cloudflare Turnstile com Python

Como resolver o Captcha do Cloudflare Turnstile com Python

Logo of CapSolver

Adélia Cruz

Neural Network Developer

18-Nov-2025

O que é o Cloudflare Turnstile

Cloudflare Turnstile é uma ferramenta gratuita projetada para substituir os tradicionais CAPTCHAs. O Turnstile oferece experiências web sem frustrações e sem CAPTCHA para os visitantes com apenas um snippet de código simples. Ao contrário dos tradicionais CAPTCHAs, ele protege sites contra tráfego de bots sem comprometer a privacidade do usuário ou a experiência do usuário.

Principais benefícios do Turnstile:

  • Amigável ao usuário: sem mais quebra-cabeças ou seleções de imagens irritantes.
  • Prioridade à privacidade: não rastreia dados pessoais.
  • Proteção contra bots: garante que os visitantes sejam reais e mitiga abusos.
  • Leve e fácil de implementar com código mínimo.

Como Identificar Captchas do Cloudflare Turnstile

O Turnstile pode aparecer em diferentes formas, dependendo do contexto e da avaliação de risco:

  1. Desafio não interativo

  2. Desafio interativo não intrusivo

    • Pode ser necessário um simples clique se o visitante for suspeito de ser um bot.
      Exemplo interativo
      Link do exemplo
  3. Desafio invisível

    • O captcha é carregado no HTML, mas não é visível na página.
      Exemplo invisível
      Link do exemplo

🛠️ Resolver o Captcha do Cloudflare Turnstile com Python

⚙️ Requisitos prévios

🤖 Passo 1: Instalar Pacotes Necessários

bash Copy
pip install requests

👨‍💻 Passo 2: Script Python para Resolver o Turnstile

python Copy
import time
import requests

CAPSOLVER_API_KEY = "chave de api"
PAGE_URL = "url"
WEBSITE_KEY = "chave do site"

def solvecf(metadata_action=None, metadata_cdata=None):
    url = "https://api.capsolver.com/createTask"
    task = {
        "type": "AntiTurnstileTaskProxyLess",
        "websiteURL": PAGE_URL,
        "websiteKey": WEBSITE_KEY,
    }
    if metadata_action or metadata_cdata:
        task["metadata"] = {}
        if metadata_action:
            task["metadata"]["action"] = metadata_action
        if metadata_cdata:
            task["metadata"]["cdata"] = metadata_cdata
    data = {
        "clientKey": CAPSOLVER_API_KEY,
        "task": task
    }
    response_data = requests.post(url, json=data).json()
    print(response_data)
    return response_data['taskId']


def solutionGet(taskId):
    url = "https://api.capsolver.com/getTaskResult"
    status = ""
    while status != "ready":
        data = {"clientKey": CAPSOLVER_API_KEY, "taskId": taskId}
        response_data = requests.post(url, json=data).json()
        print(response_data)
        status = response_data.get('status', '')
        print(status)
        if status == "ready":
            return response_data['solution']

        time.sleep(2)


def main():
    
    taskId = solvecf()
    solution = solutionGet(taskId)
    if solution:
        user_agent = solution['userAgent']
        token = solution['token']

    print("User_Agent:", user_agent)
    print("Turnstile resolvido, token:", token)

  
if __name__ == "__main__":
    main()

⚠️ Variáveis a atualizar

  • CAPSOLVER_API_KEY: Obtenha sua chave de API no Painel do Capsolver.
  • PAGE_URL: Substitua pela URL do site onde deseja resolver o Turnstile.
  • WEBSITE_KEY: Substitua pela chave do site do Turnstile do site.

✅ Conclusão

Ao utilizar o CapSolver, os desenvolvedores podem bypassar eficientemente os CAPTCHAs do Cloudflare Turnstile de forma segura e automatizada. Com alta precisão, suporte sem proxy e configuração mínima, esta solução é ideal para fluxos de trabalho de raspagem de web, automação e testes que precisam interagir com sites protegidos pelo Turnstile.

A API do Python do Capsolver torna fácil a integração em scripts existentes ou em pipelines de automação, permitindo que você economize tempo e reduza a intervenção manual.


❓ Perguntas Frequentes

Q1: Preciso de proxies para usar o Capsolver para Turnstile?
A: Não, o Capsolver oferece resolução sem proxy, embora você possa usar seus próprios proxies para maior segurança, se necessário.

Q2: Quanto tempo leva para resolver um captcha do Turnstile?
A: Normalmente alguns segundos, dependendo do tipo de desafio e das condições da rede.

Q3: Esta solução pode lidar com vários desafios do Turnstile em paralelo?
A: Sim, você pode criar várias tarefas simultaneamente para resolver desafios de forma concorrente.

Q4: É seguro usá-lo em ambientes de produção?
A: Sim, o Capsolver é projetado para alta confiabilidade e pode lidar com fluxos de trabalho automatizados em tempo real sem risco para suas contas.

Q5: Há limitações para o desafio do Turnstile invisível?
A: Os desafios invisíveis funcionam da mesma forma que os visíveis; o Capsolver os detecta e resolve automaticamente.

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

O que é um bot de raspagem e como construir um
O que é um bot de raspagem e como construir um

Aprenda o que é um bot de raspagem e como criar um para extração automática de dados. Descubra os melhores ferramentas, técnicas de navegação segura e práticas éticas de raspagem.

web scraping
Logo of CapSolver

Adélia Cruz

16-Jan-2026

Melhor Solucionador de reCAPTCHA 2026 para Automação & Web Scraping
Melhor Resolutor de reCAPTCHA 2026 para Automação & Web Scraping

Descubra os melhores solucionadores de reCAPTCHA para automação e raspagem de dados da web em 2026. Aprenda como eles funcionam, escolha o adequado e fique à frente da detecção de bots.

web scraping
Logo of CapSolver

Rajinder Singh

15-Jan-2026

Scrapy vs. Selenium
Scrapy vs. Selenium: Qual é o melhor para o seu projeto de raspagem de web

Descubra as vantagens e diferenças entre o Scrapy e o Selenium para raspagem de dados. Aprenda qual ferramenta é a mais adequada para o seu projeto e como lidar com desafios como CAPTCHAs.

web scraping
Logo of CapSolver

Anh Tuan

14-Jan-2026

Como usar o Selenium Driverless para coleta eficiente de dados da web
Como Usar o Selenium Driverless para Web Scraping Eficiente

Aprenda como usar o Selenium Driverless para raspagem de web eficiente. Este guia fornece instruções passo a passo para configurar seu ambiente, escrever seu primeiro script Selenium Driverless e lidar com conteúdo dinâmico. Simplifique suas tarefas de raspagem de web evitando as complexidades da gestão tradicional do WebDriver, tornando seu processo de extração de dados mais simples, mais rápido e mais portátil.

web scraping
Logo of CapSolver

Emma Foster

14-Jan-2026

Resolvendo Erros 403 Proibidos ao Raspar Sites com Python
Resolvendo Erros 403 Proibidos ao Raspar Sites com Python

Aprenda como superar erros 403 Proibido ao raspar sites com Python. Este guia aborda rotação de IPs, falsificação de user-agent, limitação de requisições, gerenciamento de autenticação e uso de navegadores headless para contornar restrições de acesso e continuar raspando sites com sucesso.

web scraping
Logo of CapSolver

Emma Foster

13-Jan-2026

Agno com Integração CapSolver
Como resolver CAPTCHA no Agno com integração do CapSolver

Aprenda como integrar o CapSolver com o Agno para resolver desafios de reCAPTCHA v2/v3, Cloudflare Turnstile e WAF em agentes de IA autônomos. Inclui exemplos reais de Python para raspagem de web e automação.

web scraping
Logo of CapSolver

Adélia Cruz

13-Jan-2026