Como Resolver reCAPTCHA com Playwright e CapSolver (Guia Passo a Passo)
Como Resolver reCAPTCHA com Playwright e CapSolver (Guia Passo a Passo)
Ad¨¦lia Cruz
Neural Network Developer
02-Sep-2025
? poss¨ªvel que voc¨º tenha encontrado CAPTCHAs em sua raspagem web? Muitos sites empregam um sistema CAPTCHA (o mais comum ¨¦ o reCAPTCHA) para evitar acesso automatizado. Mas, neste guia, mostrarei como resolver o reCAPTCHA v2 e v3 automaticamente com o Playwright usando o CapSolver ¡ª uma poderosa API de resolu??o de CAPTCHA.
O que ¨¦ Playwright?
Playwright ¨¦ uma biblioteca Node.js de c¨®digo aberto para automa??o de navegador. Ele suporta v¨¢rios navegadores como Chromium, Firefox e WebKit, tornando-o uma ferramenta vers¨¢til para desenvolvedores. O Playwright ¨¦ conhecido por sua confiabilidade, velocidade e capacidade de lidar com intera??es web complexas, incluindo lidar com conte¨²do din?mico, preencher formul¨¢rios e lidar com pop-ups.
Lutando com a falha repetida em resolver completamente o CAPTCHA irritante?
Descubra a solu??o autom¨¢tica perfeita de CAPTCHA com a tecnologia Auto Web Unblock com IA do Capsolver!
Pe?a seu C¨®digo B?nus para as melhores solu??es de CAPTCHA; CapSolver: WEBS. Ap¨®s resgat¨¢-lo, voc¨º receber¨¢ um b?nus extra de 5% ap¨®s cada recarga, Ilimitado
O que ¨¦ reCAPTCHA e por que ¨¦ importante na raspagem web?
reCAPTCHA ¨¦ um sistema CAPTCHA projetado pelo Google para diferenciar usu¨¢rios humanos de bots. Ele geralmente apresenta aos usu¨¢rios tarefas como identificar imagens ou simplesmente marcar uma caixa com a inscri??o "N?o sou um rob?". Embora essas tarefas sejam simples para humanos, elas representam um desafio significativo para os bots, o que ¨¦ exatamente o objetivo.
O reCAPTCHA vem em v¨¢rias vers?es, cada uma projetada para diferenciar humanos de bots de maneiras ¨²nicas:
reCAPTCHA v1: A vers?o original exigia que os usu¨¢rios decifrassem e digitassem texto distorcido em uma caixa de texto.
reCAPTCHA v2: Esta vers?o introduziu a caixa de sele??o familiar onde os usu¨¢rios confirmam sua identidade humana clicando em "N?o sou um rob?". Ocasionalmente, pode solicitar aos usu¨¢rios que selecionem imagens espec¨ªficas de uma grade para verificar sua autenticidade.
reCAPTCHA v3: Ao contr¨¢rio das vers?es anteriores, o reCAPTCHA v3 opera silenciosamente em segundo plano, analisando o comportamento do usu¨¢rio para atribuir uma pontua??o de risco que indica se o usu¨¢rio provavelmente ¨¦ humano ou um bot. Esta vers?o oferece uma experi¨ºncia perfeita, sem exigir intera??o direta do usu¨¢rio.
Neste blog, vamos nos concentrar em resolver o reCAPTCHA V2 e V3, que s?o amplamente usados para distinguir usu¨¢rios genu¨ªnos de bots. O reCAPTCHA V2 geralmente exibe uma caixa de sele??o com a mensagem "N?o sou um rob?", enquanto o reCAPTCHA V3 pode aparecer como um distintivo invis¨ªvel, realizando suas verifica??es sem interromper a experi¨ºncia do usu¨¢rio. Aqui est¨¢ um exemplo visual do reCAPTCHA em a??o:
Por que usar Playwright para raspagem web?
A capacidade do Playwright de simular intera??es reais do usu¨¢rio em v¨¢rios navegadores o torna ideal para raspagem web. Ele pode lidar com cen¨¢rios complexos, como preencher formul¨¢rios, navegar pelas p¨¢ginas e interagir com conte¨²do din?mico. No entanto, quando um site emprega o reCAPTCHA, o Playwright sozinho n?o consegue resolver o desafio ¡ª ¨¦ a¨ª que entra o CapSolver.
Passo a passo: Resolver reCAPTCHA v2 com Playwright e CapSolver
CapSolver oferece suporte a uma ampla gama de desafios CAPTCHA com suporte abrangente, incluindo reCAPTCHA v2, v3 e muito mais. As solu??es personalizadas garantem navega??o suave, mesmo pelos sistemas de seguran?a mais avan?ados.
Os principais recursos do CapSolver incluem:
Ampla gama de CAPTCHAs suportados: De reCAPTCHA a Turnstile, o CapSolver pode lidar com todos eles.
F¨¢cil integra??o da API: Documenta??o detalhada dispon¨ªvel , tornando simples a integra??o do CapSolver com seus aplicativos existentes.
Extens?es de navegador: Dispon¨ªvel para Chrome permitem que voc¨º resolva CAPTCHAs diretamente no seu navegador.
Pre?os flex¨ªveis: O CapSolver oferece diferentes pacotes de pre?os para atender a v¨¢rias necessidades, garantindo que voc¨º possa encontrar um plano que se ajuste ao seu projeto.
Instala??o e configura??o
Para resolver desafios reCAPTCHA usando Playwright, voc¨º precisar¨¢ instalar a biblioteca playwright-recaptcha. Esta biblioteca requer que o FFmpeg seja instalado em seu sistema, o que ¨¦ essencial para transcrever desafios de ¨¢udio do reCAPTCHA v2.
Voc¨º pode instalar a biblioteca e o FFmpeg necess¨¢rios usando os seguintes comandos com base no seu sistema operacional:
Instala??o da biblioteca:
bashCopy
pip install playwright-recaptcha
Instala??o do FFmpeg:
Debian:
bashCopy
apt-get install ffmpeg
MacOS:
bashCopy
brew install ffmpeg
Windows:
bashCopy
winget install ffmpeg
Observa??o: Certifique-se de que os bin¨¢rios ffmpeg e ffprobe estejam no PATH do seu sistema para que o pydub possa localiz¨¢-los.
Integrando o CapSolver em seu fluxo de trabalho
Depois de instalar as ferramentas necess¨¢rias, voc¨º pode integrar o CapSolver ao seu projeto de raspagem web para lidar com os desafios reCAPTCHA automaticamente. Aqui est¨¢ um exemplo de como fazer isso usando Python:
C¨®digo de exemplo para resolver reCAPTCHA v2 com CapSolver
pythonCopy
# pip install requests
import requests
import time
# TODO: defina sua configura??o
api_key = "YOUR_API_KEY" # sua chave de API do capsolver
site_key = "6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-" # chave do site do seu site de destino
site_url = "https://www.google.com/recaptcha/api2/demo" # URL da p¨¢gina do seu site de destino
def capsolver():
payload = {
"clientKey": api_key,
"task": {
"type": 'ReCaptchaV2TaskProxyLess',
"websiteKey": site_key,
"websiteURL": site_url
}
}
res = requests.post("https://api.capsolver.com/createTask", json=payload)
resp = res.json()
task_id = resp.get("taskId")
if not task_id:
print("Falha ao criar tarefa:", res.text)
return
print(f"Obteve taskId: {task_id} / Obtendo resultado...")
while True:
time.sleep(3) # atraso
payload = {"clientKey": api_key, "taskId": task_id}
res = requests.post("https://api.capsolver.com/getTaskResult", json=payload)
resp = res.json()
status = resp.get("status")
if status == "ready":
return resp.get("solution", {}).get('gRecaptchaResponse')
if status == "failed" or resp.get("errorId"):
print("Solu??o falhou! resposta:", res.text)
return
token = capsolver()
print(token)
C¨®digo de exemplo para resolver reCAPTCHA v3 com CapSolver
pythonCopy
# pip install requests
import requests
import time
# TODO: defina sua configura??o
api_key = "YOUR_API_KEY" # sua chave de API do capsolver
site_key = "6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_kl-" # chave do site do seu site de destino
site_url = "https://www.google.com" # URL da p¨¢gina do seu site de destino
def capsolver():
payload = {
"clientKey": api_key,
"task": {
"type": 'ReCaptchaV3TaskProxyLess',
"websiteKey": site_key,
"websiteURL": site_url,
"pageAction": "login",
}
}
res = requests.post("https://api.capsolver.com/createTask", json=payload)
resp = res.json()
task_id = resp.get("taskId")
if not task_id:
print("Falha ao criar tarefa:", res.text)
return
print(f"Obteve taskId: {task_id} / Obtendo resultado...")
while True:
time.sleep(1) # atraso
payload = {"clientKey": api_key, "taskId": task_id}
res = requests.post("https://api.capsolver.com/getTaskResult", json=payload)
resp = res.json()
status = resp.get("status")
if status == "ready":
return resp.get("solution", {}).get('gRecaptchaResponse')
if status == "failed" or resp.get("errorId"):
print("Solu??o falhou! resposta:", res.text)
return
token = capsolver()
print(token)
Melhores pr¨¢ticas para tratamento de CAPTCHA em raspagem web
Use proxies: Ao raspar sites, ¨¦ importante usar proxies para evitar ser banido ou limitado pela taxa.
Gire os agentes de usu¨¢rio: Para evitar ainda mais a detec??o, gire suas strings de agente de usu¨¢rio para imitar diferentes navegadores e dispositivos.
Respeite as pol¨ªticas do site: Sempre verifique o arquivo robots.txt do site e cumpra suas regras de raspagem. Evite sobrecarregar os servidores com muitas solicita??es.
Lidar com erros com eleg?ncia: Implemente o tratamento de erros em seus scripts para gerenciar cen¨¢rios em que a resolu??o de CAPTCHA falha. Isso ajudar¨¢ a manter a robustez de seus projetos de raspagem.
Conclus?o
Combinando o Playwright com o CapSolver, voc¨º pode contornar o reCAPTCHA v2 e v3 automaticamente, mantendo seus projetos de raspagem funcionando sem problemas. ? r¨¢pido, confi¨¢vel e economiza interrup??es manuais.
? Quer experimentar por si mesmo? Confira a documenta??o oficial do CapSolver e pe?a seu c¨®digo de b?nus hoje.
FAQs sobre resolu??o de reCAPTCHA com Playwright
P1: Qual a maneira mais f¨¢cil de resolver o reCAPTCHA no Playwright?
O m¨¦todo mais simples ¨¦ integrar a API do CapSolver ¡ª ele manipula automaticamente os tokens v2 e v3.
P2: O CapSolver pode lidar com o reCAPTCHA v3?
Sim. Ele retorna um token gRecaptchaResponse com base em sua pontua??o m¨ªnima (minScore) necess¨¢ria.
P3: Qu?o r¨¢pido ¨¦ o CapSolver?
Normalmente apenas alguns segundos, dependendo da carga do sistema.
P4: Posso usar o CapSolver sem proxies?
Sim, mas os proxies melhoram a estabilidade e reduzem os bloqueios.
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.
