Skip to content
CaptchaSonic

Für KI-Agenten und Browser-Automatisierung

CAPTCHA-Solver für KI-Agenten

Wenn Ihr LangChain-, CrewAI-, browser-use- oder Playwright-Agent auf ein Captcha stößt, bleibt er stehen. CaptchaSonic gibt Agenten und MCP-Clients eine Lösungsfunktion, damit sie die Aufgabe abschließen, statt blockiert zu werden.

Warum KI-Agenten blockiert werden

Autonome Agenten surfen im Live-Web und stoßen daher auf dieselben Anti-Bot-Prüfungen wie jede Automatisierung: reCAPTCHA, hCaptcha, Cloudflare Turnstile, AWS WAF und weitere. Ein Captcha mitten im Ablauf unterbricht den Loop, der Agent verliert den Kontext und die Aufgabe scheitert. Behandeln Sie das Lösen von Captchas als Werkzeug, das der Agent aufrufen kann, dann läuft der Vorgang durchgehend weiter.

LangChainCrewAIbrowser-usePlaywrightPuppeteerSeleniumMCP clientsAutoGen

CAPTCHA-Lösung in den Agenten-Loop einbinden

Stellen Sie CaptchaSonic als Tool bzw. Funktion bereit, die das Modell aufrufen kann, oder verbinden Sie den gehosteten MCP-Server. Liefert ein Schritt statt Inhalt ein Captcha, ruft der Agent das Tool auf, erhält ein Token und setzt fort, ohne menschliches Eingreifen.

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

Gehosteter MCP-Server

Verbinden Sie jeden MCP-kompatiblen Client mit https://mcp.captchasonic.com und Ihrem API-Schlüssel. Er erhält sofort CAPTCHA-Lösungswerkzeuge, ganz ohne Glue-Code. Die Einrichtung finden Sie in der MCP-Dokumentation.

MCP- / KI-Agenten-Dokumentation

So funktioniert der Agenten-Loop

01

Blockade erkennen

Der Agent bemerkt, dass eine Seite statt des erwarteten Inhalts eine Captcha-Prüfung geliefert hat.

02

Lösungs-Tool aufrufen

Er ruft CaptchaSonic (Tool oder MCP) mit Captcha-Typ, Seiten-URL und Site-Key auf und fragt dann das Token ab.

03

Aufgabe fortsetzen

Das Token wird in die Seite oder Anfrage eingefügt, und der Agent setzt sein ursprüngliches Ziel fort.

Geben Sie Ihrem Agenten eine Lösungsfunktion

Starten Sie kostenlos mit $0.50 Bonusguthaben. Gehosteter MCP-Server plus Python-, Node.js- und Go-SDKs.

Häufig gestellte Fragen

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.