mcpField
X
x402search — Pay-Per-Search API Discovery for AI Agents

x402search — Pay-Per-Search API Discovery for AI Agents

本地服务
github.com/x402-index开发工具231 周前更新

关于 x402search — Pay-Per-Search API Discovery for AI Agents

x402search 是面向 AI Agent 的 MCP 服务,用于发现支持 x402 的 HTTP API。搜索结果包含端点和支付信息,费用以 Base 上的 USDC 支付。

主要功能

  1. 01搜索支持 x402 的 HTTP API
  2. 02按网络和价格筛选
  3. 03限制结果数量并排序
  4. 04返回端点及支付元数据

适用场景

  1. 01查找代币价格 API
  2. 02发现 DeFi 和区块链 API
  3. 03按网络或费用筛选 API

MCP 相关

向 MCP 客户端提供 search_x402_apis 工具。每次搜索收费 0.01 USDC(Base),并需要 EVM 钱包私钥。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"x402search": {
"command": "npx",
"args": [
"-y",
"x402search-mcp"
],
"env": {
"PRIVATE_KEY": "<PRIVATE_KEY>"
}
}
}
}
启动命令npx -y x402search-mcp
需要配置的环境变量
PRIVATE_KEY密钥EVM private key for x402 payment signing

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
npmx402search-mcp1.0.2

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。

详细介绍

x402search MCP 服务

从任何兼容 MCP 的 Agent 搜索 14,000 多个支持 x402 的 HTTP API。

版本: 1.0.3 · 许可证: MIT · 费用: 每次搜索 0.01 USDC · Base 主网 · 无需账户

npm: https://www.npmjs.com/package/x402search-mcp
PyPI: https://pypi.org/project/x402search-mcp
API: https://x402search.xyz


要求


安装:Claude Desktop

添加到你的 claude_desktop_config.json:

{
  "mcpServers": {
    "x402search": {
      "command": "npx",
      "args": ["[email protected]"],
      "env": {
        "EVM_PRIVATE_KEY": "0xYOUR_PRIVATE_KEY_HERE"
      }
    }
  }
}

配置文件位置:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

安装:Claude Code

claude mcp add x402search -- npx [email protected]

然后设置你的密钥:

export EVM_PRIVATE_KEY=0xYOUR_PRIVATE_KEY_HERE

安装:Cursor

添加到 .cursor/mcp.json:

{
  "mcpServers": {
    "x402search": {
      "command": "npx",
      "args": ["[email protected]"],
      "env": {
        "EVM_PRIVATE_KEY": "0xYOUR_PRIVATE_KEY_HERE"
      }
    }
  }
}

安装:Windsurf

添加到 ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "x402search": {
      "command": "npx",
      "args": ["[email protected]"],
      "env": {
        "EVM_PRIVATE_KEY": "0xYOUR_PRIVATE_KEY_HERE"
      }
    }
  }
}

安装:Python Agent(LangChain、CrewAI、AutoGen、GAME SDK)

pip install x402search-mcp
from x402search import search_x402_apis
results = search_x402_apis(
    query="token price API ethereum",
    private_key="0xYOUR_PRIVATE_KEY_HERE"
)
print(results)

完整文档:https://pypi.org/project/x402search-mcp


快速测试

EVM_PRIVATE_KEY=0xYOUR_KEY npx [email protected]

工具:search_x402_apis

参数类型必填说明
querystring是例如:"token price API"、"DEX swap routing"
networkstring否例如:Base 主网使用 "eip155:8453"
max_price_usdcnumber否筛选价格不高于此价格的 API
limitnumber否最大结果数(默认 10,最多 50)

Virtuals ACP 集成

x402search 已作为原生 ACP Agent 上架 Virtuals 协议市场。

  • Agent ID: 22531
  • Agent 资料: https://app.virtuals.io/acp/agent-details/22531
  • 任务名称: x402search
  • 价格: 每次搜索 0.01 USDC
  • 接受加密货币、DeFi 和区块链 API 发现查询
  • 在请求阶段自动拒绝离题请求
  • 返回结构化结果:端点 URL、支付元数据、网络和相关性排名

链接

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。