Node.js: SDK @botmetria/ucp

WooCommerce и витрина из фида — 15 минут · SDK — около часа · 4 способа · работает не только на WordPress

Express или чистый node:http — агентская коммерция и аналитика ставятся одним npm-пакетом. MIT, ноль зависимостей, Node ≥ 18.

npm → GitHub →

Установка

npm install @botmetria/ucp

Быстрый старт

Middleware — первым в стеке, до роутов и body-парсеров:

const { Ucp, expressMiddleware } = require("@botmetria/ucp");

const ucp = new Ucp({
  store_name: "My Shop",
  store_url: "https://my-shop.com/",
  currency: "EUR",
  products: myProducts,   // { list(offset, limit), get(id) } — sync or async
  // cart: myCart,        // { fill(items, ctx) } — agent checkout
});

app.use(expressMiddleware(ucp)); // first, before routes and body parsers

Бонус: аналитика тем же пакетом

Второй entry-point — коллектор ИИ-ботов: учёт с IP-верификацией и блокировка по правилам из кабинета.

const { middleware } = require("@botmetria/ucp/collect");
app.use(middleware()); // BM_SITE / BM_KEY / BM_SECRET from env

Два уровня — один пакет

Витрина (только каталог)

products (list/get, можно async) — агенты видят каталог, манифест сообщает checkout:false.

Полный чекаут

cart.fill(items, ctx) — полный агентский чекаут с подписанным hand-off в вашу корзину.

Проверка

Манифест на вашем домене плюс живое демо покупки:

curl https://your-store.com/.well-known/ucp

Пакет и исходники: npm · GitHub · Спецификация UCP и self-hosting