Back to Details

a1-yandex-kit-store

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

A1 Yandex KIT — Store

A1 Yandex KIT — 商店

Communication

沟通规范

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; 
UpdateWarehouse
uses JSON Merge Patch), upload files (
POST /v1/files
— with 
POST /v1/videos
in the catalog domain, one of the API's two 
multipart/form-data
endpoints), and maintain SEO redirects and blog/news posts.
Alerts are the store's system-problem feed: 
GET /v1/alerts
requires a status filter (
ACTIVE
/
RESOLVED
) and returns 
CRITICAL
before 
WARNING
, newest first within a severity. Only 
WARNING
alerts can be closed by hand via 
POST /v1/alerts/{alert_id}/resolve
; an active 
CRITICAL
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 
/v1/
), the 3 rps rate limit and the 
{code, message, trace_id}
error contract, see the 
a1-yandex-kit
skill.
在生成任何面向用户的消息之前，请完整阅读并遵循
../a1-yandex-kit/references/merchant-communication.md
中的要求。
涵盖Yandex KIT电商API的商店级领域——标签：商店、仓库、用户、地理区域、文件、重定向、新闻、告警。你可以在此处读取商店资料和API用户信息，管理仓库（商品库存关联仓库；
UpdateWarehouse
使用JSON Merge Patch），上传文件（
POST /v1/files
——与商品目录领域的
POST /v1/videos
一同，是API仅有的两个
multipart/form-data
端点），以及维护SEO重定向和博客/新闻文章。
告警是商店的系统问题信息流：
GET /v1/alerts
必须携带状态过滤器（
ACTIVE
/
RESOLVED
），返回结果中
CRITICAL
（严重）级别排在
WARNING
（警告）之前，同一级别内按最新优先排序。仅
WARNING
级别的告警可通过
POST /v1/alerts/{alert_id}/resolve
手动关闭；尝试关闭活跃的
CRITICAL
告警会返回400错误，且该告警会在底层问题修复后自动清除。
关于认证（
Authorization: Bearer <token>
）、基础URL（
https://api.kit.yandex.net
，所有路径均在
/v1/
下）、每秒3次的速率限制以及
{code, message, trace_id}
错误约定，请查看
a1-yandex-kit
技能文档。

Workflow

工作流程

Run the bundled scripts from this skill's directory — they are self-contained (Node.js >= 20, builtins + a vendored validator, no 
npm install
, no network).
  1. 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 "создать склад"
    .
  2. 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
  3. 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 
    VALID
    (exit 0) or the list of schema violations (exit 1).
  4. Execute the operation:
    • prefer the matching 
      mcp-yandex-kit
      MCP tool from «Related MCP tools» below (e.g. 
      get_store
      , 
      create_warehouse
      );
    • any operation without a dedicated tool: the 
      kit_request
      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).
从本技能目录运行捆绑的脚本——它们是独立的（Node.js >= 20，仅使用内置模块和自带的验证器，无需
npm install
，无需网络）。
  1. 搜索所需操作：
    bash
    node scripts/search_docs.mjs "<查询关键词>" [--tag "<标签>"] [--limit N]
    匹配操作ID、路径、标签以及俄文摘要/描述，例如
    node scripts/search_docs.mjs "创建仓库"
    。
  2. 查看单个操作的完整契约——路径/查询参数以及完全解引用的请求/响应 Schema：
    bash
    node scripts/search_docs.mjs --operation CreateWarehouse
  3. 离线验证草拟的请求正文，再发送请求：
    bash
    node scripts/validate.mjs --operation CreateWarehouse --body '<json内容>'
# 或：node scripts/validate.mjs --operation CreateWarehouse --body-file body.json
    验证通过则输出
    VALID
    （退出码0），否则输出Schema违规列表（退出码1）。
  4. 执行操作：
    • 优先使用下方「相关MCP工具」中匹配的
      mcp-yandex-kit
      工具（例如
      get_store
      、
      create_warehouse
      ）；
    • 无专用工具的操作：使用
      kit_request
      MCP工具——它会在发送前用相同的Schema验证请求正文；
    • 或使用普通HTTP请求： 
      curl -H "Authorization: Bearer $YANDEX_KIT_TOKEN" https://api.kit.yandex.net/v1/...
      （注意每秒3次的速率限制）。

Endpoints (23 operations)

端点（23个操作）

Магазин

商店

MethodPathOperationIdSummary (RU)
GET
/v1/store
GetStore
Получение информации о магазине
请求方法路径操作ID摘要（中文）
GET
/v1/store
GetStore
获取商店信息

Склады

仓库

MethodPathOperationIdSummary (RU)
GET
/v1/warehouses
GetWarehouses
Получение списка складов
POST
/v1/warehouses
CreateWarehouse
Создание нового склада
GET
/v1/warehouses/{id}
GetWarehouseById
Получение склада по ID
PATCH
/v1/warehouses/{id}
UpdateWarehouse
Обновление склада
POST
/v1/warehouses/{id}/archive
ArchiveWarehouse
Архивирование склада
POST
/v1/warehouses/{id}/unarchive
UnarchiveWarehouse
Восстановление склада из архива
请求方法路径操作ID摘要（中文）
GET
/v1/warehouses
GetWarehouses
获取仓库列表
POST
/v1/warehouses
CreateWarehouse
创建新仓库
GET
/v1/warehouses/{id}
GetWarehouseById
根据ID获取仓库信息
PATCH
/v1/warehouses/{id}
UpdateWarehouse
更新仓库信息
POST
/v1/warehouses/{id}/archive
ArchiveWarehouse
归档仓库
POST
/v1/warehouses/{id}/unarchive
UnarchiveWarehouse
从归档恢复仓库

Пользователи

用户

MethodPathOperationIdSummary (RU)
GET
/v1/users/current
GetCurrentUser
Получение текущего пользователя
请求方法路径操作ID摘要（中文）
GET
/v1/users/current
GetCurrentUser
获取当前用户信息

Гео

地理区域

MethodPathOperationIdSummary (RU)
GET
/v1/geo/regions
GetRegions
Получение списка регионов
请求方法路径操作ID摘要（中文）
GET
/v1/geo/regions
GetRegions
获取区域列表

Файлы

文件

MethodPathOperationIdSummary (RU)
POST
/v1/files
UploadFile
Загрузка файла
GET
/v1/files/{id}
GetFileById
Получение файла по ID
请求方法路径操作ID摘要（中文）
POST
/v1/files
UploadFile
上传文件
GET
/v1/files/{id}
GetFileById
根据ID获取文件信息

Редиректы

重定向

MethodPathOperationIdSummary (RU)
GET
/v1/redirects
GetRedirects
Получение списка редиректов
POST
/v1/redirects
CreateRedirect
Создание редиректа
GET
/v1/redirects/{redirect_id}
GetRedirectById
Получение редиректа по ID
PATCH
/v1/redirects/{redirect_id}
UpdateRedirect
Обновление редиректа
DELETE
/v1/redirects/{redirect_id}
DeleteRedirectById
Удаление редиректа
请求方法路径操作ID摘要（中文）
GET
/v1/redirects
GetRedirects
获取重定向列表
POST
/v1/redirects
CreateRedirect
创建重定向
GET
/v1/redirects/{redirect_id}
GetRedirectById
根据ID获取重定向信息
PATCH
/v1/redirects/{redirect_id}
UpdateRedirect
更新重定向信息
DELETE
/v1/redirects/{redirect_id}
DeleteRedirectById
删除重定向

Новости

新闻

MethodPathOperationIdSummary (RU)
GET
/v1/blogs/{blog_id}
GetBlogById
Получение новости по уникальному идентификатору
PATCH
/v1/blogs/{blog_id}
UpdateBlog
Обновление новости
DELETE
/v1/blogs/{blog_id}
DeleteBlogById
Удаление новости
GET
/v1/blogs
GetBlogs
Получение списка новостей
POST
/v1/blogs
CreateBlog
Создание новости
请求方法路径操作ID摘要（中文）
GET
/v1/blogs/{blog_id}
GetBlogById
根据唯一ID获取新闻
PATCH
/v1/blogs/{blog_id}
UpdateBlog
更新新闻
DELETE
/v1/blogs/{blog_id}
DeleteBlogById
删除新闻
GET
/v1/blogs
GetBlogs
获取新闻列表
POST
/v1/blogs
CreateBlog
创建新闻

Алерты

告警

MethodPathOperationIdSummary (RU)
GET
/v1/alerts
GetAlerts
Получение списка алертов
POST
/v1/alerts/{alert_id}/resolve
ResolveAlert
Закрытие алерта
请求方法路径操作ID摘要（中文）
GET
/v1/alerts
GetAlerts
获取告警列表
POST
/v1/alerts/{alert_id}/resolve
ResolveAlert
关闭告警

Related MCP tools

相关MCP工具

Curated 
mcp-yandex-kit
tools for these tags (the server also exposes the meta trio — 
search_operations
, 
get_operation_schema
, 
kit_request
— reaching all 162 operations):
  • get_store
    — Get information about the current store (id, slug, b2c_url).
  • get_current_user
    — Get the user that owns the API token.
  • get_regions
    — Get the list of geographic regions (countries, regions, cities).
  • list_warehouses
    — List warehouses of the store (paginated).
  • get_warehouse
    — Get a single warehouse by its ID (title, slug, status).
  • create_warehouse
    — Create a new warehouse.
  • update_warehouse
    — Update an existing warehouse via JSON Merge Patch: send only the fields to change; setting a field to null removes it.
  • warehouse_action
    — Archive a warehouse (soft delete: status becomes ARCHIVED, warehouse can no longer be used for stock) or unarchive it (status becomes ACTIVE again).
  • upload_file
    — Upload a file (e.g. an image for a variant or collection) via multipart/form-data.
  • get_file
    — Get metadata of a previously uploaded file by its ID (name, size, URL).
  • list_blogs
    — List store news articles (paginated).
  • get_blog
    — Get one store news article by ID.
  • create_blog
    — Create a store news article.
  • update_blog
    — Update a store news article.
  • list_alerts
    — List system alerts of the store (paginated), CRITICAL ones first and newest first within the same severity.
  • resolve_alert
    — Mark an alert as resolved.
Редиректы have no dedicated tools — manage them through 
search_operations
+ 
kit_request
.
为上述标签整理的
mcp-yandex-kit
工具（服务器还提供三个元工具——
search_operations
、
get_operation_schema
、
kit_request
——可覆盖全部162个操作）：
  • get_store
    — 获取当前商店信息（ID、别名、b2c_url）。
  • get_current_user
    — 获取API令牌所属用户信息。
  • get_regions
    — 获取地理区域列表（国家、地区、城市）。
  • list_warehouses
    — 列出商店的仓库（分页）。
  • get_warehouse
    — 根据ID获取单个仓库信息（名称、别名、状态）。
  • create_warehouse
    — 创建新仓库。
  • update_warehouse
    — 通过JSON Merge Patch更新现有仓库：仅发送需要修改的字段；将字段设为null会删除该字段。
  • warehouse_action
    — 归档仓库（软删除：状态变为ARCHIVED，仓库无法再用于库存管理）或恢复归档仓库（状态变回ACTIVE）。
  • upload_file
    — 通过multipart/form-data上传文件（例如商品或分类的图片）。
  • get_file
    — 根据ID获取已上传文件的元数据（名称、大小、URL）。
  • list_blogs
    — 列出商店新闻文章（分页）。
  • get_blog
    — 根据ID获取单篇商店新闻文章。
  • create_blog
    — 创建商店新闻文章。
  • update_blog
    — 更新商店新闻文章。
  • list_alerts
    — 列出商店的系统告警（分页），严重级别告警优先，同一级别内按最新优先排序。
  • resolve_alert
    — 将告警标记为已解决。
重定向暂无专用工具——请通过
search_operations
+ 
kit_request
进行管理。