Merchant Context

Merchant Context

Merchant Context は、エージェント構築者向けのオープンなマーチャント事前確認ツールです。

実用的な問いから始めます。

エージェントは、推測せずに、何を販売しているのか、誰向けなのか、価格はいくらなのか、どのルールが適用されるのか、次にどのアクションを取るべきなのかを判断できますか？

このリポジトリには、次のものが含まれています。

• マーチャント公開チェックリスト；
• マーチャントコンテキストのスキーマ草案；
• SaaS の実例；および
• 主要なコマースおよびディスカバリー標準の一覧。

正式な情報源

• 製品および機械向け概要：https://merchant.atomandbits.com/llms.txt
• バージョン 0.1 のスキーマ：https://merchant.atomandbits.com/schema/merchant-context-v0.1.json
• UCP ディスカバリー：https://merchant.atomandbits.com/.well-known/ucp
• オープンソースと履歴：https://github.com/ihint/merchant-context

ドメインスキーマと schema/merchant-context.schema.json は、意味的に同一でなければなりません。バージョン付きリリースでは、古いコントラクトを維持します。

ステータス

これは Atom & Bits による初期の公開草案です。新しい決済またはチェックアウトのプロトコルではありません。ACP、UCP、MCP、A2A、x402、Web Bot Auth への対応を認定するものではありません。

UCP プロファイルでは、サービス、チェックアウト機能、決済ハンドラーは宣言されていません。存在しない操作を実行できるとうたうことなく、エージェントに明示的なディスカバリー応答を提供します。

目標は、これらのシステムの成熟に合わせてマッピングできる、検証可能な単一のコンテキストレイヤーをマーチャントに提供することです。

社内テスト、レジストリの表示、リポジトリのアクティビティ、または自己資金による決済を根拠とした外部での採用は主張していません。

エージェントのエンドポイント

• MCP：https://api.merchant.atomandbits.com/mcp
• 無料の MCP ツール：resolve_merchant
• 無料の HTTP：POST https://api.merchant.atomandbits.com/v1/resolve
• 有料の MCP ツール：refresh_merchant
• 有料の HTTP x402：POST https://api.merchant.atomandbits.com/v1/refresh
• 価格：Base 上で $0.01 USDC
• 初回の決済確認：Base トランザクション 0x2f0f…57af

初回の有料呼び出しは 2026-08-04 に決済され、 https://merchant.atomandbits.com のライブ検査結果を返しました。

クイックスタート

1. CHECKLIST.md に沿って作業します。
2. examples/saas.json をコピーします。
3. サンプル値をすべて、自分のサイトまたはシステムから得られる事実に置き換えます。
4. 価格、在庫、ポリシー、アクション URL を最新の状態に保ちます。
5. 公開前に python3 scripts/validate.py を実行します。

エージェントに追加する

リモート MCP エンドポイントは、Streamable HTTP に対応したクライアントで動作します。

https://api.merchant.atomandbits.com/mcp

まず resolve_merchant を使います。

無料です。

キャッシュにヒットした場合、マーチャントへのフェッチも有料の検査呼び出しも行われません。

Codex、Claude Code、 Gemini CLI、Cursor、OpenAI Responses API については、エージェント統合ガイドを参照してください。

オープンな Agent Skills 形式に対応したエージェントは、 skills/merchant-context を使用できます。

設計ルール

• スローガンより事実を優先します。
• URL は API ではありません。
• エージェントは価格、在庫、ポリシー、権限を推測してはなりません。
• 各主張には、その情報源と更新時刻を明記してください。
• 購入などの影響の大きいアクションでは、人間の承認が必要となるタイミングを明示してください。
• 既存の標準を優先します。独自の方言を考案せず、既存の標準にマッピングしてください。

エージェントサービス

worker ディレクトリには、テスト対象のホスト型 MCP サービスが含まれています。次の機能を提供します。

• resolve_merchant：鮮度、不明点、安全なアクション、帰属情報を含む、出典付きの無料加盟店レコード
• search_merchants：キャッシュされた出典付きレコードを対象とする、中立的な検索
• compare_offers：不明な値をそのまま保持する、出典付きの比較
• get_safe_actions：承認および復旧ルールを含む、加盟店管理のアクション引き継ぎ
• preflight：再利用可能な解決およびアクションのゲート
• check_merchant：無料の加盟店サイト診断
• refresh_merchant：明示的な承認が必要な、$0.01 の x402 による新規調査
• inspect_merchant：有料更新の初回リリース向け互換エイリアス
• /v1 配下の直接 HTTP ルート
• /.well-known/merchant-context：エージェントとレジストリ向けの公開サービスレコード

インスペクターが受け付けるのは、公開された HTTPS オリジンのみです。ローカルおよび IP のターゲットをブロックし、各リダイレクトを検査して、レスポンスのサイズと時間に上限を設け、ページ本文は返しません。支払い処理では、ウォレットアドレスや署名済み支払いトークンではなく、ハッシュを記録します。

ローカルチェックを実行します。

cd worker
npm install
npm test
npm run typecheck
npx wrangler deploy --dry-run

コントリビューション

Issue、例、修正を歓迎します。プルリクエストを作成する前に、CONTRIBUTING.md をお読みください。

ライセンス

MIT です。LICENSE をご覧ください。