Merchant Web MCP — прототип аналитики агентов и операционной готовности

Превратите любой интернет-магазин в наблюдаемую, измеримую и транзакционную платформу для ИИ-агентов покупок.

[!NOTE] Уведомление о прототипе и симуляции: Этот репозиторий содержит интерактивную симуляционную панель и прототип предлагаемой архитектуры плагина BigCommerce / Merchant Web MCP. Движок симуляции работает на стороне клиента с имитацией задержек, настоящим подписанием Web Crypto HMAC-SHA256, реальными 15-минутными таймерами резервирования запасов (TTL) и дашбордом Agent Intent Analytics для руководства.

🎯 Основная проблема и ценность предложения

Ближайшая реальность: слепота к трафику агентов

Сегодня продавцы слепы к ИИ-агентам покупок (ChatGPT Agent, Claude, Perplexity, Apple Intelligence). Когда боты парсят страницы товаров:

• Трафик неотличим от трафика примитивных веб-скраперов.

• Визуальный скрапинг потребляет 6 000–10 000 токенов на страницу и часто ломается при гидратации React или редизайне DOM.

• Продавцы имеют нулевую видимость того, какие товары ищут агенты, какие запросы терпят неудачу и какой коммерческий спрос остаётся неучтённым.

Решение: BigCommerce Merchant Web MCP

1. Agent Intent Analytics (немедленная ценность SaaS): Фиксирует входящие сессии агентов, выполнение инструментов, обнаруженную ценность намерений (пайплайн £124k+), разбивку по провайдерам и пробелы спроса в каталоге.

2. Детерминированный интерфейс MCP: Предоставляет структурированные инструменты JSON-RPC (search_products, get_product_details, check_variant_stock, apply_promotions, add_to_cart_session, create_checkout_session).

3. Проверяемая криптографическая передача: Генерирует подписанные URL-адреса оформления заказа с использованием настоящих токенов Web Crypto HMAC-SHA256 и 15-минутных эфемерных мягких блокировок запасов.

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

• Автономное демо Projector (HTML в одном файле): https://merchant-web-mcp.web.app/demos/merchant-web-mcp-demo-v2.html

🛡️ Основные аспекты безопасности и целостности в этом репозитории

• Настоящий Web Crypto HMAC-SHA256: реализован в src/mcp/cryptoAuth.ts на основе стандартного crypto.subtle. Подписи криптографически проверяются при генерации сессии оформления заказа.

• Активное истечение TTL запасов: реализовано в src/mcp/merchantMcpEngine.ts. Временные резервирования истекают через 900 секунд (15 минут), автоматически возвращая остатки в доступный запас и уведомляя клиентский wire HUD.

• Многоуровневая эшелонированная защита: реализована в src/mcp/securityGuard.ts. Нормализует обфускацию Unicode/zero-width и сканирует отзывы покупателей, поисковые запросы и аргументы промоакций.

• Изоляция нескольких корзин: Движок явно сопоставляет корзины по cart_id, отклоняя попытки оформления заказа для недействительных или посторонних сессий корзин.

🗺️ Дорожная карта и производственная спецификация

Спецификацию целевого периферийного сервера Cloudflare Worker + BigCommerce см. в ROADMAP.md.