GeeTest v4 di Node.js: Pendaftaran Batch dengan fetch dan Tipe

geetest v4 in node.js - GeeTest v4 in Node.js: Batch Sign-Ups With fetch and Types

Untuk memecahkan GeeTest v4 di Node.js tanpa browser, baca captcha_id dari halaman satu kali, panggil solver.geetestV4() dari paket capskip dengan id itu dan alamat halaman, lalu kirim lima field yang dikembalikannya dengan nama yang sama dalam request yang dibuat halaman itu sendiri. Skrip di bawah melakukannya untuk enam pendaftaran dengan fetch bawaan, satu pemecahan baru per pengiriman, dan diakhiri dengan Promise.allSettled. Task diselesaikan oleh pemecah GeeTest v4 CapSkip di PC Windows Anda sendiri, tanpa biaya per pemecahan.

Apa yang Anda butuhkan

  • Mesin Windows dengan CapSkip 5.0.0 atau versi yang lebih baru, rilis pertama yang memecahkan GeeTest v4 menurut changelog.
  • Node.js 18 atau lebih baru, sesuai yang dinyatakan field engines pada capskip 1.8.0. Itu adalah versi SDK pertama dengan geetestV4(). Pengujian saya mencakup 20.11.1, 24.22.0, dan 25.2.1, jadi saya tidak pernah menjalankan Node.js 18 itu sendiri.
  • TypeScript, tetapi hanya untuk pemeriksaan tipe yang opsional. Saat artikel ini ditulis, npm menyelesaikan typescript 7.0.2, yang menyatakan Node.js 16.20 atau lebih baru, dan @types/node 26.6.6.
  • Halaman pendaftaran atau login dengan widget GeeTest v4 yang boleh Anda otomatisasi.
  • Sebuah alamat untuk CapSkip. Mode Local menjaganya di 127.0.0.1. Mode Server juga menerima koneksi dari jaringan atau IP publik Anda, dan bagian Connection Settings pada panduan penyiapan menjelaskan kedua mode.

Setiap proses di bawah memakai dua server kecil yang saya tulis, satu meniru API CapSkip dan satu meniru halaman pendaftaran, sehingga aturan situsnya adalah buatan saya. Aplikasi CapSkip yang asli tidak merespons di PC ini saat saya menguji, jadi saya tidak mengirim apa pun kepadanya, dan tidak ada situs GeeTest yang melihat request. Jika sebuah klaim bertumpu pada dokumentasi CapSkip, kode sumber SDK, atau dokumentasi GeeTest dan bukan pada sebuah proses, saya menyebutkannya. Situs sungguhan memeriksa kelima field di servernya sendiri, dengan private key-nya, melalui API validasi server GeeTest.

Langkah 1: siapkan folder

Jalankan blok pertama di folder kosong. Blok itu membuat package.json, menginstal capskip, dan menambahkan TypeScript untuk pemeriksaan tipe. Simpan blok tsconfig sebagai tsconfig.json. Lalu simpan keempat blok JavaScript pada Langkah 2 sampai 5, sesuai urutan, sebagai satu file bernama geetest_v4.mjs. Ekstensi .mjs memungkinkan top-level await. Sebelum proses pertama, ubah ORIGIN, kedua path, dan email menjadi milik situs Anda. Jika dibiarkan apa adanya, skrip bertanya ke example.com dan berhenti dengan "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"]
}

Dengan file ini, tsc membaca skrip sebagai JavaScript bertipe. Paket ini menyertakan GeetestV4Options dan SolveResult yang kelima field GeeTest-nya opsional, jadi Langkah 3 memiliki guard.

Langkah 2: baca captcha_id sekali

Halaman meneruskan id ke initGeetest4 sebagai captchaId, dan request ke gcaptcha4.geetest.com/load membawanya sebagai captcha_id, menurut Dokumentasi API GeeTest v4. Id itu sama untuk setiap pengunjung, jadi readCaptchaId menyimpan promise-nya dalam sebuah variabel dan mengambil halaman satu kali per proses, berapa pun pengiriman yang menyusul. Fungsi ini mengumpulkan setiap kecocokan dalam Set dan menolak menebak: dua id yang berbeda, atau tidak ada sama sekali, membuat setiap pengiriman gagal sebelum ada pemecahan yang dibeli. Ia juga menyimpan promise yang ditolak, jadi satu timeout halaman menggagalkan seluruh proses.

// @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;
}

Pada halaman mock saya, id terbaca dengan benar ketika halaman menulisnya dengan tanda kutip ganda, dengan tanda kutip tunggal dan kunci di barisnya sendiri, sebagai kunci berkutip dalam objek bergaya JSON, dan di URL load. Halaman dengan id lama yang tertinggal di komentar di samping yang asli berhenti dengan "found 2", dan halaman yang skripnya membangun id di tempat lain berhenti dengan "found 0". Polanya mengharapkan 32 karakter heksadesimal, seperti id pada dokumentasi.

Langkah 3: minta lima field dengan opsi bertipe

Pemanggilannya adalah solver.geetestV4(captchaId, url, options). Ia mengirim task, melakukan polling untuk hasilnya, dan di-resolve menjadi sebuah objek. Dokumentasi API menyatakan res.php mengirim lima nilai sebagai satu string JSON di field request-nya, itulah sebabnya code berupa string: SDK mengurainya untuk kedua kalinya dan menyalin captcha_id, lot_number, pass_token, gen_time, dan captcha_output ke hasil, ditambah isOffline ketika GeeTest tidak dapat dijangkau. Menurut kode sumber SDK, string yang tidak dapat diurai membuat hasil tidak diperluas dan tidak memunculkan error, jadi fiveFields melempar exception kecuali kelimanya ada.

/** @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);
}

Dua nama terlihat mirip. captcha_id adalah id widget yang digemakan kembali GeeTest, dan itulah yang harus dikirim. captchaId adalah id yang diberikan CapSkip pada task. Hasilnya membawa keduanya, dan contoh SDK mencetak captchaId dengan label Captcha ID. Pada mock saya id task-nya 102, dan mengirimnya sebagai captcha_id ditolak.

Dokumentasi mencantumkan sepuluh nilai untuk riskType: slide, icon, nine, word, phrase, match, winlinze, svg_seed, svg_icon, dan ai. GeeTest hanya menerapkan salah satunya jika situs mengizinkan, dan pilihan situs sendiri biasanya yang menang, jadi saya tidak dapat menguji efeknya. Definisi SDK sendiri mengetikkan riskType sebagai string biasa, dan saat runtime SDK hanya memeriksa bahwa nilainya string, sehingga salah ketik terus berjalan: mock saya menerima risk_type slid tanpa perubahan. Typedef RiskType menangkapnya, dan tsc menolak pemanggilan itu dengan error TS2345. Typedef itu tidak dapat menangkap nama opsi yang salah eja, karena tipe options mengizinkan kunci lain. Opsi bernama risktype berhasil dikompilasi, lalu SDK menolaknya saat runtime sebagai parameter yang tidak didukung.

Opsi timeout dan polling_interval dalam hitungan detik. Tanpa timeout, default klien 300 detik berlaku, dan SDK tidak menerima AbortSignal, jadi atur timeout alih-alih beradu dengan signal: polling berhenti bersamanya. SDK memeriksa batas waktu hanya ketika polling berikutnya jatuh tempo. Terhadap mock yang tidak pernah menjawab, timeout 5 berakhir setelah 7.9 detik dengan interval default 5, dan setelah 5.9 dengan polling_interval 2. Timeout yang terlalu ketat juga dapat menghilangkan jawaban yang sudah selesai, seperti yang ditunjukkan tabel di bawah. Sisakan ruang untuk pemecahan ditambah satu interval. AsyncCapSkip adalah class yang sama dengan nama lain, karena setiap metode sudah mengembalikan promise.

Opsi proxy menerima string atau objek dengan type dan uri. Dengan string, proxytype default ke HTTP, dan mock saya melihat bentuk objek sampai sebagai nilai proxy ditambah proxytype SOCKS5. Opsi itu hanya berlaku pada pemecahan CapSkip, dan panggilan fetch saya tidak memakainya. Dokumentasi CapSkip menyarankan pool proxy untuk pemecahan yang lebih dari sesekali. Saya tidak menguji proxy sungguhan.

Sebelas kesalahan ditolak oleh SDK dengan ValidationException sebelum apa pun sampai ke in.php mock saya: tanpa captcha id, alamat halaman yang hilang, relatif, atau ftp, parameter v3 gt dan challenge, opsi userAgent, nama opsi yang tidak dikenal, angka sebagai riskType, proxytype SOCKS4, dan objek proxy tanpa uri. Penolakan userAgent perlu diketahui, karena metode MTCaptcha dan Yandex SmartCaptcha menerimanya sedangkan GeeTest v4 tidak. Dokumentasi menyatakan aplikasi menjawab ERROR_BAD_PARAMETERS untuk captcha_id yang hilang atau proxytype yang tidak didukung dan ERROR_PAGEURL untuk alamat halaman yang hilang atau salah format. Untuk penolakan lainnya dokumentasi tidak menyebut apa-apa, dan SDK menghentikannya lebih dulu.

Langkah 4: kirim lima field sebagai JSON

Dokumentasi CapSkip menyatakan untuk mengirim field dengan nama tersebut dalam request yang dibuat submit bawaan halaman, tanpa perubahan, dan memecahkan lagi untuk setiap pengiriman. Halaman mock saya mengirim JSON berisi email dan kelima field, jadi submit melakukan hal yang sama. Jika halaman Anda mengirim formulir, ganti isinya dengan new URLSearchParams dan buang header content type.

/**
 * @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)" : ""}`;
}

Kedua header itu penting karena fetch tidak menambahkan Origin maupun Referer. Dengan kedua header dihapus, mock saya menjawab keenam pengiriman dengan 403 dan error csrf, setelah enam pemecahan terpakai. Dengan hanya salah satu dari keduanya, mock menerimanya. Itu aturan mock saya dan situs Anda punya aturannya sendiri, jadi kirim satu pengiriman percobaan sebelum batch.

Jangan pernah memakai ulang sebuah jawaban. Ketika saya mengirim kelima field yang sama dua kali, mock saya menjawab 200 lalu 403 dengan captcha used. Apakah GeeTest sendiri menerima pengulangan, saya tidak dapat mengujinya.

Flag isOffline untuk kasus ketika GeeTest sendiri tidak dapat dijangkau. Dokumentasi menyatakan widget kemudian meloloskan tanpa challenge, jawabannya membawa isOffline bernilai true, dan situs memutuskan di servernya apakah akan menerimanya. Panduan penyiapan menjelaskan label Offline pass di tab Monitor, dan submit menambahkan kata offline pass pada baris hasilnya. Dengan setiap jawaban kedua bersifat offline, situs mock yang menolak pass offline menerima tiga dari enam, dan yang menerimanya menerima keenamnya.

Langkah 5: GeeTest v4 di Node.js dengan Promise.allSettled

Panduan penyiapan menyatakan CapSkip memecahkan task satu tipe sekaligus hanya sebanyak yang diizinkan pengaturan Max. Threads-nya. Yang lain menunggu thread bebas hingga Wait Timeout detik, dan timeout panggilan Anda tetap berjalan selama itu. Loop di bawah mengirim WAVE pengiriman, menunggu semuanya dengan Promise.allSettled, dan memulai gelombang berikutnya. allSettled tidak pernah menolak, jadi skrip mengatur exit code sendiri, dan describe mengubah masing-masing dari empat class exception SDK menjadi satu baris.

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;

Periksa tipenya, lalu jalankan. Skrip mencetak satu baris per email.

# Check the types, then run the script
npx tsc
node geetest_v4.mjs

Baris-baris ini adalah hasil mock dari Node.js 24.22.0 di Windows 11 dengan capskip 1.8.0, diukur dari awal proses sampai keluar. Jumlahnya sama pada 20.11.1 dan 25.2.1, dan waktunya sesuai dalam selisih 0.3 detik.

Pengaturan mockYang dilakukan skrip
Enam pengiriman, pemecahan 2 detik, 3 slot; WAVE 3, 6, atau 1Enam dalam setiap kasus, dalam 7.7, 5.9, dan 22.9 detik; paling banyak 3, 3, dan 1 task sekaligus
Timeout panggilan 4, polling_interval 1, pemecahan 2 detik, 3 slot; WAVE 3 atau 6WAVE 3: enam berhasil, 5.7 detik. WAVE 6: tiga berhasil, tiga "timeout 4 exceeded" pada 4.9
Pemecahan 2 detik, timeout 3; polling_interval 2 atau 12: ketiganya "timeout 3 exceeded" pada 3.9 detik. 1: ketiganya berhasil, 2.9 detik
Jawaban tidak pernah siap, timeout 5; polling_interval 5, 2, atau 1TimeoutException setelah 7.9, 5.9, dan 5.9 detik
Header Origin dan Referer dihapusEnam ditolak dengan 403 csrf, setelah enam pemecahan terpakai
Lima field yang sama dikirim dua kali200, lalu 403 "captcha used"
Setiap jawaban kedua bersifat offline; situs menolak atau menerima pass offlineTiga berhasil dan tiga ditolak, atau keenamnya berhasil
Jawabannya bukan JSON, atau lot_number hilangEnam error guard dan tidak ada request ke situs
Dua task pertama berakhir dengan ERROR_CAPTCHA_UNSOLVABLEDua baris FAIL, empat berhasil

Gelombang memakan waktu ketika timeout longgar: enam pengiriman sekaligus memakan 5.9 detik berbanding 7.7 untuk gelombang berisi tiga, karena sebuah gelombang menunggu anggotanya yang paling lambat sebelum gelombang berikutnya dimulai. Gelombang berguna ketika timeout panggilan ketat, seperti ditunjukkan baris kedua. Dengan timeout 4 detik, tiga task yang mengantre di belakang slot penuh kehabisan waktu. Baris ketiga adalah jawaban yang hilang: mock menyiapkannya pada 2 detik, tetapi polling terakhir datang pada 1.8 detik dan berikutnya jatuh tempo pada 3.8, melewati batas waktu. Jaga WAVE sama dengan atau di bawah nilai Max. Threads pada baris GeeTest di CapSkip.

Kesalahan umum

Kecuali sebuah baris menyatakan terlihat, informasinya berasal dari Dokumentasi API GeeTest v4.

KesalahanPenyebabPerbaiki
ValidationExceptionDitolak di dalam SDK, tidak ada yang dikirim (terlihat, sebelas kasus)Baca pesannya
ERROR_BAD_PARAMETERSMenurut dokumentasi: tanpa captcha_id, atau proxytype yang tidak diterimaSDK menolak keduanya lebih dulu
ERROR_PAGEURLMenurut dokumentasi: alamat halaman hilang atau salah formatBerikan alamat halaman lengkap
ERROR_PROXY_FORMATMenurut dokumentasi: nilai proxy yang tidak dapat diurai CapSkipGunakan IP:PORT atau login:password@IP:PORT
ERROR_CAPTCHA_UNSOLVABLEMenurut dokumentasi: task tidak dapat dipecahkan. Mock saya menghasilkannya untuk dua taskJalankan ulang email yang gagal
ERROR_KEY_DOES_NOT_EXISTAPI Key Validation aktif. Tanpa apiKey, SDK mengirim kunci capskip, dan mock saya menolaknyaTeruskan key Anda sebagai apiKey
TimeoutExceptionTidak ada jawaban dalam timeout (terlihat)Naikkan timeout atau turunkan polling_interval
NetworkExceptionconnect ECONNREFUSED ketika tidak ada yang mendengarkan (terlihat)Jalankan CapSkip, periksa host dan port
HTTP 403 dari situsAturan situs itu sendiri: header, jawaban yang sudah dipakai, atau pass offlineBandingkan dengan request bawaan halaman

FAQ

Bisakah skrip dijalankan di PC yang berbeda dari CapSkip?

Bisa. Jalankan CapSkip dalam mode Server dan atur opsi host ke alamat PC-nya, yang menjadi satu-satunya baris yang berubah. Panduan penyiapan mencatat bahwa mode Server membutuhkan hak administrator. Saran saya, bukan klaim panduan penyiapan: anggap port terbuka ke semua alamat dalam mode Server, tambahkan aturan block Windows Firewall untuk mesin yang tidak Anda harapkan, dan aktifkan API Key Validation agar setiap panggilan harus membawa kunci.

Bisakah satu pemecahan melayani beberapa pengiriman?

Tidak. Dokumentasi menyatakan untuk memecahkan lagi pada setiap pengiriman, dan mock saya menolak pengulangan.

Apakah ini berfungsi pada halaman yang memberikan gt dan challenge?

Tidak, itu GeeTest v3, dan SDK menolak gt dan challenge dalam panggilan v4. Untuk generasi itu, ikuti panduan GeeTest v3 untuk Node.js.

GeeTest v4 di Node.js intinya satu id yang dibaca per proses, satu pemecahan per pengiriman, dan lima field yang disalin dengan nama aslinya. Pengiriman yang ditolak atau pemecahan kedua tidak pernah masuk ke tagihan, karena pemecah captcha lokal berjalan di PC Anda sendiri. Lihat halaman pemecah CAPTCHA Node.js untuk tipe CAPTCHA lainnya.