我构建了一个按搜索付费的 API 发现引擎——无需 API 密钥,只用 crypto (x402)

发布: (2026年3月8日 GMT+8 20:19)
5 分钟阅读
原文: Dev.to

Source: Dev.to

I built a pay-per-search API discovery engine — no API keys, just crypto (x402) 的封面图片

问题

当一个代理需要它没有的能力——天气数据、图像生成、价格信息、网页抓取——时,它没有好的方式自行寻找付费 API。如今所有的 API 变现模式都假设有人类在进行注册。机器没有标准的方式来表达“我想要这个能力,这里是付款,给我结果”。

我正试图填补这一空白。

什么是 x402?

x402 是一个开放协议,使 HTTP 402 Payment Required 状态码活起来。当客户端在未付款的情况下访问启用了 x402 的端点时,服务器会返回 402 并附带机器可读的付款请求。客户端在链上支付(通常是 Base 主网的 USDC),附加付款证明头部,然后重试——整个过程只需一次往返。无需账户、API 密钥或仪表板。只需要一个钱包和一个 HTTP 客户端。

x402search 的功能

x402search 是一个面向 x402‑enabled API 的发现引擎。它索引了 13,000+ 个 API,遍布 x402 生态系统,并通过 MCP(Model Context Protocol)工具向 Claude、Cursor、Windsurf 以及任何兼容 MCP 的代理原生提供调用。

  • 每次搜索在 Base 主网的费用为 $0.01 USDC — 由使用 x402 协议的代理自动支付。
  • 无需注册,无速率限制层级,无 API 密钥轮换。
  • 搜索工具支持自然语言查询,并支持网络过滤(Base 为 eip155:8453)和最高价格过滤。
  • 结果包括端点 URL、描述、定价以及实际调用 API 所需的支付元数据。

在两行内安装

将以下内容添加到您的 MCP 配置中(Claude Desktop、Cursor、Windsurf 等):

{
  "mcpServers": {
    "x402search": {
      "command": "npx",
      "args": ["-y", "x402search-mcp"],
      "env": {
        "WALLET_PRIVATE_KEY": ""
      }
    }
  }
}

您的钱包需要在 Base 主网拥有少量 USDC。每次搜索 $0.01,$1 可进行 100 次查询。MCP 服务器会自动处理付款——代理只需使用查询字符串调用 search_x402_apis 即可。

工作原理

  1. 代理调用 search_x402_apis
  2. MCP 服务器向 https://x402search.xyz/v1/search 发送 POST 请求。
  3. 服务器返回一个 402 响应,其中包含付款请求:网络 eip155:8453、金额 10000(6 位小数表示的 0.01 USDC)、收款地址以及 nonce。
  4. x402 客户端库在 Base 主网签名并提交 USDC 转账,附带 X-Payment 头部作为付款凭证,然后重新发起请求。
  5. 服务器验证链上付款后,返回搜索结果。

MCP 服务器使用 @x402/axios 包装标准的 Axios 实例,使用 @x402/evm(基于 viem)进行 EVM 签名,并通过 @modelcontextprotocol/sdk 将工具以 stdio 方式暴露。私钥始终保留在本地——从不离开代理的运行环境。

当前状态

  • 索引器已上线,针对 CDP Bazaar 数据集运行,已索引 12,845+ 条资源。
  • 搜索 API 正在 Base 主网运行,并接受真实支付。
  • MCP 包已在 npm 上发布。

接下来

  • 在 CDP Bazaar 之外实现更广泛的索引覆盖
  • 关键字 + 语义混合搜索
  • 一个不仅能 查找 API,还能自主在它们之间组合多步骤工作流的代理
  • 一个公开的最常查询能力排行榜

试一试

如果你正在使用 MCP 开发或探索 x402 生态系统,请给项目点个星并告诉我你在做什么。我尤其对那些需要在单个任务中组合多个付费 API 的代理用例感兴趣——这正是它变得有趣的地方。

0 浏览
Back to Blog

相关文章

阅读更多 »