Skip to content
CaptchaSonic

Pour agents IA et automatisation de navigateur

Solveur de CAPTCHA pour agents IA

Quand votre agent LangChain, CrewAI, browser-use ou Playwright rencontre un CAPTCHA, il se bloque. CaptchaSonic donne aux agents et aux clients MCP une capacité de résolution pour qu'ils mènent la tâche à terme au lieu d'être bloqués.

Pourquoi les agents IA sont bloqués

Les agents autonomes naviguent sur le web en direct : ils rencontrent donc les mêmes défis anti-bot que toute automatisation : reCAPTCHA, hCaptcha, Cloudflare Turnstile, AWS WAF et d'autres. Un CAPTCHA en cours d'exécution interrompt la boucle, l'agent perd son contexte et la tâche échoue. Traitez la résolution de CAPTCHA comme un outil que l'agent peut appeler, et l'exécution se poursuit de bout en bout.

LangChainCrewAIbrowser-usePlaywrightPuppeteerSeleniumMCP clientsAutoGen

Intégrez la résolution de CAPTCHA dans la boucle de l'agent

Exposez CaptchaSonic comme outil ou fonction que le modèle peut appeler, ou connectez le serveur MCP hébergé. Lorsqu'une étape renvoie un CAPTCHA au lieu du contenu, l'agent appelle l'outil, obtient un jeton et reprend, sans intervention humaine.

agent_loop.py
from captchasonic import CaptchaSonic
from langchain.tools import tool

solver = CaptchaSonic(api_key="YOUR_API_KEY")

@tool
def solve_captcha(captcha_type: str, website_url: str, website_key: str) -> str:
    """Solve a captcha and return a token the agent can submit."""
    task = solver.create_task(
        type=captcha_type,          # e.g. "ReCaptchaV2" | "Turnstile" | "HCaptcha"
        website_url=website_url,
        website_key=website_key,
    )
    return solver.get_task_result(task.id).token

# Agent loop: detect -> solve -> continue
page.goto(target_url)
if page.locator('iframe[src*="recaptcha"]').count():
    sitekey = page.get_attribute('[data-sitekey]', 'data-sitekey')
    token = solve_captcha("ReCaptchaV2", page.url, sitekey)
    page.evaluate("(t)=>{document.querySelector('#g-recaptcha-response').value=t}", token)
    page.click('button[type=submit]')  # task resumes, no human in the loop

Serveur MCP hébergé

Pointez n'importe quel client compatible MCP vers https://mcp.captchasonic.com avec votre clé API : il obtient aussitôt des outils de résolution de CAPTCHA, sans code de liaison. Consultez la documentation MCP pour la configuration.

Documentation MCP / agents IA

Fonctionnement de la boucle de l'agent

01

Détecter le blocage

L'agent remarque qu'une page a renvoyé un défi CAPTCHA au lieu du contenu attendu.

02

Appeler l'outil de résolution

Il appelle CaptchaSonic (outil ou MCP) avec le type de CAPTCHA, l'URL de la page et la clé du site, puis interroge le jeton.

03

Poursuivre la tâche

Le jeton est injecté dans la page ou la requête, et l'agent reprend son objectif initial.

Donnez à votre agent une capacité de résolution

Commencez gratuitement avec $0.50 de crédits bonus. Serveur MCP hébergé, plus les SDK Python, Node.js et Go.

Questions fréquentes

It is an API (and, for CaptchaSonic, a hosted MCP server) that an autonomous agent can call as a tool when it hits a captcha. The agent submits the captcha type, page URL and site key, receives a token, injects it, and continues its task instead of stalling.

Yes. Expose CaptchaSonic as a LangChain/CrewAI tool or a Python/Node.js/Go function, or connect the hosted MCP server. browser-use, Playwright, Puppeteer and Selenium agents call the same solve flow inline.

Point any MCP-compatible client at the hosted CaptchaSonic MCP server (https://mcp.captchasonic.com) and it gains CAPTCHA-solving tools with no glue code. The model decides when to call them during a run. Setup is documented in the MCP docs.

hCaptcha, reCAPTCHA v2, Cloudflare Turnstile, GeeTest, AWS WAF, TikTok, Binance and image/OCR — the same coverage as the rest of the CaptchaSonic API, only charged for successful solves.

Agents browse the live web, so anti-bot systems present the same challenges they show any automation. Without a solve step the agent loses its loop context and the task fails. Adding captcha solving as a callable tool keeps the run going end to end.