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 reCAPTCHA v2 no Relevance AI com integração da CapSolver
Construa uma ferramenta da Relevance AI para resolver reCAPTCHA v2 usando o CapSolver. Automatize os envios de formulários via API sem automação de navegador.

Adélia Cruz
03-Feb-2026

Ferramentas de Raspagem de Dados Instantâneas: Métodos Rápidos para Extrair Dados da Web Sem Código
Descubra as melhores ferramentas de raspagem de dados instantâneas para 2026. Aprenda formas rápidas de extrair dados da web sem código usando as melhores extensões e APIs para extração automatizada.

Emma Foster
28-Jan-2026

Top 9 Frameworks de Agentes de IA em 2026
Descubra os 9 principais frameworks de agentes de IA para 2026, incluindo CrewAI, AutoGen e LangGraph. Aprenda como escolher o melhor framework para orquestração de agentes multi e desenvolvimento de agentes autônomos, e descubra ferramentas essenciais para interação web no mundo real.

Sora Fujimoto
26-Jan-2026

Uso do Navegador vs Browserbase: Qual Ferramenta de Automação de Navegador é Melhor para Agentes de IA?
Compare o uso do navegador vs Browserbase para automação de agentes de IA. Descubra funcionalidades, preços e como resolver CAPTCHAs com o CapSolver para fluxos de trabalho sem interrupções.

Adélia Cruz
26-Jan-2026

Bloqueios de IP em 2026: Como Funcionam e Métodos Práticos para Contornar Eles
Aprenda como burlar o banimento de IP em 2026 com nosso guia abrangente. Descubra técnicas modernas de bloqueio de IP e soluções práticas como proxies residenciais e solucionadores de CAPTCHA.

Adélia Cruz
26-Jan-2026

Como resolver Captcha no Maxun com Integração do CapSolver
Um guia prático para integrar o CapSolver com o Maxun para raspagem de web realista. Aprenda como lidar com reCAPTCHA, Cloudflare Turnstile e sites protegidos por CAPTCHA usando fluxos de trabalho de pré-autenticação e robô.

Adélia Cruz
21-Jan-2026

