Como resolver Captcha no Puppeteer usando o 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.

Durante o tutorial, seguiremos os seguintes passos para resolver o captcha acima:
- Instalar as dependências necessárias.
- Encontrar a chave do site do Formulário de Captcha.
- Configurar o CapSolver.
- 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:
python -m pip install pyppeteer capsolver-python
Agora, crie um arquivo chamado main.py onde escreveremos o código Python para resolver captchas.
bash
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:
- Acesse o Formulário de Captcha.

- Abra as Ferramentas do Desenvolvedor do Chrome pressionando
Ctrl/Cmd+Shift+I. - Vá para a guia
Elementose procure pordata-sitekey. Copie o valor do atributo.

- 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:
- Registre-se em uma conta no CapSolver visitando capsolver.com.

- 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.

- Agora, copie a Chave da API fornecida pelo CapSolver e armazene-a de forma segura para uso posterior.

💡 Resolver o Captcha
Agora, resolveremos o captcha usando o CapSolver. O processo geral envolve três etapas:
- Iniciar o navegador e visitar a página do captcha usando o pyppeteer.
- Resolver o captcha usando o CapSolver.
- 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
# 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
# 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
# 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
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 🥳.

✅ 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
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
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 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.

Adélia Cruz
13-Mar-2026

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.

Emma Foster
13-Mar-2026

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.

Anh Tuan
11-Mar-2026

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.

Adélia Cruz
06-Mar-2026

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.

Adélia Cruz
02-Mar-2026

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.

Adélia Cruz
02-Mar-2026

