Skip to content
CaptchaSonic

AI 에이전트 및 브라우저 자동화용

AI 에이전트용 캡차 해결 도구

LangChain, CrewAI, browser-use 또는 Playwright 에이전트가 캡차에 막히면 작업이 멈춥니다. CaptchaSonic은 에이전트와 MCP 클라이언트에 해결 기능을 제공해 작업을 끝까지 완료하도록 돕습니다.

AI 에이전트가 차단되는 이유

자율형 에이전트는 실제 웹을 탐색하므로 다른 자동화 도구와 같은 안티봇 확인에 부딪힙니다. reCAPTCHA, hCaptcha, Cloudflare Turnstile, AWS WAF 등이 그 예입니다. 실행 중 캡차가 나타나면 흐름이 끊기고, 에이전트는 맥락을 잃고, 작업은 실패합니다. 캡차 해결을 에이전트가 호출할 수 있는 도구로 다루면 작업이 처음부터 끝까지 계속 진행됩니다.

LangChainCrewAIbrowser-usePlaywrightPuppeteerSeleniumMCP clientsAutoGen

에이전트 루프에 캡차 해결 추가

CaptchaSonic을 모델이 호출할 수 있는 도구나 함수로 노출하거나, 호스팅 MCP 서버를 연결하세요. 단계 결과가 콘텐츠 대신 캡차를 반환하면 에이전트가 도구를 호출해 토큰을 받고 작업을 재개합니다. 사람의 개입은 필요하지 않습니다.

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

호스팅 MCP 서버

MCP를 지원하는 클라이언트에서 API 키와 함께 https://mcp.captchasonic.com 을 지정하면 추가 코드 없이 캡차 해결 도구를 바로 사용할 수 있습니다. 설정 방법은 MCP 문서를 참고하세요.

MCP / AI 에이전트 문서

에이전트 루프 작동 방식

01

차단 감지

에이전트가 페이지가 예상 콘텐츠 대신 캡차 확인 화면을 반환했음을 알아챕니다.

02

해결 도구 호출

캡차 유형, 페이지 URL, 사이트 키와 함께 CaptchaSonic(도구 또는 MCP)을 호출한 뒤 토큰을 폴링합니다.

03

작업 계속하기

토큰을 페이지나 요청에 넣고 에이전트는 원래 목표를 이어서 수행합니다.

에이전트에 캡차 해결 기능을 추가하세요

$0.50 보너스 크레딧으로 무료 시작하세요. 호스팅 MCP 서버와 Python, Node.js, Go SDK를 제공합니다.

자주 묻는 질문

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.