Zahlung pro Lösung · API
1. Verstecktes Skript
Ein mit dem Site Key geladenes Skript läuft im Hintergrund auf jeder Seite, die es verwendet. Der Besucher sieht kein Kontrollkästchen und muss nichts tun.
Ein mit dem Site Key geladenes Skript läuft im Hintergrund auf jeder Seite, die es verwendet. Der Besucher sieht kein Kontrollkästchen und muss nichts tun.
Anhand der gesammelten Verhaltensdaten vergibt Google dem Besucher einen Score, der angibt, wie wahrscheinlich ein Mensch dahintersteckt. Den Schwellenwert legt der Website-Betreiber fest.
Die Website vergleicht den Score mit ihrem eigenen Schwellenwert. Liegt er darunter, kann die Website eine zusätzliche Prüfung verlangen oder die Anfrage blockieren.
grecaptcha.execute für eine Aktion auf.success true ist, der Score den Schwellenwert erfüllt und die Aktion übereinstimmt. Ein gültiger Token mit niedrigem Score kann trotzdem abgelehnt werden.reCAPTCHA-v3-Scores liegen zwischen 0.0 (vermutlich Bot) und 1.0 (vermutlich Mensch). Google empfiehlt einen Schwellenwert von 0.5. Beobachten Sie zuerst den echten Traffic, bevor Sie ihn durchsetzen oder anpassen.
Google unterstützt 11 Score-Stufen. Im kostenlosen Essentials-Tarif werden 0.1, 0.3, 0.7 und 0.9 zurückgegeben; mit Abrechnung sind alle Stufen und Reason Codes verfügbar. Scores in Staging und in der ersten Woche können von der Produktion abweichen.
Der CapMonster-Cloud-Parameter minScore (0.1–0.9) legt den Mindest-Score des Tokens fest. Orientieren Sie sich am Schwellenwert der Website; hohe Werte wie 0.9 erhöhen fehlgeschlagene Versuche.
pageAction muss zur Action in grecaptcha.execute passen. Erlaubt sind nur Buchstaben, Ziffern, Schrägstriche und Unterstriche. Abweichungen können abgelehnt werden. Übergeben Sie sowohl minScore als auch pageAction.
Ein Score-Test braucht ein Backend: der Score kommt in der siteverify-Antwort.
1. Nutzen Sie auf einer Testseite Ihren Site Key und rufen Sie grecaptcha.execute mit einer Action auf.
2. Senden Sie Token und Secret Key von Ihrem Backend an https://www.google.com/recaptcha/api/siteverify.
3. Vergleichen Sie den zurückgegebenen score mit Ihrem Schwellenwert und prüfen Sie die action.
Testen Sie unsere reCAPTCHA-v3-Demo-Seite, ohne eine eigene Testseite zu bauen.
Die Tabelle zeigt Preis, API-Antwortzeit und Erfolgsrate für vier reCAPTCHA-v3-Lösdienste.
| Parameter | CapMonster Cloud | 2Captcha | CapSolver | DeathByCaptcha |
|---|---|---|---|---|
Preis pro 1000 Lösungen (ab) | $ 0.90 | $1.45 | $1.00 | $2.89 |
API-Antwortzeit | ≤ 2 s | ≤ 2 s | < 3 s | ≤ 3 s |
Erfolgsrate der Lösung | bis zu 99% | ~77–92% | ~95–98% | ~64–90% |
Hinweis: 2Captcha, CapSolver und DeathByCaptcha sind Marken der jeweiligen Inhaber. CapMonster Cloud ist mit diesen Unternehmen nicht verbunden. Leistungs- und Preisvergleiche basieren auf öffentlich verfügbaren Daten und internen Benchmarks vom 28.09.2026.
$0.10
Neue Nutzer erhalten $0.10 Testguthaben, um CapMonster Cloud auszuprobieren.
1. Registrieren Sie sich bei CapMonster Cloud.
2. Schreiben Sie dem Support per Live-Chat oder an support@capmonster.cloud und geben Sie die E-Mail Ihres Kontos an.
CapMonster Cloud nimmt Captcha-Parameter entgegen, verarbeitet sie auf seinen Servern und gibt ein einsatzbereites Token zurück. Fügen Sie dieses Token in das Formular ein, um die Prüfung ohne Nutzerinteraktion zu bestehen. Die Aufgabe RecaptchaV3TaskProxyless läuft auf den eigenen Proxy-Servern von CapMonster Cloud, daher übergeben Sie keine Proxy-Parameter.
In diesem Schritt übermitteln Sie Ihren API-Schlüssel, den Captcha-Typ und seine Parameter. Der Dienst gibt eine eindeutige taskId zurück, mit der Sie später das Ergebnis abrufen können.
In der Anfrage zum Lösen von reCAPTCHA v3 müssen Sie die folgenden Parameter angeben:
| Parameter | Beschreibung |
|---|---|
typestringErforderlich | RecaptchaV3TaskProxyless |
websiteURLstringErforderlich | die Adresse der Seite, auf der das Captcha gelöst wird |
websiteKeystringErforderlich | der Schlüssel-Identifikator (sitekey), der auf der Seite Ihrer Website mit dem Captcha angegeben ist https://www.google.com/recaptcha/api.js?render=SITE_KEY6Le0xVgUAAAAAIt20XEB4rVhYOODgTl00d8juDob |
isEnterprisebooleanOptional | Für reCAPTCHA v3 Enterprise setzen Sie isEnterprise: true in RecaptchaV3TaskProxyless (true/false oder 1/0). CapMonster Cloud verarbeitet es wie RecaptchaV3EnterpriseTask. |
minScoredoubleOptional | kann einen Wert von 0.1 bis 0.9 haben |
pageActionstringOptional | der Wert des action-Parameters, der vom ReCaptcha-Widget in Google übermittelt wird. Standardwert: verify grecaptcha.execute('site_key', {action: 'login_test'}) |
https://api.capmonster.cloud/createTask{
"clientKey": "API_KEY",
"task": {
"type": "RecaptchaV3TaskProxyless",
"websiteURL": "https://lessons.zennolab.com/captchas/recaptcha/v3.php?level=beta",
"websiteKey": "6Le0xVgUAAAAAIt20XEB4rVhYOODgTl00d8juDob",
"minScore": 0.3,
"pageAction": "myverify"
}
}
{
"errorId":0,
"taskId":407533072
}
https://api.capmonster.cloud/getTaskResult{
"clientKey":"API_KEY",
"taskId": 407533072
}
{
"errorId": 0,
"status": "ready",
"solution": {
"gRecaptchaResponse": "3AHJ_VuvYIBNBW5yyv0zRYJ75VkOKv…hKj9_xGBJKnQimF72rfoq3Iy-DyGHMwLAo6a3"
}
}
{
"errorId": 0,
"status": "ready",
"solution": {
"userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/155.0.0.0 Safari/537.36",
"gRecaptchaResponse": "0cAFcWeA5Y3...hF8UWA",
"cookies": {
"nocookies": "true"
}
}
}userAgent. Verwenden Sie diesen UserAgent beim Senden des Tokens oder Bestätigen der Lösung, auch wenn er von dem Ihres Browsers oder Skripts abweicht.userAgent. Verwenden Sie diesen UserAgent beim Senden des Tokens oder Bestätigen der Lösung, auch wenn er von dem Ihres Browsers oder Skripts abweicht.Für eine reCAPTCHA-v3-Aufgabe brauchen Sie den Site Key (websiteKey) und den Action-Namen (pageAction).
1. Rechtsklicken Sie auf die Seite und wählen Sie Inspect.
2. Suchen Sie in Elements oder Network nach api.js?render=SITE_KEY. Der Wert nach render= ist websiteKey. reCAPTCHA Enterprise nutzt enterprise.js?render=SITE_KEY.
3. Suchen Sie grecaptcha.execute('SITE_KEY', {action: 'ACTION'}). ACTION ist pageAction. Enterprise nutzt grecaptcha.enterprise.execute. Fehlt der Wert, verwendet die Aufgabe standardmäßig verify.
4. Fangen Sie grecaptcha.execute in einem Headless-Browser wie Playwright ab, um beide Werte zu erfassen. Beispiele in JavaScript, Python und C# finden Sie in der CapMonster-Cloud-Dokumentation.
import asyncio
from capmonstercloudclient import CapMonsterClient, ClientOptions
from capmonstercloudclient.requests import RecaptchaV3ProxylessRequest
client_options = ClientOptions(api_key="YOUR_API_KEY") # Geben Sie Ihren CapMonster-Cloud-API-Schlüssel an
cap_monster_client = CapMonsterClient(options=client_options)
# Bei Bedarf können Sie den Kontostand prüfen
balance = asyncio.run(cap_monster_client.get_balance())
print("Balance:", balance)
recaptcha_v3_request = RecaptchaV3ProxylessRequest(
websiteUrl="https://lessons.zennolab.com/captchas/recaptcha/v3.php?level=beta", # URL Ihrer Seite mit dem Captcha
websiteKey="6Le0xVgUAAAAAIt20XEB4rVhYOODgTl00d8juDob", # Durch einen korrekten Wert ersetzen
minScore=0.7, # Mindestschwelle für den Vertrauensscore
pageAction="myverify" # Aktion auf der Seite
)
async def solve_captcha():
return await cap_monster_client.solve_captcha(recaptcha_v3_request)
responses = asyncio.run(solve_captcha())
print(responses)Führen Sie Sign-up-, 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.
Prüfen Sie, dass geschützte Formulare und Endpunkte nach Releases und Schwellenänderungen weiterhin funktionieren.
Erfassen Sie öffentlich verfügbare Daten von offenen Seiten mit score-basierten Prüfungen.
Unterstützen Sie automatisierte assistive Workflows auf Seiten mit unsichtbaren Bot-Prüfungen.
Ein Agent kann über MCP ein Token anfordern, wenn ein Workflow eine Captcha erreicht.
Nutzen Sie CapMonster Cloud für öffentlich verfügbare Daten und auf Seiten, die Ihnen gehören oder die Sie testen dürfen. Das Sammeln fremder Daten hinter Login oder Paywall ohne Erlaubnis ist verboten.
reCAPTCHA Enterprise nutzt score-basierte Prüfungen: Essentials liefert vier Stufen.
Premium und Enterprise liefern 11, mit grundlegenden bzw. erweiterten Explainability-Reasons.
Für reCAPTCHA v3 Enterprise setzen Sie isEnterprise: true in RecaptchaV3TaskProxyless (true/false oder 1/0). CapMonster Cloud verarbeitet es wie RecaptchaV3EnterpriseTask.
POST https://www.google.com/recaptcha/api/siteverify secret=YOUR_SECRET_KEY response=TOKEN
Senden Sie auf Ihrer Website secret und response an https://www.google.com/recaptcha/api/siteverify. Tokens laufen nach 2 Minuten ab und gelten einmal. Prüfen Sie success, score und action; Google empfiehlt einen Schwellenwert von 0.5.
Siehe Captcha API (Google reCAPTCHA v3) für Node.js- und Python-Beispiele, Fehlerbehandlung und score-basierte Aktionen.
Python SDK
secretSecret keymissing-input-secretDer Parameter secret fehlt
secretSecret keyinvalid-input-secretDer Parameter secret ist ungültig oder fehlerhaft
responseTokenmissing-input-responseDas Token fehlt
responseTokeninvalid-input-responseDas Token ist ungültig oder fehlerhaft
requestRequestbad-requestDie Anfrage ist ungültig oder fehlerhaft
responseToken-Lebensdauertimeout-or-duplicateDas Token ist zu alt oder wurde bereits verwendet
reCAPTCHA v2reCAPTCHA v3· aktuellreCAPTCHA v2 EnterprisereCAPTCHA v3 Enterprise
GeeTest
Cloudflare TurnstileCloudflare Bot Challenge
DataDome
Tencent CAPTCHA
Amazon Waf
Faucet Pay
Imperva (Incapsula)
Prosopo
Text CAPTCHA
BinanceComplexImageTask Recaptcha
ComplexImageTask RecognitionreCAPTCHA Enterprise (Spotify, Yahoo)
Yidun
MTCaptcha
Altcha
Funcaptcha
TSPD
Hunt
Alibaba
Friendly
Dokumentation zu reCAPTCHA v3 (EN) →Dokumentation zu reCAPTCHA v3 Enterprise (EN) →Wie man ReCaptcha v3 in Python mit Selenium & CapMonster Cloud löst (EN) →Wie man ReCaptcha v3 in JavaScript mit Selenium & CapMonster Cloud löst (EN) →Wie man ReCaptcha v3 in C# mit Selenium & CapMonster Cloud löst (EN) →Captcha API (Google reCAPTCHA v3): Dokumentation und Integrationsanleitung für Entwickler (EN) →Der Parameter minScore akzeptiert Werte von 0.1 bis 0.9 und teilt CapMonster Cloud den minimalen Trust Score mit, den der zurückgegebene Token haben muss. 0.3 ist ein vernünftiger Ausgangswert. Ein zu hoher Wert (z. B. 0.9) erhöht die Wahrscheinlichkeit von Lösungsfehlern; ein zu niedriger Wert kann Tokens mit einem Score zurückgeben, den Ihr serverseitiger Schwellenwert ohnehin ablehnen würde. Passen Sie den Wert an die tatsächlichen Ablehnungsraten in Ihrer Testumgebung an.
Öffnen Sie die Seite und suchen Sie im Seiteninspektor nach api.js?render=SITE_KEY. Der Wert nach render= ist der sitekey. Die action steht im Aufruf grecaptcha.execute(siteKey, {action: "..."}). Mit Playwright können Sie diesen Aufruf automatisch erfassen. Manche Werte ändern sich bei jedem Laden; erstellen Sie die Aufgabe daher direkt nach der Erfassung. Ausführliche Anleitung.
1.0 steht sehr wahrscheinlich für eine legitime Interaktion, 0.0 für einen Bot. Google empfiehlt 0.5 als Standardschwelle. Entscheidend ist die Schwelle der jeweiligen Website. Setzen Sie minScore entsprechend und passen Sie den Wert an den tatsächlichen Datenverkehr an. So prüfen Sie den Score.
Ein von reCAPTCHA v3 erhaltener Token ist etwa 2 Minuten gültig. Ihre Automatisierung muss den Token innerhalb dieses Zeitfensters an den Server senden; danach gibt Googles siteverify-Endpunkt success: false zurück. Führen Sie den Lösungsschritt so nah wie möglich am Formularversand durch und vermeiden Sie das Caching von Tokens über Anfragen hinweg.
Ein Token kann nur einmal verifiziert werden. Ein abgelaufenes oder bereits verwendetes Token führt zu timeout-or-duplicate. Fordern Sie für jeden Formularversand ein neues Token an.
Um einen reCAPTCHA-v3-Token zu injizieren, finden Sie das versteckte Antwortfeld (meist ein textarea- oder input-Element mit der ID g-recaptcha-response) und fügen Sie den vom CAPTCHA-Solver-Dienst erhaltenen Token ein. So geht es in den drei Automatisierungsframeworks.
Playwright / Puppeteer (Node.js)
const token = "YOUR_TOKEN";
await page.evaluate((t) => {
document.getElementById('g-recaptcha-response').value = t;
}, token);
await page.click('#submit-btn');Selenium (Python)
token = "YOUR_TOKEN"
driver.execute_script(f"document.getElementById('g-recaptcha-response').value = '{token}';")
driver.find_element("id", "submit-btn").click()Manche Websites verwenden Callback-Funktionen zur Token-Validierung. Wenn das Formular nicht abgesendet wird, ermitteln Sie den Funktionsnamen über die Konsole (___grecaptcha_cfg.clients) und rufen Sie ihn manuell auf:
await page.evaluate((t) => {
window.onSuccessCallback(t);
}, token);Eine success: true-Antwort von Google bedeutet nur, dass der Token gültig ist. Ihr Backend kann die Anfrage dennoch ablehnen, wenn der Token-Score unter Ihrem konfigurierten Schwellenwert liegt.
Ein weiteres häufiges Problem ist eine Action-Abweichung. Der Token muss gegen denselben action-Wert geprüft werden, der bei der Aufgabenerstellung verwendet wurde.
Zur Fehlerdiagnose:
Ist success true, ist das error-codes-Array in der Regel leer – score und action sind dann die wichtigsten Felder.
Ja. Setzen Sie isEnterprise: true in der reCAPTCHA-v3-Aufgabe (zulässige Werte: true/false oder 1/0). Die Verarbeitung entspricht RecaptchaV3EnterpriseTask. Weitere Informationen finden Sie im Abschnitt oben und in der API-Dokumentation.
Kein Tool kann bei sich weiterentwickelnden Schutzmechanismen eine Erfolgsquote von 100 % garantieren. CapMonster Cloud erreicht jedoch eine hohe Erfolgsquote bei reCAPTCHA v3. Grundlage sind interne monatliche Benchmarks des CapMonster Cloud Teams. Die tatsächliche API-Antwortzeit und Erfolgsquote hängen von der Zielwebsite, der Serverauslastung und den Netzwerkbedingungen ab.
reCAPTCHA ist eine Marke von Google LLC. CapMonster Cloud ist weder mit Google verbunden noch von Google unterstützt. Der Dienst ist für öffentlich zugängliche Daten, Tests eigener oder autorisierter Websites, Bilderkennung und Barrierefreiheit vorgesehen. Das Sammeln fremder Daten hinter einer Anmeldung oder Bezahlschranke ohne Erlaubnis ist verboten; eigene Konten sind davon nicht betroffen. Sie bestimmen vor Arbeitsbeginn den rechtlichen Status Ihrer Daten.