AI एजेंट और MCP
किसी भी AI एजेंट से CaptchaSonic का उपयोग करें — Claude Code, Cursor, Windsurf, Antigravity, n8n — होस्टेड MCP सर्वर mcp.captchasonic.com के ज़रिए, स्थानीय npx सर्वर से, या सीधे SDK से।
CaptchaSonic agent-native है। कोई भी AI एजेंट हमारे MCP सर्वर के ज़रिए CAPTCHA हल कर सकता है, और यह दो तरीकों से उपलब्ध है:
- होस्टेड:
https://mcp.captchasonic.com, बेयरर टोकन के रूप में आपकी API key के साथ। कुछ इंस्टॉल नहीं करना होता। अनुशंसित। - स्थानीय:
npx -y @captchasonic/mcp-serverstdio पर, उन क्लाइंट्स के लिए जो केवल स्थानीय सर्वर समर्थित करते हैं।
दोनों में एक ही पाँच टूल हैं: solve_token_captcha, solve_image_captcha, get_task_result, get_balance और list_captcha_types। हर क्लाइंट के लिए MCP Get Started guide से शुरू करें, या नीचे दिए एजेंट-वार नोट्स पढ़ें। यदि आपका एजेंट MCP नहीं बोल सकता, तो इसके बजाय direct SDK का उपयोग करें।
एजेंट के लिए Golden Path
इसे किसी भी एजेंट में डालें, और वह एक ही राउंड ट्रिप में CAPTCHA हल कर सकता है:
# Claude Code (or any MCP client): add the hosted server once
claude mcp add --transport http captchasonic https://mcp.captchasonic.com --header "Authorization: Bearer sonic_xxx"
# Or, with no MCP — the same lifecycle via curl (replace TASK_ID after createTask):
curl -s https://api.captchasonic.com/createTask -H 'content-type: application/json' -d '{"apiKey":"sonic_xxx","task":{"type":"AntiTurnstileTaskProxyLess","websiteURL":"https://example.com","websiteKey":"0x4AAAAAAA..."}}'
curl -s https://api.captchasonic.com/getTaskResult -H 'content-type: application/json' -d '{"apiKey":"sonic_xxx","taskId":"TASK_ID"}'
TIP
किसी एजेंट को MCP for AI Agents की ओर इंगित करें। इसमें बताया गया है कि sitekeys कैसे खोजें, सही टूल कैसे चुनें और टोकन कैसे सबमिट करें, ताकि एजेंट बिना अतिरिक्त निर्देशों के काम कर सके।
Claude Code
होस्टेड सर्वर जोड़ें:
claude mcp add --transport http captchasonic https://mcp.captchasonic.com --header "Authorization: Bearer sonic_xxx"
स्थानीय रूप से चलाना पसंद है? claude mcp add captchasonic --env SONIC_API_KEY=sonic_xxx -- npx -y @captchasonic/mcp-server stdio पर वही टूल देता है।
Claude skill plugin (अनुशंसित)
निर्देशित वर्कफ़्लो के लिए आधिकारिक CaptchaSonic skill plugin इंस्टॉल करें। इसमें तीन Claude skills शामिल हैं और यह SONIC_API_KEY एनवायरनमेंट वेरिएबल का उपयोग करके होस्टेड MCP सर्वर से जुड़ता है। अपनी key एक्सपोर्ट करें, Claude Code शुरू करें, फिर चलाएँ:
/plugin marketplace add Captcha-Sonic/Agent-skills
/plugin install captchasonic
इसके बाद तीन skills सामान्य वर्कफ़्लो में एजेंट का मार्गदर्शन करती हैं:
captchasonic-setup— पहली बार MCP सेटअप और सत्यापन।captchasonic-solve— किसी भी CAPTCHA प्रकार को चरण-दर-चरण मार्गदर्शन के साथ हल करें।captchasonic-balance— खाते का बैलेंस और क्रेडिट स्थिति जाँचें।
TIP
सॉल्व के किसी बैच से पहले get_balance (या captchasonic-balance skill) को गार्ड के रूप में उपयोग करें, ताकि क्रेडिट कम होने पर एजेंट जल्दी रुक सके।
Antigravity
Antigravity की MCP कॉन्फ़िगरेशन में CaptchaSonic को स्थानीय stdio सर्वर के रूप में रजिस्टर करें:
{
"mcpServers": {
"captchasonic": {
"command": "npx",
"args": ["-y", "@captchasonic/mcp-server"],
"env": { "SONIC_API_KEY": "sonic_xxx" }
}
}
}
Antigravity के MCP सर्वर रीलोड करें, और CaptchaSonic के टूल एजेंट की टूल सूची में दिखेंगे।
Cursor
Settings → MCP खोलें (या ~/.cursor/mcp.json संपादित करें) और होस्टेड सर्वर जोड़ें:
{
"mcpServers": {
"captchasonic": {
"url": "https://mcp.captchasonic.com",
"headers": { "Authorization": "Bearer sonic_xxx" }
}
}
}
Windsurf
Settings → Cascade → MCP Servers खोलें (या ~/.codeium/windsurf/mcp_config.json संपादित करें):
{
"mcpServers": {
"captchasonic": {
"serverUrl": "https://mcp.captchasonic.com",
"headers": { "Authorization": "Bearer sonic_xxx" }
}
}
}
Generic MCP
कोई भी MCP क्लाइंट जो रिमोट सर्वर समर्थित करता है: https://mcp.captchasonic.com को Streamable HTTP transport और Authorization: Bearer sonic_xxx हेडर के साथ उपयोग करें। VS Code, Codex और Gemini CLI की कॉन्फ़िगरेशन Get Started guide में हैं।
जो क्लाइंट केवल स्थानीय सर्वर चलाते हैं, वे मानक stdio ब्लॉक लें (देखें Run locally):
{
"mcpServers": {
"captchasonic": {
"command": "npx",
"args": ["-y", "@captchasonic/mcp-server"],
"env": { "SONIC_API_KEY": "sonic_xxx" }
}
}
}
n8n
CaptchaSonic के पास एक सत्यापित n8n community node है (n8n.io listing), जो 20+ CAPTCHA प्रकारों को ड्रैग-और-ड्रॉप वर्कफ़्लो नोड्स में लपेटता है। यह स्टैंडअलोन नोड और n8n के AI Agent नोड के लिए टूल, दोनों के रूप में काम करता है।
→ पूरी n8n Integration Guide — चरण-दर-चरण इंस्टॉलेशन, क्रेडेंशियल सेटअप, 4 वर्कफ़्लो रेसिपी, प्रति-CAPTCHA-प्रकार कॉन्फ़िगरेशन, एरर हैंडलिंग पैटर्न और समस्या-निवारण।
त्वरित इंस्टॉल: Settings → Community Nodes → n8n-nodes-captchasonic इंस्टॉल करें → अपनी API key के साथ CaptchaSonic क्रेडेंशियल बनाएँ → हो गया।
MCP के बिना (सीधा SDK)
यदि आपका एजेंट MCP का उपयोग नहीं कर सकता, तो SDK को सीधे कॉल करें। टोकन-प्रकार का CAPTCHA एक ही फ़ंक्शन कॉल है।
result = solver.solve_turnstile(
website_url="https://example.com",
website_key="0x4AAAAAAA...",
proxy="http://user:pass@host:port", # optional
)
token = result["token"]await solver.solveTurnstile({
websiteURL: "https://example.com",
websiteKey: "0x4AAAAAAA...",
proxy: "http://user:[email protected]:8080",
});पूरी मेथड सूची के लिए Python SDK और Node.js SDK पेज देखें, या कच्चे तीन-कॉल लाइफ़साइकिल के लिए REST API reference देखें।