MCP से अपने AI एजेंट में CAPTCHA हल करने की क्षमता जोड़ें

आधिकारिक @solvethree/sdk डाउनलोड में solvethree-mcp एक्ज़ीक्यूटेबल शामिल है। नीचे दिए गए कॉन्फ़िगरेशन में दिए गए पैकेज URL से इसे चलाने के लिए npx इस्तेमाल होता है। दर्ज करने के लिए कोई होस्ट किया गया MCP एंडपॉइंट नहीं है।

• जिस वातावरण में आपका MCP होस्ट चलता है, वहाँ npx उपलब्ध रखें।
• होस्ट के वातावरण में SOLVETHREE_API_KEY को अपने वर्कस्पेस की API कुंजी पर सेट करें। इसे ब्राउज़र कोड और प्रॉम्प्ट से बाहर रखें।
• उसी वातावरण में SOLVETHREE_PROXY सेट करें। reCAPTCHA टूल अपना एकमात्र प्रॉक्सी इस वेरिएबल से पढ़ता है, टूल अनुरोध से नहीं।

JSON MCP कॉन्फ़िगरेशन स्वीकार करने वाले होस्ट के लिए यह सर्वर एंट्री जोड़ें:

{
  "mcpServers": {
    "solvethree": {
      "command": "npx",
      "args": [
        "--yes",
        "--package=https://solvethree.com/downloads/solvethree-sdk-0.1.0.tgz",
        "solvethree-mcp"
      ]
    }
  }
}

Codex के लिए इसके बजाय यह TOML कॉन्फ़िगरेशन इस्तेमाल करें। इसकी env_vars एंट्री होस्ट के वातावरण से दोनों वेरिएबल आगे भेजती है; यह उनके मान सेट नहीं करती।

[mcp_servers.solvethree]
command = "npx"
args = ["--yes", "--package=https://solvethree.com/downloads/solvethree-sdk-0.1.0.tgz", "solvethree-mcp"]
env_vars = ["SOLVETHREE_API_KEY", "SOLVETHREE_PROXY"]
startup_timeout_sec = 60
tool_timeout_sec = 100

इन एनवायरनमेंट वेरिएबल की उपलब्धता के साथ होस्ट शुरू या रीलोड करें। जाँचें कि वह solvethree_capabilities, solvethree_create_recaptcha, solvethree_create_kasada, solvethree_create_tmpt और solvethree_get_task उपलब्ध कराता है।

reCAPTCHA टास्क बनाने से पहले लक्ष्य साइट की प्रोफ़ाइल सेट अप करें और सुनिश्चित करें कि वह आपके वर्कस्पेस के लिए सक्रिय है। MCP से होस्टनाम और action भेजने से वह प्रोफ़ाइल नहीं बनती।

उपलब्ध क्षमताओं की जाँच के लिए solvethree_capabilities इस्तेमाल करें। reCAPTCHA v3 Enterprise के लिए इस अनुरोध के साथ solvethree_create_recaptcha कॉल करें:

{
  "site": "accounts.example.com",
  "action": "login",
  "requestId": "agent-login-001",
  "waitMs": 0
}

accounts.example.com को अपनी लक्ष्य साइट से और login को अपने एप्लिकेशन के लिए ज़रूरी action से बदलें। इस लॉजिकल टास्क के लिए एक requestId चुनें और उसे अनुरोध के साथ सहेजें। waitMs शून्य पर सेट होने पर इस कॉल में पूरा होने की प्रतीक्षा करने के बजाय परिणाम अलग से प्राप्त करें।

हर MCP create के लिए requestId ज़रूरी है, भले ही मूल टास्क API में यह फ़ील्ड वैकल्पिक हो। 1–64 ASCII अक्षर, अंक, अंडरस्कोर या हाइफ़न इस्तेमाल करें।

1. 1.

   लौटाया गया टास्क ID सहेजें

   टास्क बनना परिणाम नहीं है। टास्क ID सहेजें ताकि एजेंट वही टास्क प्राप्त कर सके।

2. 2.

   solvethree_get_task कॉल करें

   create कॉल से लौटाया गया टास्क ID इस्तेमाल करें। अगर स्थिति pending या solving है, तो कुछ समय बाद टास्क फिर से प्राप्त करें। इनमें से किसी भी स्थिति में उपयोग योग्य समाधान नहीं होता।

3. 3.

   अंतिम स्थिति सँभालें

   ready पर समाधान अपने ब्राउज़र या एप्लिकेशन इंटीग्रेशन को दें। failed पर errorCode और error की जाँच करें और उस टास्क की पोलिंग रोक दें।

reCAPTCHA के लिए अपने ब्राउज़र या एप्लिकेशन अनुरोध से solution.token सबमिट करें। उसके User-Agent और sec-ch-ua हेडर लौटाए गए userAgent और secChUa से सेट करें, और SOLVETHREE_PROXY में कॉन्फ़िगर किया गया प्रॉक्सी दोबारा इस्तेमाल करें। अगर आपका प्रदाता निकास बदलता रहता है, तो उस प्रॉक्सी सेशन को एक ही निकास पर स्थिर रखें।

Kasada हेडर लौटाता है और Ticketmaster TMPT कच्चा कुकी मान लौटाता है। आपने जिस टास्क का अनुरोध किया है, उसी के अनुसार आउटपुट लागू करें; इन परिणामों को एक-दूसरे की जगह इस्तेमाल नहीं किया जा सकता।

MCP सर्वर ब्राउज़र नहीं चलाता और न ही फ़ॉर्म भरता है। उसके होस्ट को निजी समाधान डेटा मिलता है और आपका एप्लिकेशन उसे सबमिट करता है। लक्ष्य की प्रतिक्रिया अलग से जाँचें: ready का अर्थ है कि solvethree ने समाधान जनरेट किया है, न कि लक्ष्य ने उसे स्वीकार कर लिया है।

कनेक्शन टाइम आउट होने से यह साबित नहीं होता कि टास्क बनाना विफल हुआ। अगर आपको टास्क ID मिला है, तो उससे टास्क प्राप्त करें। अन्यथा, मौजूदा टास्क प्राप्त करने के लिए वही निर्माण अनुरोध उसी requestId और बिना बदले टास्क इनपुट के साथ दोहराएँ। केवल प्रतिक्रिया खो जाने के कारण नया ID जनरेट न करें।

अलग टास्क इनपुट के साथ उसी अनुरोध ID का दोबारा उपयोग करने पर टकराव होता है। अगर टास्क ही विफल हुआ है, तो क्या बदलना है यह तय करने से पहले उसकी त्रुटि पढ़ें; अमान्य इनपुट को बिना सोचे दोबारा सबमिट करने से वे ठीक नहीं होंगे। अनुरोध संबंधी त्रुटियों और टास्क विफलताओं का अंतर जानने के लिए CAPTCHA API त्रुटियाँ देखें।