核心用法
x402-direct 是 Coinbase 推出的 x402 生态服务目录，为 AI Agent 提供付费 API 的发现与评估能力。该工具通过四个 RESTful 端点实现功能：免费浏览服务列表 (/api/services)、按关键词搜索 (/api/search，$0.001/次)、获取单个服务详情 (/api/services/:id)，以及查看生态统计 (/api/stats)。核心使用场景包括：Agent 自主发现图像生成、天气查询、AI 推理等 x402 支付能力的服务；通过 scoutScore (0-100) 和 scoutVerdict (safe/caution/avoid) 评估服务可信度；基于 Base、Polygon、Solana 等网络筛选服务。
搜索端点采用 HTTP 402 + x402 支付协议，首次请求触发 402 响应，需支付 $0.001 USDC 后重试。支持 x402 npm 包自动处理支付流。浏览和详情端点完全免费，适合批量筛选与支付前尽职调查。
显著优点
1. 原生加密支付：深度集成 x402 协议，Agent 无需传统 API Key，通过链上支付即时获取访问权，实现真正的机器经济 (machine-to-machine commerce)。
2. 信任评分体系：自动化 Scout 评分综合 HTTPS、主网部署、域名声誉、文档质量等信号，降低 Agent 调用恶意或劣质服务的风险。
3. 语义搜索能力：付费搜索端点支持自然语言查询，超越传统分类浏览，便于模糊需求匹配。
4. 生态透明性：实时统计展示 247+ 服务、38 家提供商、跨 4 条链，帮助开发者把握 x402 生态成熟度。
潜在局限
- 搜索成本门槛：每次搜索 $0.001 虽低，但高频探索场景下成本累积，可能限制即兴查询行为。
- 服务覆盖度有限：当前 247 个服务、12 个分类规模较小，长尾需求 (如垂直行业数据) 可能无匹配结果。
- 评分中心化：ScoutScore 由目录运营方算法生成，非社区治理，存在主观权重争议空间。
- 网络集中：Base 主网占 73% 服务，多链均衡性不足，非 Base 生态 Agent 选择受限。
适合人群
- 构建自主 Agent 的开发者，需程序化发现付费能力
- DeFAI、AI 代理钱包项目，需为 Agent 集成 "技能市场"
- 探索机器支付 (Machine Payable Web) 的前沿团队
常规风险
- 合约风险：调用的目标服务智能合约未经审计，ScoutScore 不保证代码安全。
- 价格波动：服务方可能随时调整
price，Agent 需每次调用前校验详情端点。 - 网络风险：Solana、Polygon 服务存在跨链桥接或网络拥堵导致的支付失败。
- 目录单点故障：x402.direct 若宕机，Agent 失去服务发现能力，建议本地缓存常用服务元数据。