क्लॉड कोड CAPTCHA सॉल्वर: कैपसॉल्वर MCP सेटअप गाइड

एल;डीआर

• कैप्सॉल्वर मीसीपी पैकेज से क्लॉड कोड को जोड़ें ताकि समर्थित कैप्चा-समाधान उपकरण उपलब्ध हो सकें।
• समर्थित कैप्चा प्रकारों की सूची शुरू करें; एक सफल उपकरण कनेक्शन यह साबित नहीं करता कि भुगतान किए गए समाधान के अनुरोध के सफल होने की संभावना है।
• जब आपके पास समर्थित चुनौती प्रकार, पेज URL और साइटकी हो, तो solve_captcha का उपयोग करें।
• पेज उपकरण अपना अलग ब्राउजर सत्र शुरू करते हैं; वे वर्तमान क्लॉड ब्राउजर टैब को स्वचालित रूप से जारी नहीं रखते हैं।
• लौटाए गए टोकन या भरे गए विजेट की अंतिम स्वीकृति लक्षित एप्लिकेशन द्वारा आवश्यक होती है।

क्लॉड कोड ब्राउजर कार्य लिखने या डीबग करने में मदद कर सकता है, लेकिन अनुमोदित कार्य के दौरान एक समर्थित कैप्चा बाधा आने पर इसे वास्तविक समाधान उपकरण की आवश्यकता होती है। मॉडल से "अधिक कोशिश करें" कहना चुनौती के लिए आवश्यक साइट पैरामीटर, एपीआई कनेक्शन या परिणाम निर्माण की आवश्यकता को पूरा नहीं करता है।

कैपसॉल्वर अपने एमसीपी सेवा के माध्यम से इन क्षमताओं को उजागर करता है। यह गाइड में पैकेज स्थापित करने, इसे क्लॉड कोड से जोड़ने, उपलब्ध उपकरणों की जांच करने और समाधान कॉल का चयन करने के बारे में बताया गया है। उदाहरण आपके अपने पृष्ठों या अनुमति प्राप्त स्वचालन कार्यों के बारे में हैं। वे खाता बनाने, खरीदारी करने या सीमित डेटा तक पहुंच के लिए स्वचालन नहीं करते हैं।

क्लॉड कोड कैपसॉल्वर एमसीपी के साथ क्या कर सकता है?

क्लॉड कोड आपके द्वारा कॉन्फ़िगर और स्वीकृत सर्वर के बाद कैपसॉल्वर के एमसीपी उपकरणों की खोज और कॉल कर सकता है।

आधिकारिक एमसीपी सेवा पांच उपकरण प्रस्तुत करती है:

उपकरण के नाम अलग-अलग ऑपरेशन का वर्णन करते हैं। बैलेंस की जांच एक पृष्ठ को नहीं पहचानती है, और एक विजेट की पहचान करना इसके हल करने के बराबर नहीं है। आप वास्तव में आवश्यक ऑपरेशन से शुरू करें।

इस गाइड के लिए स्थापित संस्करण, capsolver-mcp 0.1.3, अपने समर्थित-प्रकार उपकरण के माध्यम से reCaptchaV2, reCaptchaV3 और cloudflare की सूची देता है। इस इंटरफ़ेस में, क्लाउडफ़ेयर हैंडलर टर्नस्टाइल के बारे में है। नाम के आधार पर क्लाउडफ़ेयर के हर उत्तर या पूर्ण-पृष्ठ चुनौती के लिए सामान्य समर्थन के रूप में इसकी व्याख्या न करें।

REST API अन्य कार्य परिवार प्रदान करता है, लेकिन इन्हें स्वचालित रूप से इस एमसीपी उपकरण सेट में जोड़ा जाता है। विशेष रूप से, केवल कैपसॉल्वर के अलग एपीआई छवि पहचान के समर्थन के कारण solve_captcha में एक छवि-टू-टेक्स्ट कार्य न दें।

आधिकारिक पैकेज स्थापित करें

क्लॉड कोड द्वारा शुरू किए गए पायथन वातावरण में कैपसॉल्वर कोर, एमसीपी सर्वर और ब्राउजर निर्भरताएं स्थापित करें।

निम्नलिखित आदेश इस गाइड के लिए उपयोग किए गए कोर और एमसीपी संस्करण को निर्धारित करते हैं:

python -m pip install capsolver-core==0.1.1 "capsolver-mcp[browser]==0.1.3"
python -m playwright install chromium

स्थापना कैपसॉल्वर के आधिकारिक पैकेज निर्देशों के अनुसार होती है। ब्राउजर एक्स्ट्रा और क्रोमियम एमपी टूल के लिए आवश्यक हैं। प्लेयराइट ब्राउजर स्थापना गाइड बताता है कि ब्राउजर बाइनरी पायथन पैकेज से अलग निर्भरता हैं।

अगले चरण में इस वातावरण के पायथन एक्सीक्यूटेबल का उपयोग करें। यदि आप एक वर्चुअल वातावरण में स्थापित करते हैं और अलग पायथन का उपयोग करते हैं, तो क्लाइंट यह रिपोर्ट कर सकता है कि यह capsolver_mcp को आयात नहीं कर सकता है, भले ही अन्य जगह स्थापना सफल हो गई हो।

आपके पास वास्तविक समाधान के लिए क्लॉड कोड और कैपसॉल्वर खाता कुंजी की आवश्यकता होती है। खाता कुंजी को परिवेश में CAPSOLVER_API_KEY के रूप में संग्रहीत करें जिसका उपयोग क्लॉड कोड शुरू करते समय किया जाता है। इसे चैट प्रॉम्प्ट में न डालें या साझा परियोजना फ़ाइल में कमेंट करें।

पैकेज कनेक्शन और स्थानीय डिटेक्शन पथ को भुगतान किए गए ज्ञान से अलग जांचा जा सकता है। इस गाइड में एक लाइव भुगतान किए गए समाधान का उदाहरण नहीं दिखाया गया है; इस चरण के लिए आपके खाते और अनुमोदित लक्षित के वर्तमान पैरामीटर की आवश्यकता होती है।

प्रोजेक्ट एमसीपी कॉन्फ़िगरेशन में कैपसॉल्वर जोड़ें

प्रोजेक्ट के .mcp.json में एक capsolver प्रविष्टि जोड़ें, जो आपके द्वारा पैकेज स्थापित किए गए पायथन वातावरण को संदर्भित करता है।

नीचे दिए गए कॉन्फ़िगरेशन में कैपसॉल्वर के दस्तावेज़ीकृत पायथन-मॉड्यूल लॉन्च पैटर्न और क्लॉड कोड के परिवेश चर के विस्तार का उपयोग किया गया है। अपने वातावरण के वास्तविक पूर्ण पथ से पायथन पथ को बदलें:

{
  "mcpServers": {
    "capsolver": {
      "command": "/absolute/path/to/venv/bin/python",
      "args": ["-m", "capsolver_mcp"],
      "env": {
        "CAPSOLVER_API_KEY": "${CAPSOLVER_API_KEY}"
      }
    }
  }
}

यदि .mcp.json में पहले से कोई अन्य सर्वर है, तो इस प्रविष्टि को उसके मौजूदा mcpServers ऑब्जेक्ट में जोड़ें, फाइल को बदलने के बजाय। रेफरेंस चाबी मान को फ़ाइल से बाहर रखता है, लेकिन जब क्लॉड कोड शुरू होता है तो चर की आवश्यकता होती है।

क्लॉड कोड के एमसीपी कॉन्फ़िगरेशन दस्तावेज़ीकरण परियोजना व्यापकता, परिवेश विस्तार और सर्वर स्वीकृति को कवर करता है। इच्छित परियोजना से क्लॉड कोड शुरू करें, परियोजना-सर्वर स्वीकृति प्रेरणा की समीक्षा करें और आदेश और पैकेज के साथ आपके द्वारा स्थापित होने की पुष्टि करने के बाद ही इस सर्वर को स्वीकृत करें।

परियोजना निर्देशिका से कॉन्फ़िगरेशन की जांच करें:

claude mcp list

एक अंतर्क्रियात्मक क्लॉड कोड सत्र में, /mcp का उपयोग सर्वर स्थिति और उपलब्ध नियंत्रण की जांच करने के लिए करें। एक प्रतीक्षा-स्वीकृति स्थिति का मतलब है कि परियोजना सर्वर को आपकी समीक्षा की आवश्यकता है। यह एक अनुपलब्ध एक्सीक्यूटेबल या विफल कनेक्शन से अलग है।

सॉल्व करने से पहले उपकरणों की जांच करें

अपने खाते क्रेडिट खर्च करने से पहले क्लॉड कोड से समर्थित कैप्चा प्रकारों की सूची मांगें।

एक उपयुक्त पहला अनुरोध है:

कैपसॉल्वर get_supported_captchas उपकरण का उपयोग करें और मुझे बताएं कि इस सर्वर वर्तमान में कौन-से कैप्चा प्रकार समर्थित हैं। कृपया समाधान कार्य न भेजें।

यह ग्राहक के वास्तविक उपकरण तक पहुंचने की पुष्टि करता है और आपके स्थापित सर्वर के वास्तविक कवरेज की जांच करता है। एमसीपी के कनेक्शन जीवन चक्र में शुरूआत को बाद के ऑपरेशन से अलग कर दिया गया है; कनेक्शन स्थापित करना उपयोगकर्ता एकीकरण की शुरूआत ही है।

एक खाता जांच के लिए, आप get_balance के लिए पूछ सकते हैं। यदि उत्तर में खाता जानकारी हो, तो इसे गोपनीय रखें। इसके विफल होने से खाता पहुंच या सेवा संचार की समस्या संकेतित होती है और भुगतान किए गए समाधान के प्रयास से पहले इसे हल करना आवश्यक है।

मॉडल के कथन से "कैपसॉल्वर के बारे में जानता है" के आधार पर तैयारी का आकलन न करें। वास्तविक उपकरण परिणाम की जांच करें। खोजे गए उपकरण, सफल खाता प्रश्न और पूर्ण कैप्चा समाधान अलग-अलग तथ्य स्थापित करते हैं।

कैपसॉल्वर बोनस कोड का उपयोग करें

अपने स्वचालन बजट को तत्काल बढ़ाएं!
कैपसॉल्वर खाता में जमा करते समय बोनस कोड CAP26 का उपयोग करें ताकि प्रत्येक भुगतान पर 5% बोनस मिले — कोई सीमा नहीं।
अपने कैपसॉल्वर डैशबोर्ड में अभी बोनस कोड का उपयोग करें

ज्ञात चुनौती पैरामीटर के लिए टोकन मोड का उपयोग करें

जब आपके अनुमोदित ब्राउजर या एप्लिकेशन फ्लो में आवश्यक प्रकार, पेज URL और साइटकी उपलब्ध हो, तो solve_captcha का उपयोग करें।

उदाहरण के लिए, क्लॉड कोड को एक सीमित निर्देश दें जैसे:

मेरे अनुमोदित परीक्षण पृष्ठ पर reCAPTCHA v2 के लिए कैपसॉल्वर solve_captcha एक बार उपयोग करें। ठीक पेज URL और साइटकी का उपयोग करें। यदि कोई भी अनुपलब्ध है, तो अनुमान लगाए बिना अपेक्षित इनपुट की रिपोर्ट करें और अपने सारांश में पूर्ण टोकन के बिना टूल स्थिति लौटाएं।

उपकरण के स्कीमा में captcha_type, website_url और website_key का उपयोग किया जाता है। आप अपने प्रबंधन कर रहे चुनौती के लिए आवश्यक अतिरिक्त पैरामीटर के लिए खोजे गए स्कीमा की जांच करें। एमसीपी प्रकार क्षेत्र में रीस्ट टास्क नाम की नकल न करें: reCaptchaV2 एमसीपी मान है, जबकि रीस्ट एपीआई के अपने दस्तावेज़ीकृत टास्क नाम हैं।

आपकी एप्लिकेशन को लौटाए गए टोकन का उपयोग लक्षित के इच्छित फ्लो द्वारा करना होता है। एमसीपी कॉल स्वयं प्रत्येक फॉर्म भरने या व्यावसायिक परिणाम की पुष्टि नहीं करता है। पृष्ठ-विशिष्ट reCAPTCHA इनपुट के लिए, reCAPTCHA v2 टास्क दस्तावेज़ीकरण की समीक्षा करें।

यदि कोई पैरामीटर अज्ञात है, तो उचित ब्राउजर टूल्स के साथ वर्तमान अनुमोदित पृष्ठ की जांच करें। अन्य पृष्ठ से यादृच्छिक साइटकी वर्तमान विजेट के लिए साक्ष्य नहीं है। अपने डिबग कर रहे वास्तविक ऑपरेशन से समाधान को जोड़ें।

पेज टूल्स के ब्राउजर सीमा के ध्यान में रखते हुए उपयोग करें

पेज टूल्स के लिए एक URL स्वीकार करें और एमसीपी सेवा द्वारा बनाए गए ब्राउजर सत्र में कार्य करें।

डिटेक्शन के लिए, एक उपयोगी अनुरोध है:

इस अनुमोदित पृष्ठ URL पर कैपसॉल्वर detect_captchas कॉल करें और पहचाने गए प्रकार की रिपोर्ट करें। अभी तक इसका समाधान न करें।

जब इस पृष्ठ के समाधान को इरादा कार्य के रूप में बताया जाता है, तो solve_on_page इसके दस्तावेज़ीकृत डिटेक्शन, समाधान और भरने के अनुक्रम को कर सकता है। अपने अवलोकन चुनौती और समर्थित कवरेज की समीक्षा करने के बाद इस कॉल के लिए अनुरोध करें।

महत्वपूर्ण सीमा दृश्यमान है आधिकारिक एमसीपी कार्यान्वयन: इन टूल्स एक ब्राउजर के लिए एक कॉल खोलते हैं और बाद में बंद कर देते हैं। वे अलग ब्राउजर एमसीपी या स्वचालित रूप से इसके लॉगिन स्थिति के एक टैब को जोड़ते नहीं हैं।

इसके कारण, एक सीधा, पहुंच योग्य परीक्षण पृष्ठ एक अन्य निजी सत्र चरणों के बाद केवल एक पृष्ठ के रूप में उपलब्ध होने वाले पृष्ठ की तुलना में स्पष्ट शुरुआत बिंदु है। यदि आपके कार्य में आपके द्वारा नियंत्रित ब्राउजर पृष्ठ पर रहना आवश्यक है, तो उस वास्तविक पृष्ठ पर कार्य करने वाले समर्थित एकीकरण का उपयोग करें। कैपसॉल्वर कोर SDK इस अलग एकीकरण आवश्यकता के लिए ब्राउजर-एडेप्टर क्षमताओं के बारे में दस्तावेज़ीकरण करता है।

अस्पष्ट ब्राउजर-एजेंट सतह के बारे में कैपसॉल्वर ब्राउजर एजेंट वर्कफ़्लो के साथ क्लॉड कंप्यूटर उपयोग के बारे में ब्लॉग चर्चा करता है। क्लॉड कंप्यूटर उपयोग और इस क्लॉड कोड एमसीपी सेटअप को एक दूसरे के साथ बराबर विन्यास के रूप में न लें।

बार-बार कैप्चा कॉल करने से पहले सेटअप त्रुटियों का समाधान करें

अधिकांश सेटअप विफलताओं को एक्सीक्यूटेबल पथ, परिवेश, ब्राउजर स्थापना या कार्य इनपुट में सीमित किया जा सकता है।

यदि सर्वर कमांड खोज नहीं पाता है, तो उपरोक्त निर्दिष्ट निर्देशांक पायथन पथ का उपयोग करें। यदि पैकेज आयात नहीं किया जा सकता है, तो सुनिश्चित करें कि वही पायथन वातावरण capsolver-mcp और capsolver-core के साथ उपलब्ध है।

यदि पेज डिटेक्शन के परिणाम में अनुपलब्ध ब्राउजर एक्सीक्यूटेबल रिपोर्ट किया जाता है, तो एमसीपी सर्वर लॉन्च करने वाले परिवेश में क्रोमियम स्थापना आदेश चलाएं। टोकन मोड के लिए ब्राउजर की आवश्यकता नहीं होती है, इसलिए ब्राउजर स्टार्टअप विफलता को सॉल्वर एपीआई विफलता से अलग करें।

यदि सर्वर जुड़ जाता है लेकिन एपीआई कॉल विफल हो जाता है, तो लौटाए गए त्रुटि कोड और रेडैक्टेड सारांश को बरकरार रखें। दोबारा प्रयास करने से पहले खाता कुंजी, समर्थित प्रकार, आवश्यक इनपुट और वर्तमान पृष्ठ स्थिति की जांच करें।

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

छोटी सीमा के साथ बार-बार प्रयास करें। यदि एक ही त्रुटि अपरिवर्तित रहती है, तो समाधान के लिए साक्ष्य को समीक्षा के लिए लौटाएं बजाय एजेंट को असीमित रूप से पुनरावृत्ति करने के निर्देश दें।

कैपसॉल्वर के साथ विश्वसनीय स्वचालन वर्कफ़्लो बनाएं

वास्तविक एमसीपी कनेक्शन से शुरू करें, स्थापित उपकरण सेट की जांच करें, और अपने अनुमोदित कार्य में चुनौती के अनुरूप ऑपरेशन के अनुरोध करें।

कैपसॉल्वर क्लॉड कोड के लिए दस्तावेज़ीकृत कैप्चा-समाधान क्षमता प्रदान करता है। सही इनपुट और स्पष्ट ब्राउजर सीमा इस क्षमता को उपयोगी बनाते हैं; अंतिम एप्लिकेशन प्रतिक्रिया आपको बताती है कि क्या इच्छित कार्य वास्तव में पूरा हो गया है।

एफक्यूएआई

प्रश्न: क्या प्रत्येक एमसीपी टूल के लिए ब्राउजर निर्भरताएं आवश्यक हैं?

नहीं। पेज टूल्स के लिए ब्राउजर एक्स्ट्रा और क्रोमियम की आवश्यकता होती है। टोकन समाधान और खाता या कवरेज प्रश्न अपनी संबंधित सेवा या स्थानीय क्षमता को कॉल करने के लिए ब्राउजर खोलने की आवश्यकता नहीं होती है।

प्रश्न: क्या कैपसॉल्वर एमसीपी आपके वर्तमान ब्राउजर टैब को जारी रख सकता है?

एमसीपी संस्करण में पेज टूल्स अपना ब्राउजर सत्र खोलते हैं और बंद करते हैं। अन्य ब्राउजर टूल द्वारा स्वामित्व वाले टैब को नियंत्रित करते हैं इसकी अपेक्षा न करें।

प्रश्न: क्या एमसीपी सर्वर प्रत्येक कैपसॉल्वर रीस्ट टास्क का समर्थन करता है?

नहीं। get_supported_captchas और खोजे गए उपकरण स्कीमा की जांच करें। अलग रीस्ट क्षमताएं इस एमसीपी पैकेज द्वारा स्वचालित रूप से उपलब्ध नहीं होती हैं।

प्रश्न: क्लॉड कोड के पास प्रतीक्षा स्वीकृति क्यों है?

एक परियोजना एमसीपी सर्वर का उपयोग करने से पहले स्वीकृति आवश्यक हो सकती है। क्लॉड कोड में इसे समीक्षा करें और कॉन्फ़िगर कमांड की पुष्टि करें, बजाय एपीआई-कुंजी त्रुटि के रूप में स्वीकृति स्थिति को लें।

प्रश्न: सफल समाधान का मतलब है कि एजेंट अपना कार्य पूरा कर चुका है?

नहीं। यह सुनिश्चित करें कि परिणाम इच्छित एप्लिकेशन द्वारा उपभोग किया गया है और कॉल किए गए पृष्ठ ऑपरेशन पूरा हो गया है। टोकन या भरे गए विजेट एक बीच के परिणाम हैं।