Scout Packs

Scout Packs — Tiger Operations

x402（Base 上の USDC、eip155:8453）を通じて AI エージェントに販売する、検証済み B2B リードパックとリードごとのエンリッチメント検索です。需要検証価格（2026-10-04）： 検索またはパック1件あたり $0.01 です。 Scout の原価との利益率の逆転は認識しています。これは需要検証であり、ビジネスモデルではありません。撤退基準：価格改定後7日以内に、2つ以上の異なるウォレットから有料検索が3件以上あること。

パック	リード数	価格	提供方法
scout-pack-25	25	$0.01	支払い後、即時に JSON をダウンロード
scout-pack-50	50	$0.01	必要に応じて作成し、24時間以内に提供
scout-pack-100	100	$0.01	必要に応じて作成し、24時間以内に提供

リードごとのエンリッチメント：GET /lookup?query=<company or domain> — 402 のペイウォール、 $0.01 USDC、POST /fulfill-lookup は、検証済みの企業メールアドレス1件 + ソース URL + 出所情報を返します。

複合ドシエ：GET /dossier?domain=<domain> — 402 のペイウォール、 $0.05 USDC、POST /fulfill-dossier は、複合ドメインドシエを返します。 1つのドメインについて、RDAP 登録情報 + DNS インフラストラクチャのシグナル、技術スタックの検出、 企業メールアドレスの推定パターン + MX 検証、SSL/TLS 証明書の状態を組み合わせ、 シグナルの集約リストとともに単一のレスポンスで返します。つまり、個別に4回呼び出す代わりに、 /domain-intel、/tech-stack、/email-pattern、/ssl-check の結果を1回の呼び出しで取得できます。

各リードには、company_name、city_state、category、contact_email（検証済み企業メールアドレス）、source_url が含まれます。

エンドポイント

• GET / — 人間向けランディングページ
• GET /catalog — パックと価格（JSON）
• GET /.well-known/x402 — 機械可読な支払い条件
• GET /llms.txt — エージェント向け購入手順
• GET /packs/{25,50,100}/preview — マスキング済みのプレビュー（メールアドレスはマスキング）、無料
• GET /packs/{25,50,100} — PAYMENT-REQUIRED（v2）+ X-PAYMENT-REQUIRED（v1）ヘッダー付きの 402
• GET /lookup?query=<company or domain> — 支払い条件（$0.01 USDC）付きの 402。該当なしの場合は 404
• POST /fulfill — {"tx_hash":"0x...","pack":"25","deliver_to":"..."}
• POST /fulfill-lookup — {"tx_hash":"0x...","query":"<company>"}
• GET /dossier?domain=<domain> — 支払い条件（$0.05 USDC）付きの 402。ドメイン情報、技術スタック、メールアドレスのパターン、SSL チェックを1回の呼び出しで組み合わせた複合ドメインドシエ
• POST /fulfill-dossier — {"tx_hash":"0x...","domain":"<domain>"}
• GET /skill.md — リード検索用エージェントスキルファイル（Markdown）
• /mcp — MCP ストリーミング可能 HTTP エンドポイント（MCP_PROXY_PORT が設定されている場合、同系列の MCP サーバーにプロキシされます）

インターフェースのリファレンス（エージェント／MCP クライアント向け）

GET /packs/{25,50,100} → 402 Payment Required

• ヘッダー：PAYMENT-REQUIRED = base64(JSON x402 v2 terms)、X-PAYMENT-REQUIRED = base64(JSON x402 v1 terms)
• 本文：{error:"payment_required", pack, leads, price_usd, currency:"USDC", network:"eip155:8453", fulfillment, sales_enabled, x402:{x402Version:2, accepts:[{scheme:"exact", network, amount (atomic USDC, 6 decimals), description, mimeType, payTo, maxTimeoutSeconds, asset, extra}], resource:{url, description, mimeType}}, how_to_pay:[...]}
• 販売者のアドレスが未設定の間（現在の状態）は sales_enabled:false です。設定されると自動的に切り替わります。

POST /fulfill — 本文 {tx_hash:"0x…", pack:"25"|"50"|"100", deliver_to:"…" (optional)}

• 成功、パック 25 → 200 {receipt:"ok", pack:"scout-pack-25", tx_hash, verified_at, leads:{…25-lead pack JSON…}}
• 成功、パック 50／100 → 200 {receipt:"ok", pack, tx_hash, verified_at, order_id, status:"queued_for_assembly", eta:"within 24 hours of payment confirmation", deliver_to, note}
• 失敗 → 402 {error:"payment_not_verified", detail:"sales_paused: receiving address not configured" | "bad_tx_hash" | "already_redeemed" | "tx_not_found" | "tx_not_successful" | "tx_too_old" | "no_matching_usdc_transfer" | "chain_lookup_failed", pay:[…steps…]} または 400 {error:"unknown_pack"|"bad_json"}

検証ルール：tx は、設定済みの受取アドレス宛ての Base USDC 送金で、成功しており、パックの金額以上で、30 日未満前にマイニングされたものである必要があります。各 tx hash は 1 回のみ使用できます。

購入の流れ

1. GET /packs/25 → 402 の利用条件（payTo、正確な USDC 金額）を確認します。
2. 標準的な x402：Base 上で、ちょうど $0.01 USDC の EIP-3009 認証に署名し、署名を X-PAYMENT（v1）または PAYMENT-SIGNATURE（v2）ヘッダーに含めて同じリクエストを再試行します。支払いはファシリテーターによって検証・決済され、パック 25 は直ちに返されます（50／100 では 24 時間以内に注文確認が返されます）。
3. フォールバック：Base 上で payTo にちょうど $0.01 USDC を自分で送金し、その後 tx hash を指定して POST /fulfill を呼び出します。

支払いはオンチェーンで検証されます（Blockscout の無料 API）：tx は、受取アドレス宛ての USDC 送金で、成功しており、パックの金額以上である必要があります。tx hash は再利用できません（リプレイ攻撃対策）。30 日を超えた tx は拒否されます。

設定

• SCOUTPACKS_RECEIVING_ADDRESS — USDC を受け取る Base アドレスです。未設定の場合（またはゼロアドレスの場合）、エンドポイントはプレビュー専用モードで動作します：402 の本文と /.well-known/x402 では sales_enabled=false となり、/fulfill はすべてのリクエストを拒否します。
• SCOUTPACKS_PUBLIC_BASE — 402 の resource フィールドで使用する公開 URL です。
• PORT — デフォルトは 8000 です。
• MCP_PROXY_PORT — オプションです（例：8001）。設定すると、/mcp は同じ階層の MCP ストリーマブル HTTP サーバー（mcp/http_server.py）へリバースプロキシします。このポートを指定すると、1 回のデプロイで x402 API と永続的な HTTPS MCP エンドポイントの両方を公開できます。

デプロイ

./run.sh &                                   # localhost:8000

本番環境（2026-10-02 以降）は Railway 上で稼働しています — https://scout-packs-production.up.railway.app が唯一の本番エンドポイントです。 以前の localtunnel 経由のパス（lt-proxy.js、loca.lt サブドメイン）は、503 が頻発したため 2026-10-02 に廃止され、現在は使用されていません。新規デプロイで通常のインフラを使う場合は、 cloudflared tunnel --url http://127.0.0.1:8000 を通常どおり使用できます。

次に、402 Index などのオープンなインデックスに登録します： POST https://402index.io/api/v1/register を {url, name, protocol:"x402", description, price_usd, payment_asset:"USDC", payment_network:"eip155:8453", category:"data", tags:[...]} とともに送信します。

MCP サーバー（エージェントクライアント向け）

AI エージェントは、MCP サーバー（mcp/）を通じて、MCP クライアント （Claude Desktop、Cursor、MCP Inspector、エージェントフレームワーク）内から パックを検索して購入することもできます。

• list_packs — 無料です。パックのサイズ、価格、リアルタイムの販売状況、編集済みサンプルを確認できます。
• buy_pack — 正確な x402 支払い条件と手順を返します。購入するエージェント自身のウォレットからエンドポイントに支払います。資金の移動や秘密鍵の保持は一切行いません。

クイックスタート（Python 3.10 以降。mcp SDK のみをインストールします）：

cd mcp && python3 -m venv .venv && .venv/bin/pip install mcp
BASE_URL=https://<endpoint-url> .venv/bin/python scout_packs_mcp.py

または、PyPI で公開後は、BASE_URL を設定して uvx scout-packs-mcp を実行します。 ドキュメント全文：mcp/README.md。レジストリの掲載情報： mcp/REGISTRIES.md。