Knopka

API · MCP

Every Knopka store is readable and orderable by any AI agent. Каждый магазин на Кнопке открыт для ИИ-агентов.

Catalog JSON

GET https://knopko.com/api/public/<slug>/catalog.json

MCP (Streamable HTTP, JSON-RPC 2.0)

POST https://knopko.com/mcp/<slug>

tools: search_products {query}, get_product {id}, create_order {items:[{id,qty}], name, contact, address?}
curl -s https://knopko.com/mcp/svechi-ani -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_products","arguments":{"query":"лаванда"}}}'

Claude Desktop / Claude Code: claude mcp add --transport http knopka https://knopko.com/mcp/svechi-ani

REST API v1

Create a key in Cabinet → Integrations (shown once, stored as SHA-256). Ключ создаётся в кабинете: «Подключения». Limit 120 req/min per key; read-only keys get 403 on writes. CORS enabled.

Authorization: Bearer kn_…        (or  x-api-key: kn_…)

GET    https://knopko.com/v1/shop
GET    https://knopko.com/v1/products?q=&sku=&limit=&offset=
POST   https://knopko.com/v1/products            {title, price, sku?, compare_price?, category?, description?, stock?, active?, image_url?}
GET    https://knopko.com/v1/products/{id}
PATCH  https://knopko.com/v1/products/{id}       {price?, stock?, …}
DELETE https://knopko.com/v1/products/{id}
GET    https://knopko.com/v1/orders?status=&since=<ms>&limit=
GET    https://knopko.com/v1/orders/{id|number}
POST   https://knopko.com/v1/orders              {items:[{id|sku, qty}], name, contact, address?, comment?}
PATCH  https://knopko.com/v1/orders/{id}         {status: new|confirmed|paid|shipped|done|cancelled}
GET    https://knopko.com/v1/customers?limit=&offset=
curl -s https://knopko.com/v1/products?q=candle -H "Authorization: Bearer $KNOPKA_KEY"
curl -s -X PATCH https://knopko.com/v1/products/ID -H "Authorization: Bearer $KNOPKA_KEY" \
  -H 'content-type: application/json' -d '{"stock": 12, "price": 990}'

Webhooks

Events: order.created, order.status_changed, product.updated, chat.handoff, subscriber.created (+ ping from the Test button). POST JSON, 8 s timeout, one retry, delivery log in the cabinet.

POST https://your.app/hook
x-knopka-event: order.created
x-knopka-delivery: <id>
x-knopka-signature: sha256=<hex HMAC-SHA256(raw body, webhook secret)>

{"id":"…","event":"order.created","created_at":"2026-…","shop":{"id":"…","slug":"…"},"data":{…}}
// Node.js — verify
const sig = 'sha256=' + crypto.createHmac('sha256', SECRET).update(rawBody).digest('hex');
if (!crypto.timingSafeEqual(Buffer.from(sig), Buffer.from(req.headers['x-knopka-signature']))) return res.status(401).end();

Zapier: Catch Hook · Make: Custom webhook · n8n: Webhook node · amoCRM / Bitrix24: via Make, Zapier or n8n (order.created → deal) · 1C: pull GET /v1/orders?since= or receive order.created.

Product feeds

Permanent public URLs, always up to date. Постоянные ссылки для маркетплейсов и рекламы.

https://knopko.com/feeds/<slug>/products.json
https://knopko.com/feeds/<slug>/products.csv
https://knopko.com/feeds/<slug>/yml.xml        Yandex Market / Direct (YML)
https://knopko.com/feeds/<slug>/google.xml     Google Merchant Center (RSS 2.0, g:)
https://knopko.com/feeds/<slug>/facebook.csv   Meta Commerce Manager catalog
https://knopko.com/feeds/<slug>/vk.csv         VK Товары

embed.js — chat & Buy on any site

Works on Tilda, WordPress, Webflow or plain HTML. Isolated in Shadow DOM, no styles leak.

<script src="https://knopko.com/embed.js" data-shop="<slug>" async></script>

<!-- Buy button: product id or exact title -->
<button data-knopka-buy="Lavender candle">Buy</button>

<!-- options: data-chat="off"  data-position="left"
     JS: Knopka.open()  Knopka.buy('id-or-title')  Knopka.products() -> Promise<[…]> -->

Import

Cabinet → Integrations → Import: CSV / Excel (xlsx), YML, Google Merchant XML, Shopify / WooCommerce / Tilda CSV, Ozon / Wildberries exports, JSON (incl. Shopify /products.json), a Google Sheets link, or any website URL (Shopify JSON, JSON-LD, Open Graph, sitemap). Preview first; matching by SKU, then title — no duplicates.

Made by Sudarev · sudarev.app