Captchas lösen mit
n8n-Agenten
Ein Agent, der auf eine Challenge trifft, hat nichts in seinem Toolset, das sie lösen kann – also bleibt er hängen oder halluziniert sich daran vorbei. Geben Sie ihm einen Solver als Tool, und die Blockade wird zu einem weiteren Aufruf.
HTTP Request node
Method: POST
URL: https://api.captchano.com/v1/solve?wait=60
Authentication: Header Auth
Name: Authorization
Value: Bearer cn-YOUR_API_KEY
Send Body: JSON
Body:
{
"type": "turnstile",
"sitekey": "{{ $json.sitekey }}",
"url": "{{ $json.pageUrl }}"
}
The node outputs { status, solution: { token, userAgent }, cost } —
pass {{ $json.solution.token }} to the next step.Warum gerade Agenten das brauchen
Ein Scraper, der auf eine Challenge trifft, scheitert laut, und Sie beheben das Problem. Ein Agent scheitert leise: Er denkt über die blockierte Seite nach, erfindet einen plausiblen nächsten Schritt und meldet Fortschritt, den es nie gab. Der Fehler ist schlimmer, weil er unbemerkt bleibt. Ein typisiertes Solver-Tool macht aus einer unklaren Sackgasse ein deterministisches Ergebnis, auf das der Agent reagieren kann.
Was das Tool zurückgibt
- Ein Token oder Cookie – je nach Challenge-Typ. Sitzungsbasiert bewertende Systeme liefern ein Cookie sowie die Header, mit denen es erhalten wurde.
- Den verwendeten User-Agent, damit der Agent ihn beim Absenden übernehmen kann.
- Die Kosten der Lösung, damit ein Agent mit Budget sie verbuchen kann, statt blind auszugeben.
Die Schleife begrenzt halten
Geben Sie dem Agenten ein Lösungsbudget pro Lauf. Jede Response meldet ihre Kosten, sodass ein Supervisor die Schleife abbrechen kann, wenn die Ausgaben einen Schwellenwert überschreiten – statt es erst auf der Rechnung zu bemerken. Bei $0.00598 pro Lösung kostet ein typischer Agent-Lauf wenige Cent oder weniger, aber eine unbegrenzte Retry-Schleife bleibt eine unbegrenzte Retry-Schleife.
Den Tool-Aufruf blockierend halten
Die Beispiele rufen ?wait=60 auf, sodass das Tool in einem einzigen Schritt ein fertiges Token zurückgibt. Für Agenten ist das wichtiger als für Skripte: Ein Tool, das „wird noch gelöst“ zurückgibt, zwingt das Modell, über Polling nachzudenken – und das kann es schlecht. Brauchen Sie eine höhere Obergrenze, erhöhen Sie wait auf bis zu 120 Sekunden. Die Request-Formate für jeden Challenge-Typ finden Sie in der API-Referenz.
So fügt sich die Lösung in n8n ein
Der AI-Agent-Node von n8n kann ein HTTP-Request-Tool aufrufen. Richten Sie es auf den Solve-Endpoint, und der Agent kann mitten im Workflow ein Captcha lösen.
- 01AI-Agent-Node hinzufügen
Verbinden Sie wie gewohnt ein Chat-Modell und Memory.
- 02HTTP-Request-Tool hinzufügen
POST an die API mit ?wait=60 und Header-Auth-Credentials.
- 03Tool beschreiben
Weisen Sie den Agenten an, es mit type, sitekey und url aufzurufen, wenn eine Seite ein Captcha zeigt.
- 04Token verwenden
Der Agent übergibt das Token an das Tool, das das Formular absendet.
So kommt das Token in die Seite
Der Agent erhält das Token vom Tool und übergibt es an den nächsten Node oder das Tool, das absendet.
Woran Integrationen meistens scheitern
Setzen Sie das Timeout des Tools höher als den wait-Wert.
Nutzen Sie n8n-Credentials, damit der Schlüssel nie im Prompt oder im Workflow-Export erscheint.
FAQ zu Captchas mit n8n
Gibt es einen Community-Node?
Nein, und es ist auch keiner nötig. Das HTTP-Request-Tool deckt die gesamte API ab.
Kann ich es ohne Agenten nutzen?
Ja. In der n8n-Integrationsanleitung finden Sie einen einfachen Workflow mit einem HTTP-Request-Node.
Funktioniert es in n8n Cloud?
Ja. Es ist ein gewöhnlicher ausgehender HTTPS-Request.
Wie sehe ich, was der Agent ausgegeben hat?
Jedes Ergebnis enthält die Kosten, und das Dashboard listet jede Lösung auf.
Hilfreiche Anleitungen
Bereit zum Loslegen?
Starten Sie mit einer kostenlosen 3-tägigen Testphase und zahlen Sie danach pro erfolgreicher Lösung, wenn Ihr Traffic wächst. Für die Testphase ist keine Karte nötig.