Como resolver reCAPTCHA v3 com Python

Automatizar a Pesquisa do Google, ferramentas de SEO ou coleta de dados frequentemente exige interagir com sites protegidos pelo reCAPTCHA v3. Ao contrário do v2, o reCAPTCHA v3 não exibe uma caixa de seleção — ele atribui silenciosamente uma pontuação de risco (0,0–1,0). Para realizar automação estável e obter uma pontuação semelhante à humana (0,7–0,9), você precisa tanto da implementação correta quanto de um solver confiável.
Este guia mostra como resolver o reCAPTCHA v3 usando Python e CapSolver, com um script pronto para uso, dicas de configuração-chave e melhores práticas para evitar pontuações baixas.

⚙️ Pré-requisitos

• Python instalado
• Chave da API do CapSolver

Por que esses pré-requisitos importam
O Python permite integração fácil com solvers baseados em API, enquanto a chave da API do Capsolver identifica sua conta e garante que a solicitação receba pontuação semelhante à humana. O reCAPTCHA v3 é altamente sensível à simulação de comportamento do usuário, então usar uma API otimizada é essencial.

🤖 Etapa 1: Instalar Pacotes Necessários

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

pip install capsolver

⚡ Dica: Usar um ambiente virtual (como venv ou conda) ajuda a isolar dependências e evitar conflitos com outros projetos Python.

👨‍💻 Etapa 2: Código Python para resolver reCaptcha v3 e obter pontuação de 0,7-0,9

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

import json
import os
import capsolver
from urllib.parse import urlparse

# Altere esses valores
capsolver.api_key = "SuaChaveAPI"
PAGE_URL = ""
PAGE_KEY  = ""
PAGE_ACTION = ""

def solve_recaptcha_v3(url,key,pageAction):
    solution = capsolver.solve({
        "type": "ReCaptchaV3TaskProxyLess",
        "websiteURL": url,
        "websiteKey":key,
        "pageAction":pageAction
    })
    return solution


def main():

    print("Resolvendo reCaptcha v3")
    solution = solve_recaptcha_v3(PAGE_URL, PAGE_KEY, PAGE_ACTION)
    print("Solução: ", solution)

if __name__ == "__main__":
    main()

📌 Explicação Adicional

• chave do site
  Essa é normalmente o valor data-sitekey embutido no HTML do site de destino. Você pode encontrá-lo por meio das Ferramentas do Desenvolvedor do navegador ou solicitações de rede.

• ação da página
  O Google usa pageAction para categorizar interações do usuário. Defini-lo corretamente aumenta significativamente a precisão da pontuação. Você pode consultar o blog vinculado para extrair valores reais de pageAction.

• ReCaptchaV3TaskProxyLess
  Este modo é recomendado quando o site não exige um navegador com proxy. Se o sistema retornar pontuações normalmente baixas, você pode considerar um tipo de tarefa com proxy para simular localidade do usuário.

• Estrutura do Resultado
  O Capsolver retorna uma string de token (g-recaptcha-response) que você deve passar de volta para o formulário ou ponto de extremidade da API do site de destino durante a submissão.

Este exemplo de código se concentra na clareza, mas em scripts de produção, você também pode querer:
✓ Adicionar lógica de repetição
✓ Registrar respostas
✓ Adicionar tratamento de exceções para redes/tempo limite
✓ Validar tokens antes da submissão

⚠️ Altere estas variáveis

• capsolver.api_key: Obtenha sua chave da API no Painel do CapSolver
• PAGE_URL: Substitua pela URL do site para o qual deseja resolver o reCaptcha v3.
• PAGE_KEY: Atualize com a chave específica do site com reCAPTCHA.
• PAGE_ACTION: Substitua pela ação da página. Você pode ler este blog

👀 Mais informações

• Como resolver o 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

✅ Conclusão

Resolver o reCAPTCHA v3 de forma confiável é essencial para tarefas de automação como extração de dados de SEO, raspagem de SERP do Google e automação de fluxos de trabalho de alto volume. Com o Python e a API do CapSolver, você pode gerar pontuações semelhantes às humanas (0,7–0,9) e evitar páginas de desafio, mesmo em sites fortemente protegidos.
Seguindo as dicas de configuração acima, você garante taxas de sucesso mais altas e integração mais suave em sua pipeline de automação.

❓ Perguntas Frequentes

1. O que é o reCAPTCHA v3 e como ele se difere do v2?

O reCAPTCHA v3 usa um sistema baseado em pontuação em vez de desafios ou testes de imagens. Ele analisa silenciosamente o comportamento do usuário e atribui uma pontuação de 0,0 a 1,0. Pontuações mais altas indicam atividade semelhante à humana, enquanto bots geralmente recebem pontuações baixas.

2. Como posso encontrar a sitekey necessária para resolver o reCAPTCHA v3?

Você pode inspecionar o HTML da página usando as Ferramentas do Desenvolvedor do Chrome. Procure o atributo data-sitekey ou verifique o script que carrega a biblioteca reCAPTCHA.

3. O que é pageAction e por que ele importa?

O parâmetro pageAction identifica o tipo de interação na página, como login, envio ou pesquisa. Uma páginaAction incorreta pode levar a pontuações baixas ou rejeições.

4. Por que minha pontuação do reCAPTCHA v3 permanece baixa?

Causas comuns incluem pageAction ausente, sitekey incorreto, proxies de baixa qualidade (se usados) ou falha em imitar o comportamento real do navegador. Usar a configuração otimizada do CapSolver ajuda a melhorar a pontuação.

5. Este solução pode ser integrada com Selenium, Playwright ou Puppeteer?

Sim. Após obter o token usando o CapSolver, você pode injetá-lo em formulários ou variáveis JavaScript em qualquer navegador automatizado, incluindo Selenium ou Playwright.