모든 전자상거래 스토어프론트를 AI 쇼핑 에이전트를 위한 관찰 가능하고, 측정 가능하며, 거래 가능한 플랫폼으로 전환하세요.
[!NOTE] 프로토타입 및 시뮬레이션 고지: 이 저장소는 제안된 BigCommerce / Merchant Web MCP 플러그인 아키텍처의 대화형 시뮬레이션 콕핏 및 프로토타입을 포함합니다. 시뮬레이션 엔진은 클라이언트 측에서 실행되며, 시뮬레이션된 지연 시간, 실제 Web Crypto HMAC-SHA256 서명, 실제 15분 TTL 재고 예약 타이머, 그리고 경영진용 에이전트 의도 분석 대시보드를 제공합니다.
오늘날 판매자들은 AI 쇼핑 에이전트(ChatGPT Agent, Claude, Perplexity, Apple Intelligence)에 대해 알지 못합니다. 봇이 제품 페이지를 스크레이핑할 때:
트래픽은 단순 웹 스크레이퍼와 구분할 수 없습니다.
시각적 스크레이핑은 페이지당 6,000–10,000 토큰을 소비하며 React hydration 또는 DOM 재설계 시 자주 실패합니다.
판매자들은 에이전트가 어떤 제품을 검색하는지, 어떤 쿼리가 실패하는지, 어떤 상업적 수요가 포착되지 않은 채 지나가는지에 대해 전혀 가시성이 없습니다.
에이전트 의도 분석(즉각적인 SaaS 가치): 유입되는 에이전트 세션, 도구 실행, 발견된 의도 가치(£124k+ 파이프라인), 공급자별 분석, 카탈로그 수요 격차를 포착합니다.
결정적 MCP 인터페이스: 구조화된 JSON-RPC 도구(search_products, get_product_details, check_variant_stock, apply_promotions, add_to_cart_session, create_checkout_session)를 노출합니다.
검증된 암호화 핸드오프: 15분 임시 재고 소프트락과 함께 실제 Web Crypto HMAC-SHA256 토큰을 사용하여 서명된 체크아웃 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에 알립니다.
계층형 심층 방어: src/mcp/securityGuard.ts에 구현되었습니다. 유니코드/제로 폭 난독화를 정규화하고 고객 리뷰, 검색 쿼리, 프로모션 인수를 검사합니다.
다중 카트 격리: 엔진은 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.
