用途:通过 npx awal@latest x402 命令发现和查看 x402 bazaar 市场上可用的付费 API 端点,适合在需要调用付费服务前先检索和确认价格与支付要求。搜索、列表和详情命令无需认证或余额。
主要能力:
- 关键词搜索:npx awal@latest x402 bazaar search <query> [-k <n>] [--force-refresh] [--json],使用 BM25 相关性搜索,-k/--top 指定结果数(默认 5),--force-refresh 从 CDP API 重新获取资源索引,--json 输出 JSON。结果本地缓存于 ~/.config/awal/bazaar/,12 小时后自动刷新。
- 浏览资源:npx awal@latest x402 bazaar list [--network <network>] [--full] [--json],--network 按网络过滤(base、base-sepolia),--full 显示含 schema 的完整详情。
- 查看支付要求:npx awal@latest x402 details <url> [--json],在不付费的情况下自动尝试 GET、POST、PUT、DELETE、PATCH 直到获得 402 响应,随后显示价格、可接受的支付方案、网络及输入输出 schema。
示例:npx awal@latest x402 bazaar search "weather";npx awal@latest x402 bazaar search "sentiment analysis" -k 10;npx awal@latest x402 bazaar list --full;npx awal@latest x402 details https://example.com/api/weather。
下一步:找到目标服务后,可使用 pay-for-service 技能向该端点发起付费请求。
限制与错误:搜索、列表、详情无需认证;出现 CDP API returned 429 表示被限流,若有缓存数据则使用缓存;出现 No X402 payment requirements found 表示该 URL 可能不是 x402 端点。