AI Ajanları ve Tarayıcı Otomasyonu için
AI Ajanları için CAPTCHA Çözücü
LangChain, CrewAI, browser-use veya Playwright ajanınız bir captcha ile karşılaştığında takılır. CaptchaSonic, ajanlara ve MCP istemcilerine çözme yeteneği vererek görevlerini engellenmeden tamamlamalarını sağlar.
Yapay zeka ajanları neden engelleniyor
Özerk ajanlar canlı web'de gezindikleri için her otomasyon gibi aynı anti-bot doğrulamalarıyla karşılaşır: reCAPTCHA, hCaptcha, Cloudflare Turnstile, AWS WAF ve daha fazlası. Çalışma sırasında çıkan bir captcha döngüyü kırar, ajan bağlamını kaybeder ve görev başarısız olur. Captcha çözmeyi ajanın çağırabileceği bir araç olarak ele alın; çalışma uçtan uca devam etsin.
Captcha çözmeyi ajan döngüsüne ekleyin
CaptchaSonic'i modelin çağırabileceği bir araç/fonksiyon olarak sunun veya barındırılan MCP sunucusuna bağlanın. Bir adım içerik yerine captcha döndürdüğünde ajan aracı çağırır, bir token alır ve devam eder — döngüde insan gerekmez.
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 loopBarındırılan MCP sunucusu
MCP uyumlu herhangi bir istemciyi API anahtarınızla https://mcp.captchasonic.com adresine yönlendirin; ekstra kod yazmadan captcha çözme araçlarını hemen kullanır. Kurulum için MCP belgelerine bakın.
MCP / AI Ajan BelgeleriAjan döngüsü nasıl çalışır
Engeli tespit edin
Ajan, bir sayfanın beklenen içerik yerine captcha doğrulaması döndürdüğünü fark eder.
Çözme aracını çağırın
Captcha türü, sayfa URL'si ve site anahtarıyla CaptchaSonic'i (araç veya MCP) çağırır, ardından token için sorgu yapar.
Görevi sürdürün
Token sayfaya veya isteğe eklenir ve ajan özgün hedefine devam eder.
Ajanınıza çözme yeteneği verin
$0.50 bonus krediyle ücretsiz başlayın. Barındırılan MCP sunucusu ile birlikte Python, Node.js ve Go SDK'ları.
Sık sorulan sorular
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.