Python में MTCaptcha: sitekey निकालें, हल करें और post करें

mtcaptcha in python - MTCaptcha in Python: Scrape the Sitekey, Solve and Post

requests से बिना ब्राउज़र के Python में MTCaptcha संभालने के लिए login पेज लोड करें, उसके mtcaptchaConfig object से sitekey और action पढ़ें, दोनों को CapSkip SDK के solver.mtcaptcha() को दें, और लौटे हुए token को फ़ॉर्म सबमिशन के mtcaptcha-verifiedtoken फ़ील्ड में भेजें। इस call के पीछे का CapSkip MTCaptcha सॉल्वर आपके अपने Windows PC पर, फिक्स्ड कीमत वाले लाइसेंस के साथ चलता है, इसलिए ठुकराए गए token की कीमत बस loop से एक और बार गुज़रना है।

आपको क्या चाहिए

  • CapSkip 4.3.0 (9 नवंबर 2026, MTCaptcha वाली पहली रिलीज़) या बाद का, जो किसी Windows PC पर चल रहा हो। इंस्टॉल करने के चरण सेटअप गाइड में दिए हैं। मेरे PC पर मौजूद कॉपी ने mt_captcha method स्वीकार किया, लेकिन मैं उसका वर्ज़न नहीं पढ़ सका।
  • Python 3.10 या बाद का, जो capskip 1.7.0, requests 2.34.2 और urllib3 2.8.0 का घोषित न्यूनतम वर्ज़न है, साथ में capskip 1.7.0 या बाद का, जिसमें पहली बार MTCaptcha method आया। मैंने इन्हें सिर्फ़ Python 3.11.7, 3.13.7 और 3.14.0 पर चलाया।
  • दोनों पैकेज PowerShell से python -m pip install capskip requests के साथ इंस्टॉल होते हैं (py -m pip भी चलता है), इसलिए pip का आपके PATH में होना ज़रूरी नहीं।
  • CapSkip के लिए एक पता। Local mode (127.0.0.1) में सिर्फ़ वही PC उस तक पहुँच सकता है जिस पर CapSkip चल रहा है। Server mode आपके नेटवर्क या पब्लिक IP को जोड़ देता है, जिससे कोई दूसरा PC या Windows VPS वही रिक्वेस्ट भेज सकता है। दोनों मोड का वर्णन सेटअप गाइड में कनेक्शन सेटिंग्स के तहत मिलता है। Service Emulator की किसी भी सेटिंग को उसके डिफ़ॉल्ट पर रहने दें, क्योंकि SDK CapSkip से उसके डिफ़ॉल्ट फ़ॉर्मैट में बात करता है और एम्युलेट की गई सेवा अलग जवाब दे सकती है।

मैंने इस script को अपने लिखे दो mock के सामने टेस्ट किया (यानी टेस्ट के लिए बनाए नकली सर्वर): एक CapSkip की भूमिका निभाता है और दूसरा login साइट की। मेरे PC के असली CapSkip app ने तीन MTCaptcha टास्क लिए, SDK के अपने उदाहरण के public डेमो sitekey और पेज के पते के साथ, ताकि असली token देखा जा सके और SDK call का समय नापा जा सके। किसी साइट ने कभी कोई token नहीं जाँचा, इसलिए यहाँ कुछ नहीं दिखाता कि कोई असली साइट उसे स्वीकार करती है, और mock में साइट का हर नियम मेरा अपना है। साइट token को कैसे जाँचती है, यह जानने के लिए देखें: MTCaptcha का token वैलिडेशन गाइड.

चरण 1: session सेट करें और MTCaptcha का sitekey खोजें

पहला कोड ब्लॉक mtcaptcha_login.py के रूप में सेव करें। उसके बाद का हर ब्लॉक, इस चरण के अगले ब्लॉक समेत, उसी फ़ाइल के अंत में दिखाए गए क्रम में जाता है, और फ़ाइल चरण 4 के बाद पूरी होती है। पेज लोड, हल और फ़ॉर्म सबमिशन, तीनों में एक ही User-Agent string चलती है, इसलिए कोई भी मौजूदा ब्राउज़र string चुन लें। Server mode में host में अपने सर्वर का पता रखें। API Key Validation चालू हो, तो अपनी key को apiKey के रूप में भी दें।

# python -m pip install capskip requests
import re

import requests
from capskip import ApiException, CapSkip

LOGIN_URL = "https://example.com/login"  # the page that shows the widget
USER_AGENT = (
    "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 "
    "(KHTML, like Gecko) Chrome/140.0.0.0 Safari/537.36"
)

# Local mode. In Server mode, use your server's address as the host.
solver = CapSkip(host="127.0.0.1", port=8080)

ज़्यादातर MTCaptcha पेज widget को एक inline mtcaptchaConfig object से कॉन्फ़िगर करते हैं, जिसकी sitekey value MTPublic- से शुरू होती है, और वह एक action भी सेट कर सकता है। CapSkip का डेमो पेज उसे एक ही पंक्ति में लिखता है, जिसमें lang key, तीन callbacks और कोई action नहीं है। CapSkip के दस्तावेज़ उसे कई पंक्तियों में फैलाते हैं और एक action जोड़ते हैं। दूसरे पेज single quotes और बिना quotes वाली keys इस्तेमाल करते हैं। नीचे की function हर key को नाम से खोजती है, इसलिए वह इन सबको पढ़ लेती है, लेकिन object के अंदर कोई inline function, या ऐसी script जो object को closing brace और semicolon से या closing script tag से खत्म नहीं करती, उसे नाकाम कर देगी।

जब पेज में ऐसा कोई object या उसमें कोई sitekey नहीं होता, तो यह function error उठाती है, और पहला मामला असली है। 2Captcha के डेमो पेज के GET ने ऐसा HTML लौटाया जिसमें sitekey सिर्फ़ उसके निर्देशों में दिखता है। ऐसे पेज के लिए sitekey को widget के iframe के पते से एक बार कॉपी करें, जहाँ वह service.mtcaptcha.com पर sitekey query parameter है। अगर पेज कोई action सेट करता है, तो उसे भेजें: MTCaptcha के action दस्तावेज़ के अनुसार check call वही action बताता है जिससे widget शुरू हुआ था, ताकि साइट उसकी तुलना कर सके। अगर वह कोई action सेट नहीं करता, तो कोई न भेजें।

def read_config(html):
    """Return (sitekey, action) from the page's mtcaptchaConfig object."""
    found = re.search(r"mtcaptchaConfig\s*=\s*\{(.*?)(?:\}\s*;|</script>)", html, re.S)
    if not found:
        raise RuntimeError("no mtcaptchaConfig in the page source")

    def value(name):
        pattern = r"(?<![\w-])[\"']?" + name + r"[\"']?\s*:\s*[\"']([^\"']+)[\"']"
        pair = re.search(pattern, found.group(1))
        return pair.group(1) if pair else None

    sitekey = value("sitekey")
    if not sitekey:
        raise RuntimeError("no sitekey in mtcaptchaConfig")
    return sitekey, value("action")

मैंने read_config को अपने mock की तीनों quoting शैलियों पर, sitekey से पहले और action से पहले आने वाले nested object पर, बिना trailing semicolon वाली config पर, और दो public पेजों की सेव की गई प्रतियों पर चलाया। CapSkip के डेमो पेज ने अपना sitekey दिया और कोई action नहीं, और 2Captcha के डेमो पेज पर ऊपर वाला error उठा। तीनों Python वर्ज़न एकमत रहे।

चरण 2: SDK से token माँगें

आप solver.mtcaptcha(sitekey, url, **options) call करते हैं। यह टास्क सबमिट करता है, नतीजे के लिए poll करता है और एक dictionary लौटाता है, इसलिए आपको कोई loop नहीं लिखना पड़ता। url के रूप में पेज का असली पता दें, क्योंकि MTCaptcha token सिर्फ़ उन domains के लिए जारी करता है जिनके लिए sitekey registered है। यह function फ़ाइल के अंत में जोड़ें। यह action तभी जोड़ती है जब पेज ने कोई action सेट किया हो।

def get_token(sitekey, action):
    options = {"userAgent": USER_AGENT}
    if action:  # only when the page's config sets one
        options["action"] = action
    return solver.mtcaptcha(sitekey, LOGIN_URL, **options)["token"]

कुछ भी भेजने से पहले SDK आपके arguments जाँचता है। तीन चीज़ें ValidationException तुरंत उठाती हैं: ऐसा sitekey जो MTPublic- के बाद 55 तक अक्षरों, अंकों, हाइफ़न या अंडरस्कोर का न हो, ऐसा पेज पता जो absolute http या https URL न हो, और ऐसा option जिसे MTCaptcha API नहीं लेता, जैसे invisible। sk=MTPublic- के रूप में चिपकाया गया sitekey स्वीकार हो जाता है, और SDK उसका prefix हटा देता है।

तीन असली रन में dictionary में keys "captchaId", "code" और "token" थीं, और आख़िरी दो एक ही string हैं, वही जो mtcaptcha-verifiedtoken के लिए है। हर असली token v1( से शुरू हुआ और **) पर खत्म हुआ, 418 अक्षरों का था और उसमें कॉमा से अलग पाँच फ़ील्ड थे, जिनमें तीसरा sitekey है। दस्तावेज़ छोटे नमूने छापते हैं, इसलिए token को उसकी लंबाई से validate न करें।

userAgent option वह ब्राउज़र string बताता है जो CapSkip MTCaptcha को दिखाता है। मैं session की अपनी string देता हूँ, ताकि हल, पेज लोड और फ़ॉर्म सबमिशन एक ही ब्राउज़र दिखाएँ। इसके बिना CapSkip Windows के लिए Chrome की एक string इस्तेमाल करता है। मैंने जो पढ़ा उसमें कुछ नहीं कहता कि MTCaptcha दोनों की तुलना करता है, और मैंने इसे टेस्ट नहीं किया। live API दस्तावेज़ ऐसे User-Agent के लिए ERROR_WRONG_USERAGENT सूचीबद्ध करते हैं जो टास्क के लिए इस्तेमाल नहीं हो सकता, और असली app को मेरा userAgent option कभी नहीं दिखा, इसलिए अगर वह यही error दे, तो get_token से option हटा दें।

समय, call से ठीक पहले से उसके लौटने तक: Python 3.14.0 पर एक बार 3.77 सेकंड और 3.11.7 पर दो बार 3.76 सेकंड, capskip 1.7.0, डिफ़ॉल्ट polling और Windows 11 पर असली CapSkip app के साथ। उन तीनों calls ने न userAgent भेजा न action। SDK की polling का शेड्यूल उस आँकड़े को आकार देता है: mock के सामने उसने submit के बाद 0, 0.25, 0.76, 1.76, 3.76 और 7.76 सेकंड पर नतीजा माँगा, और 1.9 से 3.6 सेकंड के बीच कभी भी तैयार हुआ mock token 3.76 पर लौटा। इसलिए असली हल 1.76 और 3.76 सेकंड के polls के बीच पूरा हुआ, और तीन रन कोई benchmark नहीं हैं।

MTCaptcha हल के लिए कोई ब्राउज़र नहीं चलता, इसलिए SDK उतना इंतज़ार करता है जितना उसका defaultTimeout देता है, डिफ़ॉल्ट रूप से 120 सेकंड। defaultTimeout घटाकर 6 सेकंड करने पर, कभी जवाब न देने वाले mock ने call के 7.78 सेकंड बाद TimeoutException उठाया, क्योंकि polls के बीच की आख़िरी नींद सीमा के पार चली गई।

चरण 3: token ताज़ा रहते फ़ॉर्म सबमिट करें

ब्राउज़र में widget token को mtcaptcha-verifiedtoken नाम के एक hidden input में लिखता है। ब्राउज़र के बिना आप वह फ़ील्ड खुद भेजते हैं, फ़ॉर्म के अपने फ़ील्ड के साथ। नीचे की function, जो फ़ाइल के अंत में जोड़ी जाती है, यही करती है। session पेज की cookies को form post में ले जाता है। अगर फ़ॉर्म का action कहीं और इशारा करता है, तो session.post call का पहला argument बदल दें।

token एक बार चलता है, और सिर्फ़ थोड़े समय के लिए। MTCaptcha का validation guide कहता है कि token आम तौर पर कुछ मिनट मान्य रहता है लेकिन डिफ़ॉल्ट expiry 60 से 120 सेकंड देता है, और डिफ़ॉल्ट रूप से उसे सिर्फ़ एक बार जाँचा जा सकता है, इसलिए उसे एक मिनट के भीतर भेजें। CapSkip के दस्तावेज़ कहते हैं कि token form post से ठीक पहले माँगें, इसलिए get_token पेज लोड के बाद चलता है और form post तुरंत होता है। अगर आप अपना कोई इंतज़ार जोड़ें, तो हल उसके बाद करें। ठुकराया गया token खर्च हो जाता है, इसलिए चरण 4 का loop नया माँगता है।

form post पेज को Referer के रूप में भी देता है, क्योंकि requests न Referer भेजता है न Origin, और कुछ frameworks दोनों के बिना HTTPS form post को ठुकरा देते हैं। मेरा mock ऐसा ही एक है, और header के बिना उसने 403 दिया।

def post_form(session, token, username, password):
    return session.post(
        LOGIN_URL,
        data={
            "username": username,  # your form's own fields go here
            "password": password,
            "mtcaptcha-verifiedtoken": token,
        },
        headers={"Referer": LOGIN_URL},  # requests sends none by itself
        timeout=30,
    )

चरण 4: Python में MTCaptcha के लिए पूरी login script

आख़िरी ब्लॉक mtcaptcha_login.py के अंत में जोड़ें, जिसके बाद वह पूरी हो जाती है। LOGIN_URL सेट करें और python mtcaptcha_login.py चलाएँ (या py mtcaptcha_login.py)। दो strings आपकी साइट के लिए placeholder हैं: "Welcome", वह text जो सफल login दिखाता है, और "captcha check failed", एक वाक्यांश जो आपकी साइट के अपने captcha इनकार में होता है। यह तीन कोशिशों के बाद हार मान लेती है।

CapSkip के दस्तावेज़ों के अनुसार, ERROR_CAPTCHA_UNSOLVABLE का जवाब नया टास्क सबमिट करना है, और script सिर्फ़ उसी code पर retry करती है। दस्तावेज़ दो ऐसी नाकामियों का नाम लेते हैं जो वही टास्क दोबारा भेजने पर दोहराई जाती हैं, एक अज्ञात sitekey और पेज के domain पर अनुमति न पाने वाला sitekey, और बाकी हर error भी script को रोक देता है। ApiException के संदेश के अंदर code सादे text के रूप में या JSON envelope में लिपटा आता है, और which_error दोनों में से उसे निकाल लेता है।

ठुकराया गया form post नया token तभी पाता है जब जवाब में आपकी साइट का captcha इनकार वाला वाक्यांश हो। उद्धृत वाले जैसा वाक्यांश इस्तेमाल करें, कभी सिर्फ़ captcha शब्द नहीं। गलत password के बाद दोबारा दिखाया गया login पेज फिर भी widget का अपना mtcaptchaConfig और mtcaptcha-verifiedtoken रखता है, इसलिए सिर्फ़ यह शब्द मेल खा जाएगा और तीन token खर्च कर देगा। मैंने यह अपने mock के सामने देखा। ऐसे वाक्यांश के साथ जो सिर्फ़ इनकार में होता है, एक टास्क खर्च होता है।

def which_error(err):
    # The message holds the code as bare text or inside a JSON envelope.
    found = re.search(r"ERROR_[A-Z_]+", str(err))
    return found.group(0) if found else str(err)


def log_in(username, password):
    session = requests.Session()
    session.headers["User-Agent"] = USER_AGENT
    for attempt in range(1, 4):
        page = session.get(LOGIN_URL, timeout=30)  # cookies first, then config
        sitekey, action = read_config(page.text)
        try:
            token = get_token(sitekey, action)
        except ApiException as err:
            code = which_error(err)
            if code != "ERROR_CAPTCHA_UNSOLVABLE":
                raise  # a bad sitekey or domain would fail the same way again
            print(f"attempt {attempt}: {code}, new task")
            continue
        reply = post_form(session, token, username, password)
        if "Welcome" in reply.text:  # use a sign your site shows on success
            return reply
        if "captcha check failed" not in reply.text.lower():  # your site's phrase
            raise RuntimeError(f"login refused ({reply.status_code}), not the captcha")
        print(f"attempt {attempt}: captcha refused ({reply.status_code}), new token")
    raise RuntimeError("no login after 3 attempts")


if __name__ == "__main__":
    print(log_in("alice", "YOUR_PASSWORD").text[:40])

mock के सामने तीनों Python वर्ज़न ने एक जैसे नतीजे दिए:

mock सेटिंगscript ने क्या किया
पेज की config दस्तावेज़ों जैसी, action के साथएक टास्क, in.php को action मिला, form post स्वीकार हुआ
एक पंक्ति में config, callbacks के साथ और कोई action नहीं, डेमो पेज जैसीएक टास्क, कोई action फ़ील्ड नहीं भेजा गया, form post स्वीकार हुआ
पेज action सेट करता है लेकिन call उसे छोड़ देता हैतीन टास्क, तीन ठुकराए गए form post, फिर RuntimeError
पहले दो हल ERROR_CAPTCHA_UNSOLVABLE पर खत्मदो retry संदेश, फिर तीसरे टास्क का token स्वीकार हुआ
भेजते समय token 3 सेकंड पुराना, mock की वैधता 2 सेकंड पर सेटबासी (stale) बताकर ठुकराया गया, फिर नया token स्वीकार हुआ
poll पर अज्ञात sitekey या domain errorएक टास्क के बाद ApiException और कोई form post नहीं, JSON के रूप में या सादे text के रूप में
सादे इनकार text के साथ गलत password, या Referer header के बिना form postएक टास्क के बाद RuntimeError, कोई नया token नहीं
गलत password के बाद दोबारा दिखाया गया login पेज, सिर्फ़ captcha शब्द से जाँचा गयातीन टास्क, फिर RuntimeError। वाक्यांश की जाँच के साथ, एक टास्क

इस तालिका को मेरे mock का टेस्ट मानें, किसी असली साइट का नहीं। एक बार का इस्तेमाल, छोटी वैधता और action का मेल दस्तावेज़ों का पालन करते हैं, लेकिन दो सेकंड की वैधता मेरी मनमानी संख्या है।

आम errors

इनमें से ज़्यादातर errors CapSkip के MTCaptcha API डॉक्स से आते हैं, सिवाय वहाँ के जहाँ किसी पंक्ति में लिखा है कि मैंने उसे खुद देखा।

त्रुटिकारणफिक्स
ValidationExceptionSDK ने call को भेजने से पहले ही ठुकरा दिया, चरण 2 के किसी कारण सेसंदेश समस्या का नाम बताता है, इसलिए उस argument को ठीक करें
ERROR_RECAPTCHA_INVALID_SITEKEYMTCaptcha sitekey को नहीं पहचानताइसे mtcaptchaConfig से फिर कॉपी करें। दोबारा भेजना नाकाम होगा, इसलिए script error उठाती है
ERROR_RECAPTCHA_INVALID_DOMAINउस पते के domain पर sitekey को अनुमति नहीं है जो आपने भेजाउस पेज का पता दें जिस पर widget असल में है
ERROR_CAPTCHA_UNSOLVABLEMTCaptcha पास नहीं हुआनया टास्क सबमिट करें, जो script आपके लिए तीन बार तक करती है
ERROR_TASK_NOT_SUPPORTEDCapSkip उस रिलीज़ से पुराना है जिसने MTCaptcha जोड़ाCapSkip 4.3.0 या बाद की रिलीज़ इंस्टॉल करें
ERROR_WRONG_USERAGENTlive API दस्तावेज़ इसे ऐसे User-Agent के लिए सूचीबद्ध करते हैं जो टास्क के लिए इस्तेमाल नहीं हो सकता। असली app ने मेरे कोड से userAgent option कभी नहीं देखाget_token से userAgent option हटा दें
ERROR_WRONG_USER_KEY या ERROR_KEY_DOES_NOT_EXISTAPI Key Validation चालू है और key गलत है। apiKey के बिना call key capskip के साथ जाती हैCapSkip() को अपनी असली key उसके apiKey के रूप में दें
TimeoutExceptiondefaultTimeout के भीतर कोई token नहीं आया, 120 सेकंड जब तक आपने उसे बदला न होCapSkip के Monitor में टास्क देखें, फिर script दोबारा चलाएँ
NetworkExceptionटास्क भेजते समय उस host और port पर कोई जवाब नहीं दे रहा, या जवाब एक HTTP error था। अगर poll के दौरान CapSkip जवाब देना बंद कर दे, तो आपको इसकी जगह TimeoutException मिलता हैCapSkip शुरू करें और पुष्टि करें कि host और port उसकी कनेक्शन सेटिंग्स से मेल खाते हैं
साइट ऐसे token को ठुकराती है जो ठीक लगता हैtoken पहले इस्तेमाल हो चुका था, बहुत पुराना था, पेज का action छूट गया था, या Referer के बिना आया थाहर token को एक बार ही, तुरंत, पेज को Referer बनाकर और पेज के अपने action के साथ भेजें

FAQ

क्या script CapSkip से अलग मशीन पर चल सकती है?

हाँ, Server mode के ज़रिए। उसे CapSkip वाले PC की कनेक्शन सेटिंग्स में चालू करें और उस PC का पता host के रूप में CapSkip() को दें। बाकी कुछ नहीं बदलता। Server mode के लिए CapSkip का administrator अधिकारों के साथ चलना ज़रूरी है, और सेटअप गाइड स्थिर पब्लिक IP की सलाह देता है। Server mode शुरू होने पर CapSkip अपना port हर पते के लिए खोल देता है, इसलिए जिन मशीनों को उस तक नहीं पहुँचना चाहिए उनके लिए Windows Firewall में block rule जोड़ें। solver आपके अपने Windows हार्डवेयर पर रहता है और कुछ भी मीटर नहीं होता।

क्या script invisible MTCaptcha widgets के साथ काम करती है?

CapSkip के MTCaptcha solver पेज के अनुसार invisible widget भी दिखने वाले widget जैसी ही रिक्वेस्ट से गुज़रता है और उसी तरह का token लौटाता है। API दस्तावेज़ों का MTCaptcha सेक्शन invisible मोड का ज़िक्र नहीं करता, और मैंने किसी invisible widget पर कुछ नहीं चलाया, इसलिए इसे अपुष्ट मानें। आपके पेज को फिर भी sitekey अपने source में रखना होगा, क्योंकि read_config को वह वहीं चाहिए।

क्या MTCaptcha के लिए proxy चाहिए?

शुरू करने के लिए नहीं। दस्तावेज़ टेस्ट के लिए एक पता ठीक बताते हैं, लेकिन कहते हैं कि एक ही पते से लगातार हल करने पर rate limiting को न्योता मिलता है। ज़्यादा मात्रा के लिए app की MTCaptcha सेटिंग्स में proxy list लोड करें, या mtcaptcha() को proxy option दें, जैसे proxy={"type": "HTTP", "uri": "login:password@IP:PORT"}। mock को proxy और उसका type मिला; मैंने कोई असली proxy इस्तेमाल नहीं किया।

संक्षेप में

Python में MTCaptcha तीन चालों पर आकर टिकता है: पेज से sitekey और action पढ़ें, form post से ठीक पहले token माँगें, और form post ठुकराया जाए तो फिर माँगें। क्योंकि CapSkip एक लोकल captcha सॉल्वर है जिसे आप खुद चलाते हैं, इसलिए ठुकराया गया token बिल में कभी कुछ नहीं जोड़ता। दूसरे प्रकारों के SDK calls के लिए Python कैप्चा सॉल्वर पेज देखें। असली फ़ॉर्म में token आज़माना हो, तो MTCaptcha डेमो खोलें।