Como resolver reCAPTCHA v2 com Python

TL;DR

• Este guia mostra como resolver a reCAPTCHA v2 usando Python e o CapSolver, com os tipos de tarefa Proxy e Proxyless.
• Inclui explicações mais profundas, dicas comuns de solução de problemas e exemplos expandidos para cenários de automação do mundo real.
• Ideal para desenvolvedores que trabalham com scraping, automação de SEO, extração de dados do SERP, bots de preenchimento de formulários e pipelines de testes de CI.

Introdução

A reCAPTCHA v2 do Google é amplamente usada para bloquear tráfego automatizado.
Se você estiver construindo scrapers, fluxos de automação, criadores de contas, submissões de formulários online ou ferramentas SERP, resolver a reCAPTCHA v2 é praticamente essencial.

Este guia expandido o guia por meio de:

• Instalação
• Como cada tipo de tarefa funciona
• Exemplos detalhados em Python
• Quando usar proxy / proxyless
• Tratamento de erros
• Pontos importantes para implementações em alvos de alto valor

⚙️ Pré-requisitos

• Um proxy funcional (Opcional, leia ambos os exemplos, pois um requer proxy e outro não)
• Python instalado
• Chave da API do CapSolver

🤖 Instale os Pacotes Necessários

Execute os seguintes comandos para instalar os pacotes necessários:

pip install capsolver

👨‍💻 Código Python para resolver reCaptcha v2 com seu proxy

Aqui está um script de exemplo em Python para realizar a tarefa:

import capsolver

# Considere usar variáveis de ambiente para informações sensíveis
PROXY = "http://username:password@host:port"
capsolver.api_key = "Sua chave da API do Capsolver"
PAGE_URL = "URL_DA_PAGINA"
PAGE_KEY = "CHAVE_DO_SITE"

def solve_recaptcha_v2(url,key):
    solution = capsolver.solve({
        "type": "ReCaptchaV2Task",
        "websiteURL": url,
        "websiteKey":key,
        "proxy": PROXY
    })
    return solution


def main():
    print("Resolvendo reCaptcha v2")
    solution = solve_recaptcha_v2(PAGE_URL, PAGE_KEY)
    print("Solução: ", solution)

if __name__ == "__main__":
    main()

👨‍💻 Código Python para resolver reCaptcha v2 sem proxy

Aqui está um script de exemplo em Python para realizar a tarefa:

import capsolver

# Considere usar variáveis de ambiente para informações sensíveis
capsolver.api_key = "Sua chave da API do Capsolver"
PAGE_URL = "URL_DA_PAGINA"
PAGE_KEY = "CHAVE_DO_SITE"

def solve_recaptcha_v2(url,key):
    solution = capsolver.solve({
        "type": "ReCaptchaV2TaskProxyless",
        "websiteURL": url,
        "websiteKey":key,
    })
    return solution



def main():
    print("Resolvendo reCaptcha v2")
    solution = solve_recaptcha_v2(PAGE_URL, PAGE_KEY)
    print("Solução: ", solution)

if __name__ == "__main__":
    main()

⚠️ Altere estas variáveis

• PROXY: Atualize com os detalhes do seu proxy. O formato deve ser http://username:password@ip:port. APENAS NECESSÁRIO com ReCaptchaV2Task
• capsolver.api_key: Obtenha sua chave da API no Painel do CapSolver.
• PAGE_URL: Substitua pela URL do site para o qual deseja resolver a reCaptcha v2.
• PAGE_KEY: Substitua pela CHAVE_DO_SITE do site para o qual deseja resolver a reCaptcha v2.

📌 Conclusão

Resolver a reCAPTCHA v2 de forma confiável é essencial para a automação moderna — seja você executando pipelines de scraping em larga escala, automatizando submissões de formulários, realizando extração de dados do SERP ou construindo agentes de IA personalizados que interajam com a web. Com o CapSolver, todo o processo se torna muito mais previsível, estável e escalável.
Ao escolher o tipo de tarefa correto (Proxy vs Proxyless), validar suas sitekeys e garantir que sua configuração de proxy seja sólida, você pode obter resoluções de CAPTCHA quase instantâneas com pouco custo.

Perguntas Frequentes

1. Preciso de um proxy para cada site?

Não — muitos sites funcionam perfeitamente com a tarefa Proxyless. Você só precisa de proxies para alvos de alto valor (por exemplo, marketplaces, plataformas de ingressos, Google Search, fluxos de login, etc.).

2. Que tipo de proxy funciona melhor com a reCAPTCHA v2?

Proxies residenciais ou de ISP oferecem a melhor estabilidade.
Proxies de datacenter podem funcionar, mas muitas vezes são bloqueados em sites de alto valor.

3. Quão rápido o CapSolver retorna o token?

A maioria das tarefas de reCAPTCHA v2 é resolvida em 1–5 segundos, dependendo da dificuldade do site e da carga da fila.

4. Posso reutilizar o mesmo token várias vezes?

Não. Cada token é de uso único e expira muito rapidamente (geralmente em ~120 segundos).

👀 Mais informações

• Como resolver reCAPTCHA v3 e obter uma pontuação de 0,7-0,9 como um humano
• Resolver todos os tipos de reCAPTCHA v2 / v2 invisível / v2 enterprise / v3 / v3 enterprise

Aumente seu orçamento de automação instantaneamente!
Use o código de bônus CAPN ao recarregar sua conta no CapSolver para obter um bônus extra de 5% em cada recarga — sem limites.
Resgate-o agora no seu Painel do CapSolver

🧾 Pontos-chave

• Use ReCaptchaV2Task + proxy bom para alvos de alto valor.
• Use Proxyless apenas para sites menos protegidos.
• O CapSolver simplifica drasticamente a integração — basta chamar capsolver.solve().
• A reCAPTCHA v2 fica mais rigorosa a cada ano; solucionadores estáveis são essenciais para fluxos de trabalho de produção.
• Sempre verifique cuidadosamente a sitekey e a URL — 90% dos erros de iniciantes vêm de sitekeys incorretas.