GeeTest v4 di Python: Baca ID Sekali, Pecahkan di Setiap POST

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

GeeTest v4 di Python intinya satu id dan satu panggilan untuk setiap POST formulir. Baca captcha_id dari halaman satu kali saja, minta pass dari solver.geetest_v4() milik SDK CapSkip, lalu kirim kembali lima nilai yang dikembalikannya, yaitu captcha_id, lot_number, pass_token, gen_time, dan captcha_output, dengan nama yang sama persis. Pemecahannya dikerjakan oleh pemecah GeeTest v4 CapSkip di PC Windows Anda sendiri dengan lisensi tetap, jadi pass yang ditolak hanya berarti satu pemecahan lagi tanpa biaya tambahan. Tidak ada yang perlu diambil sebelum setiap percobaan, dan itulah perbedaannya dengan pasangan gt dan challenge pada alur GeeTest v3.

Yang Anda butuhkan sebelum memecahkan GeeTest v4

  • CapSkip 5.0.0 atau lebih baru di Windows (changelog mencantumkan pemecahan GeeTest v4 di sana, 14 November 2026) dan SDK Python 1.8.0 atau lebih baru (16 November 2026). Untuk detail request-nya, lihat bagian GeeTest v4 pada dokumentasi API yang menjelaskan request-nya.
  • Python 3.10 atau lebih baru, batas minimum yang dinyatakan oleh capskip 1.8.0 dan requests 2.34.2. Versi yang saya jalankan adalah Python 3.11.7, 3.13.7, dan 3.14.0 di Windows 11. Instal kedua paket dengan python -m pip install capskip requests. Paket capskip juga menginstal httpx dan aiofiles, yang hanya dipakai oleh klien async.
  • Sebuah alamat untuk CapSkip. Mode Local (127.0.0.1) hanya bisa dijangkau dari PC yang menjalankannya. Pada mode Server, CapSkip mendengarkan di jaringan atau IP publik Anda, sehingga skrip di mesin lain bisa mengaksesnya. Bagian pengaturan koneksi pada panduan penyiapan menunjukkan tempat mengganti modenya.

Saya menguji dengan dua server mock buatan saya sendiri, satu sebagai pengganti CapSkip dan satu lagi sebagai pengganti situs dengan formulir komentar. Tidak ada pemecahan sungguhan yang terjadi, jadi saya tidak punya waktu pemecahan nyata untuk diberikan, dan setiap aturan situs di mock adalah buatan saya. Di situs sungguhan, backend meneruskan kelima nilai itu ke GeeTest dengan tanda tangan dari private key-nya, seperti yang dijelaskan dalam referensi API server GeeTest tersebut. Mock tidak dapat membuktikan bahwa backend sungguhan menerima apa pun.

Langkah 1: temukan captcha_id di halaman

Simpan blok pertama sebagai comment_geetest.py dan tambahkan setiap blok berikutnya di bagian akhir, secara berurutan. File selesai setelah Langkah 3. Arahkan PAGE_URL ke halaman yang menampilkan widget. Pada mode Server, isi host dengan alamat mesin 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 bersifat publik dan sama untuk setiap pengunjung, jadi Anda membacanya sekali lalu memakainya kembali. Halaman meneruskannya ke initGeetest4 sebagai opsi captchaId, dan skrip widget juga mengirimnya sebagai parameter query captcha_id pada request-nya ke gcaptcha4.geetest.com/load. Halaman CapSkip GeeTest v4 menyebut id sepanjang 32 karakter, tetapi SDK tidak memeriksa format apa pun, sehingga polanya menerima karakter kata atau tanda hubung apa saja. Pola itu mencari opsi berdasarkan namanya, bukan mengurai pemanggilannya, sehingga tetap bekerja pada struktur bersarang, tanda kutip tunggal, dan urutan kunci yang berbeda.

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)

Saya menjalankan read_captcha_id pada enam halaman mock: id dalam tanda kutip ganda, dalam tanda kutip tunggal di antara opsi lain, dalam objek bersarang dengan kunci berkutip yang bukan yang pertama, dalam sebuah variabel dengan kunci di posisi terakhir, hanya di alamat load, dan tidak ada sama sekali karena sebuah skrip membangun pemanggilan itu saat runtime. Untuk kasus terakhir, buka tab Network browser satu kali, filter dengan gcaptcha4, lalu salin captcha_id dari request load. Saya tidak menjalankan fungsi ini pada situs sungguhan.

Langkah 2: minta pass dengan geetest_v4()

Signature metodenya adalah solver.geetest_v4(captcha_id, url, **options). SDK mengirim task, terus melakukan polling sampai jawabannya siap, lalu mengembalikan sebuah dictionary, jadi Anda tidak perlu menulis loop tunggu. url adalah alamat lengkap halaman tempat widget berada. Blok di bawah ini hanya menyimpan lima field untuk formulir, dan menambahkan risk_type hanya jika Anda mengaturnya.

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 itu menyimpan lima nilai sebagai kunci yang terpisah. Ia juga menyimpan captchaId, yaitu nomor yang diberikan CapSkip pada task, yang bukan id widget: formulir membutuhkan captcha_id dengan garis bawah. Kunci code menyimpan string JSON mentah, yang menurut dokumentasi API adalah cara res.php mengemas kelima nilai itu. SDK mengurainya untuk Anda, dan pada mock saya yang mengikuti dokumentasi, code berupa string yang bisa diurai menjadi lima nilai. Kirim field yang terpisah, bukan code.

Ketika GeeTest tidak dapat dijangkau, widget-nya meloloskan pengunjung dalam mode offline dan dictionary juga membawa isOffline bernilai True. Jika tidak, kunci itu tidak ada. Fungsi pick mencetak catatan dan tetap mengembalikan kelima field, karena situslah yang memutuskan apakah akan menerima pass offline.

Opsi risk_type ditujukan untuk situs yang membiarkan pemanggil memilih challenge. Nilainya, menurut dokumentasi API, adalah slide, icon, nine, word, phrase, match, winlinze, svg_seed, svg_icon, dan ai, dan GeeTest hanya menerapkan salah satunya jika situs mengizinkan, jadi jangan sertakan jika tidak perlu. SDK hanya memeriksa bahwa nilainya berupa string: slide dan nine sampai ke mock tanpa perubahan, riskType diganti namanya menjadi risk_type, dan nilai karangan seperti risk_type=bogus juga ikut terkirim.

Sebelum apa pun dikirim, SDK memunculkan ValidationException untuk captcha_id yang hilang, kosong, atau bukan string, alamat halaman yang kosong atau bukan URL http atau https absolut, risk_type yang bukan string, riskType dan risk_type dengan nilai berbeda, serta opsi apa pun yang tidak diterima API. Itu termasuk userAgent, yang diterima oleh metode hCaptcha dan MTCaptcha tetapi tidak oleh metode ini, serta nama v3 gt dan challenge. Terhadap port tanpa server, masing-masing memunculkan pengecualian dalam waktu jauh di bawah seperseratus detik. Dokumentasi API memberikan ERROR_PAGEURL dan ERROR_BAD_PARAMETERS untuk kesalahan yang sama, jadi pemanggil in.php mentah melihat kode itu di tempat Anda melihat sebuah exception.

Metode geetest_v4() menjalankan browser sungguhan di dalam CapSkip, sehingga SDK memberinya recaptchaTimeout, 300 detik secara default, bukan defaultTimeout. Saya memeriksa keduanya. Dengan defaultTimeout 3 detik dan mock yang tidak pernah menjawab, pemanggilan masih melakukan polling setelah 9 detik. Dengan recaptchaTimeout 3, TimeoutException muncul setelah 3.76 detik, karena SDK bertanya pada detik 0, 0.25, 0.76, dan 1.76, tidur 2 detik lagi, dan baru kemudian memeriksa batas waktunya. Jadwal yang sama juga menunda keberhasilan: pass yang siap setelah 1 detik kembali pada 1.76, yang siap setelah 2 detik pada 3.76, dan yang siap setelah 6 detik pada 7.76. Ini adalah Python 3.14.0, capskip 1.8.0, dan polling default, terhadap mock. Halaman CapSkip GeeTest v4 menyebut 1 sampai 4 detik untuk pass satu klik dan sekitar 15 sampai 20 untuk slide, jadi sesuaikan recaptchaTimeout dengan tipe paling lambat yang mungkin ditampilkan situs Anda.

Langkah 3: kirim kelima nilai, lalu pecahkan lagi untuk POST berikutnya

Kirim kelima nilai dengan nama di atas, bersama field Anda sendiri, dan bandingkan dengan yang dikirim submit bawaan halaman di tab Network. Fungsi ini juga mengirim halaman sebagai Referer. Library requests tidak menambahkan Referer maupun Origin, dan beberapa framework menolak POST formulir HTTPS yang tidak memiliki keduanya, seperti yang dilakukan mock saya dengan 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,
    )

Pecahkan lagi untuk setiap POST formulir. Dokumentasi API menyatakan demikian, dan mock saya mengikutinya: ia menolak POST kedua dengan kelima nilai yang sama karena sudah dipakai, dan menolak pass yang dikirim 3 detik setelah pemecahan ketika masa berlakunya diatur 2 detik. Karena itu loop meminta pass di dalam loop komentar, sedangkan captcha_id berasal dari open_session satu kali. Loop meminta pemecahan baru hanya pada ERROR_CAPTCHA_UNSOLVABLE atau ketika situs menyatakan pemeriksaan captcha gagal. ApiException lainnya akan dimunculkan, karena kunci yang salah akan gagal dengan cara yang sama lagi.

Uji penolakannya berupa frasa utuh dari situs Anda, di sini captcha check failed. Uji pada kata captcha saja cocok dengan halaman komentar yang ditampilkan kembali setelah komentar kosong, yang masih memuat markup widget, dan menghabiskan tiga task untuk kesalahan yang tidak berkaitan dengan captcha. Frasa yang lebih pendek check failed cocok dengan halaman 403 dari pemeriksaan Referer.

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")

Jalankan dengan python comment_geetest.py (py comment_geetest.py juga bisa). Terhadap mock, skrip berperilaku sama pada Python 3.11.7, 3.13.7, dan 3.14.0:

Pengaturan mockApa yang terjadi
Tiga komentar, pengaturan defaultTiga task dengan captcha_id yang sama, tiga POST diterima
Dengan POST tulisan tangan: lima nilai yang sama dikirim dua kaliPOST kedua ditolak karena sudah dipakai
Dengan POST tulisan tangan: pass dikirim 3 detik setelah pemecahan, masa berlaku mock 2 detikDitolak karena terlalu lama, dan pemecahan baru berikutnya berhasil
Dua jawaban unsolvable di awalDua kali percobaan ulang, dan pass dari task ketiga diterima
Tiga jawaban unsolvable berturut-turutRuntimeError setelah tiga task terpakai
Pass offline, situs menerimanyaCatatan dicetak, POST diterima setelah satu task
Pass offline, situs menolaknyaTiga task, lalu RuntimeError
Komentar kosong, halaman ditampilkan kembali dengan markup widgetRuntimeError setelah satu task. Dengan kata captcha saja sebagai ujinya, tiga task
POST formulir tanpa header Referer403, RuntimeError setelah satu task
Validasi kunci aktif, kunci default SDKApiException setelah satu task. Dengan apiKey yang benar, diterima

Bacalah tabel ini sebagai uji terhadap mock dan skrip saya, bukan terhadap GeeTest. Dokumentasi menyarankan untuk mengirim dengan segera dan memecahkan lagi untuk setiap POST formulir. Pemakaian sekali dan masa berlaku dua detik adalah aturan mock saya.

Beberapa POST sekaligus dengan AsyncCapSkip

Klien async berguna karena satu alasan: sebuah pass butuh beberapa detik, dan tiga pass bisa diminta bersamaan. AsyncCapSkip dibangun di atas httpx, jadi asyncio.gather membuat pemecahan berjalan tumpang tindih sementara POST formulir tetap memakai requests biasa. Dengan mock yang membutuhkan 3.0 detik per pass, tiga POST membutuhkan 11.35 detik jika pemecahan dilakukan satu per satu dan 4.09 detik jika dibuat tumpang tindih, pada Python 3.14.0, dengan tiga task terbuka bersamaan di mock.

Port 8080 di kedua blok adalah default layanan bergaya 2captcha, jadi gunakan port yang tertera di pengaturan CapSkip. Untuk pola pool yang lebih besar, lihat artikel tentang memecahkan captcha secara paralel dengan Python. Ganti blok utama dari Langkah 3 dengan yang di bawah ini. Pemecahan yang gagal menjadi None di solve_all dan submit_all meminta lagi dengan satu panggilan, jadi kunci yang salah tetap berakhir dengan ApiException yang sama. Minta pass sebanyak yang bisa Anda kirim selagi masih segar, dan bagi daftar yang panjang menjadi beberapa batch.

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")

Kesalahan umum

Kode CapSkip berasal dari dokumentasi API, baris exception dari kode sumber SDK, dan baris terakhir adalah pembacaan saya atas baris dokumentasi untuk memecahkan lagi pada setiap pengiriman formulir.

KesalahanPenyebabPerbaiki
ValidationExceptionSDK menolak argumen di mesin Anda tanpa menghubungi CapSkip, karena salah satu alasan di Langkah 2Teks exception menunjuk argumen yang bermasalah
ERROR_CAPTCHA_UNSOLVABLEPass tidak dapat diperoleh untuk task ituKirim task baru, seperti yang dilakukan submit_all hingga tiga kali percobaan. Dokumentasi menyebut aplikasi dapat mengembalikan teks pengganti yang diatur di Settings, jadi cocokkan dengan teks itu jika Anda mengubahnya
ERROR_KEY_DOES_NOT_EXIST atau ERROR_WRONG_USER_KEYAplikasi memeriksa kunci (API Key Validation) dan kunci Anda tidak ada atau salah. Panggilan tanpa apiKey memakai kunci capskip, yang dijawab mock dengan kode pertamaBerikan kunci asli Anda sebagai apiKey ke CapSkip()
ERROR_PROXY_FORMATDokumentasi mencantumkannya untuk nilai proxy yang tidak dapat dibaca CapSkip, dan meminta agar tidak memakai awalan skema. SDK mengirim nilai berawalan tanpa mengubahnyaTulis login:password@IP:PORT tanpa http://
NetworkExceptionTidak ada jawaban dari host dan port itu saat task dikirim, yang saya lihat setelah sekitar 2 detik di Windows. Server yang diam di tengah polling menghasilkan TimeoutExceptionPastikan CapSkip terbuka dan host serta port cocok dengan pengaturan koneksi
TimeoutExceptionTidak ada pass yang datang dalam recaptchaTimeout, 300 detik kecuali Anda menetapkan nilai lainLihat task di aplikasi CapSkip dan jalankan skripnya lagi
Situs menyatakan pemeriksaan captcha gagalDugaan saya, bukan daftar yang didokumentasikan: kelima nilai pernah dipakai, sudah terlalu lama, atau diubahKirim setiap set sekali saja dan segera, tanpa perubahan, dengan halaman sebagai Referer

FAQ

Bisakah saya memanggil CapSkip dari komputer lain?

Bisa, melalui mode Server. Aktifkan di pengaturan koneksi PC CapSkip, lalu berikan alamat PC itu sebagai host ke CapSkip(), ditambah kunci Anda sebagai apiKey jika API Key Validation aktif. Mode Server membuka port CapSkip ke semua alamat saat dimulai, jadi aturan block Windows Firewall untuk mesin yang tidak Anda percayai itulah yang menahan pihak lain. Aturan allow tambahan tidak akan mengubah apa pun. Itu tetap mesin Windows milik Anda sendiri, dan tetap tanpa meteran.

Apakah saya butuh proxy untuk GeeTest v4?

Tidak untuk memulai. Dokumentasi API menyebut satu alamat sudah cukup untuk pengujian, dan menyatakan bahwa aliran stabil dari satu alamat adalah sasaran pembatasan laju GeeTest. Untuk volume besar, muat pool proxy di aplikasi, atau berikan proxy tersendiri pada sebuah task, yang diutamakan dibanding pool. Lihat artikel tentang proxy untuk pemecah captcha yang membahas cara memilihnya. Di Python, opsinya berupa dictionary, proxy={"type": "HTTP", "uri": "login:password@IP:PORT"}, atau string biasa dengan proxytype di sampingnya. Kedua bentuk itu sampai ke mock sebagai field proxy dan proxytype.

Bagaimana jika halaman memberi saya gt dan challenge?

Berarti situs itu memakai GeeTest v3, yang membutuhkan challenge baru untuk setiap percobaan dan mengembalikan challenge, validate, dan seccode. Alur itu dibahas di artikel tentang GeeTest v3 di Python.

Versi singkatnya

GeeTest v4 di Python adalah satu captcha_id yang dibaca sekali, satu pemecahan untuk setiap POST formulir, dan lima field yang dikirim kembali tanpa diubah. Karena CapSkip adalah pemecah captcha tanpa batas yang berjalan di PC Anda sendiri, pemecahan berulang tidak menambah tagihan apa pun. Lihat Halaman pemecah CAPTCHA Python untuk panggilan SDK tipe lainnya.