AgentReady Woo — инструментарий готовности к агентной коммерции для самостоятельных магазинов WooCommerce

Работает на app.utilityhouse.xyz.

AgentReady сканирует самостоятельный магазин WooCommerce и оценивает, насколько он готов к коммерции через ИИ-агентов (MCP/A2A), а затем предоставляет живой каталог через продуктовый фид и поверхность MCP-инструментов, которые торговые агенты могут запрашивать и совершать покупки. Оформление заказа всегда завершается на собственном сайте продавца через подписанную, ограниченную по времени передачу корзины — данные карт никогда не проходят через AgentReady.

Подключите магазин, вставив его URL и ключ WooCommerce REST API только для чтения, созданный в админ-панели WordPress самого продавца (Settings → Advanced → REST API). Установка плагина не требуется. Ключ можно отозвать в один клик, и AgentReady никогда не записывает данные в магазин — только доступ к каталогу для чтения.

Что он делает

• Бесплатное сканирование готовности — оценивает любой магазин WooCommerce по 100-балльной шкале: файлы обнаружения, работоспособность Store API, качество фида, поддержка передачи корзины.

• Живой продуктовый фид — повторно синхронизируется с магазином по расписанию; цена и наличие всегда актуальны.

• Файл обнаружения агентов — /.well-known/agenticweb.md для каждого подключенного магазина, чтобы агенты могли узнать, что поддерживает фид магазина, прежде чем вызывать его.

• Поверхность MCP-инструментов — агенты вызывают search_products, get_offer, get_feed, create_cart_link и verify_cart_link для живого каталога магазина.

• Подписанная передача корзины — HMAC-подписанные, одноразовые ссылки для добавления в корзину, срок действия которых истекает через ≤60 минут; покупатель завершает оформление заказа на собственном сайте продавца.

• Панель управления — видимость трафика агентов и упущенных возможностей для продавца.

Related MCP server: mcp-woocommerce

MCP-эндпоинты

Этот репозиторий предоставляет две отдельные поверхности MCP, использующие одну форму вызова инструмента (POST {tool, input} — в форме MCP, но не полный протокол JSON-RPC 2.0; см. «Статус» ниже):

• Инструмент коммерции для каждого магазина — POST /mcp/{store_id} — пять инструментов каталога, перечисленных выше, ограниченных живым магазином одного подключенного продавца.

• Инструмент сканирования готовности — POST /mcp — единый глобальный инструмент с оплатой через x402 (agentready_woo_agentic_commerce_readiness_toolkit_for_self_h), который по запросу оценивает готовность любого магазина WooCommerce к агентам.

Статус

Развернут и используется в производстве, с реальной интеграцией биллинга Paddle и финансовым реестром на базе D1 для инструмента сканирования готовности с оплатой через x402. Тестовый набор (npm test) покрывает аутентификацию, вебхуки биллинга, сканер готовности и поверхность MCP-инструментов.

Форма вызова MCP-инструмента намеренно минимальна — {tool, input} через JSON — а не полный протокол MCP JSON-RPC 2.0. Подключение официальной обвязки @modelcontextprotocol/sdk — это отслеживаемый следующий шаг, а не блокер для текущего использования (см. mcp-registry/server.json для описания, ориентированного на реестр).

Локальная разработка

npm install
npm run typecheck
npm test

Развертывание

Cloudflare Workers, через wrangler.toml в этом репозитории (привязка D1, маршрутизация пользовательских доменов, секреты задокументированы встроенными комментариями — сами секреты никогда не коммитятся, только устанавливаются с помощью wrangler secret put).

npx wrangler deploy

Лицензия

Проприетарная. Исходный код публикуется здесь для прозрачности MCP Registry / обнаружения агентов; это не предоставление лицензии с открытым исходным кодом.