So fügen Sie ein CAPTCHA-Löser-Tool zu Ruflo hinzu

Ein ausführbares, fixture-first stdio-MCP-Begleittool mit einem Wiederherstellungsversuch, begrenztem Polling, strukturierter Validierung und menschlicher Übergabe.

English · 简体中文 · 日本語 · Español · Português · 한국어

Einführung

Wenn ein autorisierter Ruflo-Workflow auf eine CAPTCHA-Unterbrechung stößt, benötigt er ein begrenztes Wiederherstellungstool, das entweder ein validiertes Ergebnis zurückgibt oder für eine menschliche Überprüfung anhält. Dieser begleitende MCP-Server zeigt, wie eine Ruflo-Aufgabe CapSolver nur nach expliziter Autorisierung und einem unterstützten Challenge-Signal aufrufen kann. Er modifiziert Ruflo nicht und beansprucht keine offizielle Partnerschaft. Das API-Aufgabenobjekt bleibt vom Aufrufer überprüft, sodass das Beispiel keine Produktfelder erfindet.

Funktionen

• Ein MCP-Tool: captcha_solver_recover_once

• Explizite Autorisierungs- und Challenge-Gates

• Stabile Wiederherstellungs-ID für Idempotenz

• Ein Create-Aufruf und höchstens fünf Ergebnisabfragen

• Timeouts, strukturierte Fehler und menschliche Übergabe

• Offline-Fixtures; kein echter Schlüssel oder Ziel erforderlich

So funktioniert es

Ruflo leitet eine genehmigte Aufgabe an den lokalen stdio-Server weiter. Das Tool validiert Autorisierung, Challenge-Zustand, Kontext und Budget, bevor es den offiziellen Auftragserstellungsvertrag verwendet. Es akzeptiert nur eine fertige Lösung, andernfalls pollt es innerhalb des konfigurierten Budgets und stoppt sicher.

Architektur

Ruflo → MCP tools/call → policy gates → CapSolver client → result validator → resume or human handoff

Schnellstart

npm test
npm run smoke
CAPSOLVER_API_KEY=replace_me npm start

Öffnen Sie in der Web-UI von Ruflo MCP (n) → Add Server, wählen Sie einen stdio-Server und verwenden Sie node src/server.js als lokalen Befehl. Ruflo dokumentiert auch HTTP- und SSE-Endpunkte; dieses Repository implementiert absichtlich nur stdio.

Verwendung

Verwenden Sie examples/tool-call.json als Fixture-Form. Ersetzen Sie task nur mit einem Aufgabenobjekt, das gegen den offiziellen createTask-Anfragevertrag geprüft wurde. Die Ergebnisabfrage folgt dem offiziellen getTaskResult-Lebenszyklus.

Beispielausgabe

{"ok":true,"status":"ready","recoveryId":"qa-run-0001","polls":1,"solution":{"fixtureResult":"ok"}}

Unterstützte Szenarien

Eigene Test-Fixtures, explizit autorisierte QA und verhältnismäßige Automatisierung gegen genehmigte Ziele. Nicht unterstützte Zustände stoppen für eine menschliche Überprüfung.

Projektstruktur

• src/server.js — stdio-JSON-RPC-Router

• src/tool.js — MCP-Tooldefinition und sichere Fehlerzuordnung

• src/recovery.js — begrenzter Wiederherstellungsvertrag

• tests/ — Offline-Unit-Tests

• examples/ — Nur-Fixture-Toolaufruf

Testen

npm test
npm run smoke

Die Tests verwenden injizierte Clients und rufen niemals eine Live-API auf.

Fehlerbehebung

AUTHORIZATION_REQUIRED, NO_SUPPORTED_CHALLENGE, DUPLICATE_RECOVERY, TIMEOUT und BUDGET_EXHAUSTED sind Stoppsignale. Überprüfen Sie die Aufgabe und übergeben Sie sie einem Menschen, anstatt endlos zu wiederholen.

Verantwortungsvolle Nutzung

Verwenden Sie nur öffentliche Daten, eigene Systeme oder Ziele, die durch eine ausdrückliche schriftliche Genehmigung abgedeckt sind. Respektieren Sie Zugriffsrichtlinien, Bedingungen, Ratenlimits, Aufbewahrungslimits und menschliche Stoppentscheidungen. Verwenden Sie dieses Beispiel nicht für private Daten, Anmeldeinformationen, sensible persönliche Informationen, uneingeschränkte Sammlung oder unbefugten Zugriff.

Mitwirken

Halten Sie Änderungen fixture-first, begrenzt und fail-closed. Führen Sie beide Prüfungen vor einem Pull-Request aus.

Sicherheit

Committen Sie niemals Schlüssel, Cookies, Browserprofile, private Ziel-URLs oder Produktionsantworten. Siehe SECURITY.md.

Fazit

Dieses Begleittool gibt Ruflo eine kleine, prüfbare Wiederherstellungsgrenze, während Routing, Budgets, Validierung und menschliche Kontrolle explizit bleiben. Bestätigen Sie für einen autorisierten Produktionsadapter jedes Aufgabenfeld anhand der CapSolver-Dokumentation, bevor Sie es verwenden.

Hinweis des Betreuers

Entwickler, der CapSolver-Integrationsbeispiele teilt.

Lizenz

MIT