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
Automatización de agentes · Playwright
Añada la resolución de CAPTCHA a los agentes de Playwright
Proporciona a los agentes de IA basados en Playwright una forma de gestionar CAPTCHAs compatibles. CapSolver Agent Tools puede detectar un desafío y, cuando la resolución está habilitada, devolver y autocompletar el resultado para que pueda continuar un flujo de trabajo autorizado Python.
Cómo funciona
Cómo funciona la resolución CAPTCHA con Playwright
Utilice CapSolver Agent Tools para detectar CAPTCHAs compatibles, resolverlos cuando estén habilitados y rellenar automáticamente el resultado para que su flujo de trabajo autorizado Playwright pueda continuar.
01
Detectar
Aparece un iframe o widget CAPTCHA
02
Resolver
createTask → getTaskResult
03
Inyectar
page.evaluate(token)
04
Continuar
Enviar formulario, continuar
Cuándo usar
Donde los agentes de IA basados en Playwright utilizan CapSolver
Automatización de pruebas de QA
Gestione CAPTCHAs en las pruebas de preproducción y producción autorizadas para reducir las interrupciones en las ejecuciones de las pruebas.
Flujos de trabajo RPA
Mantenga en funcionamiento la introducción de datos, el procesamiento de pedidos, la generación de informes y otros flujos de trabajo del navegador cuando aparezca un CAPTCHA.
Extracción de datos
Extracción de datos web y recopilación de datos de sitios con protección contra bots: datos públicos que están restringidos por reCAPTCHA o Cloudflare Turnstile.
Agentes de navegador personalizados
Crea agentes de navegador con IA personalizados con Playwright que puedan resolver CAPTCHAs y continuar con sus tareas.
Inicio rápido
Agregar resolución CAPTCHA a Playwright
Elija el modo automático para una configuración más rápida, o utilice el modo token cuando necesite un mayor control sobre el resultado 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())
Inyección de tokens
Diferentes CAPTCHAs, diferentes campos de inyección.
Cada tipo CAPTCHA almacena el token en un elemento DOM diferente. A continuación, se explica cómo inyectarlo para los tipos más comunes.
# 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 CAPTCHA disponibles para agentes Playwright
Utilice CapSolver con Playwright para gestionar los desafíos comunes reCAPTCHA y Cloudflare Turnstile.
Tipo CAPTCHA
Tipo de tarea
Selector de inyección
Estado
reCAPTCHA v2
ReCaptchaV2TaskProxyLess
#g-recaptcha-response
Compatible
reCAPTCHA v3
ReCaptchaV3TaskProxyLess
Se envía con la solicitud
Compatible
reCAPTCHA Enterprise
ReCaptchaV2EnterpriseTaskProxyLess
#g-recaptcha-response
Compatible
Cloudflare Turnstile
AntiTurnstileTaskProxyLess
[name="cf-turnstile-response"]
Compatible
Mejores prácticas de producción
Consejos para gestionar CAPTCHA de forma fiable en entornos de producción.
Verificar antes de resolver
01Llama CapSolver únicamente cuando haya un CAPTCHA presente. Comprueba primero si existe un iframe o widget.
Establecer un tiempo de espera
02Establezca un tiempo de espera razonable (30–60 s) y reintente con demoras progresivas si getTaskResult tarda demasiado.
Gestionar los resultados con claridad
03Aplique correctamente el resultado obtenido y defina qué debe hacer el flujo de trabajo cuando la resolución no se complete.
Respete los límites de velocidad.
04Al ejecutar contextos de navegador en paralelo, limite las llamadas CapSolver para mantenerse dentro de los límites de su plan.
Registrar encuentros CAPTCHA
05Registre el ID de la tarea, el tipo de CAPTCHA, el estado del resultado y los errores de cada intento de resolución.
Proteja su clave API
06Guarda tu clave API CapSolver en variables de entorno o en un gestor de secretos.
Uso responsable
Utilice CapSolver para una automatización responsable.
CapSolver está diseñado para casos de automatización autorizados: pruebas de QA, RPA en sistemas a los que tiene permiso de acceso, recopilación de datos públicos y tareas de automatización conformes a la normativa. No apoyamos ni toleramos el acceso no autorizado, los ataques de relleno de credenciales, el spam ni las actividades que infrinjan los términos de servicio o las leyes aplicables.
Muchos flujos de trabajo automatizados legítimos se identifican erróneamente como bots. CapSolver te ayuda a solucionar los falsos positivos de los desafíos CAPTCHA cuando tienes una razón válida para automatizar.
Preguntas frecuentes
Integraciones relacionadas
Explore más integraciones de CapSolver para su conjunto de herramientas de agentes
Elija otra integración para agregar la resolución CAPTCHA al flujo de trabajo de su agente o navegador.
02
Browser Use
Agregar CapSolver como una acción para agentes de IA basados en navegador.
03
LangChain
Utilice CapSolver como una herramienta invocable en los agentes LangChain.
04
OpenAI Agents SDK
Agregar resolución CAPTCHA a través de herramientas funcionales y flujos de trabajo de agentes.
Añade la resolución CAPTCHA a tus agentes Playwright
Obtén tu clave API, sigue la guía de integración Python y añade CapSolver a tu flujo de trabajo Playwright.