solvethree エージェントスキルをインストールする

curl --fail --location --output solvethree-skill-0.1.0.zip \
  https://solvethree.com/downloads/solvethree-skill-0.1.0.zip
unzip -l solvethree-skill-0.1.0.zip
unzip solvethree-skill-0.1.0.zip -d ./skill-review
# Inspect skill-review/solvethree/SKILL.md before installing it in your host.
# The archive contains instructions; it does not start an MCP server.

1. 1.

   展開した手順を読む

   インストール前に skill-review/solvethree/SKILL.md を開いて読んでください。これはエージェントに渡される指示文です。アーカイブをダウンロードして展開しても、サーバーは起動しません。

2. 2.

   ディレクトリをホストのスキル保存先にコピーする

   Codex では、ユーザーレベルのインストールには ~/.agents/skills/solvethree/SKILL.md、プロジェクト内では .agents/skills/solvethree/SKILL.md を使用します。Markdown ファイルだけでなく、展開した solvethree ディレクトリをコピーしてください。他のホストにはそれぞれのインストール先があるため、Codex と同じパスを使用するとは限りません。

3. 3.

   ホストのドキュメントに従って読み込む

   ホストのスキル読み込み手順に従ってください。認証情報はホストの環境に保持し、SKILL.md には絶対に記載しないでください。ワークスペースの API キーは必ずサーバー側に保持してください。

ホストに呼び出し可能なツールが必要な場合は、MCP 連携を別途設定してください。公式 SDK のダウンロードには solvethree-mcp が含まれています。そのホスト環境で SOLVETHREE_API_KEY と SOLVETHREE_PROXY を指定します。これはホスト型のエンドポイントではありません。

スキルを読み込むだけで、エージェントが自律的に API を呼び出すとは考えないでください。リクエストを送るための手段の設定と、それを使用する権限が引き続き必要です。MCP サーバーはブラウザーの操作やフォームへの入力を行いません。返された解決結果は、アプリケーション側で適用する必要があります。

所有している、またはテストの許可を得ている対象への reCAPTCHA タスクでは、ホスト名、アクション、プロキシ入力を指定してください。ワークスペースには、あらかじめ有効なサイトプロファイルが必要です。スキルのインストールでもタスクの送信でも、プロファイルは作成されません。サイトプロファイルを使用するか、プロファイル設定手順に従い、プロファイルが目的のホスト名、キャプチャアクション、reCAPTCHA の種類と一致していることを確認してください。

作成後はタスク ID を保持してください。pending と solving は、引き続き待つ必要があることを意味します。利用可能な解決結果が含まれるのは ready のみです。タスクが failed の場合はポーリングを停止し、同じ入力を繰り返すのではなく、errorCode と error を確認してください。

返されたブラウザー識別情報と解決に成功したプロキシを使用し、目的の送信先へのリクエストに結果を適用してください。reCAPTCHA では solution.token を送信します。他の製品では異なる形式の結果が返されます。タスクの準備ができたことは、solvethree が解決結果を生成したことを意味し、アプリケーションのリクエストが成功したことを意味するわけではありません。