GeeTest v4 in Python: die ID einmal lesen, jeden POST lösen

GeeTest v4 in Python läuft auf eine ID und einen Aufruf pro Formular-POST hinaus. Lesen Sie die captcha_id einmal von der Seite ab, fordern Sie mit solver.geetest_v4() aus dem CapSkip-SDK eine Freigabe an und senden Sie die fünf zurückgegebenen Werte, captcha_id, lot_number, pass_token, gen_time und captcha_output, unter denselben Namen zurück. Der CapSkip-GeeTest-v4-Löser übernimmt das Lösen auf Ihrem eigenen Windows-PC mit einer Pauschallizenz, daher kostet eine abgelehnte Freigabe nur eine weitere Lösung und keine Zusatzgebühr. Vor jedem Versuch muss nichts abgerufen werden, anders als beim Paar aus gt und challenge in dem GeeTest-v3-Ablauf.
Was Sie brauchen, bevor Sie GeeTest v4 lösen
- CapSkip 5.0.0 oder neuer unter Windows (das Changelog führt dort das Lösen von GeeTest v4 auf, 14. November 2026) und Python SDK 1.8.0 oder neuer (16. November 2026). Die GeeTest-v4-Sektion der API-Dokumentation beschreibt die Anfrage.
- Python 3.10 oder neuer, die von capskip 1.8.0 und requests 2.34.2 deklarierte Untergrenze. Ich habe Python 3.11.7, 3.13.7 und 3.14.0 unter Windows 11 verwendet. Installieren Sie beide Pakete mit python -m pip install capskip requests. Das Paket capskip installiert außerdem httpx und aiofiles, die nur der Async-Client nutzt.
- Eine Adresse für CapSkip. Local mode (127.0.0.1) ist nur von dem PC aus erreichbar, auf dem es läuft. Im Server mode lauscht es stattdessen auf Ihrem Netzwerk oder Ihrer öffentlichen IP, sodass Skripte auf anderen Rechnern es erreichen können. Der Abschnitt Verbindungseinstellungen der Einrichtungsanleitung zeigt, wo der Modus umgeschaltet wird.
Ich habe mit zwei eigenen Mock-Servern getestet, einem Ersatz für CapSkip und einem Ersatz für eine Website mit Kommentarformular. Es fand keine echte Lösung statt, daher kann ich keine echte Lösungszeit nennen, und jede Website-Regel im Mock stammt von mir. Auf einer echten Website leitet das Backend die fünf Werte mit einer Signatur seines privaten Schlüssels an GeeTest weiter, wie die GeeTest-Server-API-Referenz beschreibt. Ein Mock kann nicht zeigen, dass ein echtes Backend irgendetwas akzeptiert.
Schritt 1: die captcha_id auf der Seite finden
Speichern Sie den ersten Block als comment_geetest.py und hängen Sie jeden weiteren Block der Reihe nach ans Ende an. Die Datei ist nach Schritt 3 fertig. Setzen Sie PAGE_URL auf die Seite, die das Widget zeigt. Tragen Sie im Server mode die Adresse des CapSkip-Rechners in host ein.
# 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)Die captcha_id ist öffentlich und für jeden Besucher gleich, Sie lesen sie also einmal und verwenden sie wieder. Die Seite übergibt sie als Option captchaId an initGeetest4, und das Widget-Skript sendet sie außerdem als Query-Parameter captcha_id in seiner Anfrage an gcaptcha4.geetest.com/load. Die CapSkip-GeeTest-v4-Seite beschreibt eine ID mit 32 Zeichen, aber das SDK prüft kein Format, daher akzeptiert das Muster beliebige Wortzeichen oder Bindestriche. Es sucht die Option nach ihrem Namen, statt den Aufruf zu parsen, was Verschachtelung, einfache Anführungszeichen und eine andere Reihenfolge der Schlüssel übersteht.
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)Ich habe read_captcha_id auf sechs Mock-Seiten ausgeführt: die ID in doppelten Anführungszeichen, in einfachen Anführungszeichen zwischen anderen Optionen, in einem verschachtelten Objekt mit einem Schlüssel in Anführungszeichen, der nicht an erster Stelle stand, in einer Variablen mit dem Schlüssel am Ende, nur in einer Load-Adresse und nirgends, weil ein Skript den Aufruf zur Laufzeit zusammenbaut. Öffnen Sie für diesen Fall einmal den Network-Tab des Browsers, filtern Sie nach gcaptcha4 und kopieren Sie die captcha_id aus der Load-Anfrage. Ich habe die Funktion nicht gegen eine echte Website ausgeführt.
Schritt 2: mit geetest_v4() eine Freigabe anfordern
Die Signatur der Methode lautet solver.geetest_v4(captcha_id, url, **options). Das SDK sendet die Aufgabe, fragt so lange ab, bis die Antwort bereit ist, und gibt ein Dictionary zurück, eine Warteschleife ist also nicht nötig. Die url ist die vollständige Adresse der Seite, auf der das Widget sitzt. Der folgende Block behält nur die fünf Felder für das Formular und fügt risk_type nur hinzu, wenn Sie es setzen.
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))Das Dictionary enthält die fünf Werte als einzelne Schlüssel. Es enthält außerdem captchaId, die Nummer, die CapSkip der Aufgabe gegeben hat, und die ist nicht die Widget-ID: Das Formular will captcha_id mit Unterstrich. Der Schlüssel code enthält den rohen JSON-String, in dem res.php laut API-Dokumentation die fünf Werte verpackt. Das SDK parst ihn für Sie, und gegen meinen Mock, der der Dokumentation folgt, war code ein String, der zu den fünf Werten geparst wurde. Senden Sie die einzelnen Felder, nicht code.
Wenn GeeTest nicht erreichbar ist, lässt sein Widget den Besucher im Offline-Modus durch, und das Dictionary enthält zusätzlich isOffline mit dem Wert True. Sonst fehlt der Schlüssel. Die Funktion pick gibt einen Hinweis aus und liefert trotzdem die fünf Felder zurück, weil die Website entscheidet, ob sie eine Offline-Freigabe akzeptiert.
Die Option risk_type ist für Websites gedacht, die den Aufrufer eine Challenge wählen lassen. Die Werte laut API-Dokumentation sind slide, icon, nine, word, phrase, match, winlinze, svg_seed, svg_icon und ai, und GeeTest wendet einen nur dort an, wo die Website es erlaubt, lassen Sie sie also sonst weg. Das SDK prüft nur, ob es ein String ist: slide und nine kamen unverändert beim Mock an, riskType wurde in risk_type umbenannt, und ein erfundener Wert wie risk_type=bogus wurde ebenfalls gesendet.
Bevor etwas gesendet wird, wirft das SDK eine ValidationException bei einer fehlenden, leeren oder nicht als String übergebenen captcha_id, bei einer Seitenadresse, die leer oder keine absolute http- oder https-URL ist, bei einem risk_type, der kein String ist, bei riskType und risk_type mit unterschiedlichen Werten und bei jeder Option, die die API nicht kennt. Dazu gehört userAgent, das die Methoden für hCaptcha und MTCaptcha akzeptieren, diese hier aber nicht, sowie die v3-Namen gt und challenge. Gegen einen Port ohne Server lösten diese Fälle jeweils in weit unter einer hundertstel Sekunde aus. Die API-Dokumentation nennt für dieselben Fehler ERROR_PAGEURL und ERROR_BAD_PARAMETERS, ein Aufrufer des rohen in.php sieht also diese Codes, wo Sie eine Exception sehen.
Die Methode geetest_v4() lässt in CapSkip einen echten Browser laufen, daher gibt das SDK ihr recaptchaTimeout, standardmäßig 300 Sekunden, und nicht defaultTimeout. Ich habe beides geprüft. Mit defaultTimeout von 3 Sekunden und einem Mock, der nie antwortete, fragte der Aufruf nach 9 Sekunden noch immer ab. Mit recaptchaTimeout von 3 kam die TimeoutException nach 3,76 Sekunden, weil das SDK bei 0; 0,25; 0,76 und 1,76 Sekunden nachfragte, noch 2 weitere schlief und erst dann auf die Frist sah. Derselbe Ablauf verzögert auch einen Erfolg: Eine nach 1 Sekunde bereite Freigabe kam bei 1,76 an, eine nach 2 Sekunden bereite bei 3,76 und eine nach 6 Sekunden bereite bei 7,76. Das sind Python 3.14.0, capskip 1.8.0 und die Standardabfrage, gegen den Mock. Die CapSkip-GeeTest-v4-Seite nennt 1 bis 4 Sekunden für eine Freigabe per Klick und etwa 15 bis 20 für einen Slide, dimensionieren Sie recaptchaTimeout also für den langsamsten Typ, den Ihre Website liefern kann.
Schritt 3: die fünf Werte per POST senden, dann für den nächsten POST erneut lösen
Senden Sie die fünf Werte unter den oben genannten Namen neben Ihren eigenen Feldern und vergleichen Sie mit dem, was das eigene Absenden der Seite im Network-Tab sendet. Die Funktion sendet außerdem die Seite als Referer. Die Bibliothek requests fügt weder Referer noch Origin hinzu, und manche Frameworks weisen einen HTTPS-Formular-POST ab, dem beides fehlt, wie es mein Mock mit einem 403 tat.
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,
)Lösen Sie für jeden Formular-POST erneut. Das sagt die API-Dokumentation, und mein Mock folgt ihr: Er lehnte einen zweiten POST derselben fünf Werte als bereits verwendet ab, ebenso eine Freigabe, die 3 Sekunden nach der Lösung gesendet wurde, als ihre Lebensdauer auf 2 Sekunden gesetzt war. Die Schleife fordert also innerhalb der Schleife über die Kommentare eine Freigabe an, während die captcha_id einmal aus open_session kommt. Eine neue Lösung fordert sie nur bei ERROR_CAPTCHA_UNSOLVABLE an oder wenn die Website meldet, die Captcha-Prüfung sei fehlgeschlagen. Jede andere ApiException wird ausgelöst, weil ein falscher Schlüssel erneut genauso scheitert.
Der Test für die Ablehnung ist ein ganzer Satz Ihrer Website, hier captcha check failed. Ein Test auf das bloße Wort captcha ergab einen Treffer auf der Kommentarseite, die nach einem leeren Kommentar erneut angezeigt wird und noch das Widget-Markup enthält, und verbrauchte drei Aufgaben wegen eines Fehlers, der mit dem Captcha nichts zu tun hatte. Das kürzere check failed ergab einen Treffer auf der 403-Seite der Referer-Prüfung.
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")Starten Sie es mit python comment_geetest.py (py comment_geetest.py funktioniert ebenfalls). Gegen den Mock verhielt sich das Skript auf Python 3.11.7, 3.13.7 und 3.14.0 gleich:
| Mock-Einstellung | Was passiert ist |
|---|---|
| Drei Kommentare, Standardeinstellungen | Drei Aufgaben mit derselben captcha_id, drei POSTs akzeptiert |
| Mit handgeschriebenem POST: dieselben fünf Werte zweimal gesendet | Der zweite POST wurde als bereits verwendet abgelehnt |
| Mit handgeschriebenem POST: Freigabe 3 Sekunden nach der Lösung gesendet, Lebensdauer im Mock 2 Sekunden | Als zu alt abgelehnt, und die nächste frische Lösung ging durch |
| Zwei nicht lösbare Antworten zu Beginn | Zwei Wiederholungen, und die Freigabe der dritten Aufgabe wurde akzeptiert |
| Drei nicht lösbare Antworten in Folge | RuntimeError, sobald drei Aufgaben verbraucht waren |
| Offline-Freigabe, die Website akzeptiert sie | Hinweis ausgegeben, POST nach einer Aufgabe akzeptiert |
| Offline-Freigabe, die Website lehnt sie ab | Drei Aufgaben, dann RuntimeError |
| Leerer Kommentar, Seite erneut mit dem Widget-Markup angezeigt | RuntimeError nach einer Aufgabe. Mit dem bloßen Wort captcha als Test drei Aufgaben |
| Formular-POST ohne den Header Referer | 403, RuntimeError nach einer Aufgabe |
| Schlüsselprüfung eingeschaltet, Standardschlüssel des SDK | ApiException nach einer Aufgabe. Mit dem richtigen apiKey akzeptiert |
Lesen Sie die Tabelle als Test meines Mocks und meines Skripts, nicht von GeeTest. Die Dokumentation sagt, man solle zügig senden und für jeden Formular-POST erneut lösen. Die Einmalverwendung und die Lebensdauer von zwei Sekunden sind Regeln meines Mocks.
Mehrere POSTs gleichzeitig mit AsyncCapSkip
Der Async-Client hat aus einem Grund seinen Platz: Eine Freigabe dauert Sekunden, und drei lassen sich zusammen anfordern. AsyncCapSkip basiert auf httpx, daher überlappt asyncio.gather die Lösungen, während die Formular-POSTs in einfachem requests bleiben. Bei 3,0 Sekunden pro Freigabe im Mock brauchten drei POSTs nacheinander 11,35 Sekunden und überlappend 4,09 Sekunden, auf Python 3.14.0, mit drei gleichzeitig offenen Aufgaben im Mock.
Port 8080 ist in beiden Blöcken der Standard des Dienstes im Stil von 2captcha, verwenden Sie also den in den CapSkip-Einstellungen angezeigten Port. Ein Muster für einen größeren Pool finden Sie im Beitrag über das parallele Lösen von Captchas mit Python. Ersetzen Sie den Hauptblock aus Schritt 3 durch den folgenden. Eine fehlgeschlagene Lösung wird in solve_all zu None, und submit_all fragt mit einem einzelnen Aufruf erneut an, sodass ein falscher Schlüssel weiterhin in derselben ApiException endet. Fordern Sie nur so viele Freigaben an, wie Sie senden können, solange sie frisch sind, und teilen Sie eine lange Liste in Stapel auf.
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")Häufige Fehler
Die CapSkip-Codes stammen aus der API-Dokumentation, die Exception-Zeilen aus dem SDK-Quellcode, und die letzte Zeile ist meine Lesart der Dokumentationszeile, für jeden Formular-POST erneut zu lösen.
| Fehler | Ursache | Beheben |
|---|---|---|
| ValidationException | Das SDK hat die Argumente auf Ihrem Rechner abgelehnt, ohne CapSkip zu kontaktieren, aus einem der Gründe in Schritt 2 | Der Text der Exception nennt das fehlerhafte Argument |
| ERROR_CAPTCHA_UNSOLVABLE | Die Freigabe konnte für diese Aufgabe nicht erlangt werden | Senden Sie eine neue Aufgabe, wie es submit_all bis zu dreimal tut. Laut Dokumentation kann die App einen in den Settings festgelegten Ersatztext zurückgeben, gleichen Sie also mit diesem Text ab, falls Sie ihn geändert haben |
| ERROR_KEY_DOES_NOT_EXIST oder ERROR_WRONG_USER_KEY | Die App prüft Schlüssel (API Key Validation), und Ihrer fehlt oder ist falsch. Aufrufe ohne apiKey verwenden den Schlüssel capskip, den der Mock mit dem ersten Code beantwortete | Übergeben Sie Ihren echten Schlüssel als apiKey an CapSkip() |
| ERROR_PROXY_FORMAT | Die Dokumentation nennt ihn für einen proxy-Wert, den CapSkip nicht lesen kann, und verlangt kein Schema-Präfix. Das SDK sendete einen Wert mit Präfix unverändert | Schreiben Sie login:password@IP:PORT ohne http:// |
| NetworkException | Keine Antwort von diesem Host und Port, wenn die Aufgabe hinausgeht, was ich unter Windows nach etwa 2 Sekunden sah. Ein Server, der mitten im Abfragen verstummt, ergibt stattdessen eine TimeoutException | Stellen Sie sicher, dass CapSkip geöffnet ist und host und port zu den Verbindungseinstellungen passen |
| TimeoutException | Innerhalb von recaptchaTimeout, standardmäßig 300 Sekunden, kam keine Freigabe an | Sehen Sie sich die Aufgabe in der CapSkip-App an und führen Sie das Skript erneut aus |
| Die Website meldet, die Captcha-Prüfung sei fehlgeschlagen | Meine Schlussfolgerung, keine dokumentierte Liste: Die fünf Werte wurden schon einmal verwendet, waren zu alt oder wurden verändert | Senden Sie jeden Satz einmal und sofort, unverändert, mit der Seite als Referer |
FAQ
Kann ich CapSkip von einem anderen Computer aus aufrufen?
Ja, über den Server mode. Schalten Sie ihn in den Verbindungseinstellungen des CapSkip-PCs ein und geben Sie die Adresse dieses PCs als host an CapSkip() weiter, dazu Ihren Schlüssel als apiKey, wenn API Key Validation eingeschaltet ist. Der Server mode öffnet den CapSkip-Port beim Start für jede Adresse, eine Windows-Firewall-Blockregel für die Rechner, denen Sie nicht trauen, hält also andere fern. Eine weitere Erlaubnisregel würde nichts ändern. Es ist weiterhin Ihr eigener Windows-Rechner und weiterhin ohne Abrechnung nach Nutzung.
Brauche ich einen Proxy für GeeTest v4?
Nicht zum Einstieg. Die API-Dokumentation hält eine einzelne Adresse für Tests für ausreichend und sagt, dass ein stetiger Strom von einer Adresse genau das ist, worauf die Ratenbegrenzung von GeeTest zielt. Laden Sie für größere Mengen einen Proxy-Pool in die App oder geben Sie einer Aufgabe einen eigenen Proxy, der Vorrang vor dem Pool hat. Der Beitrag über Proxys für einen Captcha-Löser behandelt die Auswahl eines Proxys. In Python ist die Option entweder ein Dictionary, proxy={"type": "HTTP", "uri": "login:password@IP:PORT"}, oder ein einfacher String mit proxytype daneben. Beide Formen kamen beim Mock als die Felder proxy und proxytype an.
Was ist, wenn mir die Seite stattdessen ein gt und eine challenge gibt?
Dann nutzt die Website GeeTest v3, das für jeden Versuch eine frische Challenge braucht und challenge, validate und seccode zurückgibt. Diesen Ablauf behandelt der Beitrag über GeeTest v3 in Python.
Die Kurzfassung
GeeTest v4 in Python bedeutet: eine einmal gelesene captcha_id, eine Lösung pro Formular-POST und fünf unverändert zurückgesendete Felder. Da CapSkip ein unbegrenzter Captcha-Löser ist, der auf Ihrem eigenen PC läuft, schlägt eine wiederholte Lösung auf keiner Rechnung zu Buche. Die Python-Captcha-Solver-Seite listet die SDK-Aufrufe für die anderen Typen auf.
