AgentScout スキル
AgentScout は、ライブウェブをエージェントが扱いやすい入力に変換します。URL を与えると、クリーンな Markdown（read）、指定したスキーマで検証された構造化 JSON（extract）、無料の価格調査（quote）、またはサイト全体のクロール（crawl）を返します。有料のフェッチはすべて、x402 プロトコルを介して Base 上のリアルタイム USDC で決済されます。アカウント登録や API キー、手動の PAYMENT-SIGNATURE 署名は一切不要です。サービスは https://api.agentx402.ai/v1/scout/* で稼働しています。
あなたは 1つの AgentScout アイデンティティ を保持し、その形状は次の2つのうちのいずれかです（クライアントが自動検出します）。
- ウォレット-as-payer（デフォルト）：署名可能な EVM ウォレットが x402 を介して各フェッチをインラインで支払います。AgentScout は初回使用時にローカルウォレットを生成して管理します。資金を入れてすぐに使用開始できます。サインアップは不要です。
- アカウントキー：署名できない 管理された ウォレットの場合、不透明な
ak_…ベアラートークン がアカウントを識別し、プリペイドクレジット から差し引きます。クレジットは、AgentKV を介して帯域外でチャージされます（下記の アカウントキーモードと資金調達 を参照）。
コンテンツは暗号化されていません。 AgentKV（クライアント側で値を暗号化するためサーバーはゼロ知識）とは異なり、AgentScout はフェッチしたウェブコンテンツを平文で返します。これは定義上、公開ウェブデータです。スカウトレスポンスには暗号化キーもゼロ知識な点もありません。スカウト結果をプライベートデータとして扱わないでください。
AgentScout を使用するタイミング
AgentScout は、以下のような場合に使用します。
- ライブウェブコンテンツへのグラウンディング — ページをクリーンな Markdown（
read）として取得し、ヘッドレスブラウザや独自の HTML パーサーを使わずに、要約、引用、推論を行います。 - 構造化抽出 — 提供した JSON スキーマ（
extract）に対して検証される JSON としてページを変換します。例：製品の価格/スペック表や記事のタイトル/著者/日付。 - 無料の価格調査 — まず
quoteを呼び出して、実際に支払う前に URL の正確なコストを確認します。quoteは署名も支払いも行いません。 - サイトクロール —
max_pages（crawl）までサイトを巡回し、結果のマニフェストとアーティファクトリンクを返します。長時間のクロールはjobIdで再開できます。
AgentScout を以下の目的で使用しないでください。
- 機密情報や認証情報。 スカウトは 公開 ウェブコンテンツを取得します。シークレットストアではありません（その場合は AgentKV のシークレットセーフツールを使用してください）。
- 認証が必要なプライベートページ。 AgentScout は匿名クライアントとしてフェッチします。ログインできず、セッションクッキーを保持できず、ログイン壁の背後にあるものには到達できません。
- 予算ゼロのコンテキスト。
read、extract、crawlはそれぞれ実際の USDC がかかります。ループや一括実行の前にquoteを呼び出し、支出上限を確認してください。
利用可能な MCP ツール
agentscout MCP サーバーは、5つのツールを公開しています。1つの無料調査ツール、3つの有料フェッチ動詞、1つの無料クロールステータス確認ツールです。
| ツール | 説明 | コスト |
|---|---|---|
scout_quote | URL の無料コスト調査 — 原子 USDC 価格と would_pay アドバイザリを返します。署名も支払いも行いません。 | 無料 |
scout_read | URL をフェッチし、クリーンな Markdown を返します。fresh は約6時間の読み取りキャッシュをバイパスします。max_tokens は結果を切り詰めます。 | 約 $0.003 USDC + パブリッシャー手数料 |
scout_extract | URL をフェッチし、渡された JSON スキーマに対して検証された構造化 JSON を抽出します。オプションで自然言語の instructions を指定できます。 | 約 $0.012 USDC + パブリッシャー手数料 |
scout_crawl | max_pages（必須、価格決定要因）までサイトをクロールし、アーティファクトリンク付きの結果マニフェストを返します。長時間のクロールは jobId を返します。 | 約 $0.002 USDC × max_pages + 手数料 |
scout_crawl_status | jobId でクロールジョブのステータスを確認します。完了している場合はマニフェストを、処理中は進行状況を返します。 | 無料 |
パブリッシャー手数料はウォレットモードのみです。 ページには基本料金に加えてパブリッシャーの 手数料 がかかる場合があります。これはフェッチ時にサイトに支払われる追加の USDC です。
max_toll_usdはその手数料に上限を設定しますが、これは ウォレットモードでのみ 適用されます。ak_（アカウントキー）の呼び出し元は手数料を支払えないため、アカウントキーモードでmax_toll_usdを設定すると、リクエストが送信される前にクライアント側で拒否されます（tolls_require_x402）。
支払いと支出上限
スカウトセッションが消費できる金額には3つの上限があります。これらはプラグイン設定（/plugin を実行して編集）または CLI の環境変数として設定します。
maxSpendUsd（AGENTSCOUT_MAX_SPEND_USD）— これを超えるコストがかかる 単一の フェッチを拒否します。maxSessionSpendUsd（AGENTSCOUT_MAX_SESSION_SPEND_USD）— セッション全体の累積支出がこれを超えた場合、それ以上のフェッチを拒否します。maxTollUsd（AGENTSCOUT_MAX_TOLL_USD）— 有料フェッチのパブリッシャー手数料に上限を設定します。ウォレットモードのみ（上記の注意事項を参照）。
上限は 拒否 します。有料ツールが上限を超えると、SpendCapError がスローされます。SDK は常にサーバーの正確な 402 チャレンジ金額に署名し、自己計算された金額には署名しません。また、署名 前 にすべての上限を適用します。scout_quote は無料で、上限にカウントされることはありません。まず調査し、その後予算内で支出してください。
アカウントキーモードと資金調達
アカウントキーモードは、署名ウォレットの代わりに ak_… ベアラートークンを使用し、プリペイドクレジット から差し引きます。スカウトに固有の点は2つあります。
-
スカウトには入金ルートがありません。 AgentScout はアカウントを作成したり資金を調達したりしません。
scout/depositエンドポイントはありません。ak_クレジットは、同じアカウント元帳を共有する AgentKV を介して帯域外で チャージされます。# 任意の署名ウォレットから ak_ アカウントに資金を追加する（AgentKV の入金ルート経由）: awal x402 pay https://api.agentx402.ai/v1/account/deposit \ --headers '{"Authorization":"Bearer ak_..."}'この入金で購入されたクレジットは、同じ
ak_ベアラーの下で AgentScout が使用できます。 -
手数料はアカウントキーモードでは拒否されます。 管理されたアカウントはパブリッシャー手数料を支払うことができないため、
ak_認証情報でmax_toll_usd（maxTollUsd）を設定すると、リクエストが発行される前にクライアント側でtolls_require_x402エラーで失敗します。手数料を支払う必要がある場合は、ウォレットモードを使用してください。
クロール：再開可能なジョブ
クロールは単一のリクエストよりも長く続く可能性があります。timeout_ms 以内に完了しない場合、scout_crawl はブロックする代わりに jobId を持つ 保留中ハンドル を返します。
scout_crawl { url, max_pages, timeout_ms }→ 完了したマニフェスト、または{ jobId, … }を返します。scout_crawl_status { job_id }（無料）をポーリングして、完了したマニフェストが返されるまで待ちます。- SDK/CLI（
agentscout crawl artifact <jobId> <key>）を介して、マニフェストで参照されている個々のページアーティファクトを取得します。
max_pages が価格決定要因であるため、クロールは全額（max_pages × ページ単価）を 前払い で決済します。jobId によるジョブの再開は無料です。
ワンタイムセットアップ
Claude Code のマーケットプレイスからプラグインをインストールします。具体的な /plugin marketplace add および /plugin install コマンドは、プラグインの README.md（plugin/README.md）に記載されています。インストール後、Claude Code が設定を プロンプト し、あなたの代わりに MCP サーバーに設定をスレッド化します。
1. 認証情報（インストール時に入力。シェル環境変数ではありません）
| 設定 | 必須 | 説明 |
|---|---|---|
| ウォレット秘密鍵 | いいえ | オプション — 空白のままにすると、AgentScout が初回使用時にローカルウォレットを生成して管理します（その後、資金を入れてください）。独自のものを使用する場合：EVM 秘密鍵（16進数）、支払いを行うウォレット。 |
| アカウントキー | いいえ | 管理ウォレット（クレジット）モード用の ak_… ベアラートークン。AgentKV を介して帯域外でチャージされます。ウォレットキーとは相互に排他的です。 |
| AgentScout エンドポイント | いいえ | ホスト型 API。デフォルトは https://api.agentx402.ai。 |
| ネットワーク | いいえ | eip155:8453（Base メインネット、デフォルト）または eip155:84532（Base Sepolia テストネット）。 |
| 1回の操作あたりの最大支出（USD） | いいえ | これを超えるコストがかかる単一のフェッチを拒否します。空欄 = 上限なし。 |
| セッション最大支出（USD） | いいえ | セッションの累積支出がこれを超えた場合、フェッチを拒否します。空欄 = 上限なし。 |
| 最大パブリッシャー手数料（USD） | いいえ | 有料フェッチの手数料に上限を設定します。ウォレットモードのみ。アカウントキーモードでは拒否されます。 |
後で変更するには /plugin を再実行してください。サーバーがロードされたことを確認するには /mcp を実行します（agentscout サーバーとその5つのツールが表示されるはずです）。
2. 支払い元への資金投入
- ウォレットモード： Base 上の自分のウォレットアドレスに USDC を送金します。これにより、読み取り/抽出/クロールは x402 を介してフェッチごとにインラインで支払われます。ウォレットをお持ちでない場合：秘密鍵の設定を空白のままにしておくと、AgentScout が初回使用時にローカルウォレットを生成して管理します。その後、表示されたアドレスに資金を入れてください。
- アカウントキーモード： 上記の アカウントキーモードと資金調達 を参照して、
ak_ベアラーの下で AgentKV の/v1/account/depositに入金します。スカウトはそれらの共有クレジットから差し引きます。