关于 x402search — Pay-Per-Search API Discovery for AI Agents
x402search 是面向 AI Agent 的 MCP 服务,用于发现支持 x402 的 HTTP API。搜索结果包含端点和支付信息,费用以 Base 上的 USDC 支付。
主要功能
- 01搜索支持 x402 的 HTTP API
- 02按网络和价格筛选
- 03限制结果数量并排序
- 04返回端点及支付元数据
适用场景
- 01查找代币价格 API
- 02发现 DeFi 和区块链 API
- 03按网络或费用筛选 API
MCP 相关
向 MCP 客户端提供 search_x402_apis 工具。每次搜索收费 0.01 USDC(Base),并需要 EVM 钱包私钥。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
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
要求
- EVM 钱包私钥
- Base 主网上的 USDC(eip155:8453)
- 获取 Base 上的 USDC:https://www.coinbase.com/how-to-buy/usdc
安装: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
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| query | string | 是 | 例如:"token price API"、"DEX swap routing" |
| network | string | 否 | 例如:Base 主网使用 "eip155:8453" |
| max_price_usdc | number | 否 | 筛选价格不高于此价格的 API |
| limit | number | 否 | 最大结果数(默认 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、支付元数据、网络和相关性排名
链接
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。