x402 Agent Tools

x402 Agent Tools

面向 AI Agent 的按次付费工具。使用 x402 协议（HTTP 402）通过 Base 上的 USDC 付款。无需 API 密钥、注册或账户。

• 在线服务：https://x402-agent-tools.x402agenttools.workers.dev
• 面向 LLM：https://x402-agent-tools.x402agenttools.workers.dev/llms.txt
• 发现入口：/.well-known/x402 · /openapi.json · /health
• MCP（远程，Streamable HTTP）：https://x402-agent-tools.x402agenttools.workers.dev/mcp

工具和价格

端点	价格（USDC）	功能
GET /v1/markdown?url=	$0.01	将网页转换为整洁的 Markdown
GET /v1/extract?url=	$0.04	结构化 JSON：元数据/OpenGraph、JSON-LD、标题、链接、表格、电子邮件
GET /v1/crawl?url=&max_pages=	$0.16	同源抓取，最多 10 个页面，每页输出 Markdown
GET /v1/token-risk?address=	$0.04	Base 代币/合约启发式风险检查（代理、所有者、危险选择器）
GET /v1/token-price?address=	$0.005	Base 代币美元价格（GeckoTerminal，备用数据源为 DefiLlama）
GET /v1/wallet-profile?address=	$0.02	Base 钱包 ETH/USDC 余额、nonce、近期 USDC 转账
GET /v1/fx?from=&to=&amount=&date=	$0.002	法币汇率（ECB 参考汇率）
GET /v1/alerts/latest?limit=	$0.01	最新的客观加密货币/市场提醒
GET|POST /v1/alerts/pass	$1	用于 GET /v1/alerts?since= 的 7 天 Bearer 令牌
GET /v1/alerts/sample	免费	3 条延迟 60 分钟以上的提醒

加密货币提醒会在触发后约 1 至 2 分钟内显示。股票新闻提醒延迟 15 至 20 分钟。提醒仅包含客观观察（价格/成交量变动）：不提供评分或买卖建议，也不构成投资建议。

免费试用

调用方（按哈希 IP 识别）每天对 /v1/markdown、/v1/token-price 和 /v1/fx 发起的前 3 次调用免费；无需提供付款标头。免费调用受每日全局上限限制。X-Free-Trial-Remaining 响应标头会显示剩余次数。抓取和提醒通行证始终收费。

Agent 如何付款（x402）

1. 调用端点。你会收到 402 Payment Required 响应，其中包含 PAYMENT-REQUIRED 标头（x402 v2）和一个 JSON 正文，列出 accepts（scheme exact、network eip155:8453、asset USDC、payTo、金额）。
2. 使用你的钱包签署 USDC 授权，然后在重试请求时携带 PAYMENT-SIGNATURE（v2）或 X-PAYMENT（v1）标头。
3. 付款中介会进行验证和结算；你将收到结果以及 PAYMENT-RESPONSE 标头。

// any x402 client works, e.g. @x402/fetch:
import { wrapFetchWithPayment } from "@x402/fetch";
const fetchWithPay = wrapFetchWithPayment(fetch, yourX402Client);
const res = await fetchWithPay("https://x402-agent-tools.x402agenttools.workers.dev/v1/markdown?url=https://example.com");

MCP

远程 MCP 服务，采用无状态 Streamable HTTP（JSON 响应），无需安装：

{ "mcpServers": { "x402-agent-tools": { "type": "http", "url": "https://x402-agent-tools.x402agenttools.workers.dev/mcp" } } }

工具：web_markdown、web_extract、web_crawl、base_token_risk、base_token_price、base_wallet_profile、fx_rates、alerts_latest、alerts_sample（免费）。

未付款调用付费工具时，返回 isError: true，并在 structuredContent["x402/payment-required"] 中提供 x402 付款要求。使用 HTTP 标头 PAYMENT-SIGNATURE 或 params._meta["x402/payment"] 传入 base64 编码的 x402 付款载荷，重试同一 tools/call。结算信息会通过 result._meta["x402/payment-response"] 返回。

无需 npm：任何支持 HTTP 传输的 MCP 客户端均可使用，也可以直接用 curl：

curl -s https://x402-agent-tools.x402agenttools.workers.dev/mcp -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

自托管

Cloudflare Worker（Hono + @x402/hono）。

npm install
# edit wrangler.toml: account_id, KV namespace id, PAY_TO (your own receive address)
npx wrangler secret put ALERTS_HMAC   # random secret for alert tokens
npx wrangler deploy

此仓库中不存放任何机密信息；所有敏感信息均为 Wrangler secret 或环境变量。

许可证

MIT。由自主 AI Agent 团队运营。仅提供信息，不构成投资建议。