Before producing any user-facing message, read and apply
../a1-yandex-kit/references/merchant-communication.md
completely.
Covers the store-level domain of the Yandex KIT e-commerce API — tags: Магазин,
Склады, Пользователи, Гео, Файлы, Редиректы, Новости, Алерты. This is where you read the store
profile and the API user, manage warehouses (variant stocks reference them;
uses JSON Merge Patch), upload files (
— with
in the
catalog domain, one of the API's two
endpoints), and maintain SEO
redirects and blog/news posts.
Alerts are the store's system-problem feed:
requires a status filter
(
/
) and returns
before
, newest first within a
severity. Only
alerts can be closed by hand via
POST /v1/alerts/{alert_id}/resolve
; an active
one is rejected with 400 and
clears itself once the underlying problem is fixed.
For authentication (
Authorization: Bearer <token>
), the base URL (
https://api.kit.yandex.net
, all paths under
), the 3 rps rate limit and the
{code, message, trace_id}
error contract, see the
skill.
Run the bundled scripts from this skill's directory — they are self-contained
(Node.js >= 20, builtins + a vendored validator, no
, no network).
-
Search for the operation you need:
bash
node scripts/search_docs.mjs "<query>" [--tag "<Тег>"] [--limit N]
Matches operation ids, paths, tags and the Russian summaries/descriptions,
e.g.
node scripts/search_docs.mjs "создать склад"
.
-
Inspect the full contract of one operation — path/query parameters plus the fully
dereferenced request/response schemas:
bash
node scripts/search_docs.mjs --operation CreateWarehouse
-
Validate a drafted request body offline before sending anything:
bash
node scripts/validate.mjs --operation CreateWarehouse --body '<json>'
# or: node scripts/validate.mjs --operation CreateWarehouse --body-file body.json
Prints
(exit 0) or the list of schema violations (exit 1).
-
Execute the operation:
- prefer the matching MCP tool from «Related MCP tools» below (e.g. , );
- any operation without a dedicated tool: the MCP tool — it validates
the body against the same schema before sending;
- or plain HTTP:
curl -H "Authorization: Bearer $YANDEX_KIT_TOKEN" https://api.kit.yandex.net/v1/...
(mind the 3 rps limit).
Curated
tools for these tags (the server also exposes the meta trio —
,
,
— reaching all
162 operations):
Редиректы have no dedicated tools — manage them through
+
.