Node.js में GeeTest v4: fetch और types के साथ batch sign-up

browser के बिना Node.js में GeeTest v4 हल करने के लिए, पेज से captcha_id एक बार पढ़ें, capskip package के solver.geetestV4() को वह id और पेज का पता देकर call करें, और जो पाँच fields लौटें उन्हें उन्हीं नामों से उस request में भेजें जो पेज ख़ुद करता है। नीचे की script छह sign-up के लिए यही करती है, built-in fetch के साथ, हर submission के लिए एक नया हल, और Promise.allSettled पर खत्म होती है। टास्क हल करने का काम CapSkip GeeTest v4 सॉल्वर आपके अपने Windows PC पर होता है, और प्रति हल कोई शुल्क नहीं।
आपको क्या चाहिए
- Windows मशीन जिस पर CapSkip 5.0.0 या बाद का version हो, changelog के अनुसार GeeTest v4 हल करने वाला पहला release।
- Node.js 18 या नया, जो capskip 1.8.0 के engines field में घोषित है। यह geetestV4() वाला पहला SDK version है। मेरे रन में 20.11.1, 24.22.0 और 25.2.1 शामिल थे, इसलिए मैंने Node.js 18 ख़ुद कभी नहीं चलाया।
- TypeScript, लेकिन सिर्फ़ वैकल्पिक type check के लिए। लिखते समय npm ने typescript 7.0.2 चुना, जो Node.js 16.20 या बाद का घोषित करता है, और @types/node 26.6.6।
- GeeTest v4 widget वाला sign-up या login पेज जिसे ऑटोमेट करने की आपको अनुमति हो।
- CapSkip का पता। Local mode उसे 127.0.0.1 पर रखता है। Server mode आपके नेटवर्क या public IP से भी कनेक्शन स्वीकार करता है, और Connection Settings सेक्शन सेटअप गाइड में दोनों मोड बताए गए हैं।
नीचे हर रन में मेरे लिखे दो छोटे servers इस्तेमाल हुए, एक CapSkip API की नक़ल करता है और दूसरा sign-up पेज की, इसलिए साइट के नियम मेरे हैं। जब मैंने टेस्ट किया, असली CapSkip app इस PC पर जवाब नहीं दे रहा था, इसलिए मैंने उसे कुछ नहीं भेजा, और किसी GeeTest साइट ने कोई request नहीं देखी। जहाँ कोई दावा रन के बजाय CapSkip docs, SDK source या GeeTest docs पर टिका है, मैं यह बता देता हूँ। असली साइट पाँचों fields की जाँच अपने server पर, अपनी private key के साथ, करती है। इसके लिए वह यह API इस्तेमाल करती है: GeeTest का सर्वर validation API.
चरण 1: folder तैयार करें
पहला block एक खाली folder में चलाएँ। यह package.json बनाता है, capskip इंस्टॉल करता है और type check के लिए TypeScript जोड़ता है। tsconfig block को tsconfig.json नाम से सेव करें। फिर चरण 2 से 5 के चारों JavaScript block क्रम से geetest_v4.mjs नाम की एक फ़ाइल में सेव करें। .mjs extension top-level await की अनुमति देता है। पहले रन से पहले ORIGIN, दोनों paths और emails को अपनी साइट के अनुसार बदलें। जैसे हैं वैसे छोड़ने पर script example.com से पूछती है और "the page answered HTTP 404" के साथ रुक जाती है।
# Run in an empty folder, in PowerShell or any other shell npm init -y npm install capskip npm install --save-dev typescript @types/node
{
"compilerOptions": {
"target": "es2022",
"module": "node16",
"moduleResolution": "node16",
"allowJs": true,
"checkJs": true,
"noEmit": true,
"strict": true,
"skipLibCheck": true,
"types": ["node"]
},
"files": ["geetest_v4.mjs"]
}इस फ़ाइल के साथ, tsc script को typed JavaScript की तरह पढ़ता है। package GeetestV4Options और एक SolveResult देता है जिसके पाँच GeeTest fields वैकल्पिक हैं, इसलिए चरण 3 में एक guard है।
चरण 2: captcha_id एक बार पढ़ें
पेज id को initGeetest4 को captchaId के रूप में देता है, और gcaptcha4.geetest.com/load की request उसे captcha_id के रूप में ले जाती है। स्रोत: CapSkip के GeeTest v4 API डॉक्स। यह हर विज़िटर के लिए एक जैसी है, इसलिए readCaptchaId अपना promise एक variable में रखता है और हर रन में पेज एक ही बार fetch करता है, चाहे आगे कितने भी submissions हों। यह हर मेल को एक Set में इकट्ठा करता है और अंदाज़ा नहीं लगाता: दो अलग ids, या कोई नहीं, कोई भी हल माँगे जाने से पहले हर submission को फेल कर देते हैं। यह rejected promise को भी cache करता है, इसलिए पेज का एक timeout पूरे रन को फेल कर देता है।
// @ts-check
// npm install capskip
import {
CapSkip, ApiException, NetworkException, TimeoutException, ValidationException,
} from "capskip";
const ORIGIN = "https://example.com";
const PAGE_URL = `${ORIGIN}/signup`; // the page that shows the widget
const API_URL = `${ORIGIN}/api/signup`; // where the page's own submit sends its JSON
// Local mode. In Server mode, use the address of the PC that runs CapSkip.
const solver = new CapSkip({ host: "127.0.0.1", port: 8080 });
/** @type {Promise<string> | undefined} */
let idRead;
// The captcha_id is the same for every visitor, so read it once per run.
function readCaptchaId() {
idRead ??= (async () => {
const res = await fetch(PAGE_URL, { signal: AbortSignal.timeout(10_000) });
if (!res.ok) throw new Error(`the page answered HTTP ${res.status}`);
const html = await res.text();
const pattern = /captchaId["']?\s*:\s*["']([0-9a-f]{32})["']|[?&]captcha_id=([0-9a-f]{32})/gi;
const ids = new Set([...html.matchAll(pattern)].map((m) => (m[1] ?? m[2]).toLowerCase()));
if (ids.size !== 1) throw new Error(`expected one captcha_id in the page, found ${ids.size}`);
return [...ids][0];
})();
return idRead;
}मेरे mock पेज पर id तब सही निकली जब पेज ने उसे double quotes में लिखा, single quotes में और key को अपनी अलग लाइन पर, JSON जैसे object में quoted key के रूप में, और load URL में। जिस पेज में असली id के बगल में comment में पुरानी id पड़ी थी, वह "found 2" पर रुका, और जिस पेज की script id कहीं और बनाती है, वह "found 0" पर रुका। pattern 32 hexadecimal अक्षर की उम्मीद करता है, जैसी docs की ids हैं।
चरण 3: typed options के साथ पाँचों fields माँगें
call solver.geetestV4(captchaId, url, options) है। यह टास्क सबमिट करती है, नतीजे के लिए poll करती है और एक object पर resolve होती है। API docs कहते हैं कि res.php पाँचों मान अपने request field में एक JSON string के रूप में भेजता है, इसीलिए code एक string है: SDK उसे दूसरी बार parse करता है और captcha_id, lot_number, pass_token, gen_time और captcha_output को result पर कॉपी करता है, साथ में isOffline जब GeeTest तक पहुँचा न जा सका हो। SDK source के अनुसार, जो string parse नहीं होती वह result को बिना फैलाए छोड़ देती है और कोई error नहीं देती, इसलिए fiveFields तब तक throw करता है जब तक पाँचों मौजूद न हों।
/** @typedef {"slide" | "icon" | "nine" | "word" | "phrase" | "match" | "winlinze" | "svg_seed" | "svg_icon" | "ai"} RiskType */
const NAMES = /** @type {const} */ (["captcha_id", "lot_number", "pass_token", "gen_time", "captcha_output"]);
// All five fields or an error: the SDK hands back an answer it cannot parse untouched.
/** @param {import("capskip").SolveResult} result */
function fiveFields(result) {
/** @type {Record<string, string>} */
const fields = {};
for (const name of NAMES) {
if (!result[name]) {
throw new Error(`the answer has no ${name}; code starts: ${String(result.code).slice(0, 40)}`);
}
fields[name] = String(result[name]);
}
return { fields, offline: result.isOffline === true };
}
/** @param {RiskType} [riskType] */
async function solveOnce(riskType) {
/** @type {import("capskip").GeetestV4Options & { riskType?: RiskType }} */
const options = { timeout: 60, polling_interval: 2 }; // both in seconds
if (riskType) options.riskType = riskType;
const result = await solver.geetestV4(await readCaptchaId(), PAGE_URL, options);
return fiveFields(result);
}दो नाम एक जैसे दिखते हैं। captcha_id वह widget id है जिसे GeeTest वापस दोहराता है, और भेजनी वही है। captchaId वह id है जो CapSkip ने टास्क को दी। result में दोनों होते हैं, और SDK का example captchaId को Captcha ID लेबल के नीचे प्रिंट करता है। मेरे mock पर टास्क id 102 थी, और उसे captcha_id के रूप में post करना ठुकरा दिया गया।
docs riskType के लिए दस मान बताते हैं: slide, icon, nine, word, phrase, match, winlinze, svg_seed, svg_icon और ai। GeeTest उनमें से एक तभी लागू करता है जब साइट इसकी अनुमति दे, और साइट की अपनी पसंद आमतौर पर जीतती है, इसलिए मैं असर टेस्ट नहीं कर सका। SDK की अपनी परिभाषा riskType को सादी string के रूप में टाइप करती है, और run time पर SDK सिर्फ़ यह जाँचता है कि वह string है, इसलिए typo आगे चला जाता है: मेरे mock को risk_type slid बिना छेड़े मिला। RiskType typedef उसे पकड़ लेता है, और tsc ने call को error TS2345 के साथ ठुकरा दिया। यह गलत लिखे option नाम को नहीं पकड़ सकता, क्योंकि options type दूसरी keys की अनुमति देता है। risktype नाम का option compile हो गया, फिर SDK ने उसे run time पर असमर्थित parameter बताकर ठुकरा दिया।
timeout और polling_interval options सेकंड में हैं। timeout के बिना client का 300 सेकंड वाला डिफ़ॉल्ट लागू होता है, और SDK कोई AbortSignal नहीं लेता, इसलिए signal से दौड़ लगाने के बजाय timeout सेट करें: polling उसके साथ रुक जाती है। SDK deadline सिर्फ़ तब जाँचता है जब अगला poll देय हो। कभी जवाब न देने वाले mock के सामने, timeout 5 डिफ़ॉल्ट interval 5 के साथ 7.9 सेकंड बाद खत्म हुआ, और polling_interval 2 के साथ 5.9 बाद। तंग timeout पूरा हो चुका जवाब भी खो सकता है, जैसा नीचे की table दिखाती है। हल के साथ एक interval की गुंजाइश रखें। AsyncCapSkip वही class है, दूसरे नाम से, क्योंकि हर method पहले से promise लौटाता है।
proxy option एक string या type और uri वाला object लेता है। string के साथ proxytype डिफ़ॉल्ट रूप से HTTP होता है, और मेरे mock ने object रूप को proxy मान और proxytype SOCKS5 के रूप में पहुँचते देखा। यह सिर्फ़ CapSkip के हल तक पहुँचता है, और मेरी fetch calls इसे इस्तेमाल नहीं करतीं। CapSkip docs कभी-कभार के हलों से आगे proxy pool की सलाह देते हैं। मैंने कोई असली proxy टेस्ट नहीं किया।
ग्यारह गलतियों को SDK ने ValidationException के साथ ठुकरा दिया, मेरे mock के in.php तक कुछ भी पहुँचने से पहले: कोई captcha id नहीं, पेज का पता गायब, relative या ftp वाला, v3 के parameters gt और challenge, एक userAgent option, अनजान option नाम, riskType के रूप में संख्या, proxytype SOCKS4 और बिना uri वाला proxy object। userAgent की अस्वीकृति जानने लायक है, क्योंकि MTCaptcha और Yandex SmartCaptcha के methods एक लेते हैं और GeeTest v4 नहीं लेता। docs कहते हैं कि app captcha_id गायब होने या असमर्थित proxytype पर ERROR_BAD_PARAMETERS और पेज का पता गायब या गलत होने पर ERROR_PAGEURL देता है। बाकी अस्वीकृतियों के बारे में docs कुछ नहीं कहते, और SDK उन्हें पहले रोक देता है।
चरण 4: पाँचों fields JSON में भेजें
CapSkip docs कहते हैं कि fields उन्हीं नामों से, बिना बदले, उस request में भेजें जो पेज का अपना submit करता है, और हर submission के लिए दोबारा हल करें। मेरा mock पेज email और पाँचों fields के साथ JSON submit करता है, इसलिए submit वही करता है। अगर आपका पेज एक form भेजता है, तो body की जगह new URLSearchParams रखें और content type header हटा दें।
/**
* @param {string} email
* @param {RiskType} [riskType]
*/
async function submit(email, riskType) {
const { fields, offline } = await solveOnce(riskType); // one solve per submission
const res = await fetch(API_URL, {
method: "POST",
// fetch adds no Origin or Referer by itself, and a CSRF check may want them.
headers: { "Content-Type": "application/json", Origin: ORIGIN, Referer: PAGE_URL },
body: JSON.stringify({ email, ...fields }),
signal: AbortSignal.timeout(10_000),
});
const body = (await res.text()).slice(0, 60);
if (!res.ok) throw new Error(`HTTP ${res.status} ${body}`);
return `${email}: HTTP ${res.status}${offline ? " (offline pass)" : ""}`;
}दोनों headers मायने रखते हैं क्योंकि fetch न Origin जोड़ता है न Referer। दोनों headers हटाने पर मेरे mock ने छहों submissions का जवाब 403 और csrf error के साथ दिया, छह हल खर्च होने के बाद। दोनों में से सिर्फ़ एक के साथ उसने उन्हें स्वीकार कर लिया। यह मेरे mock का नियम है और आपकी साइट के अपने नियम हैं, इसलिए batch से पहले एक परीक्षण submission भेजें।
जवाब को कभी दोबारा इस्तेमाल न करें। जब मैंने वही पाँच fields दो बार भेजे, मेरे mock ने 200 और फिर captcha used के साथ 403 दिया। GeeTest ख़ुद replay स्वीकार करता है या नहीं, यह मैं टेस्ट नहीं कर सका।
isOffline flag उस स्थिति के लिए है जब GeeTest तक ख़ुद पहुँचा न जा सका हो। docs कहते हैं कि तब widget बिना challenge के पास हो जाता है, जवाब में isOffline true रहता है, और साइट अपने server पर तय करती है कि उसे स्वीकार करे या नहीं। setup guide Monitor tab में Offline pass लेबल समझाती है, और submit अपनी result लाइन में offline pass शब्द जोड़ता है। जब हर दूसरा जवाब offline था, तब offline पास ठुकराने वाली mock साइट ने छह में से तीन लिए, और स्वीकार करने वाली ने सभी छह।
चरण 5: Promise.allSettled के साथ Node.js में GeeTest v4
setup guide कहती है कि CapSkip एक प्रकार के उतने ही टास्क एक साथ हल करता है जितने उसकी Max. Threads सेटिंग अनुमति दे। बाकी Wait Timeout सेकंड तक किसी खाली thread का इंतज़ार करते हैं, और इस बीच आपका call timeout चलता रहता है। नीचे का loop WAVE submissions भेजता है, Promise.allSettled से सबका इंतज़ार करता है और अगली wave शुरू करता है। allSettled कभी reject नहीं होता, इसलिए script exit code ख़ुद सेट करती है, और describe चारों SDK exception classes में से हर एक को एक पंक्ति में बदल देता है।
const WAVE = 3; // keep this at or below Max. Threads for GeeTest in CapSkip
/** @param {unknown} err */
function describe(err) {
if (err instanceof ValidationException) return `refused before sending: ${err.message}`;
if (err instanceof TimeoutException) return `no answer in time: ${err.message}`;
if (err instanceof NetworkException) return `CapSkip not reachable: ${err.message}`;
if (err instanceof ApiException) return `CapSkip error: ${err.message}`;
return err instanceof Error ? err.message : String(err);
}
const emails = [
"[email protected]", "[email protected]", "[email protected]",
"[email protected]", "[email protected]", "[email protected]",
];
/** @type {PromiseSettledResult<string>[]} */
const settled = [];
for (let i = 0; i < emails.length; i += WAVE) {
const wave = emails.slice(i, i + WAVE).map((email) => submit(email));
settled.push(...(await Promise.allSettled(wave)));
}
settled.forEach((s, i) => {
console.log(s.status === "fulfilled" ? `ok ${s.value}` : `FAIL ${emails[i]}: ${describe(s.reason)}`);
});
process.exitCode = settled.every((s) => s.status === "fulfilled") ? 0 : 1;types जाँचें, फिर चलाएँ। यह हर email के लिए एक पंक्ति प्रिंट करता है।
# Check the types, then run the script npx tsc node geetest_v4.mjs
ये पंक्तियाँ Windows 11 पर Node.js 24.22.0 और capskip 1.8.0 के mock नतीजे हैं, process शुरू होने से exit तक नापे गए। गिनती 20.11.1 और 25.2.1 पर मेल खाई, और timings 0.3 सेकंड के भीतर मिले।
| mock सेटिंग | script ने क्या किया |
|---|---|
| छह submissions, हल 2 सेकंड, 3 slots; WAVE 3, 6 या 1 | हर मामले में छह, 7.7, 5.9 और 22.9 सेकंड में; एक साथ अधिकतम 3, 3 और 1 टास्क |
| Call timeout 4, polling_interval 1, हल 2 सेकंड, 3 slots; WAVE 3 या 6 | WAVE 3: छह पूरे, 5.7 सेकंड। WAVE 6: तीन पूरे, तीन "timeout 4 exceeded" 4.9 पर |
| हल 2 सेकंड, timeout 3; polling_interval 2 या 1 | 2: तीनों "timeout 3 exceeded" 3.9 सेकंड पर। 1: तीनों पूरे, 2.9 सेकंड |
| जवाब कभी तैयार नहीं, timeout 5; polling_interval 5, 2 या 1 | TimeoutException 7.9, 5.9 और 5.9 सेकंड बाद |
| Origin और Referer headers हटाए गए | छह 403 csrf से ठुकराए गए, छह हल खर्च होने के बाद |
| वही पाँच fields दो बार भेजे गए | 200, फिर 403 "captcha used" |
| हर दूसरा जवाब offline; साइट offline पास ठुकराती है या स्वीकार करती है | तीन पूरे और तीन ठुकराए गए, या सभी छह पूरे |
| जवाब JSON नहीं है, या lot_number गायब है | छह guard errors और साइट को कोई request नहीं |
| पहले दो टास्क ERROR_CAPTCHA_UNSOLVABLE पर खत्म होते हैं | दो FAIL पंक्तियाँ, चार पूरे |
जब timeout उदार हो तो waves समय खर्च कराती हैं: छह submissions एक साथ 5.9 सेकंड में हुए, जबकि तीन की waves में 7.7, क्योंकि हर wave अगली शुरू होने से पहले अपने सबसे धीमे सदस्य का इंतज़ार करती है। वे तब फ़ायदा देती हैं जब call timeout तंग हो, जैसा दूसरी पंक्ति दिखाती है। 4 सेकंड के timeout के साथ, जो तीन टास्क भरे हुए slots के पीछे कतार में थे उनका समय खत्म हो गया। तीसरी पंक्ति खोया हुआ जवाब है: mock के पास वह 2 सेकंड पर था, लेकिन आख़िरी poll 1.8 सेकंड पर हुआ और अगला 3.8 पर होना था, deadline के बाद। WAVE को CapSkip में GeeTest पंक्ति के Max. Threads मान के बराबर या उससे कम रखें।
आम errors
जब तक कोई पंक्ति seen न कहे, वह यहाँ से आती है: CapSkip के GeeTest v4 API डॉक्स.
| त्रुटि | कारण | फिक्स |
|---|---|---|
| ValidationException | SDK के भीतर ठुकराया गया, कुछ भेजा नहीं गया (seen, ग्यारह मामले) | message पढ़ें |
| ERROR_BAD_PARAMETERS | docs के अनुसार: कोई captcha_id नहीं, या ऐसा proxytype जो स्वीकार नहीं | SDK दोनों को पहले ही ठुकरा देता है |
| ERROR_PAGEURL | docs के अनुसार: पेज का पता गायब या गलत है | पेज का पूरा पता दें |
| ERROR_PROXY_FORMAT | docs के अनुसार: ऐसा proxy मान जिसे CapSkip parse नहीं कर सकता | IP:PORT या login:password@IP:PORT इस्तेमाल करें |
| ERROR_CAPTCHA_UNSOLVABLE | docs के अनुसार: टास्क हल नहीं हो सका। मेरे mock ने इसे दो टास्क के लिए पैदा किया | फेल हुए emails दोबारा चलाएँ |
| ERROR_KEY_DOES_NOT_EXIST | API Key Validation चालू है। apiKey के बिना SDK ने key capskip भेजी, और मेरे mock ने उसे ठुकरा दिया | अपनी key को apiKey के रूप में दें |
| TimeoutException | timeout के भीतर कोई जवाब नहीं (seen) | timeout बढ़ाएँ या polling_interval घटाएँ |
| NetworkException | जब कुछ नहीं सुन रहा था तब connect ECONNREFUSED (seen) | CapSkip शुरू करें, host और port जाँचें |
| साइट से HTTP 403 | साइट का अपना नियम: headers, इस्तेमाल हो चुका जवाब या offline पास | पेज की अपनी request से तुलना करें |
FAQ
क्या मैं script को CapSkip से अलग PC पर चला सकता हूँ?
हाँ। CapSkip को Server mode में रखें और host option में उसके PC का पता डालें, जो इकलौती लाइन है जो बदलती है। setup guide बताती है कि Server mode को administrator अधिकार चाहिए। मेरी सलाह, setup guide का दावा नहीं: मानकर चलें कि Server mode में port हर पते के लिए खुला है, जिन मशीनों की आपको उम्मीद नहीं उनके लिए Windows Firewall का block rule जोड़ें, और API Key Validation चालू करें ताकि हर call को key देनी पड़े।
क्या एक हल कई submissions के काम आ सकता है?
नहीं। docs हर submission के लिए दोबारा हल करने को कहते हैं, और मेरे mock ने replay ठुकरा दिया।
क्या यह ऐसे पेज पर चलता है जो gt और challenge देता है?
नहीं, वह GeeTest v3 है, और SDK v4 call में gt और challenge को ठुकरा देता है। उस पीढ़ी के लिए यह गाइड देखें: Node.js के लिए GeeTest v3 गाइड.
Node.js में GeeTest v4 का मतलब है हर रन में एक id पढ़ना, हर submission के लिए एक हल और पाँच fields का अपने ही नामों से कॉपी होना। ठुकराया गया submission या दूसरा हल कभी किसी बिल तक नहीं पहुँचता, क्योंकि यह लोकल captcha सॉल्वर आपके अपने PC पर चलता है। दूसरे CAPTCHA प्रकारों की सूची Node.js कैप्चा सॉल्वर पेज में है।
