CAPSOLVER
Blog
Como resolver Captcha no Puppeteer usando o CapSolver

Como resolver Captcha no Puppeteer usando o CapSolver

Logo of CapSolver

Adélia Cruz

Neural Network Developer

24-Dec-2025

🎯 Visão Geral

Este tutorial o guiará pelo processo de resolver reCaptcha do Google no Puppeteer usando o CapSolver.

CapSolver é um serviço de resolução de captchas que ajuda você a resolver captchas.

Usamos algoritmos de resolução de captchas baseados em inteligência artificial, o que resulta em velocidade de resolução mais rápida e custos significativamente reduzidos, oferecendo uma excelente experiência de desenvolvedor.

O objetivo será resolver o captcha localizado em recaptcha-demo.appspot.com usando o CapSolver.

Formulário de Captcha

Durante o tutorial, seguiremos os seguintes passos para resolver o captcha acima:

  1. Instalar as dependências necessárias.
  2. Encontrar a chave do site do Formulário de Captcha.
  3. Configurar o CapSolver.
  4. Resolver o captcha.

📦 Instalar Dependências Necessárias

Para começar, precisamos instalar as seguintes dependências para este tutorial:

  • capsolver-python: SDK oficial do Python para integração fácil com a API do CapSolver.
  • pyppeteer: pyppeteer é uma versão do Puppeteer para Python.

Instale estas dependências executando o seguinte comando:

Copy
python -m pip install pyppeteer capsolver-python

Agora, crie um arquivo chamado main.py onde escreveremos o código Python para resolver captchas.

bash Copy
touch main.py

🔑 Obter a Chave do Site do Formulário de Captcha

A Chave do Site é um identificador único fornecido pelo Google que identifica unicamente cada Captcha.

Para resolver o Captcha, é necessário enviar a Chave do Site para o CapSolver.

Vamos encontrar a Chave do Site do Formulário de Captcha seguindo estes passos:

  1. Acesse o Formulário de Captcha.
Formulário de Captcha
  1. Abra as Ferramentas do Desenvolvedor do Chrome pressionando Ctrl/Cmd + Shift + I.
  2. Vá para a guia Elementos e procure por data-sitekey. Copie o valor do atributo.
Chave do Site
  1. Armazene a Chave do Site em um local seguro, pois ela será usada na próxima seção ao enviar o captcha para o CapSolver.

🤖 Configurar o CapSolver

Para resolver captchas usando o CapSolver, você precisa criar uma conta no CapSolver, adicionar fundos à sua conta e obter uma Chave da API. Siga estes passos para configurar sua conta no CapSolver:

  1. Registre-se em uma conta no CapSolver visitando capsolver.com.
Registrar-se
  1. Adicione fundos à sua conta do CapSolver usando PayPal, criptomoedas ou outros métodos de pagamento listados. Observe que o valor mínimo para depósito é de $6 e taxas adicionais se aplicam.
Adicionar Fundos
  1. Agora, copie a Chave da API fornecida pelo CapSolver e armazene-a de forma segura para uso posterior.
Armazenar Chave da API

💡 Resolver o Captcha

Agora, resolveremos o captcha usando o CapSolver. O processo geral envolve três etapas:

  1. Iniciar o navegador e visitar a página do captcha usando o pyppeteer.
  2. Resolver o captcha usando o CapSolver.
  3. Submeter a resposta do captcha.

Leia os seguintes trechos de código para entender essas etapas.
Iniciar o navegador e visitar a página do captcha:

python Copy
# Iniciar o navegador.
browser = await launch({'headless': False})

# Carregar a página de destino.
captcha_page_url = "https://recaptcha-demo.appspot.com/recaptcha-v2-checkbox.php"
page = await browser.newPage()
await page.goto(captcha_page_url)

Resolver o captcha usando o CapSolver:

python Copy
# Resolver o reCAPTCHA usando o CapSolver.
capsolver = RecaptchaV2Task("SUA_CHAVE_DA_API")

site_key = "6LfW6wATAAAAAHLqO2pb8bDBahxlMxNdo9g947u9"
task_id = capsolver.create_task(captcha_page_url, site_key)
result = capsolver.join_task_result(task_id)

# Obter o código do reCAPTCHA resolvido.
code = result.get("gRecaptchaResponse")

Definir o captcha resolvido no formulário e submetê-lo:

python Copy
# Definir o código do reCAPTCHA resolvido no formulário.
recaptcha_response_element = await page.querySelector('#g-recaptcha-response')
await page.evaluate(f'(element) => element.value = "{code}"', recaptcha_response_element)

# Submeter o formulário.
submit_btn = await page.querySelector('button[type="submit"]')
await submit_btn.click()

🚀 Juntando Tudo

Abaixo está o código completo para o tutorial, que resolverá o captcha usando o CapSolver.

python Copy
import asyncio
from pyppeteer import launch
from capsolver_python import RecaptchaV2Task

# O seguinte código resolve um desafio reCAPTCHA v2 usando o CapSolver.
async def main():
    # Iniciar o navegador.
    browser = await launch({'headless': False})

    # Carregar a página de destino.
    captcha_page_url = "https://recaptcha-demo.appspot.com/recaptcha-v2-checkbox.php"
    page = await browser.newPage()
    await page.goto(captcha_page_url)

    # Resolver o reCAPTCHA usando o CapSolver.
    print("Resolvendo captcha")
    capsolver = RecaptchaV2Task("SUA_CHAVE_DA_API")

    site_key = "6LfW6wATAAAAAHLqO2pb8bDBahxlMxNdo9g947u9"
    task_id = capsolver.create_task(captcha_page_url, site_key)
    result = capsolver.join_task_result(task_id)

    # Obter o código do reCAPTCHA resolvido.
    code = result.get("gRecaptchaResponse")
    print(f"reCAPTCHA resolvido com sucesso. O código de resolução é {code}")

    # Definir o código do reCAPTCHA resolvido no formulário.
    recaptcha_response_element = await page.querySelector('#g-recaptcha-response')
    await page.evaluate(f'(element) => element.value = "{code}"', recaptcha_response_element)

    # Submeter o formulário.
    submit_btn = await page.querySelector('button[type="submit"]')
    await submit_btn.click()

    # Pausar a execução para que você possa ver a tela após a submissão antes de fechar o navegador
    input("Submissão do Captcha bem-sucedida. Pressione Enter para continuar")

    # Fechar o navegador.
    await browser.close()

if __name__ == "__main__":
    asyncio.get_event_loop().run_until_complete(main())

Cole o código acima no seu arquivo main.py. Substitua SUA_CHAVE_DA_API pela sua chave da API e execute o código.

Você observará que o captcha será resolvido e você será recebido por uma página de sucesso 🥳.

Página de Sucesso do Captcha Resolvido

✅ Conclusão

Parabéns! Você aprendeu com sucesso como resolver captchas usando o CapSolver. Aqui estão os principais pontos aprendidos neste tutorial:

  • CapSolver oferece uma solução rápida e de baixo custo para resolução de captchas.
  • O processo geral para resolver o captcha envolve:
    • Criar uma conta no CapSolver e adicionar fundos.
    • Encontrar a chave do site do formulário de captcha alvo.
    • Submeter a chave do site e a URL da página para o CapSolver para resolver o captcha.
    • Definir a resposta do captcha resolvido no elemento apropriado e submeter o formulário.

Obrigado pelo seu tempo. 🙏 Desejamos boa sorte em sua jornada de automação! 🚀

🤔 Perguntas Frequentes

Qual é o custo para resolver captchas?

Utilizamos algoritmos de resolução de captchas baseados em inteligência artificial em vez de solucionadores humanos, resultando em custos significativamente mais baixos para resolver captchas. Portanto, nossas taxas são altamente competitivas no mercado.

Por exemplo, o custo para resolver captchas do Google v2/v3 varia de 0,8 a 1.

Para saber mais sobre nossos preços em detalhes, encorajamos você a visitar nossa página de preços aqui.

Conseguo resolver com sucesso o reCaptcha localizado em recaptcha-demo.appspot.com, mas quando tento resolver outro reCaptcha, ele não é resolvido. Por quê?

Neste tutorial, resolvemos o reCaptcha do Google V2, mas o site alvo provavelmente está usando o reCaptcha do Google V3.

Ao resolver o reCaptcha do Google V3, é importante garantir que o endereço IP e o agente do usuário usados para submeter o captcha sejam os mesmos usados para resolvê-lo.

Assim que você tiver proxies residenciais, pode atualizar o código da seguinte forma para resolver o captcha com sucesso:

  • Use um proxy ao iniciar o Puppeteer.
python Copy
browser = await launch({'args': ['--proxy-server=ip:port'], 'headless': False})
  • Defina o proxy e o agente do usuário após criar a tarefa do proxy da seguinte forma:
python Copy
capsolver = RecaptchaV2Task("SUA_CHAVE_DA_API")

capsolver.set_proxy(proxy_address='proxy_ip', proxy_port='proxy_port', proxy_login='user', proxy_password='password')

browser_useragent = browser.userAgent()
capsolver.set_user_agent(browser_useragent)

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

CAPTCHA com Inteligência Artificial alimentada por Grandes Modelos
CAPTCHA de IA Funcionada por Grandes Modelos: Por que É Mais Adequada para Cenários Empresariais

Como os modelos visuais de IA estão redefinindo o reconhecimento de CAPTCHA e por que solucionadores de nível corporativo precisam de dados, escala e treinamento personalizado.

AI
Logo of CapSolver

Adélia Cruz

13-Mar-2026

WebMCP vs MCP: Qual é a diferença para Agentes de IA?
WebMCP vs MCP: Qual é a diferença para Agentes de IA?

Explore as diferenças principais entre WebMCP e MCP para agentes de IA, compreendendo seus papéis na automação da web e na interação com dados estruturados. Aprenda como esses protocolos moldam o futuro das capacidades dos agentes de IA.

AI
Logo of CapSolver

Emma Foster

13-Mar-2026

OpenClaw vs. Nanobot
OpenClaw vs. Nanobot: Escolhendo Seu Agente de IA para Automação

Compare OpenClaw e Nanobot, dois frameworks de agentes de IA líderes, para automação eficiente. Descubra suas características, desempenho e como o CapSolver melhora suas capacidades.

AI
Logo of CapSolver

Anh Tuan

11-Mar-2026

Resolver CAPTCHA no OpenClaw
Como resolver CAPTCHA em OpenClaw – Guia passo a passo com a extensão CapSolver

Aprenda como resolver CAPTCHA no OpenClaw usando a extensão do Chrome CapSolver para automatização de navegador de IA sem interrupções.

AI
Logo of CapSolver

Adélia Cruz

06-Mar-2026

.Título PicoClaw + CapSolver
Automação PicoClaw: Um Guia para a Integração da API CapSolver

Aprenda a integrar o CapSolver com o PicoClaw para resolução automática de CAPTCHA em hardware de borda ultra-leve de $10.

AI
Logo of CapSolver

Adélia Cruz

02-Mar-2026

Resolver Captcha no Nanobot com o CapSolver
Como resolver Captcha no Nanobot com CapSolver

Automatize a resolução de CAPTCHA com o Nanobot e o CapSolver. Use o Playwright para resolver reCAPTCHA e o Cloudflare de forma autônoma.

AI
Logo of CapSolver

Adélia Cruz

02-Mar-2026