ブラウザーエージェントで CAPTCHA MCP の結果を使用する

1. 1.

   ローカル MCP サーバーを設定する

   MCP の設定手順に従い、npx で solvethree-mcp を起動してください。これはローカルの stdio サーバーであり、ホスティングされたエンドポイントではありません。SOLVETHREE_API_KEY と SOLVETHREE_PROXY はホスト環境を通じて渡し、エージェントのプロンプトに認証情報を含めないでください。

2. 2.

   利用可能なツールとサイトプロファイルを確認する

   solvethree_capabilities を呼び出して、利用可能な機能を確認してください。reCAPTCHA Enterprise では、対象のホスト名、キャプチャアクション、reCAPTCHA タイプに対応する有効なプロファイルが、ワークスペースにあらかじめ必要です。作成ツールに site と action を渡しても、そのプロファイルは作成されません。まだ設定が必要な場合は、サイトプロファイルを使用してください。

3. 3.

   ブラウザが条件の一致するリクエストを送信できるか確認する

   ブラウザは、固定した同じプロキシと、返された userAgent および secChUa を使用できる必要があります。また、アプリケーションの Cookie、CSRF フィールド、セッション要件も維持する必要があります。ブラウザツールでこれらを設定できない場合は、無関係なブラウザセッションで代用せず、解決料金が発生する前に停止してください。

reCAPTCHA MCP ツールでは、単一のプロキシをツール引数ではなく SOLVETHREE_PROXY から取得します。ブラウザから送信する際も、そのプロキシを固定して使用してください。ホストは非公開の解決データを受け取るため、通常のエージェントレポートにはトークンやプロキシの認証情報を含めないでください。

MCP サーバーとブラウザの設定が完了したら、この指示を使用してください。アプリケーションのリクエストから、対象のホスト名と実行アクションを指定します。solvethree_create_recaptcha のデフォルトは Enterprise v3 で、必須引数は site、action、requestId です。

Use the already-configured solvethree MCP server for one reCAPTCHA Enterprise task.
The target hostname must have an active workspace profile before creation.
1. Keep one requestId for this logical task. Ask before starting another paid task.
2. Call solvethree_create_recaptcha with site, action and that requestId.
   The server reads its target proxy from SOLVETHREE_PROXY.
3. Save the returned id. Call solvethree_get_task for that id while pending/solving,
   stopping at ready, failed or the agreed deadline. Never poll by creating again.
4. If ready, submit solution.token using the application’s actual token parameter.
   Use the returned userAgent/secChUa and the same pinned proxy in the browser.
   Keep the application’s cookies, CSRF fields and session requirements.
5. Read the application response. Report task ID and outcome, not secret solution data.
If the browser tool cannot configure that proxy and identity, stop and explain the
missing capability instead of claiming it submitted an equivalent request.

保存したタスクの id は solvethree_get_task 用であり、ウェブサイトに送信する値ではありません。pending と solving は、合意した期限内で引き続き待機することを意味します。利用可能な解決結果が含まれるのは ready のみです。failed の場合は errorCode と error を確認し、そのタスクのポーリングを停止してください。

汎用的な自動入力の手順はありません。結果を使用するアプリケーションのリクエストを特定し、対応する解決フィールドを使用してください。以下の各結果では、返されたブラウザ識別情報と成功時のプロキシを、本来の対象に対して使用してください。

送信後、アプリケーションのレスポンスを確認してください。タスクが ready であることは、解決結果が生成されたことを意味し、送信先が受け入れたことを意味するわけではありません。送信先が拒否した場合は、まず送信リクエストを確認し、実際のトークン、Cookie、ヘッダーが、対応するプロキシ、識別情報、アプリケーションセッションとともに送られているか確認してください。解決結果を公開せずに、タスク ID とアプリケーション側の結果を報告してください。

論理タスクごとに requestId を 1 つ生成し、元の入力とともに保持してください。1–64 文字の ASCII 英字、数字、アンダースコア、ハイフンで構成する必要があります。id を受け取る前に作成がタイムアウトした場合は、同じ requestId と変更していない入力で同じ作成リクエストを再送し、既存のタスクを取得してください。タスクの id がすでにある場合は、solvethree_get_task を使用してください。

その ID を再利用する際に入力を変更しないでください。変更すると競合が発生します。レスポンスを受け取れなかったり、ポーリングの期限が切れたりしただけで、新しい ID を生成しないでください。いずれも、元のタスクが失敗したことを示すものではありません。

各 MCP 作成呼び出しが作成するタスクは最大 1 件ですが、それによってエージェントの支出に上限が設定されるわけではありません。別の論理タスクを開始する前には承認を必須にしてください。最終的に失敗した場合は、errorCode と error を確認してから、修正したリクエストを送るべきか判断してください。解決に失敗した場合は返金されます。リクエストエラーは、ステータスが failed のタスクとは別の問題です。