Playwright · Python


Automação de Agentes · Dramaturgo
Adicionar resolução CAPTCHA aos Agentes Playwright
Dê aos agentes de IA baseados em Playwright uma maneira de lidar com CAPTCHAs suportados. As ferramentas do agente CapSolver podem detectar um desafio e, quando a resolução estiver habilitada, retornar e preencher automaticamente o resultado para que um fluxo de trabalho Python autorizado possa continuar.
Como funciona
Como funciona a resolução de CAPTCHA com Playwright
Use as ferramentas do agente CapSolver para detectar CAPTCHAs suportados, resolvê-los quando ativados e preencher automaticamente o resultado para que seu fluxo de trabalho autorizado do Playwright possa continuar.
Detectar
O iframe ou widget CAPTCHA aparece
Resolver
criarTask → obterTaskResult
Injetar
página.avaliar(token)
Continuar
Enviar formulário, prosseguir
Quando usar
Onde os agentes de IA baseados em Playwright usam CapSolver
Automação de teste de controle de qualidade
Lide com CAPTCHAs em testes autorizados de preparação e produção para reduzir execuções de testes interrompidas.
Fluxos de trabalho de RPA
Mantenha a entrada de dados, o processamento de pedidos, os relatórios e outros fluxos de trabalho do navegador em execução quando um CAPTCHA aparecer.
Extração de dados
Web scraping e coleta de dados de sites com proteção de bot – dados públicos que são controlados por reCAPTCHA ou Cloudflare Turnstile.
Agentes de navegador personalizados
Crie agentes de navegador de IA personalizados com Playwright que podem resolver CAPTCHAs e continuar suas tarefas.
Início rápido
Adicionar resolução CAPTCHA ao Playwright
Escolha o tratamento automático para uma configuração mais rápida ou use o modo token quando precisar de mais controle sobre o resultado do CAPTCHA.
# pip install capsolver-core playwright
# playwright install chromium
# export CAPSOLVER_API_KEY=CAP-XXXXXX
import asyncio
import os
from playwright.async_api import async_playwright
from capsolver_core import Capsolver, from_playwright_page
from _env import load_example_env # demo only: reads repo-root .env
load_example_env()
async def main():
async with async_playwright() as pw:
browser = await pw.chromium.launch(headless=False)
page = await browser.new_page()
await page.goto("https://www.google.com/recaptcha/api2/demo")
cap = Capsolver(api_key=os.environ["CAPSOLVER_API_KEY"])
driver = from_playwright_page(page) # wrap the live Playwright page
results = await cap.solve_on_page(driver) # detect -> solve -> autofill
for r in results:
status = "solved" if r.solution else "failed"
print(r.info.type.value, status, "filled:", r.filled)
await page.click('#recaptcha-demo-submit')
await page.wait_for_selector(".recaptcha-success")
print("Verification successful!")
await browser.close()
asyncio.run(main())
Injeção de token
Diferentes CAPTCHAs, diferentes campos de injeção.
Cada tipo de CAPTCHA armazena o token em um elemento DOM diferente. Veja como injetar para os tipos mais comuns.
# pip install capsolver-core playwright
# playwright install chromium
# export CAPSOLVER_API_KEY=CAP-XXXXXX
#
# reCAPTCHA v2 token injection -> #g-recaptcha-response
# handler.fill() writes the token and fires the widget callback for you.
import asyncio
import os
from playwright.async_api import async_playwright
from capsolver_core import Capsolver, CaptchaInfo, CaptchaType, from_playwright_page
from _env import load_example_env # demo only: reads repo-root .env
load_example_env()
URL = "https://www.google.com/recaptcha/api2/demo"
SITE_KEY = "6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-"
async def main():
async with async_playwright() as pw:
browser = await pw.chromium.launch(headless=False)
page = await browser.new_page()
await page.goto(URL)
cap = Capsolver(api_key=os.environ["CAPSOLVER_API_KEY"])
driver = from_playwright_page(page)
info = CaptchaInfo(
type=CaptchaType.RECAPTCHA_V2, website_url=URL, website_key=SITE_KEY
)
solution = await cap.solve(info)
filled = await cap.get_handler(info.type).fill(driver, solution, info)
print(f"filled={filled} token={solution.token[:40]}...")
await browser.close()
asyncio.run(main())Cobertura CAPTCHA
Tipos de CAPTCHA disponíveis para agentes Playwright
Use CapSolver com Playwright para lidar com desafios comuns de reCAPTCHA e Cloudflare Turnstile.
Tipo CAPTCHA
Tipo de tarefa
Seletor de injeção
Estado
reCAPTCHA v2
ReCaptchaV2TaskProxyLess
#g-recaptcha-resposta
reCAPTCHA v3
ReCaptchaV3TaskProxyLess
enviado com solicitação
reCAPTCHA Empresarial
ReCaptchaV2EnterpriseTaskProxyLess
#g-recaptcha-resposta
Torniquete Cloudflare
AntiTurnstilTaskProxyLess
[name="cf-turnstile-response"]
Melhores práticas de produção
Dicas para manuseio confiável de CAPTCHA na produção.
Verifique antes de resolver
01Chame CapSolver apenas quando um CAPTCHA estiver realmente presente. Verifique primeiro a existência de iframe ou widget.
Defina um tempo limite
02Defina um tempo limite razoável (30-60s) e tente novamente com espera se getTaskResult demorar muito.
Lide com os resultados com clareza
03Aplique o resultado retornado corretamente e defina o que o fluxo de trabalho deve fazer quando a resolução não for concluída.
Respeite os limites de taxas
04Ao executar contextos de navegador paralelos, limite as chamadas do CapSolver para permanecer dentro dos limites do seu plano.
Registrar encontros CAPTCHA
05Registre o ID da tarefa, o tipo de CAPTCHA, o status do resultado e os erros de cada tentativa de resolução.
Proteja sua chave API
06Armazene sua chave de API CapSolver em variáveis de ambiente ou em um gerenciador de segredos.
Uso responsável
Use CapSolver para automação responsável
CapSolver foi projetado para casos de uso de automação autorizados: testes de controle de qualidade, RPA em sistemas aos quais você tem permissão de acesso, coleta de dados públicos e tarefas de automação compatíveis. Não apoiamos nem toleramos acesso não autorizado, preenchimento de credenciais, spam ou qualquer atividade que viole os termos de serviço ou as leis aplicáveis.
Muitos fluxos de trabalho automatizados legítimos são sinalizados incorretamente como bots. CapSolver ajuda você a se recuperar de desafios CAPTCHA falso-positivos quando você tem um motivo válido para automatizar.
Perguntas frequentes
Integrações Relacionadas
Explore mais integrações CapSolver para sua pilha de agentes
Escolha outra integração para adicionar solução CAPTCHA ao fluxo de trabalho do seu agente ou navegador.
Uso do navegador
Adicione CapSolver como uma ação para agentes de IA baseados em navegador.
LangChain
Use CapSolver como uma ferramenta que pode ser chamada em agentes LangChain.
SDK de agentes OpenAI
Adicione resolução CAPTCHA por meio de ferramentas funcionais e fluxos de trabalho de agentes.

Adicione resolução CAPTCHA aos seus agentes Playwright
Obtenha sua chave de API, siga o guia de integração do Python e adicione CapSolver ao seu fluxo de trabalho do Playwright.
