Python में GeeTest v4: ID एक बार पढ़ें, हर post पर हल करें

geetest v4 in python - GeeTest v4 in Python: Read the ID Once, Solve Every Post

Python में GeeTest v4 का मतलब है एक id और हर form post के लिए एक call। captcha_id को पेज से सिर्फ़ एक बार पढ़ें, CapSkip SDK के solver.geetest_v4() से पास माँगें, और जो पाँच मान लौटते हैं, यानी captcha_id, lot_number, pass_token, gen_time और captcha_output, उन्हें उन्हीं नामों से वापस भेज दें। इसे हल करने का काम CapSkip GeeTest v4 सॉल्वर आपके अपने Windows PC पर फिक्स्ड कीमत वाले लाइसेंस के तहत करता है, इसलिए ठुकराए गए पास का मतलब बस एक और हल है, कोई अतिरिक्त शुल्क नहीं। हर कोशिश से पहले कुछ भी fetch नहीं करना पड़ता, जो उस flow से अलग है जिसमें gt और challenge की जोड़ी चाहिए, यानी GeeTest v3 का flow.

GeeTest v4 हल करने से पहले आपको क्या चाहिए

  • Windows पर CapSkip 5.0.0 या नया (changelog में वहीं से GeeTest v4 हल करना दर्ज है, 14 नवंबर 2026) और Python SDK 1.8.0 या नया (16 नवंबर 2026)। request का ब्योरा API docs का GeeTest v4 सेक्शन में मिलता है।
  • Python 3.10 या नया, जो capskip 1.8.0 और requests 2.34.2 की न्यूनतम शर्त है। मैंने Windows 11 पर Python 3.11.7, 3.13.7 और 3.14.0 चलाए। दोनों packages को python -m pip install capskip requests से इंस्टॉल करें। capskip package httpx और aiofiles भी इंस्टॉल करता है, जिन्हें सिर्फ़ async client इस्तेमाल करता है।
  • CapSkip का पता। Local mode (127.0.0.1) में उसे सिर्फ़ वही PC पा सकता है जिस पर वह चल रहा है। Server mode में वह आपके नेटवर्क या public IP पर सुनता है, इसलिए दूसरी मशीनों की scripts भी उस तक पहुँच सकती हैं। मोड कहाँ बदला जाता है, यह setup guide के कनेक्शन सेटिंग्स सेक्शन में दिखता है।

मैंने अपने बनाए दो mock server से टेस्ट किया: एक CapSkip की जगह और एक comment form वाली साइट की जगह। कोई असली हल नहीं हुआ, इसलिए आपको बताने लायक कोई असली हल समय मेरे पास नहीं है, और mock का हर साइट नियम मेरा अपना है। असली साइट पर backend पाँचों मान private key के signature के साथ GeeTest को भेजता है, जैसा GeeTest server API रेफ़रेंस में बताया गया है। mock यह नहीं दिखा सकता कि कोई असली backend कुछ भी स्वीकार करता है।

चरण 1: पेज पर captcha_id ढूँढें

पहले block को comment_geetest.py नाम से सेव करें और बाद का हर block क्रम से अंत में जोड़ते जाएँ। चरण 3 के बाद फ़ाइल पूरी हो जाती है। PAGE_URL को उस पेज पर रखें जो widget दिखाता है। Server mode में host में CapSkip वाली मशीन का पता डालें।

# python -m pip install capskip requests
import re

import requests
from capskip import ApiException, CapSkip

PAGE_URL = "https://example.com/comment"  # the page that shows the widget
FIELDS = ("captcha_id", "lot_number", "pass_token", "gen_time", "captcha_output")

# Local mode. In Server mode, use the address of the CapSkip machine.
solver = CapSkip(host="127.0.0.1", port=8080)

captcha_id सार्वजनिक है और हर विज़िटर के लिए एक जैसी है, इसलिए इसे एक बार पढ़कर दोबारा इस्तेमाल करें। पेज इसे initGeetest4 को captchaId option के रूप में देता है, और widget की script भी इसे gcaptcha4.geetest.com/load पर अपनी request के captcha_id query parameter के रूप में भेजती है। CapSkip GeeTest v4 पेज 32 अक्षरों की id बताता है, लेकिन SDK कोई फ़ॉर्मैट नहीं जाँचता, इसलिए pattern कोई भी शब्द-अक्षर या हाइफ़न स्वीकार करता है। यह call को parse करने के बजाय option को उसके नाम से खोजता है, इसलिए nesting, single quotes और अलग key क्रम में भी यह चलता है।

def read_captcha_id(html):
    """Return the captcha_id the page gives to the GeeTest v4 script."""
    for pattern in (
        r"\bcaptchaId[\"']?\s*:\s*[\"']([\w-]+)[\"']",  # initGeetest4({captchaId: ...})
        r"[?&]captcha_id=([\w-]+)",  # a gcaptcha4.geetest.com/load address
    ):
        found = re.search(pattern, html)
        if found:
            return found.group(1)
    raise RuntimeError("no captcha_id in the page, read it from the Network tab")


def open_session():
    session = requests.Session()
    page = session.get(PAGE_URL, timeout=30)  # cookies arrive with the page
    return session, read_captcha_id(page.text)

मैंने read_captcha_id को छह mock पेजों पर चलाया: id double quotes में, id दूसरे options के बीच single quotes में, id एक nested object में जिसकी quoted key पहली नहीं थी, id एक variable में जिसमें key आख़िरी थी, id सिर्फ़ load address में, और कहीं नहीं, क्योंकि एक script runtime पर call बनाती है। उस मामले में ब्राउज़र का Network tab एक बार खोलें, gcaptcha4 से filter करें और load request से captcha_id कॉपी करें। मैंने इस function को किसी असली साइट पर नहीं चलाया।

चरण 2: geetest_v4() से पास माँगें

method का signature solver.geetest_v4(captcha_id, url, **options) है। SDK टास्क सबमिट करता है, जवाब तैयार होने तक poll करता रहता है और एक dictionary लौटाता है, इसलिए इंतज़ार का कोई loop नहीं चाहिए। url उस पेज का पूरा पता है जिस पर widget है। नीचे का block फ़ॉर्म के लिए सिर्फ़ पाँच fields रखता है, और risk_type तभी जोड़ता है जब आप उसे सेट करें।

def pick(result):
    if result.get("isOffline"):
        print("offline pass: the site decides whether to accept it")
    missing = [name for name in FIELDS if name not in result]
    if missing:
        raise RuntimeError(f"GeeTest answer did not parse, missing {missing}")
    return {name: result[name] for name in FIELDS}


def get_pass(captcha_id, risk_type=None):
    options = {"risk_type": risk_type} if risk_type else {}
    return pick(solver.geetest_v4(captcha_id, PAGE_URL, **options))

dictionary में पाँचों मान अलग keys के रूप में होते हैं। उसमें captchaId भी होता है, यानी वह संख्या जो CapSkip ने टास्क को दी, और यह widget id नहीं है: फ़ॉर्म को अंडरस्कोर वाला captcha_id चाहिए। key code कच्ची JSON string रखती है, जो API docs के अनुसार res.php पाँचों मान इसी रूप में पैक करता है। SDK इसे आपके लिए parse कर देता है, और docs का पालन करने वाले मेरे mock के सामने code एक ऐसी string थी जो पाँचों मान में parse हुई। अलग-अलग fields post करें, code नहीं।

जब GeeTest तक पहुँचा नहीं जा सकता, तो उसका widget विज़िटर को offline mode में पास कर देता है और dictionary में isOffline भी True पर सेट होकर आता है। नहीं तो वह key मौजूद नहीं होती। pick function एक नोट प्रिंट करता है और फिर भी पाँचों fields लौटाता है, क्योंकि offline पास स्वीकार करना है या नहीं, यह साइट तय करती है।

risk_type option उन साइटों के लिए है जो कॉल करने वाले को challenge चुनने देती हैं। API docs के अनुसार मान slide, icon, nine, word, phrase, match, winlinze, svg_seed, svg_icon और ai हैं, और GeeTest उनमें से एक तभी लागू करता है जब साइट इसकी अनुमति दे, इसलिए अन्यथा इसे छोड़ दें। SDK सिर्फ़ यह जाँचता है कि वह एक string है: slide और nine mock तक बिना बदले पहुँचे, riskType का नाम बदलकर risk_type कर दिया गया, और गढ़ा हुआ मान, जैसे risk_type=bogus भी चला गया।

कुछ भी भेजने से पहले SDK ये सब मामले ValidationException से रोकता है: captcha_id जो गायब, खाली या string नहीं है, ऐसा पेज पता जो खाली है या पूरा http या https URL नहीं है, ऐसा risk_type जो string नहीं है, अलग-अलग मान वाले riskType और risk_type, और कोई भी option जिसे API नहीं लेती। इसमें userAgent भी आता है, जिसे hCaptcha और MTCaptcha के methods स्वीकार करते हैं पर यह method नहीं, और v3 के नाम gt और challenge भी। ऐसे port पर जहाँ कोई server नहीं था, इनमें से हर मामला सेकंड के सौवें हिस्से से भी कम समय में raise हुआ। यही गलतियाँ होने पर API docs ERROR_PAGEURL और ERROR_BAD_PARAMETERS बताते हैं, इसलिए सीधे in.php को call करने वाले को वही codes दिखते हैं जहाँ आपको exception दिखता है।

geetest_v4() method CapSkip के अंदर एक असली ब्राउज़र चलाता है, इसलिए SDK इसे defaultTimeout नहीं, बल्कि recaptchaTimeout देता है, जो डिफ़ॉल्ट रूप से 300 सेकंड है। मैंने दोनों जाँचे। defaultTimeout 3 सेकंड पर और ऐसे mock के साथ जो कभी जवाब नहीं देता था, call 9 सेकंड बाद भी poll कर रही थी। recaptchaTimeout 3 पर उसने 3.76 सेकंड बाद TimeoutException raise किया, क्योंकि SDK ने 0, 0.25, 0.76 और 1.76 सेकंड पर पूछा, 2 सेकंड और सोया और उसके बाद ही deadline देखी। यही schedule सफल जवाब को भी देर से लौटाता है: 1 सेकंड बाद तैयार पास 1.76 पर आया, 2 सेकंड बाद तैयार पास 3.76 पर और 6 सेकंड बाद तैयार पास 7.76 पर। ये Python 3.14.0, capskip 1.8.0 और डिफ़ॉल्ट polling के नतीजे हैं, mock के सामने। CapSkip GeeTest v4 पेज एक क्लिक वाले पास के लिए 1 से 4 सेकंड और slide के लिए लगभग 15 से 20 सेकंड बताता है, इसलिए recaptchaTimeout उस सबसे धीमे प्रकार के हिसाब से रखें जो आपकी साइट दिखा सकती है।

चरण 3: पाँचों मान post करें, फिर अगले post के लिए दोबारा हल करें

पाँचों मान ऊपर दिए नामों से, अपने फ़ील्ड के साथ भेजें, और Network tab में पेज के अपने submit से जो जाता है उससे मिलान करें। function पेज को Referer के रूप में भी भेजता है। requests library न Referer जोड़ती है न Origin, और कुछ framework इन दोनों के बिना आए HTTPS form post को लौटा देते हैं, जैसा मेरे mock ने 403 के साथ किया।

POST_URL = PAGE_URL  # the form's action address, if it differs from the page


def post_comment(session, fields, author, text):
    return session.post(
        POST_URL,
        data={"author": author, "comment": text, **fields},  # your form's own fields
        headers={"Referer": PAGE_URL},  # requests sends none by itself
        timeout=30,
    )

हर form post के लिए दोबारा हल करें। API docs यही कहते हैं, और मेरा mock उनका पालन करता है: उसने पाँच मानों का दूसरा post पहले से इस्तेमाल हुआ बताकर ठुकरा दिया, और ऐसा पास भी ठुकराया जो हल के 3 सेकंड बाद post हुआ जबकि उसकी आयु 2 सेकंड रखी गई थी। इसलिए loop पास comments वाले loop के भीतर माँगता है, जबकि captcha_id open_session से एक बार आती है। यह नया हल तभी माँगता है जब ERROR_CAPTCHA_UNSOLVABLE आए या साइट कहे कि captcha की जाँच विफल रही। बाकी कोई भी ApiException raise कर दी जाती है, क्योंकि गलत key दोबारा भी उसी तरह फेल होती है।

ठुकराने की जाँच आपकी साइट का पूरा वाक्यांश होती है, यहाँ captcha check failed। सिर्फ़ captcha शब्द पर की गई जाँच खाली comment के बाद दोबारा दिखे comment पेज से मेल खा गई, जिसमें अब भी widget का markup रहता है, और captcha से असंबंधित एक गलती पर तीन टास्क खर्च हो गए। छोटा check failed Referer जाँच वाले 403 पेज से मेल खा गया।

def submit_all(session, captcha_id, comments, passes=None):
    saved = 0
    for index, (author, text) in enumerate(comments):
        for attempt in range(1, 4):
            ready = passes[index] if passes and attempt == 1 else None
            try:
                fields = ready or get_pass(captcha_id)  # a new solve per form post
            except ApiException as err:
                if "ERROR_CAPTCHA_UNSOLVABLE" not in str(err):
                    raise  # a wrong key or a bad request fails again
                print(f"comment {index + 1}, attempt {attempt}: unsolvable, new task")
                continue
            reply = post_comment(session, fields, author, text)
            if "Comment saved" in reply.text:  # your site's success sign
                saved += 1
                break
            if "captcha check failed" not in reply.text.lower():  # your phrase
                raise RuntimeError(f"refused ({reply.status_code}), not the captcha")
            print(f"comment {index + 1}, attempt {attempt}: pass refused, new solve")
        else:
            raise RuntimeError(f"comment {index + 1}: no luck after 3 attempts")
    return saved


if __name__ == "__main__":
    session, captcha_id = open_session()
    comments = [("alice", "First"), ("alice", "Second"), ("alice", "Third")]
    print(submit_all(session, captcha_id, comments), "comments saved")

इसे python comment_geetest.py से चलाएँ (py comment_geetest.py भी चलता है)। mock के सामने script ने Python 3.11.7, 3.13.7 और 3.14.0 पर एक जैसा व्यवहार किया:

mock सेटिंगक्या हुआ
तीन comments, डिफ़ॉल्टएक ही captcha_id वाले तीन टास्क, तीनों post स्वीकार
हाथ से लिखे post के साथ: वही पाँच मान दो बार postदूसरा post पहले से इस्तेमाल हुआ बताकर ठुकराया गया
हाथ से लिखे post के साथ: हल के 3 सेकंड बाद पास post किया, mock की आयु 2 सेकंडबहुत पुराना बताकर ठुकराया गया, और अगला ताज़ा हल पास हो गया
शुरू में दो unsolvable जवाबदो retry, और तीसरे टास्क का पास स्वीकार हुआ
लगातार तीन unsolvable जवाबतीन टास्क इस्तेमाल होने पर RuntimeError
Offline पास, साइट उसे स्वीकार करती हैनोट प्रिंट हुआ, एक टास्क के बाद post स्वीकार
Offline पास, साइट उसे ठुकराती हैतीन टास्क, फिर RuntimeError
खाली comment, पेज widget के markup के साथ दोबारा दिखाएक टास्क के बाद RuntimeError। जाँच के रूप में सिर्फ़ captcha शब्द रखने पर तीन टास्क
Referer header के बिना form post403, एक टास्क के बाद RuntimeError
Key validation चालू, SDK की डिफ़ॉल्ट keyएक टास्क के बाद ApiException। सही apiKey के साथ स्वीकार

इस table को मेरे mock और मेरी script का टेस्ट समझें, GeeTest का नहीं। docs कहते हैं कि तुरंत submit करें और हर form post के लिए दोबारा हल करें। एक बार इस्तेमाल और दो सेकंड की आयु मेरे mock के नियम हैं।

AsyncCapSkip से एक साथ कई post

async client की जगह एक ही वजह से बनती है: एक पास में सेकंड लगते हैं, और तीन एक साथ माँगे जा सकते हैं। AsyncCapSkip httpx पर बना है, इसलिए asyncio.gather हलों को overlap करता है जबकि form post सादे requests में ही रहते हैं। mock के हर पास में 3.0 सेकंड लगने पर, तीन post को एक हल के बाद दूसरे के क्रम में 11.35 सेकंड लगे और overlap के साथ 4.09 सेकंड, Python 3.14.0 पर, और mock में एक साथ तीन टास्क खुले रहे।

दोनों blocks में port 8080 2captcha-style service का डिफ़ॉल्ट है, इसलिए CapSkip की सेटिंग्स में दिखने वाला port इस्तेमाल करें। बड़े pool वाला pattern इस post में है: Python में captchas को parallel में हल करना। चरण 3 के main block की जगह नीचे वाला block रखें। विफल हल solve_all में None बन जाता है और submit_all एक ही call से दोबारा माँगता है, इसलिए गलत key फिर भी उसी ApiException पर खत्म होती है। उतने ही पास माँगें जितने ताज़ा रहते हुए post कर सकें, और लंबी सूची को batches में बाँटें।

import asyncio

from capskip import AsyncCapSkip


async def solve_all(captcha_id, count):
    # Local mode. In Server mode, use the address of the CapSkip machine.
    async_solver = AsyncCapSkip(host="127.0.0.1", port=8080)
    jobs = [async_solver.geetest_v4(captcha_id, PAGE_URL) for _ in range(count)]
    results = await asyncio.gather(*jobs, return_exceptions=True)
    return [pick(r) if isinstance(r, dict) else None for r in results]


def submit_overlapped(comments):
    session, captcha_id = open_session()
    passes = asyncio.run(solve_all(captcha_id, len(comments)))
    return submit_all(session, captcha_id, comments, passes)


if __name__ == "__main__":
    comments = [("alice", "First"), ("alice", "Second"), ("alice", "Third")]
    print(submit_overlapped(comments), "comments saved")

आम errors

CapSkip के codes API docs से आते हैं, exception वाली पंक्तियाँ SDK source से, और आख़िरी पंक्ति docs की उस बात की मेरी व्याख्या है कि हर form submission के लिए दोबारा हल करें।

त्रुटिकारणफिक्स
ValidationExceptionSDK ने आपकी मशीन पर ही, CapSkip से संपर्क किए बिना, arguments ठुकरा दिए, चरण 2 में बताए कारणों में से किसी एक के लिएexception का text उस argument की ओर इशारा करता है जिसमें गड़बड़ी है
ERROR_CAPTCHA_UNSOLVABLEउस टास्क के लिए पास नहीं मिल सकानया टास्क सबमिट करें, जैसा submit_all अधिकतम तीन कोशिशों के लिए करता है। docs कहते हैं कि app Settings में रखा बदला हुआ text लौटा सकता है, इसलिए अगर आपने उसे बदला है तो उसी text से मिलान करें
ERROR_KEY_DOES_NOT_EXIST या ERROR_WRONG_USER_KEYapp keys जाँचता है (API Key Validation) और आपकी key गायब या गलत है। apiKey के बिना की गई calls key capskip इस्तेमाल करती हैं, जिस पर mock ने पहला code लौटायाअपनी असली key को CapSkip() में apiKey के रूप में दें
ERROR_PROXY_FORMATdocs इसे ऐसे proxy मान के लिए बताते हैं जिसे CapSkip पढ़ नहीं सकता, और scheme prefix न लगाने को कहते हैं। SDK ने prefix वाला मान बिना बदले भेज दियाhttp:// के बिना login:password@IP:PORT लिखें
NetworkExceptionटास्क जाते समय उस host और port से कोई जवाब नहीं, जो मुझे Windows पर लगभग 2 सेकंड बाद दिखा। जो server poll के बीच में चुप हो जाए, वह इसके बजाय TimeoutException देता हैपक्का करें कि CapSkip खुला है और host व port कनेक्शन सेटिंग्स से मेल खाते हैं
TimeoutExceptionrecaptchaTimeout के भीतर कोई पास नहीं आया, यानी 300 सेकंड, जब तक आपने दूसरा मान न रखा होCapSkip app में टास्क देखें और script दोबारा चलाएँ
साइट कहती है कि captcha की जाँच विफल रहीमेरा अनुमान, docs की कोई सूची नहीं: पाँचों मान पहले इस्तेमाल हो चुके थे, बहुत पुराने थे या बदल दिए गए थेहर सेट को एक बार और तुरंत, बिना बदले, पेज को Referer बनाकर post करें

FAQ

क्या मैं CapSkip को किसी दूसरे कंप्यूटर से call कर सकता हूँ?

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

क्या GeeTest v4 के लिए मुझे proxy चाहिए?

शुरू करने के लिए नहीं। API docs एक पते को टेस्ट के लिए ठीक बताते हैं, और कहते हैं कि GeeTest की rate limiting एक ही पते से आती लगातार धारा को निशाना बनाती है। ज़्यादा volume के लिए app में proxy pool लोड करें, या किसी टास्क को उसका अपना proxy दें, जो pool पर भारी पड़ता है। प्रॉक्सी चुनने के बारे में captcha solver के लिए proxies वाला post में बताया गया है। Python में option या तो एक dictionary है, proxy={"type": "HTTP", "uri": "login:password@IP:PORT"}, या proxytype के साथ एक सादी string। दोनों रूप mock तक proxy और proxytype fields के रूप में पहुँचे।

अगर पेज मुझे gt और challenge देता है तो?

तब साइट GeeTest v3 चलाती है, जिसे हर कोशिश के लिए नया challenge चाहिए और जो challenge, validate और seccode लौटाता है। वह flow इस post में है: Python में GeeTest v3.

संक्षेप में

Python में GeeTest v4 का मतलब है एक बार पढ़ी गई एक captcha_id, हर form post के लिए एक हल और बिना बदले लौटाए गए पाँच fields। चूँकि CapSkip एक असीमित कैप्चा सॉल्वर है जो आपके अपने PC पर चलता है, इसलिए बार-बार हल करने से बिल में कुछ नहीं जुड़ता। दूसरे प्रकारों के SDK calls के लिए Python कैप्चा सॉल्वर पेज देखें।