Back to Details

a1-yandex-kit-catalog

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

A1 Yandex KIT — Catalog

A1 Yandex KIT — 目录

Communication

沟通规范

Before producing any user-facing message, read and apply 
../a1-yandex-kit/references/merchant-communication.md
 completely.
Covers the catalog domain of the Yandex KIT e-commerce API — tags: Товары, Категории товаров, Характеристики товаров, Видео, Коллекции, Контекстные коллекции, Бейджи. In KIT's model the variant (
/v1/variants
) is the sellable unit carrying SKU, prices and per-warehouse stocks, and a product (
/v1/products
) groups variants, so most «товар» operations act on variants. A variant carries two distinct identifiers: 
product_id
and 
product_card_id
(карточка товара) — the card-scoped endpoints (
/v1/products/cards/{product_card_id}/similar...
and collection card management, «Добавление/Удаление карточек») take 
product_card_id
, never a product id; read it from the variant first. Variant documents (инструкции, сертификаты, паспорта) live under 
/v1/variants/{id}/attachments
: upload the file via 
POST /v1/files
first, then attach it by 
file_id
; the title must not contain 
:
or 
/
, and 
display_sequence
must be unique per variant (an occupied value returns 409 — nothing is reordered automatically). Mind the content types: 
UpdateVariant
, 
UpdateCategory
, 
UpdateCharacteristic
and 
UpdateVariantAttachment
use JSON Merge Patch (
application/merge-patch+json
— send only the fields to change; 
null
clears only the fields the schema marks nullable, see the 
a1-yandex-kit
skill), while the other updates are plain 
application/json
.
For catalog-wide syncs prefer the bulk endpoints over per-variant PATCHes: 
POST /v1/variants/prices/bulk_update
and 
POST /v1/variants/stocks/bulk_update
take up to 5000 items each and are synchronous and atomic — one invalid item (unknown or archived variant, a variant repeated in the batch, a malformed price) rejects the whole request with 400 and applies nothing, listing every offender in 
errors
. In a price item both fields are optional: omit a key to keep the current value, send 
null
to reset it (resetting 
price
works only on unpublished variants).
Product videos are a separate tag: use 
POST /v1/videos
for a local file (
multipart/form-data
) or 
POST /v1/videos/from_url
for a public link. Both accept videos up to 100 MB in mp4/mov/webm/avi/flv and deduplicate by content. Poll 
GET /v1/videos/{video_id}
— 
UPLOADED
→ 
PROCESSING
→ 
READY
, at most once every 5 seconds — and link only a ready video. A variant accepts at most one video and only alongside at least one image in the same 
media
list. Sending 
media
to 
UpdateVariant
replaces the whole list, so preserve every existing image and untouched entry. Characteristics carry two extras beyond the values themselves: groups (
/v1/characteristics/groups
, ordered by 
display_sequence
) and colors (
/v1/characteristics/colors
), where 
UpdateCharacteristicColor
recolors an existing value addressed by the value itself — there is no id — accepting a hex code or the special 
multicoloured
/ 
transparent
.
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的目录领域，涉及标签：商品、商品分类、商品属性、视频、集合、上下文集合、徽章。在KIT的模型中，变体（
/v1/variants
）是可售卖单元，包含SKU、价格和各仓库库存；而商品（
/v1/products
）用于组合变体，因此大多数“商品”操作实际作用于变体。变体包含两个不同的标识符：
product_id
和
product_card_id
（商品卡片）——以卡片为范围的接口（
/v1/products/cards/{product_card_id}/similar...
以及集合卡片管理、“添加/删除卡片”）仅接收
product_card_id
，而非商品id；需先从变体中读取该值。变体文档（说明书、证书、手册）存储在
/v1/variants/{id}/attachments
下：需先通过
POST /v1/files
上传文件，再通过
file_id
关联；文档标题不得包含
:
或
/
，且
display_sequence
在每个变体中必须唯一（若值已被占用，会返回409，系统不会自动重新排序）。注意内容类型：
UpdateVariant
、
UpdateCategory
、
UpdateCharacteristic
和
UpdateVariantAttachment
使用JSON Merge Patch（
application/merge-patch+json
——仅发送需要修改的字段；
null
仅会清除 schema 标记为可空的字段，详见
a1-yandex-kit
技能），而其他更新操作使用普通的
application/json
。
对于全目录同步，优先使用批量接口而非逐个变体的PATCH请求：
POST /v1/variants/prices/bulk_update
和
POST /v1/variants/stocks/bulk_update
每次最多支持5000个条目，且是同步且原子性的——只要有一个无效条目（未知或已归档的变体、批次中重复的变体、格式错误的价格），整个请求会返回400且不会应用任何更改，并在
errors
中列出所有问题条目。价格条目中的两个字段都是可选的：省略键值将保留当前值，发送
null
将重置该值（仅未发布的变体可重置
price
）。
商品视频是独立的标签：本地文件使用
POST /v1/videos
（
multipart/form-data
），公共链接使用
POST /v1/videos/from_url
。两者均支持最大100MB的mp4/mov/webm/avi/flv格式视频，并会根据内容去重。轮询
GET /v1/videos/{video_id}
查看状态——
UPLOADED
→ 
PROCESSING
→ 
READY
，轮询间隔至少5秒——仅可关联状态为READY的视频。每个变体最多关联一个视频，且必须与至少一张图片在同一个
media
列表中。向
UpdateVariant
发送
media
会替换整个列表，因此需保留所有现有图片和未修改的条目。除属性值本身外，属性还包含两个额外内容：属性组（
/v1/characteristics/groups
，按
display_sequence
排序）和颜色（
/v1/characteristics/colors
），其中
UpdateCharacteristicColor
用于修改现有颜色值的颜色——该值无id，需通过值本身指定，支持十六进制代码或特殊值
multicoloured
/
transparent
。
关于认证（
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 CreateProduct
  3. Validate a drafted request body offline before sending anything:
    bash
    node scripts/validate.mjs --operation CreateProduct --body '<json>'
# or: node scripts/validate.mjs --operation CreateProduct --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. 
      create_product
      , 
      update_variant
      );
    • 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，仅使用内置模块和 vendored 验证器，无需
npm install
，无需网络）。
  1. 搜索所需操作：
    bash
    node scripts/search_docs.mjs "<query>" [--tag "<Тег>"] [--limit N]
    匹配操作ID、路径、标签以及俄文摘要/描述，例如
    node scripts/search_docs.mjs "создать товар"
    。
  2. 查看单个操作的完整契约——路径/查询参数以及完全解引用的请求/响应schema：
    bash
    node scripts/search_docs.mjs --operation CreateProduct
  3. 离线验证拟发送的请求体，再实际发送：
    bash
    node scripts/validate.mjs --operation CreateProduct --body '<json>'
# 或：node scripts/validate.mjs --operation CreateProduct --body-file body.json
    验证通过时输出
    VALID
    （退出码0），否则输出schema违规列表（退出码1）。
  4. 执行操作：
    • 优先使用下方“相关MCP工具”中对应的
      mcp-yandex-kit
      工具（例如
      create_product
      、
      update_variant
      ）；
    • 无专用工具的操作：使用
      kit_request
      MCP工具——它会在发送前根据相同的schema验证请求体；
    • 或使用普通HTTP请求： 
      curl -H "Authorization: Bearer $YANDEX_KIT_TOKEN" https://api.kit.yandex.net/v1/...
      （注意每秒3次的速率限制）。

Endpoints (71 operations)

接口（共71个操作）

Товары

商品

MethodPathOperationIdSummary (RU)
GET
/v1/products
GetProducts
Получение списка продуктов
POST
/v1/products
CreateProduct
Создание нового продукта
GET
/v1/products/{id}
GetProductById
Получение продукта по ID
PATCH
/v1/products/{id}
UpdateProduct
Обновление продукта
GET
/v1/products/cards/{product_card_id}/similar
GetSimilarProductCardIDs
Получение списка похожих карточек товара.
POST
/v1/products/cards/{product_card_id}/similar/add
AddSimilarProductCards
Добавление похожих карточек товара
POST
/v1/products/cards/{product_card_id}/similar/remove
DeleteSimilarProductCards
Удаление похожих карточек товара
GET
/v1/variants
GetVariants
Получение списка товаров
POST
/v1/variants
CreateVariant
Создание нового товара
GET
/v1/variants/{id}
GetVariantById
Получение товара по ID
PATCH
/v1/variants/{id}
UpdateVariant
Обновление товара
DELETE
/v1/variants/{id}
DeleteVariant
Безвозвратное удаление архивного товара
POST
/v1/variants/{id}/archive
ArchiveVariant
Архивирование товара
POST
/v1/variants/{id}/unarchive
UnarchiveVariant
Восстановление товара из архива
GET
/v1/variants/{id}/external_ids
GetVariantExternalIDs
Получение внешних идентификаторов товара
PUT
/v1/variants/{id}/external_ids/{system_type}
SetVariantExternalID
Установка внешнего идентификатора
DELETE
/v1/variants/{id}/external_ids/{system_type}
DeleteVariantExternalID
Удаление внешнего идентификатора
GET
/v1/variants/{id}/attachments
GetVariantAttachments
Получение документов товара
POST
/v1/variants/{id}/attachments
CreateVariantAttachment
Прикрепление документа к товару
PATCH
/v1/variants/{id}/attachments/{file_id}
UpdateVariantAttachment
Обновление документа товара
DELETE
/v1/variants/{id}/attachments/{file_id}
DeleteVariantAttachment
Открепление документа от товара
POST
/v1/variants/stocks/bulk_update
BulkUpdateStocks
Массовое обновление остатков
POST
/v1/variants/prices/bulk_update
BulkUpdatePrices
Массовое обновление цен
方法路径操作ID摘要（中文）
GET
/v1/products
GetProducts
获取商品列表
POST
/v1/products
CreateProduct
创建新商品
GET
/v1/products/{id}
GetProductById
根据ID获取商品
PATCH
/v1/products/{id}
UpdateProduct
更新商品
GET
/v1/products/cards/{product_card_id}/similar
GetSimilarProductCardIDs
获取相似商品卡片列表
POST
/v1/products/cards/{product_card_id}/similar/add
AddSimilarProductCards
添加相似商品卡片
POST
/v1/products/cards/{product_card_id}/similar/remove
DeleteSimilarProductCards
删除相似商品卡片
GET
/v1/variants
GetVariants
获取变体列表
POST
/v1/variants
CreateVariant
创建新变体
GET
/v1/variants/{id}
GetVariantById
根据ID获取变体
PATCH
/v1/variants/{id}
UpdateVariant
更新变体
DELETE
/v1/variants/{id}
DeleteVariant
永久删除已归档变体
POST
/v1/variants/{id}/archive
ArchiveVariant
归档变体
POST
/v1/variants/{id}/unarchive
UnarchiveVariant
从归档中恢复变体
GET
/v1/variants/{id}/external_ids
GetVariantExternalIDs
获取变体外部标识符
PUT
/v1/variants/{id}/external_ids/{system_type}
SetVariantExternalID
设置外部标识符
DELETE
/v1/variants/{id}/external_ids/{system_type}
DeleteVariantExternalID
删除外部标识符
GET
/v1/variants/{id}/attachments
GetVariantAttachments
获取变体文档
POST
/v1/variants/{id}/attachments
CreateVariantAttachment
为变体附加文档
PATCH
/v1/variants/{id}/attachments/{file_id}
UpdateVariantAttachment
更新变体文档
DELETE
/v1/variants/{id}/attachments/{file_id}
DeleteVariantAttachment
移除变体文档
POST
/v1/variants/stocks/bulk_update
BulkUpdateStocks
批量更新库存
POST
/v1/variants/prices/bulk_update
BulkUpdatePrices
批量更新价格

Категории товаров

商品分类

MethodPathOperationIdSummary (RU)
GET
/v1/categories
GetCategories
Получение списка категорий
POST
/v1/categories
CreateCategory
Создание новой категории
GET
/v1/categories/{id}
GetCategoryById
Получение категории по ID
PATCH
/v1/categories/{id}
UpdateCategory
Обновление категории
POST
/v1/categories/{id}/archive
ArchiveCategory
Архивирование категории
POST
/v1/categories/{id}/unarchive
UnarchiveCategory
Восстановление категории из архива
方法路径操作ID摘要（中文）
GET
/v1/categories
GetCategories
获取分类列表
POST
/v1/categories
CreateCategory
创建新分类
GET
/v1/categories/{id}
GetCategoryById
根据ID获取分类
PATCH
/v1/categories/{id}
UpdateCategory
更新分类
POST
/v1/categories/{id}/archive
ArchiveCategory
归档分类
POST
/v1/categories/{id}/unarchive
UnarchiveCategory
从归档中恢复分类

Характеристики товаров

商品属性

MethodPathOperationIdSummary (RU)
GET
/v1/characteristics
GetCharacteristics
Получение списка характеристик
POST
/v1/characteristics
CreateCharacteristic
Создание новой характеристики
GET
/v1/characteristics/{id}
GetCharacteristicById
Получение характеристики по ID
PATCH
/v1/characteristics/{id}
UpdateCharacteristic
Обновление характеристики
POST
/v1/characteristics/{id}/archive
ArchiveCharacteristic
Архивирование характеристики
POST
/v1/characteristics/{id}/unarchive
UnarchiveCharacteristic
Восстановление характеристики из архива
GET
/v1/characteristics/groups
GetCharacteristicGroups
Получение списка групп характеристик
POST
/v1/characteristics/groups
CreateCharacteristicGroup
Создание группы характеристик
GET
/v1/characteristics/groups/{id}
GetCharacteristicGroupById
Получение группы характеристик по ID
PATCH
/v1/characteristics/groups/{id}
UpdateCharacteristicGroup
Обновление группы характеристик
DELETE
/v1/characteristics/groups/{id}
DeleteCharacteristicGroup
Удаление группы характеристик
GET
/v1/characteristics/colors
GetCharacteristicColors
Получение списка цветов
PATCH
/v1/characteristics/colors
UpdateCharacteristicColor
Обновление hex-кода для значения цветовой характеристики
方法路径操作ID摘要（中文）
GET
/v1/characteristics
GetCharacteristics
获取属性列表
POST
/v1/characteristics
CreateCharacteristic
创建新属性
GET
/v1/characteristics/{id}
GetCharacteristicById
根据ID获取属性
PATCH
/v1/characteristics/{id}
UpdateCharacteristic
更新属性
POST
/v1/characteristics/{id}/archive
ArchiveCharacteristic
归档属性
POST
/v1/characteristics/{id}/unarchive
UnarchiveCharacteristic
从归档中恢复属性
GET
/v1/characteristics/groups
GetCharacteristicGroups
获取属性组列表
POST
/v1/characteristics/groups
CreateCharacteristicGroup
创建属性组
GET
/v1/characteristics/groups/{id}
GetCharacteristicGroupById
根据ID获取属性组
PATCH
/v1/characteristics/groups/{id}
UpdateCharacteristicGroup
更新属性组
DELETE
/v1/characteristics/groups/{id}
DeleteCharacteristicGroup
删除属性组
GET
/v1/characteristics/colors
GetCharacteristicColors
获取颜色列表
PATCH
/v1/characteristics/colors
UpdateCharacteristicColor
更新颜色属性值的十六进制代码

Видео

视频

MethodPathOperationIdSummary (RU)
GET
/v1/videos
GetVideos
Получение списка видео
POST
/v1/videos
UploadVideo
Загрузка видео
POST
/v1/videos/from_url
UploadVideoFromUrl
Загрузка видео по ссылке
GET
/v1/videos/{video_id}
GetVideoById
Получение видео по идентификатору
方法路径操作ID摘要（中文）
GET
/v1/videos
GetVideos
获取视频列表
POST
/v1/videos
UploadVideo
上传视频
POST
/v1/videos/from_url
UploadVideoFromUrl
通过链接上传视频
GET
/v1/videos/{video_id}
GetVideoById
根据ID获取视频

Коллекции

集合

MethodPathOperationIdSummary (RU)
GET
/v1/collections/{collection_id}
GetCollectionById
Получение коллекции по ID
PATCH
/v1/collections/{collection_id}
UpdateCollection
Обновление коллекции
DELETE
/v1/collections/{collection_id}
DeleteCollectionById
Удаление коллекции
POST
/v1/collections/{collection_id}/cards/add
AddCardsToCollection
Добавление карточек в статическую коллекцию
POST
/v1/collections/{collection_id}/cards/remove
RemoveCardsFromCollection
Удаление карточек из статической коллекции
GET
/v1/collections/{collection_id}/cards/manual-order
GetCollectionCardsManualOrder
Получение ручного порядка карточек коллекции
POST
/v1/collections/{collection_id}/cards/move
MoveCollectionCards
Перемещение карточек в статической коллекции
GET
/v1/collections
GetCollections
Получение списка коллекций
POST
/v1/collections
CreateCollection
Создание коллекции
GET
/v1/collections/{collection_id}/variants
GetVariantsByCollectionId
Получение ID товаров коллекции по ID
方法路径操作ID摘要（中文）
GET
/v1/collections/{collection_id}
GetCollectionById
根据ID获取集合
PATCH
/v1/collections/{collection_id}
UpdateCollection
更新集合
DELETE
/v1/collections/{collection_id}
DeleteCollectionById
删除集合
POST
/v1/collections/{collection_id}/cards/add
AddCardsToCollection
向静态集合添加卡片
POST
/v1/collections/{collection_id}/cards/remove
RemoveCardsFromCollection
从静态集合移除卡片
GET
/v1/collections/{collection_id}/cards/manual-order
GetCollectionCardsManualOrder
获取集合卡片手动排序
POST
/v1/collections/{collection_id}/cards/move
MoveCollectionCards
在静态集合中移动卡片
GET
/v1/collections
GetCollections
获取集合列表
POST
/v1/collections
CreateCollection
创建集合
GET
/v1/collections/{collection_id}/variants
GetVariantsByCollectionId
根据集合ID获取变体ID

Контекстные коллекции

上下文集合

MethodPathOperationIdSummary (RU)
GET
/v1/context-collections
GetContextCollections
Получение списка контекстных коллекций
POST
/v1/context-collections
CreateContextCollection
Создание контекстной коллекции
GET
/v1/context-collections/{id}
GetContextCollectionById
Получение контекстной коллекции по ID
PATCH
/v1/context-collections/{id}
UpdateContextCollection
Обновление контекстной коллекции
DELETE
/v1/context-collections/{id}
DeleteContextCollection
Удаление контекстной коллекции
方法路径操作ID摘要（中文）
GET
/v1/context-collections
GetContextCollections
获取上下文集合列表
POST
/v1/context-collections
CreateContextCollection
创建上下文集合
GET
/v1/context-collections/{id}
GetContextCollectionById
根据ID获取上下文集合
PATCH
/v1/context-collections/{id}
UpdateContextCollection
更新上下文集合
DELETE
/v1/context-collections/{id}
DeleteContextCollection
删除上下文集合

Бейджи

徽章

MethodPathOperationIdSummary (RU)
GET
/v1/badges/{badge_id}
GetBadgeById
Получение бейджа по уникальному идентификатору
PATCH
/v1/badges/{badge_id}
UpdateBadge
Обновление бейджа
DELETE
/v1/badges/{badge_id}
DeleteBadgeById
Удаление бейджа
GET
/v1/badges
GetBadges
Получение списка бейджей
POST
/v1/badges
CreateBadge
Создание бейджа
GET
/v1/badges/{badge_id}/variants
GetBadgeVariantIDs
Получение уникальных идентификаторов товаров бейджа
GET
/v1/badges/{badge_id}/categories
GetBadgeCategoryIDs
Получение идентификаторов категорий бейджа
GET
/v1/badges/{badge_id}/collections
GetBadgeCollectionIDs
Получение идентификаторов коллекций бейджа
POST
/v1/badges/{badge_id}/objects/add
AddBadgeObjects
Добавление объектов в бейдж
POST
/v1/badges/{badge_id}/objects/remove
RemoveBadgeObjects
Удаление объектов из бейджа
方法路径操作ID摘要（中文）
GET
/v1/badges/{badge_id}
GetBadgeById
根据唯一ID获取徽章
PATCH
/v1/badges/{badge_id}
UpdateBadge
更新徽章
DELETE
/v1/badges/{badge_id}
DeleteBadgeById
删除徽章
GET
/v1/badges
GetBadges
获取徽章列表
POST
/v1/badges
CreateBadge
创建徽章
GET
/v1/badges/{badge_id}/variants
GetBadgeVariantIDs
获取徽章关联的变体唯一ID
GET
/v1/badges/{badge_id}/categories
GetBadgeCategoryIDs
获取徽章关联的分类ID
GET
/v1/badges/{badge_id}/collections
GetBadgeCollectionIDs
获取徽章关联的集合ID
POST
/v1/badges/{badge_id}/objects/add
AddBadgeObjects
向徽章添加对象
POST
/v1/badges/{badge_id}/objects/remove
RemoveBadgeObjects
从徽章移除对象

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):
  • list_products
    — List products of the store (paginated).
  • get_product
    — Get a single product by its ID, including its category bindings.
  • create_product
    — Create a new product.
  • update_product
    — Update an existing product (plain JSON PATCH, not merge-patch).
  • list_variants
    — List variants (sellable items / SKUs) of the store, with optional filters (paginated).
  • get_variant
    — Get a single variant by its ID (name, SKU, pricing, stocks, media, status).
  • create_variant
    — Create a new variant (sellable item) under an existing product.
  • update_variant
    — Update an existing variant via JSON Merge Patch: send only the fields to change (e.g. pricing or stocks).
  • bulk_update_prices
    — Update prices of up to 5000 variants in one synchronous, atomic request — the fast path for syncing a whole catalog instead of calling update_variant per item.
  • variant_action
    — Archive a variant (soft delete: status becomes ARCHIVED, item is hidden from the storefront but restorable) or unarchive it (status becomes HIDDEN; publish it afterwards via update_variant).
  • list_categories
    — List product categories of the store (paginated).
  • get_category
    — Get a single product category by its ID.
  • create_category
    — Create a new product category.
  • update_category
    — Update an existing category via JSON Merge Patch: send only the fields to change.
  • category_action
    — Archive a category (soft delete: hidden from the storefront, restorable) or unarchive it.
  • list_characteristics
    — List product characteristics (paginated).
  • get_characteristic
    — Get one product characteristic by ID.
  • create_characteristic
    — Create a product characteristic.
  • update_characteristic
    — Update a product characteristic.
  • list_characteristic_groups
    — List product characteristic groups (paginated).
  • get_characteristic_group
    — Get one product characteristic group by ID.
  • create_characteristic_group
    — Create a product characteristic group.
  • update_characteristic_group
    — Update a product characteristic group.
  • list_characteristic_colors
    — List the color values of the store's characteristics with their hex codes (paginated).
  • update_characteristic_color
    — Set the hex code of a color characteristic value.
  • list_videos
    — List product videos of the store (paginated), oldest upload first.
  • get_video
    — Get a single video by its ID with the current processing status.
  • upload_video
    — Upload a product video via multipart/form-data and queue it for processing.
  • upload_video_from_url
    — Upload a product video by public link and queue it for processing — use it instead of upload_video when the file lives on the web rather than on this machine.
  • list_collections
    — List collections of the store (paginated).
  • get_collection
    — Get a single collection by its ID (title, slug, status, type, SEO fields).
  • create_collection
    — Create a new collection.
  • update_collection
    — Update an existing collection (plain JSON PATCH; only the provided fields are changed).
  • delete_collection
    — Permanently delete a collection by its ID.
  • manage_collection_cards
    — Add product cards to a STATIC collection or remove them from it.
Контекстные коллекции and Бейджи have no dedicated tools — reach them through 
search_operations
+ 
kit_request
.
为上述标签整理的
mcp-yandex-kit
工具（服务器还提供三个元工具——
search_operations
、
get_operation_schema
、
kit_request
——可覆盖全部162个操作）：
  • list_products
    — 列出商店商品（分页）。
  • get_product
    — 根据ID获取单个商品，包括其分类绑定信息。
  • create_product
    — 创建新商品。
  • update_product
    — 更新现有商品（普通JSON PATCH，非合并补丁）。
  • list_variants
    — 列出商店变体（可售卖单元/SKU），支持可选筛选（分页）。
  • get_variant
    — 根据ID获取单个变体（名称、SKU、定价、库存、媒体、状态）。
  • create_variant
    — 在现有商品下创建新变体（可售卖单元）。
  • update_variant
    — 通过JSON Merge Patch更新现有变体：仅发送需要修改的字段（例如定价或库存）。
  • bulk_update_prices
    — 在一个同步、原子性请求中更新最多5000个变体的价格——相比逐个调用update_variant，这是全目录同步的快速路径。
  • variant_action
    — 归档变体（软删除：状态变为ARCHIVED，商品从商店前台隐藏但可恢复）或取消归档（状态变为HIDDEN；之后需通过update_variant发布）。
  • list_categories
    — 列出商店商品分类（分页）。
  • get_category
    — 根据ID获取单个商品分类。
  • create_category
    — 创建新商品分类。
  • update_category
    — 通过JSON Merge Patch更新现有分类：仅发送需要修改的字段。
  • category_action
    — 归档分类（软删除：从商店前台隐藏，可恢复）或取消归档。
  • list_characteristics
    — 列出商品属性（分页）。
  • get_characteristic
    — 根据ID获取单个商品属性。
  • create_characteristic
    — 创建商品属性。
  • update_characteristic
    — 更新商品属性。
  • list_characteristic_groups
    — 列出商品属性组（分页）。
  • get_characteristic_group
    — 根据ID获取单个商品属性组。
  • create_characteristic_group
    — 创建商品属性组。
  • update_characteristic_group
    — 更新商品属性组。
  • list_characteristic_colors
    — 列出商店属性的颜色值及其十六进制代码（分页）。
  • update_characteristic_color
    — 设置颜色属性值的十六进制代码。
  • list_videos
    — 列出商店商品视频（分页），按上传时间从旧到新排序。
  • get_video
    — 根据ID获取单个视频及其当前处理状态。
  • upload_video
    — 通过multipart/form-data上传商品视频并排队处理。
  • upload_video_from_url
    — 通过公共链接上传商品视频并排队处理——当文件存储在网络而非本地时，优先使用此工具。
  • list_collections
    — 列出商店集合（分页）。
  • get_collection
    — 根据ID获取单个集合（标题、别名、状态、类型、SEO字段）。
  • create_collection
    — 创建新集合。
  • update_collection
    — 更新现有集合（普通JSON PATCH；仅修改提供的字段）。
  • delete_collection
    — 根据ID永久删除集合。
  • manage_collection_cards
    — 向STATIC集合添加商品卡片或从中移除。
上下文集合和徽章暂无专用工具——可通过
search_operations
+ 
kit_request
操作。