Node.js: SDK-ul @botmetria/ucp

WooCommerce și vitrina din feed — 15 minute · SDK-uri — aproximativ o oră · 4 moduri · nu doar WordPress

Express sau node:http simplu — comerțul agentic și analitica se instalează cu un singur pachet npm. MIT, zero dependențe, Node ≥ 18.

npm → GitHub →

Instalare

npm install @botmetria/ucp

Start rapid

Middleware-ul primul în stivă, înaintea rutelor și a body-parserelor:

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

Bonus: analitică în același pachet

Al doilea entry-point este colectorul de boți AI: numărare cu verificare IP plus blocare după regulile din panou.

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

Două niveluri — un pachet

Vitrină (doar catalog)

products (list/get, sync sau async) — agenții văd catalogul, manifestul raportează checkout:false.

Checkout complet

cart.fill(items, ctx) — checkout complet pentru agenți cu hand-off semnat în coșul dvs.

Verificare

Manifestul pe domeniul dvs. plus demo-ul live de cumpărare:

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

Pachet și surse: npm · GitHub · Specificația UCP și self-hosting