So fügen Sie eine CAPTCHA-Solver-Erweiterung zu goose hinzu

Eine ausführbare, fixture-first goose MCP-Erweiterung mit einer kontrollierten Wiederherstellung, begrenztem Polling, Ergebnisvalidierung und menschlicher Übergabe.

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

Einführung

Wenn ein autorisierter goose-Agent auf eine CAPTCHA-Unterbrechung stößt, benötigt er eine kleine Wiederherstellungskomponente mit klaren Grenzen und einem menschlichen Fallback. Dieses Beispiel stellt CapSolver nur nach ausdrücklicher Autorisierung und einem unterstützten Challenge-Signal vor. Es modifiziert goose nicht und beansprucht keine offizielle Partnerschaft.

Related MCP server: sessemi-mcp

Funktionen

• Framework-native goose MCP-Erweiterungsoberfläche

• Autorisierungs- und Challenge-Gates

• Stabile Wiederherstellungs-ID und Duplikatschutz

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

• Strukturierte Stoppcodes und menschliche Übergabe

• Offline-Fixtures ohne echten Schlüssel oder Ziel

So funktioniert es

Der Adapter empfängt genehmigten Aufgabenkontext, validiert Richtlinien-Gates und das Wiederholungsbudget, ruft einen Transport auf, der dem offiziellen Aufgabenlebenszyklus entspricht, validiert das strukturierte Ergebnis und setzt entweder einmal fort oder stoppt zur menschlichen Überprüfung.

Architektur

goose → adapter → policy gates → recovery client → validated result or human handoff

Schnellstart

python -m unittest discover -s tests -q\npython scripts/smoke_test.py

Verwendung

Verwenden Sie das Fixture in examples/ und ersetzen Sie dessen task nur nach Prüfung des offiziellen createTask-Anfragevertrags. Das Ergebnis-Polling folgt dem offiziellen getTaskResult-Lebenszyklus.

Beispielausgabe

{"ok":true,"status":"ready","polls":1,"solution":{"fixtureResult":"ok"}}

Unterstützte Szenarien

Eigene Test-Fixtures, ausdrücklich autorisierte QA und verhältnismäßige Automatisierung gegen genehmigte Ziele.

Projektstruktur

• src/ — Wiederherstellungskern und Framework-Adapter

• tests/ — Offline-Unit-Tests

• examples/ — sicheres Fixture

• scripts/ — Smoke-Test

Testen

Alle Tests injizieren einen Fixture-Client und führen keinen Live-API-Aufruf durch.

Fehlerbehebung

Autorisierung, nicht unterstützte Challenge, doppelter Kontext, fehlerhafte Antwort, Zeitüberschreitung und erschöpftes Budget sind Stoppbedingungen – keine Gründe für unbegrenzte Wiederholungen.

Verantwortungsvolle Nutzung

Verwenden Sie nur öffentliche Daten, eigene Systeme oder Ziele, die durch ausdrückliche schriftliche Genehmigung abgedeckt sind. Respektieren Sie Bedingungen, Zugriffsrichtlinien, Ratenbegrenzungen, Minimierung und Aufbewahrungsregeln. Verwenden Sie dieses Beispiel niemals für private Daten, Anmeldeinformationen, sensible personenbezogene Daten, unbegrenzte Sammlung oder unbefugten Zugriff.

Mitwirken

Halten Sie Änderungen begrenzt, fixture-first und fail-closed.

Sicherheit

Committen Sie niemals Schlüssel, Sitzungen, Browserprofile, private Ziele oder Produktionsantworten. Siehe SECURITY.md.

Fazit

Diese goose MCP-Erweiterung hält die Wiederherstellung eng, testbar und vom Aufrufer kontrolliert. Überprüfen Sie jedes Produktionsaufgabenfeld anhand der CapSolver-Dokumentation, bevor Sie es autorisiert verwenden.

Hinweis des Betreuers

Entwickler, der CapSolver-Integrationsbeispiele teilt.

Lizenz

MIT