agent-web-reader

x402-agent-data

AI エージェント向けの従量課金データツールです。呼び出しごとに、x402 protocol を介して Base 上の USDC で決済します。購入者も別のエージェントです。エンドポイントを検出し、リクエストごとに自動で支払い（HTTP 402 → 支払い → データ）を行い、構造化された JSON を受け取ります。API キー、サインアップ、アカウントは不要です。販売者に必要な設定は、公開ウォレットアドレスを 1 つ用意するだけです。

https://x402.charliemorrison.dev で公開中です。また、Official MCP Registry にリモート 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 エージェントカード
• POST /mcp — リモート MCP サーバー（Streamable HTTP）。3 つのツールを一覧表示します。未払いの tools/call はデコード済みの x402 支払い要求チャレンジを返し、x402 支払いを含む呼び出しはデータを返します。

支払いの仕組み

1. エージェントが支払いなしで有料ルートを呼び出すと、サーバーは x402 チャレンジ（金額、資産 = USDC、ネットワーク = base、payTo アドレス）を含む HTTP 402 を返します。
2. エージェントの x402 クライアントが支払い承認に署名し、X-PAYMENT ヘッダーを付けて再試行します。
3. サーバーが x402 ファシリテーター経由で検証／決済し、データを返します。

このサーバーの設定に秘密鍵が保存されることはありません。サーバーが行うのは受け取りのみです。決済は x402 ファシリテーターに委任されます（デフォルトは手数料無料でガス代を負担するファシリテーターです。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／ツールの立ち上げを阻む多くのプロジェクトにとっての壁がありません。販売者の設定はウォレットアドレス 1 つだけで、すべての呼び出しで公開データを限界費用ゼロで提供できます。

ライセンス

MIT