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

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

Melhores Ferramentas de Extração de Dados para Usar em 2026 (Comparação Completa)
Descubra as melhores ferramentas de extração de dados para 2026. Compare as principais plataformas de raspagem de web, ETL e com inteligência artificial para automatizar sua coleta de dados e fluxos de trabalho de IA.

Adélia Cruz
21-Jan-2026

Como resolver Captcha no Browser4 com integração do CapSolver
Automação do Browser4 de alto throughput combinada com o CapSolver para lidar com desafios de CAPTCHA na extração de dados da web em larga escala.

Adélia Cruz
21-Jan-2026

Melhores 7 Ferramentas de Agentes de IA para Automação da Web em 2026
Descubra os Melhores 7 Ferramentas de Agentes de IA para Automação Web em 2026. Revisamos CrewAI, MultiOn e mais, classificando-as pelo desempenho em ambientes reais e resiliência para agentes de IA em produção.

Adélia Cruz
20-Jan-2026

Resolva Captchas Ilimitados com o Melhor Solucionador de Captcha
Aprenda a resolver sem problemas captchas ilimitados com o melhor solver de captchas, um guia detalhado sobre como configurar e automatizar soluções de captchas de forma eficaz

Sora Fujimoto
20-Jan-2026

