关于 scrape402
scrape402 提供调用 x402 付费 API 的 Agent 示例,按成功请求以 Base 上的 USDC 付费。示例涵盖聊天、嵌入、网页搜索和预付费计量,无需注册账户或 API 密钥。
主要功能
- 01每次 API 调用以 USDC 付费
- 02OpenAI 兼容聊天示例
- 03网页搜索示例
- 04Python 嵌入示例
- 05预付费高频调用计量
适用场景
- 01执行付费 LLM 聊天请求
- 02无需搜索账户即可搜索网页
- 03为 RAG 流程生成嵌入
- 04通过预付费计量进行高频调用
MCP 相关
README 提供 x402 服务的 MCP 工具目录链接,但未说明 MCP 服务端的实现方式。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://x402.shizu.me/mcp/rpcclaude mcp add --transport http scrape402-scrape402 https://x402.shizu.me/mcp/rpc{"mcpServers":{"scrape402-scrape402":{"type":"http","url":"https://x402.shizu.me/mcp/rpc"}}}在 Cursor 中打开{"servers":{"scrape402-scrape402":{"type":"http","url":"https://x402.shizu.me/mcp/rpc"}}}在 VS Code 中打开{"mcpServers":{"scrape402-scrape402":{"type":"http","url":"https://x402.shizu.me/mcp/rpc"}}}{"mcpServers":{"scrape402-scrape402":{"serverUrl":"https://x402.shizu.me/mcp/rpc"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
5| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| max | integer | 否 | |
| min | integer | 否 | |
| bytes | integer | 否 | 1–256,默认 16 |
详细介绍
x402 示例 — 面向 AI Agent 的按次付费 API
调用受 x402 门控的 HTTP API 的可运行示例:你的 Agent 在 Base 上按请求支付 USDC,无需注册、无需 API 密钥、无需订阅。
所有示例均使用 x402.shizu.me(77 个在线端点,
价格低至每次调用 $0.001):一个 兼容 OpenAI 的大模型网关
(/v1/chat/completions、/v1/embeddings、/v1/models)、网页搜索、代码
沙箱、网页抓取、实时加密货币/市场数据、可验证随机数,以及面向高频循环
(每分钟 100 次以上调用,无需为每次调用支付 Gas)的预付链下计量通道。
x402 的工作原理
- 调用任意端点 →
HTTP 402响应会附带已签名的 USDC 付款要求(价格、资产、收款方)。 - 付款——你的 x402 客户端在本地签署付款,并自动重试。
- 提供服务——结算在链上进行;只有调用成功时才会向你收费。错误和 4xx 响应不会结算。
为钱包充值几美元的 Base 上的 USDC,导出其私钥,这里的每个示例便可直接运行。
JavaScript
npm install x402-fetch viem
export X402_PRIVATE_KEY=0x... # wallet holding USDC on Base
node js/chat.mjs
Python
pip install x402 eth-account httpx
export X402_PRIVATE_KEY=0x...
python python/chat.py
示例
| 文件 | 说明 |
|---|---|
js/chat.mjs | 兼容 OpenAI 的聊天补全,按次付费 |
js/search.mjs | 无需搜索 API 账户即可进行实时网页搜索 |
python/chat.py | 通过 Python x402 客户端进行聊天补全 |
python/embeddings.py | 适用于 RAG 循环的 OpenAI 格式嵌入 |
python/metered_loop.py | 预付一次,然后每分钟进行 100 次以上链下调用 |
只是想看看?
每个路由都会在免费的未付款请求中报出价格:
curl -i https://x402.shizu.me/crypto # → 402 + payment requirements
curl https://x402.shizu.me/llms.txt # full catalog, agent-readable
链接
在线服务:https://x402.shizu.me · OpenAPI:https://x402.shizu.me/openapi.json · MCP 工具:https://x402.shizu.me/.well-known/mcp-tools · 联系方式:[email protected]
采用 MIT 许可证。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。