名称: 搜索服务描述: 在 x402 集市市场搜索和浏览付费 API 服务。当您或用户想要查找可用服务、查看可用内容、发现 API 或需要外部服务来完成某项任务时使用。当没有其他技能明确匹配时，也可用作后备方案——搜索集市以查看是否存在付费服务。涵盖“我能做什么？”、“为我找一个用于…的 API”、“有哪些服务可用？”、“搜索…”、“浏览集市”。用户可调用: true 禁用模型调用: false 允许的工具: [“Bash(npx awal@latest x402 bazaar )”, “Bash(npx awal@latest x402 details )”]

搜索 x402 集市

使用 npx awal@latest x402 命令来发现和检查 x402 集市市场上可用的付费 API 端点。搜索无需身份验证或余额。

命令

搜索集市

通过关键词使用 BM25 相关性搜索查找付费服务：

npx awal@latest x402 bazaar search <查询> [-k <n>] [--force-refresh] [--json]

选项	描述
`-k, --top <n>`	结果数量（默认：5）
`--force-refresh`	从 CDP API 重新获取资源索引
`--json`	以 JSON 格式输出

结果缓存在本地 ~/.config/awal/bazaar/，并在 12 小时后自动刷新。

列出集市资源

浏览所有可用资源：

npx awal@latest x402 bazaar list [--network <网络>] [--full] [--json]

选项	描述
`--network <名称>`	按网络筛选（base, base-sepolia）
`--full`	显示完整详细信息，包括模式
`--json`	以 JSON 格式输出

发现支付要求

在不支付的情况下检查端点的 x402 支付要求：

npx awal@latest x402 details <url> [--json]

通过尝试每种 HTTP 方法（GET、POST、PUT、DELETE、PATCH）直到收到 402 响应，自动检测正确的 HTTP 方法，然后显示价格、接受的支付方案、网络以及输入/输出模式。

示例

# 搜索与天气相关的付费 API
npx awal@latest x402 bazaar search "天气"

# 搜索更多结果
npx awal@latest x402 bazaar search "情感分析" -k 10

# 浏览所有集市资源并显示完整详细信息
npx awal@latest x402 bazaar list --full

# 检查一个端点需要多少费用
npx awal@latest x402 details https://example.com/api/weather

先决条件

搜索、列出或详情命令无需身份验证

后续步骤

一旦找到想要使用的服务，请使用 pay-for-service 技能向端点发出付费请求。

错误处理

“CDP API 返回 429” - 速率受限；如果有缓存数据将使用缓存数据
“未找到 X402 支付要求” - URL 可能不是 x402 端点