AgentScout 技能
AgentScout 將即時網路轉換為代理可用的輸入：提供一個網址，它就會回傳乾淨的
Markdown（read）、根據您提供的 Schema 驗證的結構化 JSON（extract）、
免費的價格查詢（quote），或是全站爬取（crawl）。每次付費請求都透過 x402 協議
以即時的 USDC 在 Base 鏈上結算 — 無需帳號、無需 API 金鑰、無需手動簽署
PAYMENT-SIGNATURE。服務位於 https://api.agentx402.ai/v1/scout/*。
您持有一個 AgentScout 身份，有兩種形式（由用戶端自動偵測）：
- 錢包即支付者（預設）：一個可簽章的 EVM 錢包透過 x402 內聯支付每次抓取。 AgentScout 在首次使用時會建立並管理一個本地錢包 — 存入資金後即可使用，無需註冊。
- 帳戶金鑰：對於無法簽章的受管錢包，使用一個不透明的
ak_…不記名令牌 來識別帳戶並扣減預付點數。點數透過 AgentKV 在頻外充值（請參閱 帳戶金鑰模式與充值）。
內容並未加密。 與 AgentKV（用戶端加密值，伺服器零知識）不同，AgentScout 以明文 回傳抓取的網頁內容。這在本質上就是公開的網路資料；沒有加密金鑰，且 scout 回應中 沒有任何零知識的機制。請勿將 scout 的結果視為私人資料。
何時使用 AgentScout
在以下情況使用 AgentScout：
- 基於即時網頁內容的推理 — 將頁面擷取為乾淨的 Markdown（
read）以便摘要、 引用或推理，無需無頭瀏覽器或自己的 HTML 解析器。 - 結構化萃取 — 將頁面轉換為符合您提供的 JSON Schema 的 JSON（
extract）， 例如產品的價格/規格表或文章的標題/作者/日期。 - 免費價格發現 — 在花費任何費用之前，先呼叫
quote以了解特定 URL 的確切費用；quote永不簽章也永不花費。 - 網站爬取 — 爬取一個網站最多
max_pages頁（crawl），並回傳結果清單與 工件連結；長時間爬取可透過jobId繼續。
請勿在以下情況使用 AgentScout：
- 機密或憑證。 Scout 抓取公開網路內容；它不是機密儲存庫（這類用途請使用 AgentKV 的安全工具）。
- 需要認證的私人頁面。 AgentScout 以匿名用戶端抓取 — 它無法登入、攜帶您的 工作階段 Cookie，或存取任何需要登入的頁面。
- 零預算情境。
read、extract和crawl都需要花費即時 USDC；在執行 迴圈或大量批次前，請先呼叫quote並檢查您的支出上限。
可用的 MCP 工具
agentscout MCP 伺服器提供五個工具 — 一個免費探測、三個付費擷取動作，以及一個
免費的爬取狀態檢查：
| 工具 | 說明 | 費用 |
|---|---|---|
scout_quote | 針對 URL 的免費費用探測 — 回傳原子 USDC 價格與 would_pay 建議。永不簽章，永不花費。 | 免費 |
scout_read | 擷取 URL 並回傳乾淨的 Markdown。fresh 可略過約 6 小時的讀取快取；max_tokens 可截斷結果。 | 約 $0.003 USDC + 發布者費用 |
scout_extract | 擷取 URL 並回傳根據您傳入的 JSON Schema 驗證的結構化 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）。
支付與支出上限
三個上限限制一個 scout 工作階段可以花費的金額。在外掛設定中設定（執行 /plugin 編輯）
或作為 CLI 的環境變數：
maxSpendUsd（AGENTSCOUT_MAX_SPEND_USD）— 拒絕任何單次費用超過此上限的抓取。maxSessionSpendUsd（AGENTSCOUT_MAX_SESSION_SPEND_USD）— 當整個工作階段的 累計花費超過此上限時，拒絕後續的抓取。maxTollUsd（AGENTSCOUT_MAX_TOLL_USD）— 限制付費抓取中的發布者費用。 僅限錢包模式（請參閱上述說明）。
上限是拒絕 — 超過上限的付費工具會拋出 SpendCapError，而非默默限制並花費較少
金額。SDK 總是簽署伺服器的精確 402 挑戰金額，絕不自訂計算，並在簽署前強制執行
每個上限。scout_quote 是免費的，永不計入上限，因此請先探測，再在預算內花費。
帳戶金鑰模式與充值
帳戶金鑰模式使用 ak_… 不記名令牌代替簽章錢包，並扣減預付點數。有兩點是
scout 特有的：
-
Scout 沒有充值途徑。 AgentScout 不會建立或充值帳戶 — 沒有
scout/deposit端點。ak_點數透過 AgentKV 在頻外充值，AgentKV 與 Scout 共用同一個帳戶帳本：# 從任何簽章錢包為 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. 憑證（在安裝時輸入，而非透過 shell 環境變數）
| 設定 | 必要 | 說明 |
|---|---|---|
| 錢包私鑰 | 否 | 可選 — 留空則 AgentScout 在首次使用時建立並管理一個本地錢包（然後存入資金）。若要自備：一個 EVM 私鑰（十六進位），即支付用的錢包。 |
| 帳戶金鑰 | 否 | 一個 ak_… 不記名令牌，用於受管錢包（點數）模式。透過 AgentKV 在頻外充值。與錢包金鑰互斥。 |
| AgentScout 端點 | 否 | 託管的 API；預設為 https://api.agentx402.ai。 |
| 網路 | 否 | eip155:8453（Base 主網，預設）或 eip155:84532（Base Sepolia 測試網）。 |
| 每次操作最高花費（USD） | 否 | 拒絕任何單次費用超過此上限的抓取；留空 = 無單次操作上限。 |
| 工作階段最高花費（USD） | 否 | 當累計工作階段花費超過此上限時拒絕抓取；留空 = 無上限。 |
| 最高發布者費用（USD） | 否 | 限制付費抓取中的發布者費用。僅限錢包模式；帳戶金鑰模式拒絕。 |
之後可重新執行 /plugin 來變更這些設定。使用 /mcp 確認伺服器已載入（您應該會看到
agentscout 伺服器及其五個工具）。
2. 為支付者充值
- 錢包模式： 將 USDC 發送到您錢包在 Base 上的地址 — 隨後每次 read/extract/crawl 都會透過 x402 內聯支付。沒有錢包？將私鑰設定留空 — AgentScout 在首次使用時會建立 並管理一個本地錢包 — 然後將資金存入它顯示的地址。
- 帳戶金鑰模式： 在您的
ak_令牌下將資金存入 AgentKV 的/v1/account/deposit（請參閱帳戶金鑰模式與充值）— scout 會扣減這些共享的點數。