HTTP 402 AI Tollbooth

HTTP 402 AI Tollbooth

エージェント向けの開発者トラブルシューティングデータを、リクエストごとに Bitcoin Lightning で販売します。

稼働中： https://http-402-ai-tollbooth.rsaun-lightning.workers.dev

HTTP 402 AI Tollbooth では、開発者と AI エージェントに役立つ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

最後のコマンドは請求書を作成します。意図的に決済チャレンジを希望する場合を除き、実行しないでください。リクエストするだけでは sat は消費されません。

エージェントが利用する理由

• DevOps、API、ML/AI、Web/Frontend、Databases にわたる203製品
• 50件、100件、200件のレコードを含む Entry、Standard、Premium のデータセット
• 購入前に試せるよう、製品ごとに無料レコードをちょうど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

料金

Tier	価格	レコード数
Entry	2,000 sats	50
Standard	5,000 sats	100
Premium	10,000 sats	200

料金設定の根拠には、ライブ環境で確認済みの受け取り最低額 2,000 sats も記載されています。

支払い方法

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 にある、読み取り専用ツール4つを備えた稼働中の Streamable HTTP JSON-RPC エンドポイント
• OpenAPI： エージェントフレームワーク向けの 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 エージェントのリカバリーサンプルをご覧ください。

実行可能な無料サンプル

このサンプルでは、エージェントが不正な形式の JSON を調べ、Retry-After に従って一時的な 429 を1回再試行し、レスポンスを復旧できない場合は安全に停止する方法を示します。Node 22+ の組み込み機能のみを使用します。

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

このデモが呼び出すのは、公開されている3件のレコードを返すプレビューエンドポイントだけです。有料ルートの呼び出し、請求書の作成、支払い証明の自動再送は行いません。

ライセンス

このビルボードリポジトリのドキュメントは MIT License の下で利用できます。非公開の本番ソースコードは、このリポジトリにもライセンスにも含まれていません。