argentina-price-index

Paid Door — アルゼンチンの食品・飲料価格指数（Cloudflare サンドボックス）

動画の中心的な仕組みを最小限の構成で動作させるテストです。1 回のエージェントリクエストが、エッジでの有料トランザクションになります。 Cloudflare Worker は D1 からリアルタイムで計算した価格指数を提供し、x402 形式の 402 → pay → retry → data ループで保護します。決済は（共有シークレットによる HMAC で）モック化されているため、ウォレットを設定せずに一連の流れを実行できます。実際の x402 への切り替えも、変更箇所を限定して行えます。

データは合成データです。 seed/observations.sql はデモを実際のスクレイパーが用意される前に実行できるよう生成されたプレースホルダーデータです。数値を実際のアルゼンチンの価格として扱わないでください。

内容

paid-door-index/
├─ wrangler.jsonc         # Worker + D1 binding + sandbox vars
├─ schema.sql            # price_observations + methodology (+ future index_series cache)
├─ seed/
│  ├─ generate.mjs       # deterministic synthetic data generator (60 SKUs x 30 days)
│  └─ observations.sql   # generated seed (1,800 rows)
├─ src/index.ts          # Worker: routes + live index math + mock x402 gate
├─ agent/test-agent.mjs  # the paying "buyer": request → 402 → pay → retry → data
└─ README.md

エンドポイント

エンドポイント	ティア	戻り値
GET /v1/headline?country=AR&category=food_beverages	無料	最新の指数値と月間変化率（ティーザー）
GET /v1/index?country=AR&category=food_beverages	有料（$0.02）	日次の全系列
GET /v1/latest?country=AR&category=food_beverages	有料（$0.02）	最新の測定値と算出方法
POST /mcp	—	MCP JSON-RPC：initialize、tools/list、tools/call

MCP インターフェース（エージェントが実際に呼び出すもの）

Worker は /mcp で HTTP 経由の MCP にも対応し、2 つのツールを公開します。

• get_ar_food_headline（無料）— 最新値と 30 日間の変化率
• get_ar_food_price_index（有料、$0.02 の mock-x402）— 日次の全系列。最初は _payment なしで呼び出してチャレンジを受け取り、その後 arguments._payment = {nonce, resource, amount, signature} を指定して再試行します

エージェントの全フローをテストします（npm run dev の実行中に）：

npm run agent:mcp     # initialize → tools/list → free call → paid call (challenge → pay → data)

本番環境に関する注意： ここの /mcp は Streamable HTTP トランスポートの最小限の JSON リクエスト／レスポンス部分集合です（SSE／セッション／認証には対応していません）。実際にデプロイする場合は、公式 MCP SDK または Cloudflare の agents McpAgent を使用し、モック HMAC を実際の x402 ファシリテーターに置き換えてください。

指数の計算方法（methodology_version = v0-simple-avg）：在庫のある SKU について index = 100 × mean(price_t / price_base) とします。base は期間内の初日です。スキーマには、カテゴリ内では幾何平均、カテゴリ間ではラスパイレス指数を使う拡張方法も織り込まれています。

ローカルで実行する

前提条件：Node 18 以降と Cloudflare アカウント（npx wrangler login）。

cd paid-door-index
npm install

# 1. Create the D1 database, then paste the printed database_id into wrangler.jsonc
npm run db:create

# 2. Load schema + seed into LOCAL D1
npm run schema:local
npm run seed:gen        # (optional) regenerate observations.sql
npm run seed:local

# 3. Start the Worker
npm run dev             # serves http://127.0.0.1:8787

# 4. In a second terminal, run the paying agent
npm run agent

想定されるエージェントの出力：無料のヘッドラインに続いて、価格チャレンジ付きの 402 が返り、その後、全系列と PAYMENT-RESPONSE 決済ヘッダー付きの 200 が返ります。1 回のリクエストがトランザクションになります。

アカウントにデプロイする

npm run schema:remote
npm run seed:remote
npm run deploy
# then point the agent at the deployed URL:
BASE=https://paid-door-index.<your-subdomain>.workers.dev npm run agent

npx wrangler tail でライブログを確認します。

サンドボックスから実環境へ（後日）

1. 実データ： seed/generate.mjs を、アルゼンチンのオンライン食料品店 1～2 店舗を毎日スクレイピングして price_observations に保存する、スケジュール実行の Worker に置き換えます。
2. 実際の決済： src/index.ts の HMAC モック（verifyPayment／challenge）を、Cloudflare の Agents x402 ドキュメントに従って実際の x402 ファシリテーター（POST /verify、POST /settle）に置き換えます。
3. シークレットを移動する： 平文の変数の代わりに npx wrangler secret put MOCK_PAYMENT_SECRET を実行します。
4. MCP として公開する： このアシスタントを含むあらゆる AI エージェントが get_index を直接呼び出せるようにします。
5. 実体化する： クエリ量が増えたら、夜間キャッシュとして index_series を実体化します。

注意事項／留意点

• モック決済で証明できるのは共有シークレットを知っていることだけです。オンチェーンでの暗号学的な決済ではありません。 リクエスト／レスポンスの形式を試す目的でのみ使用します。
• サンドボックスではリプレイ攻撃を防止しません（有効な署名は何度でも再利用できます）。実際の x402 決済ではこの問題に対処します。
• 合成データの月間変化率には、意図的にノイズが加えられています。単一のエンドポイントから読み取るインフレ率が大きく変動すること自体が、教材として役立つポイントです。