HTTP 402 AI Tollbooth

HTTP 402 AI 收费站

面向 Agent 的开发者故障排查数据，按请求通过 Bitcoin Lightning 售卖。

在线地址： https://http-402-ai-tollbooth.rsaun-lightning.workers.dev

HTTP 402 AI 收费站为开发者和 AI Agent 免费提供每个产品的 3 条实用记录，之后可通过 BOLT11 Lightning 付款解锁完整的结构化数据集。无需账户、订阅、信用卡或 API 密钥。

这是一个公开的文档和示例仓库。生产环境的 Worker 实现仍为私有，未包含在此处。

立即试用

列出完整目录：

curl -sS https://http-402-ai-tollbooth.rsaun-lightning.workers.dev/api/catalog

免费预览恰好 3 条记录：

curl -sS https://http-402-ai-tollbooth.rsaun-lightning.workers.dev/api/preview/api-error-fixes

请求完整产品并接收 HTTP 402 Lightning 付款挑战：

curl -i https://http-402-ai-tollbooth.rsaun-lightning.workers.dev/api/data/api-error-fixes

最后一条命令会创建发票。除非你确实想触发付款挑战，否则不要运行；仅请求该端点不会花费 sats。

Agent 为何使用它

• 覆盖 DevOps、API、ML/AI、Web/Frontend 和 Databases 的 203 款产品
• Entry、Standard 和 Premium 数据集，分别包含 50、100 或 200 条记录
• 每款产品恰好免费提供 3 条记录，供用户在购买前试用和了解
• 稳定的 error_code、description 和 programmatic_fix 字段
• 通过 HTTP 402 和 Bitcoin Lightning 付款，无需用户账户
• OpenAPI 3.1、MCP 发现元数据和 llms.txt
• 确定性回退生成，确保数据集交付的可靠性
• 持久的一次性兑换和重放保护
• 已记录未来的 x402 结算方案，但在验证完成前仍处于禁用状态

架构

AI agent / developer
        |
        | HTTPS: catalog, preview, paid dataset
        v
Cloudflare Worker
   |         |                    |
   |         |                    +--> Alby --> Bitcoin Lightning invoice
   |         |
   |         +--> Durable Objects --> atomic redemption + counters
   |
   +--> Workers KV --> invoice challenges + generated dataset cache

定价

档位	价格	记录数
Entry	2,000 sats	50
Standard	5,000 sats	100
Premium	10,000 sats	200

参见定价依据，其中包括经在线验证的 2,000-sat 收款下限。

如何付款

1. 请求付费产品端点。
2. 接收包含 BOLT11 发票和付款哈希的 402 Payment Required 响应。
3. 使用 Lightning 钱包支付发票。
4. 使用 X-Payment-Hash 和 X-Payment-Preimage 重试同一端点。
5. 接收完整数据集一次；重放的付款证明会被拒绝。

在按预期用途兑换之前，切勿发布或分享付款前像。未来的 Solana USDC/x402 支持在其人工验证流程完成前处于禁用状态。

发现文档

• Smithery 服务卡片
• OpenAPI 3.1 文档
• llms.txt
• Billboard 集成摘要
• 官方 MCP Registry 就绪情况

集成

• MCP 元数据： 用于目录、预览和购买发现的工具描述
• MCP 传输： /mcp 上的在线 Streamable HTTP JSON-RPC 端点，提供 4 个只读工具
• OpenAPI： 面向 Agent 框架的完整 HTTP 端点说明
• LLMs.txt： 简洁、机器可读的项目和付款指南

将 MCP 客户端连接到 https://http-402-ai-tollbooth.rsaun-lightning.workers.dev/mcp。服务支持 list_products、preview_product、list_payment_methods 和 buy_product。最后一个工具只会返回付款说明和 HTTP 402 挑战；它不会支付发票，也不会代替调用方创建购买。

完整的免付款示例请参见 Node Agent 故障恢复示例。

可运行的免费示例

该示例展示了 Agent 如何检查格式错误的 JSON、在 Retry-After 后对临时 429 响应重试一次，并在响应无法恢复时安全停止。它仅使用 Node 22+ 内置功能：

cd examples/node-agent-recovery
npm test
npm start

该演示只会调用公开的三条记录预览端点。它不会调用付费路由、创建发票，也不会自动重放付款证明。

许可证

此展示仓库中的文档采用 MIT License。私有生产源代码不受此仓库或许可证涵盖。