核心功能
search-for-service是x402支付协议生态中的服务发现工具，用于在Bazaar市场中搜索和浏览付费API服务。用户可通过关键词搜索、完整列表浏览或指定URL查询详情三种方式发现可用服务。
主要用法
1. BM25智能搜索：npx awal@latest x402 bazaar search <query>支持关键词匹配，默认返回5条结果，可通过-k参数调整数量
2. 全量浏览：bazaar list命令可查看所有可用资源，支持按网络（base/base-sepolia）筛选和完整详情输出
3. 支付详情探测：x402 details <url>能自动探测端点的HTTP方法，返回402响应后展示价格、接受的支付方案、网络及输入输出模式，无需实际支付
显著优点
- 零门槛探索：搜索、列表、详情查询均无需认证或余额，降低服务发现成本
- 智能探测机制：自动尝试GET/POST/PUT等方法直到获得402响应，适配不同API设计
- 本地缓存优化：结果缓存于
~/.config/awal/bazaar/，12小时自动刷新，避免重复请求 - JSON输出支持：便于脚本集成和数据处理
局限性与风险
- 依赖CDP API可用性：429限流时会回退到缓存数据，但首次使用或缓存过期时可能受限
- 非x402端点识别局限：若URL未实现x402协议，会返回"No X402 payment requirements found"
- 仅限发现阶段：仅能预览服务，实际调用需配合
pay-for-service技能 - 网络覆盖有限：目前仅支持base和base-sepolia网络
适用人群
- 需要快速寻找特定功能API的开发者
- 希望评估API成本后再决策的采购方
- 探索x402生态可用服务的普通用户
- 作为其他技能无匹配时的fallback方案
安全考量
- 搜索本身无资金风险，但发现的服务后续调用涉及链上支付
- 建议通过
details命令验证端点合法性后再使用pay-for-service