🎉NOVOCapSolver para agentes de IA
Selenium CAPTCHA solver landing page hero section with code snippet and CTA buttons
Selenium CAPTCHA solver landing page hero section with code snippet and CTA buttons

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.

Playwright · Python

page.goto(target_url)
detect_captchas()
CAPTCHA detectedsupported challenge found on the page
solve_on_page(autofill=True)opt-in solving request · authorized workflow
result returned + autofilled
script continues
CapSolver Agent Tools

Solving enabled

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.

01

Detectar

O iframe ou widget CAPTCHA aparece

02

Resolver

criarTask → obterTaskResult

03

Injetar

página.avaliar(token)

04

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.

playwright_sdk.py
# 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

Suportado

reCAPTCHA v3

ReCaptchaV3TaskProxyLess

enviado com solicitação

Suportado

reCAPTCHA Empresarial

ReCaptchaV2EnterpriseTaskProxyLess

#g-recaptcha-resposta

Suportado

Torniquete Cloudflare

AntiTurnstilTaskProxyLess

[name="cf-turnstile-response"]

Suportado

Melhores práticas de produção

Dicas para manuseio confiável de CAPTCHA na produção.

Verifique antes de resolver

01

Chame CapSolver apenas quando um CAPTCHA estiver realmente presente. Verifique primeiro a existência de iframe ou widget.

Defina um tempo limite

02

Defina um tempo limite razoável (30-60s) e tente novamente com espera se getTaskResult demorar muito.

Lide com os resultados com clareza

03

Aplique 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

04

Ao executar contextos de navegador paralelos, limite as chamadas do CapSolver para permanecer dentro dos limites do seu plano.

Registrar encontros CAPTCHA

05

Registre 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

06

Armazene 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.

01

Servidor MCP

Conecte o CapSolver a outros clientes que suportam ferramentas MCP.

Ver Integração
02

Uso do navegador

Adicione CapSolver como uma ação para agentes de IA baseados em navegador.

Ver Integração
03

LangChain

Use CapSolver como uma ferramenta que pode ser chamada em agentes LangChain.

Ver Integração
04

SDK de agentes OpenAI

Adicione resolução CAPTCHA por meio de ferramentas funcionais e fluxos de trabalho de agentes.

Ver Integração

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.