MTCaptcha in Python: Den sitekey auslesen, lösen und senden

Um MTCaptcha in Python ohne Browser zu lösen, laden Sie die Login-Seite mit requests, lesen den sitekey und die action aus dem Objekt mtcaptchaConfig der Seite, übergeben beides an solver.mtcaptcha() aus dem CapSkip-SDK und senden den zurückgegebenen Token beim Absenden des Formulars im Feld mtcaptcha-verifiedtoken mit. Hinter dem Aufruf steht der CapSkip-MTCaptcha-Solver, der auf Ihrem eigenen Windows-PC mit einer Pauschallizenz läuft, daher kostet ein abgelehnter Token Sie nichts außer einem weiteren Durchlauf der Schleife.
Was Sie brauchen
- Ein Windows-PC mit CapSkip 4.3.0 (9. November 2026, die erste Version mit MTCaptcha) oder neuer. Die Einrichtungsanleitung führt durch die Installation. Die Kopie auf meinem PC akzeptierte die Methode mt_captcha, aber ich konnte ihre Version nicht auslesen.
- Python 3.10 oder neuer, die Untergrenze, die capskip 1.7.0, requests 2.34.2 und urllib3 2.8.0 angeben, dazu capskip 1.7.0 oder neuer, die erste Version mit einer MTCaptcha-Methode. Ich habe sie nur mit Python 3.11.7, 3.13.7 und 3.14.0 ausgeführt.
- Beide Pakete lassen sich aus PowerShell mit python -m pip install capskip requests installieren (py -m pip funktioniert ebenfalls), pip muss also nicht in Ihrem PATH liegen.
- Eine Adresse für CapSkip. Im Local-Modus (127.0.0.1) ist CapSkip nur für den PC erreichbar, auf dem es läuft. Der Server-Modus ergänzt Ihre Netzwerkadresse oder öffentliche IP, sodass ein anderer PC oder ein Windows-VPS dieselben Anfragen senden kann. Beide Modi sind beschrieben unter Verbindungseinstellungen in der Einrichtungsanleitung. Lassen Sie die Einstellungen von Service Emulator auf dem Standardwert, denn das SDK spricht CapSkip im Standardformat an, und ein emulierter Dienst antwortet möglicherweise anders.
Ich habe dieses Skript gegen zwei Mocks getestet, die ich geschrieben habe: einer spielte CapSkip, der andere eine Login-Website. Die echte CapSkip-App auf meinem PC nahm drei MTCaptcha-Aufgaben an, mit dem öffentlichen Demo-sitekey und der Seitenadresse aus dem eigenen Beispiel des SDK, um einen echten Token zu sehen und den SDK-Aufruf zu messen. Keine Website hat je einen Token geprüft, daher zeigt nichts hier, dass eine echte Website einen akzeptiert, und jede Website-Regel im Mock stammt von mir. Wie eine Website einen Token prüft, beschreibt MTCaptcha in der Anleitung zur Token-Validierung.
Schritt 1: Die Session einrichten und den MTCaptcha-sitekey finden
Speichern Sie den ersten Codeblock als mtcaptcha_login.py. Jeder Block danach, auch der nächste in diesem Schritt, kommt in der gezeigten Reihenfolge ans Ende derselben Datei, und die Datei ist nach Schritt 4 vollständig. Ein User-Agent-String dient für das Laden der Seite, das Lösen und das Absenden des Formulars, wählen Sie dafür also einen beliebigen aktuellen Browser-String. Tragen Sie im Server-Modus die Adresse Ihres Servers bei host ein. Ist API Key Validation eingeschaltet, übergeben Sie außerdem Ihren Schlüssel als apiKey.
# python -m pip install capskip requests
import re
import requests
from capskip import ApiException, CapSkip
LOGIN_URL = "https://example.com/login" # the page that shows the widget
USER_AGENT = (
"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 "
"(KHTML, like Gecko) Chrome/140.0.0.0 Safari/537.36"
)
# Local mode. In Server mode, use your server's address as the host.
solver = CapSkip(host="127.0.0.1", port=8080)Die meisten MTCaptcha-Seiten konfigurieren das Widget mit einem Inline-Objekt mtcaptchaConfig, dessen Wert sitekey mit MTPublic- beginnt und das auch eine action setzen kann. Die Demoseite von CapSkip schreibt es in eine Zeile mit einem Schlüssel lang, drei Callbacks und ohne action. Die CapSkip-Dokumentation verteilt es auf mehrere Zeilen und fügt eine action hinzu. Andere Seiten verwenden einfache Anführungszeichen und Schlüssel ohne Anführungszeichen. Die Funktion unten sucht jeden Schlüssel nach seinem Namen und liest daher alle diese Varianten, aber eine Inline-Funktion innerhalb des Objekts oder ein Script, das das Objekt nicht mit einer schließenden Klammer und einem Semikolon oder mit dem schließenden Script-Tag beendet, ließe sie scheitern.
Die Funktion löst einen Fehler aus, wenn die Seite kein solches Objekt oder keinen sitekey darin hat, und der erste Fall kommt tatsächlich vor. Ein GET auf die Demoseite von 2Captcha lieferte HTML, in dem der sitekey nur in den Anweisungen vorkommt. Bei einer solchen Seite kopieren Sie den sitekey einmal aus der iframe-Adresse des Widgets, wo er als Query-Parameter sitekey auf service.mtcaptcha.com steht. Setzt die Seite eine action, senden Sie sie mit, denn laut der Dokumentation zur action von MTCaptcha meldet der Check-Aufruf die action, mit der das Widget gestartet wurde, sodass eine Website sie vergleichen kann. Setzt die Seite keine, senden Sie keine.
def read_config(html):
"""Return (sitekey, action) from the page's mtcaptchaConfig object."""
found = re.search(r"mtcaptchaConfig\s*=\s*\{(.*?)(?:\}\s*;|</script>)", html, re.S)
if not found:
raise RuntimeError("no mtcaptchaConfig in the page source")
def value(name):
pattern = r"(?<![\w-])[\"']?" + name + r"[\"']?\s*:\s*[\"']([^\"']+)[\"']"
pair = re.search(pattern, found.group(1))
return pair.group(1) if pair else None
sitekey = value("sitekey")
if not sitekey:
raise RuntimeError("no sitekey in mtcaptchaConfig")
return sitekey, value("action")Ich habe read_config mit den drei Anführungsstilen aus meinem Mock ausgeführt, mit einem verschachtelten Objekt vor dem sitekey und vor der action, mit einer Config ohne abschließendes Semikolon und mit gespeicherten Kopien zweier öffentlicher Seiten. Die Demoseite von CapSkip lieferte ihren sitekey und keine action, und die Demoseite von 2Captcha löste den oben genannten Fehler aus. Alle drei Python-Versionen stimmten überein.
Schritt 2: Den Token über das SDK anfordern
Sie rufen solver.mtcaptcha(sitekey, url, **options) auf. Es sendet die Aufgabe, fragt das Ergebnis ab und gibt ein Dictionary zurück, Sie schreiben also keine Schleife. Übergeben Sie als url die echte Adresse der Seite, denn MTCaptcha stellt Token nur für die Domains aus, für die ein sitekey registriert ist. Fügen Sie diese Funktion am Ende der Datei hinzu. Sie fügt die action nur hinzu, wenn die Seite eine gesetzt hat.
def get_token(sitekey, action):
options = {"userAgent": USER_AGENT}
if action: # only when the page's config sets one
options["action"] = action
return solver.mtcaptcha(sitekey, LOGIN_URL, **options)["token"]Bevor etwas gesendet wird, validiert das SDK Ihre Argumente. Ein sitekey, der nicht MTPublic- gefolgt von bis zu 55 Buchstaben, Ziffern, Bindestrichen oder Unterstrichen ist, eine Seitenadresse, die keine absolute http- oder https-URL ist, oder eine Option, die die MTCaptcha-API nicht kennt, etwa invisible, löst sofort eine ValidationException aus. Ein sitekey, der als sk=MTPublic- eingefügt wurde, wird akzeptiert, und das SDK entfernt das Präfix.
In drei echten Läufen enthielt das Dictionary die Schlüssel "captchaId", "code" und "token", und die letzten beiden sind derselbe String, der für mtcaptcha-verifiedtoken. Jeder echte Token begann mit v1( und endete mit **), war 418 Zeichen lang und hatte fünf durch Komma getrennte Felder, deren drittes der sitekey ist. Die Dokumentation zeigt kürzere Beispiele, prüfen Sie einen Token also nicht anhand seiner Länge.
Die Option userAgent nennt den Browser-String, den CapSkip gegenüber MTCaptcha angibt. Ich übergebe den eigenen String der Session, sodass das Lösen, das Laden der Seite und das Absenden des Formulars einen einzigen Browser zeigen. Ohne diese Option verwendet CapSkip einen String für Chrome unter Windows. Nichts, was ich gelesen habe, sagt, dass MTCaptcha die beiden vergleicht, und ich habe das nicht getestet. Die aktuelle API-Dokumentation nennt ERROR_WRONG_USERAGENT für einen User-Agent, der für die Aufgabe nicht verwendet werden kann, und die echte App hat meine Option userAgent nie gesehen. Antwortet sie also mit diesem Fehler, lassen Sie die Option in get_token weg.
Zeitmessung, von kurz vor dem Aufruf bis zu seiner Rückkehr: 3,77 Sekunden einmal mit Python 3.14.0 und 3,76 Sekunden zweimal mit Python 3.11.7, mit capskip 1.7.0, den Standardabfragen und der echten CapSkip-App unter Windows 11. Diese drei Aufrufe sendeten weder userAgent noch action. Der Abfrageplan des SDK bestimmt diesen Wert: Gegen den Mock fragte es das Ergebnis nach 0; 0,25; 0,76; 1,76; 3,76 und 7,76 Sekunden nach dem Absenden ab, und ein Mock-Token, der irgendwann zwischen 1,9 und 3,6 Sekunden bereit war, kam bei 3,76 zurück. Der echte Lösevorgang endete also zwischen der Abfrage bei 1,76 und der bei 3,76 Sekunden, und drei Läufe sind kein Benchmark.
Für das Lösen von MTCaptcha läuft kein Browser, daher wartet das SDK so lange, wie sein defaultTimeout es erlaubt, standardmäßig 120 Sekunden. Mit auf 6 Sekunden gesenktem defaultTimeout löste ein Mock, der nie antwortete, 7,78 Sekunden nach dem Aufruf eine TimeoutException aus, weil die letzte Pause zwischen den Abfragen über das Limit hinauslief.
Schritt 3: Das Formular senden, solange der Token frisch ist
In einem Browser schreibt das Widget den Token in ein verstecktes Input-Feld namens mtcaptcha-verifiedtoken. Ohne Browser senden Sie dieses Feld selbst, neben den eigenen Feldern des Formulars. Die Funktion unten, die ebenfalls am Ende der Datei ergänzt wird, tut das. Die Session überträgt die Cookies der Seite in den Formular-POST. Zeigt das Attribut action des Formulars woandershin, ändern Sie das erste Argument des Aufrufs session.post.
Ein Token funktioniert nur einmal und nur kurze Zeit. Laut der Validierungsanleitung von MTCaptcha ist ein Token normalerweise einige Minuten gültig, nennt aber eine Standardablaufzeit von 60 bis 120 Sekunden, und er kann standardmäßig nur einmal geprüft werden, senden Sie ihn also innerhalb einer Minute. Die Dokumentation von CapSkip bittet darum, den Token kurz vor dem Formular-POST anzufordern, deshalb läuft get_token nach dem Laden der Seite, und der Formular-POST folgt sofort. Wenn Sie selbst eine Wartezeit einbauen, lösen Sie danach. Ein abgelehnter Token ist verbraucht, daher fordert die Schleife in Schritt 4 einen neuen an.
Der Formular-POST nennt außerdem die Seite als Referer, denn requests sendet weder Referer noch Origin, und manche Frameworks lehnen einen HTTPS-Formular-POST ohne beides ab. Mein Mock spielt eines davon, und ohne den Header antwortete er mit 403.
def post_form(session, token, username, password):
return session.post(
LOGIN_URL,
data={
"username": username, # your form's own fields go here
"password": password,
"mtcaptcha-verifiedtoken": token,
},
headers={"Referer": LOGIN_URL}, # requests sends none by itself
timeout=30,
)Schritt 4: Das vollständige Login-Skript für MTCaptcha in Python
Fügen Sie den letzten Block am Ende von mtcaptcha_login.py ein, womit die Datei vollständig ist. Setzen Sie LOGIN_URL und führen Sie python mtcaptcha_login.py aus (oder py mtcaptcha_login.py). Zwei Strings sind Platzhalter für Ihre Website: "Welcome", der Text, den ein erfolgreicher Login anzeigt, und "captcha check failed", eine Wendung, die die eigene Captcha-Ablehnung Ihrer Website enthält. Das Skript gibt nach drei Versuchen auf.
Laut der CapSkip-Dokumentation wird ERROR_CAPTCHA_UNSOLVABLE damit beantwortet, eine neue Aufgabe zu senden, und das Skript wiederholt nur diesen Code. Die Dokumentation nennt zwei Fehler, die sich wiederholen, wenn Sie dieselbe Aufgabe erneut senden, einen unbekannten sitekey und einen sitekey, der auf der Domain der Seite nicht erlaubt ist, und jeder andere Fehler beendet das Skript ebenfalls. In der Meldung der ApiException kommt der Code als bloßer Text oder in eine JSON-Hülle verpackt an, und which_error zieht ihn aus beidem heraus.
Ein abgelehnter Formular-POST bekommt nur dann einen neuen Token, wenn die Antwort die Wendung für die Captcha-Ablehnung Ihrer Website enthält. Verwenden Sie eine Wendung wie die zitierte, nie das bloße Wort captcha. Eine Login-Seite, die nach einem falschen Passwort erneut angezeigt wird, trägt weiterhin das eigene mtcaptchaConfig und mtcaptcha-verifiedtoken des Widgets, das bloße Wort würde also zutreffen und drei Token verbrauchen. Das habe ich gegen meinen Mock gesehen. Mit einer Wendung, die nur die Ablehnung enthält, wird eine Aufgabe verbraucht.
def which_error(err):
# The message holds the code as bare text or inside a JSON envelope.
found = re.search(r"ERROR_[A-Z_]+", str(err))
return found.group(0) if found else str(err)
def log_in(username, password):
session = requests.Session()
session.headers["User-Agent"] = USER_AGENT
for attempt in range(1, 4):
page = session.get(LOGIN_URL, timeout=30) # cookies first, then config
sitekey, action = read_config(page.text)
try:
token = get_token(sitekey, action)
except ApiException as err:
code = which_error(err)
if code != "ERROR_CAPTCHA_UNSOLVABLE":
raise # a bad sitekey or domain would fail the same way again
print(f"attempt {attempt}: {code}, new task")
continue
reply = post_form(session, token, username, password)
if "Welcome" in reply.text: # use a sign your site shows on success
return reply
if "captcha check failed" not in reply.text.lower(): # your site's phrase
raise RuntimeError(f"login refused ({reply.status_code}), not the captcha")
print(f"attempt {attempt}: captcha refused ({reply.status_code}), new token")
raise RuntimeError("no login after 3 attempts")
if __name__ == "__main__":
print(log_in("alice", "YOUR_PASSWORD").text[:40])Gegen den Mock lieferten alle drei Python-Versionen identische Ergebnisse:
| Mock-Einstellung | Was das Skript tat |
|---|---|
| Seiten-Config wie in der Dokumentation, mit einer action | Eine Aufgabe, in.php erhielt die action, der Formular-POST wurde angenommen |
| Config in einer Zeile mit Callbacks und ohne action, wie auf der Demoseite | Eine Aufgabe, kein Feld action gesendet, der Formular-POST wurde angenommen |
| Die Seite setzt eine action, aber der Aufruf lässt sie weg | Drei Aufgaben, drei abgelehnte Formular-POSTs, dann RuntimeError |
| Die ersten zwei Lösungen enden mit ERROR_CAPTCHA_UNSOLVABLE | Zwei Wiederholungsmeldungen, dann wurde der Token der dritten Aufgabe angenommen |
| Token beim Senden 3 Sekunden alt, Lebensdauer des Mocks auf 2 Sekunden gesetzt | Als veraltet abgelehnt, dann wurde ein neuer Token angenommen |
| Fehler wegen unbekanntem sitekey oder unbekannter Domain bei der Abfrage | ApiException nach einer Aufgabe und ohne Formular-POST, als JSON oder als bloßer Text |
| Falsches Passwort mit einem einfachen Ablehnungstext oder ein Formular-POST ohne den Header Referer | RuntimeError nach einer Aufgabe, kein neuer Token |
| Login-Seite nach einem falschen Passwort erneut angezeigt, geprüft auf das bloße Wort captcha | Drei Aufgaben, dann RuntimeError. Mit der Prüfung auf die Wendung eine Aufgabe |
Lesen Sie die Tabelle als Test meines Mocks, nicht irgendeiner echten Website. Die einmalige Verwendung, die kurze Lebensdauer und der Abgleich der action folgen der Dokumentation, aber die Lebensdauer von zwei Sekunden ist eine willkürliche Zahl von mir.
Häufige Fehler
Die meisten dieser Fehler stammen von CapSkip und stehen in der MTCaptcha-API-Dokumentation, außer wo eine Zeile sagt, dass ich den Fehler selbst gesehen habe.
| Fehler | Ursache | Beheben |
|---|---|---|
| ValidationException | Das SDK hat den Aufruf abgelehnt, bevor es ihn sendete, aus einem der Gründe in Schritt 2 | Die Meldung nennt das Problem, korrigieren Sie also dieses Argument |
| ERROR_RECAPTCHA_INVALID_SITEKEY | MTCaptcha erkennt den sitekey nicht | Kopieren Sie ihn erneut aus mtcaptchaConfig. Ein erneutes Senden würde scheitern, daher wirft das Skript |
| ERROR_RECAPTCHA_INVALID_DOMAIN | Der sitekey ist auf der Domain der gesendeten Adresse nicht erlaubt | Verwenden Sie die Adresse der Seite, auf der das Widget wirklich sitzt |
| ERROR_CAPTCHA_UNSOLVABLE | MTCaptcha wurde nicht bestanden | Senden Sie eine neue Aufgabe, was das Skript bis zu dreimal für Sie erledigt |
| ERROR_TASK_NOT_SUPPORTED | CapSkip ist älter als die Version, die MTCaptcha hinzugefügt hat | Installieren Sie CapSkip 4.3.0 oder eine neuere Version |
| ERROR_WRONG_USERAGENT | Die aktuelle API-Dokumentation nennt ihn für einen User-Agent, der für die Aufgabe nicht verwendet werden kann. Die echte App hat die Option userAgent aus meinem Code nie gesehen | Lassen Sie die Option userAgent in get_token weg |
| ERROR_WRONG_USER_KEY oder ERROR_KEY_DOES_NOT_EXIST | API Key Validation ist eingeschaltet und der Schlüssel ist falsch. Ein Aufruf ohne apiKey geht mit dem Schlüssel capskip hinaus | Übergeben Sie CapSkip() Ihren echten Schlüssel als apiKey |
| TimeoutException | Kein Token innerhalb von defaultTimeout, 120 Sekunden, sofern Sie es nicht geändert haben | Beobachten Sie die Aufgabe im CapSkip Monitor und führen Sie das Skript dann erneut aus |
| NetworkException | Unter diesem Host und Port antwortet nichts, wenn die Aufgabe gesendet wird, oder die Antwort war ein HTTP-Fehler. Hört CapSkip während der Abfrage auf zu antworten, erhalten Sie stattdessen TimeoutException | Starten Sie CapSkip und prüfen Sie, ob Host und Port zu seinen Verbindungseinstellungen passen |
| Eine Website lehnt einen Token ab, der in Ordnung zu sein scheint | Der Token wurde schon einmal verwendet, war zu alt, ließ die action der Seite weg oder kam ohne Referer | Senden Sie jeden Token nur einmal, sofort, mit der Seite als Referer und der eigenen action der Seite |
FAQ
Kann das Skript auf einem anderen Rechner laufen als CapSkip?
Ja, über den Server-Modus. Schalten Sie ihn in den Verbindungseinstellungen des CapSkip-PCs ein und übergeben Sie die Adresse dieses PCs als host an CapSkip(). Sonst ändert sich nichts. Der Server-Modus erfordert Administratorrechte für CapSkip, und die Einrichtungsanleitung empfiehlt eine statische öffentliche IP. Wenn der Server-Modus startet, öffnet CapSkip seinen Port für jede Adresse, fügen Sie also eine Block-Regel der Windows-Firewall für die Rechner hinzu, die ihn nicht erreichen sollen. Der Solver bleibt auf Ihrer eigenen Windows-Hardware, und es wird nichts nach Verbrauch abgerechnet.
Funktioniert das Skript mit unsichtbaren MTCaptcha-Widgets?
Die MTCaptcha-Solver-Seite von CapSkip sagt, dass ein unsichtbares Widget durch dieselbe Anfrage geht wie das sichtbare und dieselbe Art Token zurückgibt. Der MTCaptcha-Abschnitt der API-Dokumentation erwähnt den unsichtbaren Modus nicht, und ich habe nichts gegen ein unsichtbares Widget ausgeführt, behandeln Sie es also als unbestätigt. Ihre Seite muss den sitekey trotzdem in ihrem Quelltext tragen, denn read_config braucht ihn dort.
Brauche ich einen Proxy für MTCaptcha?
Nicht für den Anfang. Die Dokumentation nennt eine Adresse für Tests in Ordnung, sagt aber, dass ständiges Lösen von einer einzigen Adresse Ratenbegrenzung provoziert. Laden Sie für größere Mengen eine Proxy-Liste in den MTCaptcha-Einstellungen der App oder übergeben Sie eine Option proxy an mtcaptcha(), etwa proxy={"type": "HTTP", "uri": "login:password@IP:PORT"}. Der Mock hat den Proxy und seinen Typ erhalten; ich habe keinen echten Proxy verwendet.
Die Kurzfassung
MTCaptcha in Python besteht aus drei Schritten: den sitekey und die action von der Seite lesen, kurz vor dem Formular-POST einen Token anfordern und erneut einen anfordern, wenn ein Formular-POST abgelehnt wird. CapSkip ist ein lokaler Captcha-Löser und Sie betreiben ihn selbst, daher erhöht ein abgelehnter Token nie eine Rechnung. Die Python-Captcha-Solver-Seite listet die SDK-Aufrufe für andere Typen auf, und die MTCaptcha-Demo lässt Sie einen Token in einem echten Formular ausprobieren.
