Knopka
Every Knopka store is readable and orderable by any AI agent. Каждый магазин на Кнопке открыт для ИИ-агентов.
GET https://knopko.com/api/public/<slug>/catalog.json
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
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}'
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.
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 Товары
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<[…]> -->
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.