A1 Yandex KIT Skills 是做什么的？
沟通
在生成任何面向用户的消息之前，请完整阅读并应用
references/merchant-communication.md。
Yandex KIT (kit.yandex.ru, beta) 是 Yandex 的电商店铺构建器——实际上相当于俄语版的 Shopify。其 REST API 是一个用于在商家后端与平台之间同步目录、库存和价格，以及管理订单的服务器到服务器层。官方文档为俄语；完整的 OpenAPI 规范（160 个操作）已与此技能打包在 data/kit_v1.json.gz 中，并可通过以下脚本离线搜索。
API 要点
- 基础 URL：
https://api.kit.yandex.net，所有路径均以/v1/为前缀。 - 认证：
Authorization: Bearer <token>（纯 HTTP Bearer，非 OAuth）。令牌在商家后台生成：设置 → API → 生成令牌——它仅显示一次，请安全存储，若丢失需生成新令牌。 - 速率限制：每个店铺每秒 3 个请求，没有配额头部。超出限制将返回
LIMIT_EXCEEDED错误，并附带 HTTP 400（而非 429）——请在客户端进行限流，并通过其code字段而非状态码来识别该错误。 - 错误约定：每个错误均为 JSON 格式
{"code", "message", "trace_id"}。错误码：AUTHENTICATION_ERROR(401)、FORBIDDEN_ERROR(403)、VALIDATION_ERROR(400)、LIMIT_EXCEEDED(400)、UNSUPPORTED_MEDIA_TYPE(415)、NOT_FOUND(404)、CONFLICT(409)、UNKNOWN_ERROR(500)。联系支持时请提供trace_id。 - 日期时间：所有时间均为 UTC。
- 无沙箱：仅限生产环境——探索时优先使用只读调用，并仔细检查每次写入操作。
- 分页：列表接口接受
page+per_page（最大 100）查询参数。 - 内容类型：请求体为
application/json，但使用 JSON Merge Patch (application/merge-patch+json) 的 5 个操作除外：UpdateCategory、UpdateCharacteristic、UpdateVariant、UpdateVariantAttachment、UpdateWarehouse——仅发送需要更改的字段。null仅当架构标记字段可为 NULL 时清除该字段——对于以上操作，只有UpdateCategory的parent_id和file_id可被清除；在其他位置使用null会验证失败（下面的validate.mjs脚本将捕获此问题）。POST /v1/files(UploadFile) 和POST /v1/videos(UploadVideo) 使用multipart/form-data。 - 批量写入：
BulkUpdatePrices和BulkUpdateStocks每次请求最多接受 5000 个项目，且是原子操作——单个无效项目将拒绝整个批次（400），且不应用任何更改。对于目录同步，优先使用它们而非逐个变体的更新。
工作流程
从本技能的目录运行打包的脚本——它们是独立的（Node.js >= 20，内置模块 + 一个打包的验证器，无需 npm install，无需联网）。
-
搜索您需要的操作：
node scripts/search_docs.mjs "<query>" [--tag "<Тег>"] [--limit N]匹配操作 ID、路径、标签以及俄文的摘要/描述， 例如：
node scripts/search_docs.mjs "создать товар"。 -
检查一个操作的完整契约——路径/查询参数以及完全解析的请求/响应架构：
node scripts/search_docs.mjs --operation CreateProduct -
验证草拟的请求体，在发送之前离线检查：
node scripts/validate.mjs --operation CreateProduct --body '<json>' # 或：node scripts/validate.mjs --operation CreateProduct --body-file body.json输出
VALID（退出码 0）或架构违规列表（退出码 1）。 -
执行操作：
- 优先使用打包的
mcp-yandex-kitMCP 服务器：当存在专门的工具时使用（参见领域技能），否则使用下面的元工具三件套； - 任何没有专门工具的操作：使用
kit_requestMCP 工具——它在发送前会用相同的架构验证请求体； - 或使用纯 HTTP：
curl -H "Authorization: Bearer $YANDEX_KIT_TOKEN" https://api.kit.yandex.net/v1/...（注意每秒 3 个请求的限制）。
- 优先使用打包的
领域技能
当任务明确属于某一领域时，优先使用聚焦的技能——每个都打包了相同的脚本和数据，以及其标签的端点表：
a1-yandex-kit-catalog—— 商品、变体（SKU、价格、库存、批量价格/库存同步）、分类、特性（属性组、颜色）、视频、系列、场景系列、徽章。a1-yandex-kit-orders—— 订单、客户、礼品卡、附加服务（附加组件）。a1-yandex-kit-promotions—— 折扣、促销码、促销码组、赠品。a1-yandex-kit-store—— 店铺资料、仓库、用户、地理信息、文件、重定向、博客/新闻、告警。a1-yandex-kit-webhooks—— Webhook：订单事件、HTTPS 回调、签名密钥。
相关 MCP 工具
打包的 mcp-yandex-kit MCP 服务器提供了 70 个工具。精选工具覆盖日常的目录/订单/促销/店铺/Webhook 工作流程（在领域技能中列出）；下面的元工具三件套可覆盖 所有 160 个操作：
search_operations—— 通过关键字搜索所有 160 个 Yandex KIT API 操作的完整目录。get_operation_schema—— 按 operationId 获取一个 KIT API 操作的完整元数据：HTTP 方法、路径、路径/查询参数、请求内容类型、分页信息以及请求体和响应的完全解析 JSON 架构。kit_request—— 逃生门，通过 operationId 执行任意一个 Yandex KIT API 操作，包括没有专门工具的操作。