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

Como resolver CAPTCHA com o Vercel Agent Browser – Guia Passo a Passo usando o CapSolver
Aprenda como integrar o CapSolver com o Agent Browser para lidar com CAPTCHAs e construir fluxos de trabalho de automação de IA confiáveis.

Adélia Cruz
18-Mar-2026

Como resolver o fingerprinting TLS no n8n com o CapSolver
Resolva o fingerprinting TLS no n8n com o CapSolver. Faça as solicitações parecerem navegadores reais e evite bloqueios de detecção de bots.

Adélia Cruz
18-Mar-2026

Como resolver enigmas visuais no n8n com o CapSolver
Resolva CAPTCHAs visuais com o CapSolver Vision Engine no n8n. Trate deslizadores, rotação, seleção de objetos e GIF OCR instantaneamente.

Emma Foster
18-Mar-2026

Integração do CapSolver com o Web MCP: Um Guia para Agentes Autônomos
Melhore as capacidades de automação da web do seu agente de IA. Este guia detalha como integrar o CapSolver para resolver captchas de forma eficiente no framework Web MCP, garantindo operações confiáveis e em conformidade.

Emma Foster
17-Mar-2026

Como navegar pelo Cloudflare Turnstile com o Playwright Stealth em fluxos de trabalho de IA
Descubra como lidar efetivamente com o Cloudflare Turnstile em fluxos de trabalho de IA usando técnicas de disfarce do Playwright e o CapSolver para resolução confiável de captchas. Aprenda estratégias práticas de integração e melhores práticas para automação contínua.

Lucas Mitchell
17-Mar-2026

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

