AgentScout 技能
AgentScout 将实时网页转化为 Agent 可直接使用的输入：提供 URL，它就能返回干净的 Markdown（read）、根据你提供的 JSON Schema 验证的结构化 JSON（extract）、免费价格探针（quote）或全站爬取结果（crawl）。每次付费请求都通过 Base 网络上的 x402 协议以真实 USDC 结算——无需账户、无需 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，可选配自然语言指令。 | ~$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 共享同一个账户账本：# 从任意签名钱包向 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 测试网）。 |
| 单次操作最大支出（美元） | 否 | 拒绝任何单次费用超过此值的请求；留空表示无单次操作上限。 |
| 会话最大支出（美元） | 否 | 当会话累计支出超过此值时拒绝后续请求；留空表示无上限。 |
| 最大发布者费用（美元） | 否 | 限制付费请求中的发布者费用。仅限钱包模式；在账户密钥模式下被拒绝。 |
之后可重新运行 /plugin 更改这些设置。使用 /mcp 验证服务器是否已加载（你应该能看到 agentscout 服务器及其五个工具）。
2. 为支付方充值
- 钱包模式： 将 USDC 发送到你的 Base 网络钱包地址——读取/提取/爬取将随后通过 x402 逐笔支付。没有钱包？将私钥配置留空——AgentScout 在首次使用时自动创建并管理一个本地钱包——然后向其打印的地址充值即可。
- 账户密钥模式： 使用你的
ak_不记名令牌向 AgentKV 的/v1/account/deposit充值（参见 账户密钥模式与充值 部分）——Scout 将扣除这些共享积分。