agent-web-reader

x402-agent-data

面向 AI Agent 的按次付费数据工具，通过 x402 协议以 Base 上的 USDC 按次结算。买方是另一个 Agent：它会发现端点、按请求自动付款（HTTP 402 → 付款 → 数据）， 并获取结构化 JSON。无需 API 密钥、无需注册、无需账户——卖方只需设置一个公开的钱包地址。

现已上线：https://x402.charliemorrison.dev — 同时也作为远程 MCP 服务列入 官方 MCP 注册表，名称为 dev.charliemorrison/agent-web-reader。

工具

工具	端点	价格	返回内容
market_signal	GET /signal	$0.005	某个交易品种的加密货币市场信号（价格／趋势／动量）
web_read	GET /extract	$0.005	从任意 URL 提取的清晰易读文本及元数据
repo_audit	GET /audit?owner=&repo=	$0.005	GitHub 仓库的可发现性／SEO 评分（0–100）及具体改进建议

免费、无需付款的路由：

• GET / — 发现文档（服务及付费端点元数据，支持 x402）
• GET /healthz — 存活状态
• GET /.well-known/mcp.json — MCP 发现清单
• GET /.well-known/agent.json — A2A Agent Card
• POST /mcp — 远程 MCP 服务（Streamable HTTP）。列出这三个工具；未付款的 tools/call 会返回解码后的 x402 付款要求质询，而携带 x402 付款信息的调用会返回数据。

付款方式

1. Agent 不带付款信息调用付费路由 → 服务返回包含 x402 质询的 HTTP 402（金额、资产 = USDC、网络 = base、payTo 地址）。
2. Agent 的 x402 客户端签署付款授权，并在重试时添加 X-PAYMENT 标头。
3. 服务通过 x402 付款协调器验证／结算并返回数据。

此服务的配置中不会存放私钥——它只收款。结算由 x402 付款协调器处理（默认使用零费用、由服务承担 Gas 费用的协调器；也支持通过环境变量配置 Coinbase CDP 付款协调器，默认未启用）。

运行

npm install
PAY_TO=0xYourReceivingAddress node server.js   # listens on :4021

环境变量：

• PAY_TO — 你的收款钱包（Base 上的 USDC）。实际收款时必需。
• PORT — 默认为 4021。
• CDP_API_KEY_ID / CDP_API_KEY_SECRET — 可选；设置后会切换为由 Coinbase CDP 付款协调器进行结算。默认不设置。

这种设计的原因

买方是机器，分发渠道是注册表——没有需要招揽的陌生人类受众，而这正是扼杀大多数独立 API／工具发布的障碍。 卖方只需设置一个钱包地址；每次调用提供的都是边际成本为零的公开数据。

许可证

MIT