あらゆるeコマースストアを、AIショッピングエージェントにとって観測可能・測定可能・取引可能なプラットフォームへと変えます。
[!NOTE] プロトタイプ＆シミュレーションに関するお知らせ： このリポジトリには、提案中のBigCommerce / Merchant Web MCPプラグインアーキテクチャのインタラクティブなシミュレーションコックピットとプロトタイプが含まれています。シミュレーションエンジンはクライアントサイドで動作し、シミュレートされたレイテンシ、本物のWeb Crypto HMAC-SHA256署名、実際の15分TTL在庫予約タイマー、そしてエグゼクティブ向けのエージェント意図分析ダッシュボードを備えています。
現在、マーチャントはAIショッピングエージェント（ChatGPT Agent、Claude、Perplexity、Apple Intelligence）に対して盲目です。ボットが商品ページをスクレイピングするとき：
トラフィックは単純なWebスクレイパーと区別がつきません。
ビジュアルスクレイピングは1ページあたり6,000〜10,000トークンを消費し、ReactのハイドレーションやDOMの再設計で頻繁に壊れます。
マーチャントには、エージェントがどの商品を検索しているか、どのクエリが失敗するか、どのような商業需要が捕捉されずに素通りしているかについて、まったく可視性がありません。
エージェント意図分析（すぐに得られるSaaS価値）： 入ってくるエージェントセッション、ツール実行、検出された意図価値（£124k以上のパイプライン）、プロバイダー別内訳、カタログ需要ギャップを捕捉します。
決定論的MCPインターフェース： 構造化されたJSON-RPCツール（search_products、get_product_details、check_variant_stock、apply_promotions、add_to_cart_session、create_checkout_session）を公開します。
暗号学的に検証されたハンドオフ： 本物のWeb Crypto HMAC-SHA256トークンを使用して、15分間の一時的在庫ソフトロックを伴う署名済みチェックアウトURLを生成します。
Related MCP server: Shopify Agentic MCP Gateway
┌────────────────────────────────────────────────────────┐
│ AI Shopping Agent │
│ (Claude / ChatGPT / Perplexity) │
└───────────────────────────┬────────────────────────────┘
│ (1) Discover: /.well-known/mcp.json
│ (2) Transport: HTTP / SSE Stream
▼
┌────────────────────────────────────────────────────────┐
│ Merchant Web MCP Plugin Engine │
│ ┌──────────────────────────────────────────────────┐ │
│ │ Layered Security Guard (Unicode Filter & Regex) │ │
│ └────────────────────────┬─────────────────────────┘ │
│ │ │
│ ┌────────────────────────▼─────────────────────────┐ │
│ │ Standardized MCP Tools: │ │
│ │ • search_products(query, max_price, waterproof) │ │
│ │ • check_variant_stock(variant_id, postal_code) │ │
│ │ • apply_promotions(promo_code, subtotal) │ │
│ │ • add_to_cart_session(variant_id, qty) [15m TTL]│ │
│ │ • create_checkout_session (WebCrypto HMAC SHA256│ │
│ │ • get_store_policies() │ │
│ └────────────────────────┬─────────────────────────┘ │
└───────────────────────────┼────────────────────────────┘
│
┌───────────────┴───────────────┐
▼ ▼
┌───────────────────────┐ ┌───────────────────────┐
│ Merchant Catalog / DB │ │ Storefront Cart & DOM │
│ (BigCommerce / D1) │ │ (Live State Sync) │
└───────────────────────┘ └───────────────────────┘# 1. Install dependencies
bun install
# 2. Run test suite (7 tests, 27 assertions)
bun test
# 3. Start development server
bun run devインタラクティブシミュレーションコックピット： https://merchant-web-mcp.web.app
スタンドアロンのプロジェクターデモ（単一ファイルHTML）： https://merchant-web-mcp.web.app/demos/merchant-web-mcp-demo-v2.html
本物のWeb Crypto HMAC-SHA256： 標準のcrypto.subtleを使用してsrc/mcp/cryptoAuth.tsに実装されています。チェックアウトセッションの生成時に署名が暗号学的に検証されます。
アクティブTTL在庫の失効： src/mcp/merchantMcpEngine.tsに実装されています。一時的な予約は900秒（15分）後に失効し、在庫を自動的に利用可能な在庫へ戻し、クライアントのワイヤーHUDに通知します。
多層防御（Defense-in-Depth）： src/mcp/securityGuard.tsに実装されています。Unicode／ゼロ幅文字による難読化を正規化し、カスタマーレビュー、検索クエリ、プロモーション引数を横断してスキャンします。
マルチカート分離： エンジンはカートをcart_idで明示的にマッピングし、無効または無関係なカートセッションでのチェックアウト試行を拒否します。
ターゲットとなるCloudflare Worker + BigCommerceエッジサーバー仕様については、ROADMAP.mdを参照してください。
This server cannot be deployed
AI shopping gateway for product search, inventory, carts, and merchant-hosted checkout.
AI-agent product catalog: search, lookup & purchase routing over verified merchant data.
The independent agent-commerce protocol for AI-agent checkout on any online store.
The E-commerce Marketplace For Every AI Agent. A Governed Catalog Of 600M+ US Products, Plus Four Agent Ready Capabilities Search, Price Comparison, Product-Vs-Product, And Detailed Q&A.
