gooseにCAPTCHAソルバー拡張機能を追加する方法

実行可能な、フィクスチャ優先のgoose MCP拡張機能。制御された1回のリカバリ、制限付きポーリング、結果検証、および人間による引き継ぎを備えています。

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

はじめに

認可されたgooseエージェントがCAPTCHAによる中断に遭遇した場合、明確な制限と人間によるフォールバックを備えた小さなリカバリコンポーネントが必要です。この例では、明示的な認可とサポートされているチャレンジシグナルの後にのみCapSolverを紹介します。gooseを変更したり、公式パートナーシップを主張したりするものではありません。

Related MCP server: sessemi-mcp

特徴

• フレームワークネイティブのgoose MCP拡張サーフェス

• 認可およびチャレンジゲート

• 安定したリカバリIDと重複保護

• 作成呼び出しは1回、ポーリングは最大5回

• 構造化された停止コードと人間による引き継ぎ

• 実際のキーやターゲットを使用しないオフラインのフィクスチャ

仕組み

アダプタは承認されたタスクコンテキストを受け取り、ポリシーゲートとリトライ予算を検証し、公式のタスクライフサイクルに一致するトランスポートを呼び出し、構造化された結果を検証して、1回だけ再開するか、人間によるレビューのために停止します。

アーキテクチャ

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

クイックスタート

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

使用方法

examples/ 内のフィクスチャを使用し、公式のcreateTaskリクエスト契約を確認した後にのみ、その task を置き換えてください。結果のポーリングは公式のgetTaskResultライフサイクルに従います。

出力例

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

サポートされているシナリオ

所有するテストフィクスチャ、明示的に認可されたQA、および承認されたターゲットに対する適切な規模の自動化。

プロジェクト構造

• src/ — リカバリコアとフレームワークアダプタ

• tests/ — オフラインのユニットテスト

• examples/ — 安全なフィクスチャ

• scripts/ — スモークテスト

テスト

すべてのテストはフィクスチャクライアントを注入し、ライブAPI呼び出しを行いません。

トラブルシューティング

認可、サポートされていないチャレンジ、重複コンテキスト、不正なレスポンス、タイムアウト、予算の枯渇は停止条件であり、無制限のリトライの理由ではありません。

責任ある使用

公開データ、所有するシステム、または明示的な書面による認可の対象となるターゲットのみを使用してください。利用規約、アクセスポリシー、レート制限、最小化、および保持ルールを尊重してください。プライベートデータ、認証情報、機密性の高い個人データ、無制限の収集、または不正アクセスにこの例を使用しないでください。

貢献

変更は範囲を限定し、フィクスチャ優先で、フェイルクローズに保ってください。

セキュリティ

キー、セッション、ブラウザプロファイル、プライベートターゲット、または本番レスポンスをコミットしないでください。SECURITY.md を参照してください。

まとめ

このgoose MCP拡張機能は、リカバリを狭く、テスト可能に、そして呼び出し側によって制御されるように保ちます。認可された使用の前に、すべての本番タスクフィールドをCapSolverのドキュメントと照合して検証してください。

メンテナー注記

CapSolver統合の例を共有する開発者。

ライセンス

MIT