Node.js ile GeeTest v4: fetch ve Tiplerle Toplu Kayıtlar

Tarayıcı olmadan Node.js’te GeeTest v4 çözmek için captcha_id değerini sayfadan bir kez okuyun, o id ve sayfa adresiyle capskip paketinden solver.geetestV4() çağırın ve dönen beş alanı, sayfanın kendi yaptığı istekte aynı adlarla gönderin. Aşağıdaki script bunu yerleşik fetch ile altı kayıt için, gönderim başına bir taze çözümle yapar ve Promise.allSettled ile biter. Çözme işini CapSkip GeeTest v4 çözücü kendi Windows bilgisayarınızda yapar, çözüm başına ücret yoktur.
Neye ihtiyacınız var
- CapSkip 5.0.0 veya sonraki bir sürümü bulunan bir Windows makinesi; changelog’a göre GeeTest v4 çözen ilk sürüm.
- Node.js 18 veya daha yenisi; capskip 1.8.0 sürümünün engines alanının bildirdiği sürüm budur. Bu, geetestV4() bulunan ilk SDK sürümüdür. Çalıştırmalarım 20.11.1, 24.22.0 ve 25.2.1 sürümlerini kapsadı, yani Node.js 18 sürümünün kendisini hiç çalıştırmadım.
- TypeScript, ama yalnızca isteğe bağlı tür denetimi için. Bu yazı yazılırken npm, Node.js 16.20 veya daha yenisini bildiren typescript 7.0.2 ve @types/node 26.6.6 sürümlerini çözdü.
- Otomatikleştirmenize izin verilen, GeeTest v4 widget’ı olan bir kayıt veya giriş sayfası.
- CapSkip için bir adres. Local modu onu 127.0.0.1 üzerinde tutar. Server modu ağınızdan veya genel bir IP’den gelen bağlantıları da kabul eder. Her iki modu da kurulum kılavuzu içinde Connection Settings bölümü anlatır.
Aşağıdaki her çalıştırma, yazdığım iki küçük sunucu kullandı; biri CapSkip API’sini, biri bir kayıt sayfasını taklit ediyor, bu da site kurallarını benim yapıyor. Test ettiğimde gerçek CapSkip uygulaması bu bilgisayarda yanıt vermiyordu, bu yüzden ona hiçbir şey göndermedim ve hiçbir GeeTest sitesi bir istek görmedi. Bir iddia bir çalıştırmaya değil de CapSkip belgelerine, SDK kaynağına veya GeeTest belgelerine dayandığında bunu söylüyorum. Gerçek bir site beş alanı kendi sunucusunda, özel anahtarıyla, şu API üzerinden denetler: GeeTest sunucu doğrulama API’si.
1. Adım: klasörü hazırlayın
İlk bloğu boş bir klasörde çalıştırın. package.json oluşturur, capskip kurar ve tür denetimi için TypeScript ekler. tsconfig bloğunu tsconfig.json olarak kaydedin. Sonra 2 ile 5. adımların dört JavaScript bloğunu sırayla geetest_v4.mjs adlı tek bir dosya olarak kaydedin. .mjs uzantısı top-level await kullanımına izin verir. İlk çalıştırmadan önce ORIGIN, iki yolu ve e-postaları kendi sitenizle değiştirin. Olduğu gibi bırakılırsa script example.com adresine sorar ve "the page answered HTTP 404" iletisiyle durur.
# 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"]
}Bu dosyayla tsc script’i tipli JavaScript olarak okur. Paket, GeetestV4Options ve beş GeeTest alanı isteğe bağlı olan bir SolveResult sunar; bu yüzden 3. Adım’da bir koruma vardır.
2. Adım: captcha_id değerini bir kez okuyun
Sayfa id değerini initGeetest4 fonksiyonuna captchaId olarak verir ve gcaptcha4.geetest.com/load isteği onu captcha_id olarak taşır; kaynak: CapSkip GeeTest v4 API belgeleri. Her ziyaretçi için aynıdır, bu yüzden readCaptchaId promise nesnesini bir değişkende tutar ve sayfayı kaç gönderim izlerse izlesin çalıştırma başına bir kez alır. Her eşleşmeyi bir Set içinde toplar ve tahmin yürütmeyi reddeder: iki farklı id ya da hiç id, hiçbir çözüm satın alınmadan her gönderimi başarısız kılar. Ayrıca reddedilen bir promise nesnesini de önbelleğe alır, bu yüzden tek bir sayfa zaman aşımı bütün çalıştırmayı başarısız kılar.
// @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 sayfamda id şu durumlarda doğru çıktı: sayfa onu çift tırnakla, tek tırnakla ve anahtar kendi satırında yazdığında, JSON tarzı bir nesnede tırnaklı bir anahtar olarak ve load URL içinde. Gerçeğinin yanında bir yorumda eski bir id bırakılmış sayfa "found 2" ile durdu ve id değerini script içinde başka bir yerde kuran bir sayfa "found 0" ile durdu. Desen, belgelerdeki id değerleri gibi 32 onaltılık karakter bekler.
3. Adım: beş alanı tipli seçeneklerle isteyin
Çağrı solver.geetestV4(captchaId, url, options) biçimindedir. Bir görev gönderir, sonuç için yoklar ve bir nesneye çözülür. API belgelerine göre res.php beş değeri request alanında tek bir JSON dizesi olarak gönderir; code değerinin bir dize olmasının nedeni budur: SDK onu ikinci kez ayrıştırır ve captcha_id, lot_number, pass_token, gen_time ve captcha_output değerlerini, GeeTest’e ulaşılamadığında ayrıca isOffline değerini sonuca kopyalar. SDK kaynağına göre ayrışmayan bir dize sonucu açılmamış bırakır ve hata fırlatmaz; bu yüzden fiveFields, beşi de mevcut değilse fırlatır.
/** @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);
}İki ad birbirine benzer. captcha_id, GeeTest’in geri yansıttığı widget id değeridir ve gönderilecek olan odur. captchaId, CapSkip’in göreve verdiği id değeridir. Sonuç ikisini de taşır ve SDK örneği captchaId değerini Captcha ID etiketiyle yazdırır. Mock’umda görev id değeri 102 idi ve onu captcha_id olarak göndermek reddedildi.
Belgeler riskType için on değer listeler: slide, icon, nine, word, phrase, match, winlinze, svg_seed, svg_icon ve ai. GeeTest birini yalnızca site izin veriyorsa uygular ve sitenin kendi seçimi genellikle üstün gelir; bu yüzden etkisini test edemedim. SDK’nın kendi tanımı riskType türünü düz bir dize olarak belirler ve çalışma zamanında SDK yalnızca bir dize olup olmadığını denetler; bu yüzden bir yazım hatası yoluna devam eder: mock’um risk_type slid değerini olduğu gibi aldı. RiskType typedef tanımı bunu yakalar ve tsc çağrıyı TS2345 hatasıyla reddetti. Yanlış yazılmış bir seçenek adını yakalayamaz, çünkü seçenek türü başka anahtarlara izin verir. risktype adlı bir seçenek derlendi, sonra SDK onu çalışma zamanında desteklenmeyen bir parametre olarak reddetti.
timeout ve polling_interval seçenekleri saniye cinsindendir. timeout olmadan 300 saniyelik istemci varsayılanı geçerlidir ve SDK bir AbortSignal almaz; bu yüzden bir sinyalle yarıştırmak yerine timeout ayarlayın: yoklama onunla durur. SDK süre sınırını yalnızca sonraki yoklama zamanı geldiğinde denetler. Hiç yanıt vermeyen bir mock’a karşı, timeout 5 varsayılan aralık 5 ile 7,9 saniye sonra, polling_interval 2 ile 5,9 saniye sonra bitti. Sıkı bir timeout, aşağıdaki tablonun gösterdiği gibi bitmiş bir yanıtı da kaybettirebilir. Çözüm artı bir aralık için yer bırakın. AsyncCapSkip, başka bir adla aynı sınıftır, çünkü her metot zaten bir promise döndürür.
proxy seçeneği bir dize ya da type ve uri içeren bir nesne alır. Bir dizeyle proxytype varsayılan olarak HTTP olur ve mock’um nesne biçiminin bir proxy değeri artı proxytype SOCKS5 olarak ulaştığını gördü. Yalnızca CapSkip çözümüne ulaşır ve fetch çağrılarım onu kullanmaz. CapSkip belgeleri ara sıra yapılan çözümlerin ötesinde bir proxy havuzu önerir. Gerçek bir proxy test etmedim.
On bir hata, mock’umun in.php fonksiyonuna hiçbir şey ulaşmadan SDK tarafından ValidationException ile reddedildi: captcha id yok, eksik, göreli veya ftp bir sayfa adresi, v3 parametreleri gt ve challenge, bir userAgent seçeneği, bilinmeyen bir seçenek adı, riskType olarak bir sayı, proxytype SOCKS4 ve uri içermeyen bir proxy nesnesi. userAgent reddi bilmeye değer, çünkü MTCaptcha ve Yandex SmartCaptcha metotları birini kabul eder, GeeTest v4 ise etmez. Belgelere göre uygulama eksik bir captcha_id veya desteklenmeyen bir proxytype için ERROR_BAD_PARAMETERS, eksik ya da bozuk bir sayfa adresi için ERROR_PAGEURL yanıtlar. Diğer redler için belgeler bir şey söylemez ve SDK onları önce durdurur.
4. Adım: beş alanı JSON olarak gönderin
CapSkip belgeleri, alanları sayfanın kendi gönderiminin yaptığı istekte bu adlarla, değiştirmeden göndermenizi ve her gönderim için yeniden çözmenizi söyler. Mock sayfam e-posta ve beş alanla JSON gönderir, bu yüzden submit de aynısını yapar. Sayfanız bir form gönderiyorsa gövdeyi new URLSearchParams ile değiştirin ve content type başlığını bırakın.
/**
* @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)" : ""}`;
}İki başlık önemlidir, çünkü fetch ne Origin ne Referer ekler. İki başlık da kaldırıldığında mock’um altı çözüm harcandıktan sonra altı gönderimin hepsini 403 ve bir csrf hatasıyla yanıtladı. İkisinden yalnızca biriyle onları kabul etti. Bu mock’umun kuralıdır ve sitenizin kendi kuralı vardır; bu yüzden bir toplu işten önce bir deneme gönderimi yapın.
Bir yanıtı asla yeniden kullanmayın. Aynı beş alanı iki kez gönderdiğimde mock’um 200 ve sonra captcha used ile 403 yanıtladı. GeeTest’in kendisinin bir tekrarı kabul edip etmediğini test edemedim.
isOffline bayrağı, GeeTest’in kendisine ulaşılamadığı durum içindir. Belgelere göre widget o zaman challenge olmadan geçirir, yanıt true olarak ayarlı isOffline taşır ve kabul edip etmeyeceğine site kendi sunucusunda karar verir. Kurulum kılavuzu Monitor sekmesindeki bir Offline pass etiketini açıklar ve submit sonuç satırına offline pass sözcüklerini ekler. Her ikinci yanıt çevrimdışıyken, çevrimdışı geçişleri reddeden bir mock site altı tanesinden üçünü aldı, kabul edenler ise altısını da aldı.
5. Adım: Promise.allSettled ile Node.js’te GeeTest v4
Kurulum kılavuzu, CapSkip’in aynı türden görevlerin aynı anda yalnızca Max. Threads ayarının izin verdiği kadarını çözdüğünü söyler. Diğerleri Wait Timeout saniyeye kadar boş bir iş parçacığı bekler ve bu sırada çağrı zaman aşımınız işlemeye devam eder. Aşağıdaki döngü WAVE gönderim yollar, hepsini Promise.allSettled ile bekler ve sonraki dalgayı başlatır. allSettled asla reddetmez, bu yüzden script çıkış kodunu kendisi ayarlar ve describe dört SDK istisna sınıfının her birini tek bir satıra çevirir.
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;Türleri denetleyin, sonra çalıştırın. E-posta başına bir satır yazdırır.
# Check the types, then run the script npx tsc node geetest_v4.mjs
Bu satırlar, Windows 11 üzerinde capskip 1.8.0 ile Node.js 24.22.0 sürümünden alınan, süreç başlangıcından çıkışa zamanlanmış mock sonuçlarıdır. Sayılar 20.11.1 ve 25.2.1 üzerinde eşleşti ve zamanlamalar 0,3 saniye içinde uyuştu.
| Mock ayarı | Script ne yaptı |
|---|---|
| Altı gönderim, çözüm 2 saniye, 3 yuva; WAVE 3, 6 veya 1 | Her durumda altı, 7,7; 5,9 ve 22,9 saniyede; aynı anda en fazla 3, 3 ve 1 görev |
| Çağrı timeout 4, polling_interval 1, çözüm 2 saniye, 3 yuva; WAVE 3 veya 6 | WAVE 3: altı başarılı, 5,7 saniye. WAVE 6: üç başarılı, üç tanesi 4,9 saniyede "timeout 4 exceeded" |
| Çözüm 2 saniye, timeout 3; polling_interval 2 veya 1 | 2: üçü de 3,9 saniyede "timeout 3 exceeded". 1: üçü de başarılı, 2,9 saniye |
| Yanıt asla hazır olmuyor, timeout 5; polling_interval 5, 2 veya 1 | 7,9; 5,9 ve 5,9 saniye sonra TimeoutException |
| Origin ve Referer başlıkları kaldırıldı | Altı çözüm harcandıktan sonra altısı 403 csrf ile reddedildi |
| Aynı beş alan iki kez gönderildi | 200, sonra 403 "captcha used" |
| Her ikinci yanıt çevrimdışı; site çevrimdışı geçişleri reddediyor ya da kabul ediyor | Üç başarılı ve üç reddedilen, ya da altısı da başarılı |
| Yanıt JSON değil ya da lot_number eksik | Altı koruma hatası ve siteye hiçbir istek yok |
| İlk iki görev ERROR_CAPTCHA_UNSOLVABLE ile bitiyor | İki FAIL satırı, dördü başarılı |
Zaman aşımı cömert olduğunda dalgalar zamana mal olur: altı gönderimi aynı anda yapmak 5,9 saniye sürdü, üçlük dalgalar ise 7,7 saniye, çünkü bir dalga sonraki başlamadan önce en yavaş üyesini bekler. Çağrı zaman aşımı sıkı olduğunda işe yararlar, ikinci satırın gösterdiği gibi. 4 saniyelik bir timeout ile, tüm yuvalar doluyken kuyrukta bekleyen üç görevin zamanı doldu. Üçüncü satır kayıp yanıttır: mock onu 2 saniyede hazırlamıştı, ama son yoklama 1,8 saniyede geldi ve sonraki 3,8 saniyede yapılacaktı, yani süre sınırının ötesinde. WAVE değerini CapSkip’teki GeeTest satırının Max. Threads değerinin altında ya da ona eşit tutun.
Yaygın hatalar
Bir satırda görüldü yazmıyorsa, bilginin kaynağı şu CapSkip belgesidir: GeeTest v4 API belgeleri.
| Hata | Neden | Düzeltme |
|---|---|---|
| ValidationException | SDK içinde reddedildi, hiçbir şey gönderilmedi (görüldü, on bir durum) | İletiyi okuyun |
| ERROR_BAD_PARAMETERS | Belgelere göre: captcha_id yok ya da kabul edilmeyen bir proxytype | SDK ikisini de önce reddeder |
| ERROR_PAGEURL | Belgelere göre: sayfa adresi eksik ya da bozuk | Tam sayfa adresini verin |
| ERROR_PROXY_FORMAT | Belgelere göre: CapSkip’in ayrıştıramadığı bir proxy değeri | IP:PORT ya da login:password@IP:PORT kullanın |
| ERROR_CAPTCHA_UNSOLVABLE | Belgelere göre: görev çözülemedi. Mock bunu iki görev için üretti | Başarısız olan e-postaları yeniden çalıştırın |
| ERROR_KEY_DOES_NOT_EXIST | API Key Validation açık. apiKey olmadan SDK capskip anahtarını gönderdi ve mock’um onu reddetti | Anahtarınızı apiKey olarak geçirin |
| TimeoutException | timeout içinde yanıt yok (görüldü) | timeout değerini yükseltin ya da polling_interval değerini düşürün |
| NetworkException | Hiçbir şey dinlemediğinde connect ECONNREFUSED (görüldü) | CapSkip’i başlatın, host ve portu denetleyin |
| Siteden HTTP 403 | Sitenin kendi kuralı: başlıklar, kullanılmış bir yanıt ya da çevrimdışı bir geçiş | Sayfanın kendi isteğiyle karşılaştırın |
FAQ
Script’i CapSkip’ten farklı bir bilgisayarda çalıştırabilir miyim?
Evet. CapSkip’i Server moduna alın ve host seçeneğini onun bilgisayarının adresine ayarlayın; değişen tek satır budur. Kurulum kılavuzu Server modunun yönetici hakları gerektirdiğini not eder. Benim tavsiyem, kurulum kılavuzunun bir iddiası değil: Server modunda portun her adrese açık olduğunu varsayın, beklemediğiniz makineler için bir Windows Güvenlik Duvarı engelleme kuralı ekleyin ve her çağrı bir anahtar taşımak zorunda kalsın diye API Key Validation’ı açın.
Bir çözüm birkaç gönderime yeter mi?
Hayır. Belgeler her gönderim için yeniden çözmenizi söyler ve mock’um bir tekrarı reddetti.
Bu, gt ve challenge veren bir sayfada çalışır mı?
Hayır, o GeeTest v3’tür ve SDK, v4 çağrısında gt ve challenge değerlerini reddeder. O nesil için şunu izleyin: Node.js için GeeTest v3 kılavuzu.
Node.js’te GeeTest v4, çalıştırma başına bir id okumasına, gönderim başına bir çözüme ve kendi adlarıyla kopyalanan beş alana iner. Reddedilen bir gönderim ya da ikinci bir çözüm hiçbir zaman faturaya ulaşmaz, çünkü bu yerel captcha çözücü kendi bilgisayarınızda çalışır. Diğer CAPTCHA türleri için Node.js CAPTCHA çözücü sayfasına göz atın.
