Cloudflare Turnstile
Widget- Wo man es sieht
- Ein Widget innerhalb einer Seite oder eines Formulars
- Was es zurückgibt
- Ein Token in
cf-turnstile-response - CapMonster-Seite
- Diese Seite: Cloudflare Turnstile Solver
Zuletzt aktualisiert:
Ein Cloudflare Challenge- und ein Turnstile-Widget können gleich aussehen. Eine Challenge ist nicht immer eine separate „Nur einen Moment…“-Seite: Sie kann gestylt, in die Website eingebettet oder so gestaltet werden, dass sie wie ein normales Turnstile-Widget aussieht, sodass Sie sie optisch nicht unterscheiden können.
cf-turnstile-responsechallenge-form mit __cf_chl_f_tk=cf_clearance-CookieIn der Tabelle sind Preis, Lösungszeit und Lösungserfolgsquote für vier Cloudflare Turnstile Lösungsdienste aufgeführt.
| Parameter | CapMonster Cloud | 2Captcha | Anti-Captcha | DeathByCaptcha |
|---|---|---|---|---|
Preis pro 1000 Lösungen (ab) | $ 1.30 | — | — | — |
Zeit zu lösen | 6,24 s* | 16,9 s | 20,33 s | ~13 s |
Lösungserfolgsquote | 99%* | 96 % | 96 % | 96 % |
2Captcha, Anti-Captcha und DeathByCaptcha sind Marken ihrer jeweiligen Eigentümer. CapMonster Cloud ist nicht mit diesen Unternehmen verbunden. Leistungskennzahlen und Preisvergleiche basieren auf öffentlich verfügbaren Daten und internem Benchmarking mit Stand 02.10.2026.
Testen Sie jetzt die Stabilität auf Ihren eigenen Zielseiten. Wir garantieren keine 100-prozentige Erfolgsquote: CAPTCHA-Typen und die Konfiguration der Zielseite können sich jederzeit ändern.
$0.10
Neue Benutzer erhalten ein Testguthaben von 0,10 $, um CapMonster Cloud auszuprobieren.
1. Registrieren Sie sich unter CapMonster Cloud.
2. Senden Sie dem Support eine Nachricht über Live-Chat oder support@capmonster.cloud mit der E-Mail-Adresse, die mit Ihrem Konto verknüpft ist.
Führen Sie Anmelde-, Checkout- und Formularabläufe in CI/CD mit Playwright, Puppeteer oder Selenium auf Seiten aus, die Ihnen gehören oder die Sie testen dürfen.
Überprüfen Sie, ob geschützte Formulare und Endpunkte nach Veröffentlichungen und Widget-Änderungen weiterhin funktionieren.
Sammeln Sie öffentlich verfügbare Daten von geöffneten Seiten, die Cloudflare Turnstile verwenden.
Unterstützen Sie automatisierte unterstützende Arbeitsabläufe auf Websites, die auf invisible-Bot-Prüfungen basieren.
Lassen Sie einen Agenten über MCP ein Token anfordern, wenn ein Workflow ein Captcha erreicht.
Verwenden Sie CapMonster Cloud für öffentlich verfügbare Daten und auf Websites, die Ihnen gehören oder zu deren Testen Sie berechtigt sind. Das unerlaubte Sammeln von Daten Dritter hinter einem Login oder einer Paywall ist untersagt.
Cloudflare Turnstile verifiziert Besucher durch clientseitige Browsersignale und Risikobewertung anstelle von Bildrätseln. Es wird in drei Widget-Modi ausgeliefert: Managed (empfohlen), Non-Interactive und Invisible. CapMonster Cloud verarbeitet sie alle automatisch – Sie geben nie den Modus in der Aufgabe an.
Quellen: Cloudflare Dokumentation – Widget-Typen · Erste Schritte · Turnstile in Cloudflare Herausforderungen
Turnstile wählt automatisch zwischen einem non-interactive-Check und einem Kontrollkästchen basierend auf der Risikostufe des Besuchers. Keine Bilder oder Texte zum Entschlüsseln.
Ein sichtbares Widget mit einem Lade-Spinner. Die Prüfung erfolgt ohne Besucherinteraktion.
Die Prüfung läuft komplett im Hintergrund: Es werden kein Widget und keine Ladeanzeige angezeigt.
Die Seite lädt den Widget-Init-Code; Cloudflare gibt das erforderliche JS zurück und das Widget wird gerendert.
Basierend auf dem Widget-Modus und den Risikosignalen von Cloudflare entscheidet das Widget, ob eine interaktive Herausforderung angezeigt wird.
Die Clientseite callback erhält einen Token – einmalig verwendbar, gültig für 300 Sekunden. Wenn sich das Widget in einem <form> befindet, wird das Token auch automatisch als verstecktes Feld cf-turnstile-response hinzugefügt.
Die Seite sendet den Token mit den Formulardaten an das Backend.
Ihr Server ruft Cloudflares Siteverify API auf, um das Token zu bestätigen.
Quellen: Cloudflare Dokumentation – Einbetten des Widgets · Validieren des Tokens
Ein Turnstile-Token ist die Zeichenfolge, die das Widget generiert, nachdem es einen Besucher verifiziert hat. Das Widget speichert es in einem versteckten Formularfeld namens cf-turnstile-response und übergibt es auch an callback des Widgets. Der Server der Site sendet dann das Token zur Bestätigung an Cloudflares Siteverify API.
Eigenschaften des Tokens gemäß der Dokumentation von Cloudflare:
Gültig für 300 Sekunden (5 Minuten) nach der Generierung.
Einmalig: Eine zweite Validierung gibt den Fehler timeout-or-duplicate zurück.
Bis zu 2048 Zeichen lang.
Validiert auf dem Server durch Siteverify API.
CapMonster Cloud akzeptiert Captcha-Parameter, verarbeitet sie auf seinen Servern und gibt ein gebrauchsfertiges Token zurück. Fügen Sie dieses Token in das Formular ein, um die Prüfung ohne Benutzerinteraktion zu bestehen.
In dieser Phase senden Sie Ihren API-Schlüssel, den Captcha-Typ und seine Parameter. Der Dienst gibt ein eindeutiges taskId zurück, das Sie später verwenden können, um das Ergebnis abzurufen.
Erforderliche Parameter
| Parameter | Beschreibung |
|---|---|
| Typ | TurnstileTask |
| websiteURL | Die URL der Seite, auf der das Captcha gelöst wird |
| websiteKey | Turnstile Standortschlüssel. Format: 0x4AAAAAAABUYP0XeMJF0xoy |
Optionale Parameter
| Parameter | Beschreibung |
|---|---|
| userAgent | Browser User-Agent. Empfohlen: Übergeben Sie den aktuellen Wert, der von CapMonster Cloud unterstützt wird. Den aktuellen Wert erhalten Sie unter https://capmonster.cloud/api/useragent/actual |
| pageAction | Das Aktionsfeld, das in der Funktion callback gefunden wird, wenn das Captcha geladen wird |
| Daten | Der Wert des Datenfelds, entnommen aus dem Parameter cData |
| ProxyType | http – regulärer HTTP/HTTPS-Proxy; https – versuchen Sie es, wenn http nicht funktioniert (erforderlich für einige benutzerdefinierte Proxys); socks4 – SOCKS4-Proxy; socks5 – SOCKS5-Proxy |
| ProxyAdresse | IP-Adresse des Proxys (IPv4/IPv6). Transparente Proxys und Proxys auf lokalen Maschinen sind nicht zulässig |
| ProxyPort | Proxy-Port |
| ProxyLogin | Proxy-Benutzername |
| ProxyPasswort | Proxy-Passwort |
Der gleiche Typ TurnstileTask wird mit und ohne Proxy verwendet.
Endpunkt:
https://api.capmonster.cloud/createTaskAnfrage:
{
"clientKey": "API_KEY",
"task": {
"type": "TurnstileTask",
"websiteURL": "https://yourwebsite.com/page-with-turnstile",
"websiteKey": "your-website-key"
}
}Antwort:
{
"errorId": 0,
"taskId": 407533072
}Fragen Sie nach dem Erstellen der Aufgabe den Lösungsstatus ab.
Endpunkt:
https://api.capmonster.cloud/getTaskResultAnfrage:
{
"clientKey": "API_KEY",
"taskId": 407533072
}Antwort:
{
"errorId": 0,
"status": "ready",
"solution": {
"userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/156.0.0.0 Safari/537.36",
"token": "0.iGX3xsyFCkbGePM3jP4P4khLo6TrLukt8ZzBvwuQOvbC...f61f3082"
}
}| Eigentum | Typ | Beschreibung |
|---|---|---|
| Token | Zeichenfolge | Verwenden Sie das Token in einem Eingabefeld oder beim Aufruf einer callback-Funktion. |
Geben Sie den zurückgegebenen Token in das Feld cf-turnstile-response ein oder übergeben Sie ihn an callback des Widgets und senden Sie das Formular dann innerhalb von fünf Minuten ab: Cloudflare-Token verfallen nach 300 Sekunden und können nur einmal validiert werden. Codebeispiele für Playwright, Puppeteer und Selenium finden Sie in den FAQ unten.
Um eine Turnstile-Aufgabe zu erstellen, benötigen Sie zwei Werte von der Seite, auf der das Widget ausgeführt wird: den Site-Schlüssel (websiteKey) und, falls die Seite ihn festlegt, den Aktionsnamen (pageAction).
<div class="cf-turnstile" data-sitekey="SITE_KEY"← websiteKey
data-action="ACTION"></div>← pageActionturnstile.render('#container', {
sitekey: 'SITE_KEY',← websiteKey
action: 'ACTION',← pageAction
callback: function (token) { /* ... */ }
});Öffnen Sie die Seite mit dem Captcha.
Klicken Sie mit der rechten Maustaste auf das Captcha-Element und wählen Sie Inspect.
Finden Sie den Site-Schlüssel. Im Reiter Elements ist es das Attribut data-sitekey (websiteKey). Ein Turnstile-Site-Schlüssel sieht wie 0x4AAAAAAABUYP0XeMJF0xoy aus.
Suchen Sie die Aktion: im Widget-Renderaufruf (die Funktion callback, die ausgeführt wird, wenn das Captcha geladen wird) oder im Attribut data-action. Der Sitekey ist auch in dieser Funktion callback zu finden. Wenn die Seite keine Aktion festlegt, lassen Sie den Parameter weg.
Um die Werte automatisch zu erfassen, laden Sie die Seite in einen Headless-Browser wie Playwright und lesen Sie sie aus dem gerenderten Widget. Fertige Beispiele in JavaScript, Python und C# finden Sie in der CapMonster Cloud Dokumentation.
Einige Werte ändern sich jedes Mal, wenn die Seite geladen wird. Lösen Sie die Aufgabe daher direkt nach dem Sammeln.
createTask eine CAPTCHA-Lösungsaufgabe erstellen und das Ergebnis mit getTaskResult mithilfe unserer Client-Bibliotheken abrufen.Für Low-Code-Workflows verwenden Sie den offiziellen Knoten CapMonster Cloud n8n.
websiteURL und websiteKey aus derselben Darstellung der Seite.getTaskResult den Status ready zurückgegeben hat und dass Sie solution.token verwendet haben.Von Cloudflare Siteverify (timeout-or-duplicate, invalid-input-secret und andere) zurückgegebene Fehler betreffen Websitebesitzer – siehe „Siteverify Fehlercodes“ unten.
Wenn Sie die durch Turnstile geschützte Website betreiben: Überprüfen Sie die Token und testen Sie Ihr Setup
POST https://challenges.cloudflare.com/turnstile/v0/siteverify
secret=YOUR_SECRET_KEY
response=TOKENWenn Sie die Site betreiben, validiert Ihr Server jedes Turnstile-Token, indem er eine POST-Anfrage an https://challenges.cloudflare.com/turnstile/v0/siteverify sendet. Der Endpunkt akzeptiert application/x-www-form-urlencoded und JSON und gibt immer JSON zurück. Erforderliche Parameter: secret (der geheime Schlüssel Ihres Widgets) und response (das Token). Optional: remoteip und idempotency_key. Markieren Sie success und, falls Sie diese festlegen, auch action und hostname in der Antwort.
Ein Token ist 300 Sekunden lang gültig und kann nur einmal validiert werden. Lesen Sie mehr im Validierungsleitfaden von Cloudflare.
Cloudflare stellt Dummy-Sitekeys und geheime Schlüssel bereit, sodass Sie eine Turnstile-Implementierung testen können, ohne echte Herausforderungen auszulösen. Test-Sitekeys funktionieren auf jeder Domain, einschließlich localhost, und generieren das Dummy-Token XXXX.DUMMY.TOKEN.XXXX. Dummy-Token werden nur von geheimen Dummy-Schlüsseln akzeptiert und von geheimen Produktionsschlüsseln abgelehnt.
<div class="cf-turnstile"
data-sitekey="1x…AA">
</div>
cf-turnstile-response:
"XXXX.DUMMY.TOKEN.XXXX"Geht immer vorbei
Scheitert immer
Geht immer vorbei
Scheitert immer
Erzwingt eine interaktive Herausforderung
Besteht die Validierung immer
Die Validierung schlägt immer fehl
Gibt den Fehler „Token bereits ausgegeben“ zurück (Timeout oder Duplikat).
Cloudflares vollständige Referenz: Turnstile Testing.
Wenn die Validierung fehlschlägt, gibt Cloudflares Siteverify API ein error-codes-Array zurück. In der folgenden Tabelle sind die einzelnen Codes und ihre Bedeutung aufgeführt.
{
"success": false,
"error-codes": [
"timeout-or-duplicate"
]
}Der geheime Parameter wurde nicht angegeben
Der geheime Schlüssel ist ungültig oder abgelaufen
Der Antwortparameter (Token) wurde nicht bereitgestellt
Das Token ist ungültig, fehlerhaft oder abgelaufen
Die Anfrage ist fehlerhaft
Der Token wurde bereits validiert oder ist abgelaufen
Es ist ein interner Fehler aufgetreten. Versuchen Sie die Anfrage erneut
Siteverify kann success: true zurückgeben und Ihr Server sollte das Token trotzdem ablehnen, wenn hostname oder action nicht Ihren Erwartungen entsprechen.
Kurze Antworten zum Lösen von Cloudflare Turnstile mit CapMonster Cloud: Modi, Proxys, Tokens, Tests und Siteverify-Fehler.
Cloudflare Turnstile ist eine CAPTCHA-Alternative von Cloudflare, die Besucher durch Browsersignale und Risikobewertung anstelle von Bildrätseln verifiziert. Es verfügt über drei Widget-Modi. Managed (empfohlen): Cloudflare wählt zwischen einem non-interactive-Check und einem Kontrollkästchen basierend auf dem Besucherrisiko. Non-interactive: ein sichtbares Widget mit einem Lade-Spinner, das keine Interaktion erfordert. Invisible: überhaupt kein Widget. CapMonster Cloud verarbeitet alle drei automatisch, sodass Sie den Modus nicht in der Aufgabe angeben.
Nein. TurnstileTask funktioniert ohne Proxy und die Proxy-Felder (proxyType, proxyAddress, proxyPort, proxyLogin, proxyPassword) sind optional. Ein Proxy, der der Geografie der Zielseite entspricht, kann die Ergebnisse auf geosensiblen Seiten verbessern, daher lohnt es sich, beide Konfigurationen zu testen. Transparente Proxys und Proxys auf lokalen Maschinen sind nicht zulässig. Ohne eigenen Proxy löst CapMonster Cloud die Aufgabe durch seine eingebauten Proxys (IP-Adresse 65.21.190.34).
Öffnen Sie DevTools, suchen Sie das Element mit dem Attribut data-sitekey (und data-action, wenn die Seite eine Aktion festlegt) und kopieren Sie die Werte; Ein Turnstile-Site-Schlüssel sieht aus wie 0x4AAAAAAABUYP0XeMJF0xoy. Einige Werte ändern sich jedes Mal, wenn die Seite geladen wird. Extrahieren Sie sie daher direkt vor dem Erstellen der Aufgabe. Eine Schritt-für-Schritt-Anleitung finden Sie im Abschnitt oben.
cf-turnstile-response ist das versteckte Formularfeld, das das Token Turnstile enthält. Der Token ist 300 Sekunden (5 Minuten) gültig und kann nur einmal validiert werden; Danach gibt Siteverify den Fehler timeout-or-duplicate zurück. Senden Sie sofort den Token, den Sie von CapMonster Cloud erhalten haben, und fordern Sie für jede Übermittlung ein neues an.
Um ein Turnstile-Token einzufügen, suchen Sie das versteckte Antwortfeld (eine Eingabe mit dem Namen cf-turnstile-response) und setzen Sie es auf das von CapMonster Cloud abgerufene Token. Hier erfahren Sie, wie Sie dies in den drei Automatisierungs-Frameworks tun.
Playwright / Puppeteer (Node.js):
const token = "YOUR_TOKEN";
await page.evaluate((t) => {
document.querySelector('[name="cf-turnstile-response"]').value = t;
}, token);
await page.click('#submit-btn');Selenium (Python):
token = "YOUR_TOKEN"
driver.execute_script("document.querySelector('[name=\"cf-turnstile-response\"]').value = arguments[0];", token)
driver.find_element("id", "submit-btn").click()Wenn das Formular das Token über eine callback-Funktion (das data-callback-Attribut des Widgets) validiert, rufen Sie stattdessen diese Funktion mit dem Token auf.
Verwenden Sie die Dummy-Tasten von Cloudflare. Stellen Sie auf dem Client den Sitekey auf 1x00000000000000000000AA (immer erfolgreich), 2x00000000000000000000AB (immer fehl) oder 3x00000000000000000000FF (erzwingt eine interaktive Herausforderung) ein. Verwenden Sie auf dem Server einen geheimen Dummy-Schlüssel wie 1x0000000000000000000000000000000AA. Dummy-Sitekeys funktionieren auf jeder Domain, einschließlich localhost, und erzeugen das Token XXXX.DUMMY.TOKEN.XXXX, das nur Dummy-Geheimschlüssel akzeptieren. Die vollständige Liste finden Sie im Abschnitt Test oben.
Siteverify gibt success: false zurück, wenn das Token älter als 300 Sekunden ist, bereits validiert wurde oder der geheime Schlüssel falsch ist, und Ihr Server kann es auch ablehnen, wenn das zurückgegebene hostname oder action nicht Ihren Erwartungen entspricht. Überprüfen Sie das Array error-codes in der Antwort und sehen Sie sich die Fehlercodetabelle Siteverify an. Fordern Sie für jede Einreichung ein neues Token an und senden Sie es direkt nach Erhalt.
* Wir garantieren keine 100-prozentige Erfolgsquote: CAPTCHA-Typen und die Konfiguration der Zielseite können sich jederzeit ändern. CapMonster Cloud liefert eine hohe Erfolgsquote bei der Lösung von Cloudflare Turnstile. Basierend auf dem internen monatlichen Benchmarking des CapMonster Cloud Teams. Die tatsächliche Lösungsgeschwindigkeit und Erfolgsquote variieren je nach Zielstandort, Serverlast und Netzwerkbedingungen.
Cloudflare und Turnstile sind Marken von Cloudflare, Inc. CapMonster Cloud ist nicht mit Cloudflare verbunden oder wird von diesem unterstützt. Der Dienst ist für öffentlich zugängliche Daten, das Testen eigener oder autorisierter Websites, Bilderkennung und Zugänglichkeit gedacht. Das unerlaubte Sammeln von Daten Dritter hinter einem Login oder einer Paywall ist verboten; Ihre eigenen Konten sind nicht betroffen. Den rechtlichen Status Ihrer Daten ermitteln Sie vor Arbeitsbeginn.