A1 Yandex KIT MCP

Поручайте задачи магазина Яндекс KIT ассистенту

 Yandex KIT Skills ^β

Проверьте, что требует внимания, приведите каталог в порядок, разберите заказы и запустите промо обычной фразой. Ассистент читает текущее состояние магазина, выполняет изменения только по точной команде и показывает проверенный итог.

• Проверяет. Заказы, каталог, промо, вебхуки и готовность магазина к открытию.
• Выполняет. Обновляет заданные цены и остатки, запускает акции, работает с файлами и документами.
• Показывает результат. Сообщает, что изменилось, что проверено полностью и где данных не хватило.

Ваш первый запрос

Что сейчас требует внимания в магазине? Проверь заказы и каталог и укажи, какие данные удалось проверить.

Подключить магазин · Посмотреть, что ещё можно поручить · Подписаться на Telegram-канал

---

AI-ассистент для Яндекс KIT

 Yandex KIT Skills ^β позволяет управлять магазином из привычного приложения (Claude, Cursor, Codex и других). Вы ставите задачи обычными словами, а ассистент проверяет текущее состояние магазина, находит то, что требует внимания, и выполняет команды.

• Четыре готовых сценария. Операционные риски и приоритеты, ошибки каталога, запуск акций и готовность магазина к открытию.
• Голосом или текстом. Формулируйте рабочие задачи естественным языком. Пишите или диктуйте, если приложение поддерживает голосовой ввод. При желании можно вызвать нужный навык напрямую.
• Изменения только по команде. Проверки ничего не меняют, а цены, остатки, сроки и другие бизнес-значения ассистент не придумывает.

Что уже умеет ассистент

1. Оператор (a1-yandex-kit-operator) проводит операционный разбор магазина: находит всё, из-за чего можно потерять заказ, деньги или репутацию, расставляет риски по срочности и формирует точный план действий.
2. Доктор каталога (a1-yandex-kit-catalog-doctor) находит ошибки, из-за которых товары теряют видимость и продажи, и по команде владельца исправляет их.
3. Запуск промо (a1-yandex-kit-promo-launcher) превращает заданные условия в готовую акцию: создаёт, изменяет и запускает скидки, промокоды и подарки в магазине.
4. Проверка запуска (a1-yandex-kit-launch-check) определяет, готов ли магазин к открытию и приёму заказов: находит блокеры и перечисляет всё, что ещё нужно подтвердить.
5. Специализированные навыки. a1-yandex-kit-orders, a1-yandex-kit-catalog, a1-yandex-kit-promotions, a1-yandex-kit-store и a1-yandex-kit-webhooks — для отдельных задач по заказам, каталогу, акциям, ресурсам магазина и вебхукам.
6. Не нашли нужного сценария? Расскажите, какой задачи вам не хватает, и следите за новыми возможностями.

一分钟了解实际效果

接入后：

你： 商店里目前有哪些事情需要处理？

助手： 我检查了可用订单、目录、促销和 Webhook。列出了发现的风险，并单独标明了未能完整检查的部分。

你： 导出订单为 CSV，包含日期、金额和状态。

助手： 已准备好导出文件，并注明了数据范围。如果列表不完整，结果中也会标明。

你： 把所有商品的价格提高 20%。

助手： 已将全部 12 件商品的价格从 999 ₽ 调高至 1 199 ₽。基准价格和最终价格均已更新并核实。

你： [附上七个 PDF 文件]

这里有说明书、技术护照和证书。文件名看不懂。请分析每份文件对应哪些商品，并帮我附上。

助手： 我分析了七份文件的内容，并根据型号名称和 SKU 与目录进行了匹配：

• “Кресло Urban Relax”——组装说明书和技术护照；
• “Nordic Comfort Lounge Chair”——组装说明书和材料规格；
• “Black Force”“Pink Dream”和“Champion Spirit”——每款香水各一份符合性声明。

所有匹配结果都明确无误。已附上 7 份文件中的 7 份，为它们添加了易懂的名称，并核实了每件商品的文件列表。没有无法识别的文件。

---

目录

• 快速开始
• 场景详解
• 助手如何与商店交互
• 请注意
• MCP 服务
• 通过市场安装
• 更新
• 文档
• 帮助与反馈

快速开始

1. 打开终端并安装技能包：

   npx skills@latest add ztemerbekov/a1-yandex-kit-skills -y
   

   以后要获取最新更新，请运行 npx skills update。

2. 明确调用 a1-yandex-kit-setup 技能安装程序。在 Codex 中，调用方式如下：

   $a1-yandex-kit-setup
   

   在其他应用中，请在命令列表里选择同名技能。

3. 按照安装程序的提示操作。它会检查环境和令牌，将商店连接到所选应用，并执行首次调用。

4. 收到连接成功的消息后，可以通过日常表达来调用工作场景——语音或文字均可。不妨先问一个简单的问题：

   商店情况怎么样？

安装程序支持 Claude Code、Claude Desktop、Cursor、OpenAI Codex 和其他应用。也可以通过应用市场安装该软件包。如果未能完成连接，请查看详细说明：其中包含完整的平台列表、手动配置方法和错误排查方式。

场景详解

选择一项熟悉的任务并向助手发送请求。你可以调整措辞：填入自己的商品、订单、日期和条件。若只是检查，只需描述你想了解的内容；若要进行更改，请指定所需值，或附上包含该值的文件。

了解商店中有哪些事情需要处理

工作日刚开始、订单积压，或者你想快速了解商店状况时，运营人员（a1-yandex-kit-operator）会检查可用数据，并按紧急程度排列发现的风险。

可以这样提问：

商店情况怎么样？今天从哪里开始？

我三天没看商店了。分析这段时间的订单，并告诉我有哪些事情需要处理。

周末前检查订单、目录和当前促销活动。哪些问题最需要优先处理？

你将获得： 对订单、目录状态、促销和 Webhook 的分析，并附上商店中的事实信息。助手还会单独指出未能检查的内容。

整理商品卡片、价格和库存

Пришла поставка, изменился прайс или в каталоге накопились ошибки. **Доктор каталога** (`a1-yandex-kit-catalog-doctor`) поможет проверить товары и внести заданные изменения.

Что можно написать:

Проведи полный аудит каталога. Сначала покажи ошибки, которые мешают купить товар.

Найди товары без фотографий и проверь, где не заполнены характеристики.

Подними цены всех товаров на 20%.

Установи остаток у кроп-топа Summer Breeze: 13 штук.

Прикладываю файл с новыми остатками. Сопоставь товары по SKU и обнови остатки по файлу. Покажи строки, для которых не нашлось однозначного совпадения.

Что получите: список ошибок с указанием товаров или проверенный результат изменений. Для аудита ассистент разделит блокеры, риски и рекомендации, укажет охват и непроверенные участки. Цены и остатки возьмёт из вашей команды или файла.

Разобрать заказы, получить ссылку на оплату и документы для отгрузки

Нужно проверить оплату, подготовить отчёт или передать отправления службе доставки. Эти задачи доступны через a1-yandex-kit-orders.

Что можно написать:

Покажи заказы за сегодня и их статусы оплаты. Скрой имена, телефоны и адреса.

Выгрузи заказы за прошлую неделю в CSV: дата, сумма и статус.

Дай платёжную ссылку для заказа 123.

Сформируй акты приёма-передачи для всех частей заказа 123. Если для какой-то части акт недоступен, объясни почему.

Что получите: список заказов, CSV, платёжную ссылку или ссылки на PDF с актами — в зависимости от запроса. Если выгрузка неполная, ассистент укажет её охват; если акт недоступен, перечислит пропущенные части заказа с причинами.

Платёжную ссылку ассистент отдаёт вам; покупателю её отправляете вы. Она постоянная и неотзываемая, поэтому не публикуйте её в открытом доступе. Ссылки на PDF с актами, наоборот, истекают: если ссылка перестала работать, запросите акт заново.

Добавить фото, видео и документы к товарам

Поставщик прислал материалы, и их нужно разложить по карточкам. Навыки a1-yandex-kit-catalog и a1-yandex-kit-store помогают работать с медиа и файлами магазина.

Что можно написать:

Прикладываю семь PDF-файлов: инструкции, технические паспорта и сертификаты. Разбери, к каким товарам они относятся, и прикрепи документы к карточкам.

Покажи загруженные файлы, включая документы, со ссылками на них.

Покажи список загруженных видео и их статусы обработки.

Добавь это фото к товару SKU-42. Сохрани остальные фотографии в карточке.

Что получите: список файлов или результат прикрепления материалов с проверкой карточек. Если по документу нельзя однозначно определить товар, ассистент уточнит соответствие. Видео хранятся отдельно и не входят в общий список файлов — их можно запросить отдельной фразой.

Запустить акцию или изменить действующий промокод

Условия акции уже определены, осталось перенести их в магазин. Запуск промо (a1-yandex-kit-promo-launcher) создаёт и изменяет скидки, промокоды и подарки по вашей команде.

Что можно написать:

Какие акции сейчас действуют? Покажи сроки, товары и условия каждой.

Создай промокод SMPT10 «Сентябрь 10»: скидка 10% на все товары с 1 по 30 сентября 2026 года по Москве, без лимита использований. Активируй сразу.

Продли промокод SMPT10 до 7 октября 2026 года, 23:59 по Москве. Остальные условия сохрани.

Отключи промокод SMPT10 и проверь, что он больше не активен.

Что получите: обзор действующих промо или настроенную акцию с проверкой итоговых условий и статуса. Если для запуска не хватает размера скидки, товаров, срока или другого обязательного условия, ассистент уточнит его.

Получить каталог для рекламы и CRM

Рекламный специалист или интегратор просит ссылку на товарный фид — файл, из которого сервис получает каталог. Навык a1-yandex-kit-store найдёт ссылку для нужной площадки.

Что можно написать:

Нужна ссылка на каталог для Яндекс Директа. Дай YML-фид магазина.

Подключаю RetailCRM. Покажи ссылку на ICML-фид.

Дай фид для Яндекс Товаров и подпиши, какой это формат.

Что получите: постоянную ссылку на нужный фид: YML для Яндекс Директа, ICML для RetailCRM или YML_GOODS для Яндекс Товаров. Адрес сохраняется при обновлении содержимого. Ссылку нужно добавить в соответствующий сервис; получение фида само по себе не запускает рекламу и не настраивает CRM.

Найти данные клиента или подготовить выгрузку

Нужна история заказов конкретного клиента, список для отчёта или правка в карточке. Эти задачи доступны через a1-yandex-kit-orders.

Что можно написать:

Покажи заказы клиента с этим ID, скрыв его персональные данные.

Выгрузи клиентов в CSV: ID, имя и email.

В карточке клиента с этим ID замени заметку на «Предпочитает самовывоз». Остальные поля сохрани.

Что получите: запрошенные данные, выгрузку с указанием охвата или проверенное изменение карточки. Скрытие персональных данных действует только на ответ ассистента — сведения в магазине сохраняются.

Проверить уведомления для интеграций

Внешняя система получает события магазина через вебхуки. Навык a1-yandex-kit-webhooks поможет посмотреть подписки, проверить принимающий адрес или отключить конкретный вебхук.

Что можно написать:

Покажи вебхуки магазина: куда они отправляют уведомления, на какие события подписаны и какой у них статус.

Запусти проверку вебхука с этим ID и покажи результат. Не активируй его.

Отключи вебхук с этим ID. Сам вебхук сохрани.

Что получите: список настроек, результат проверки или подтверждённое отключение. Проверка отправляет тестовый запрос на адрес вебхука; ассистент выполняет её по вашей команде.

Проверить магазин перед открытием

Каталог заполнен, и вы собираетесь принимать первые заказы. Проверка запуска (a1-yandex-kit-launch-check) поможет найти то, что ещё мешает открытию.

Что можно написать:

Проверь, готов ли магазин к открытию. Что мешает начать принимать заказы?

Завтра запускаем магазин. Проверь каталог и промо, а непроверенные этапы покупки вынеси в отдельный список.

Что мне проверить вручную в оплате и доставке перед открытием?

Что получите: статус «не готов», «условно готов» или «готов» с блокерами, рисками и непроверенными участками. Ассистент проверит каталог и промо, учтёт подтверждения проверки оформления заказа, а при наличии web-доступа у приложения — посмотрит публичную витрину. Оформление и оплату тестового заказа проверяет владелец; одних данных API для статуса «готов» недостаточно.

Как ассистент взаимодействует с магазином

Проверка ничего не изменяет. Если вы просите «покажи», «проверь», «разбери» или «найди», ассистент только проверит магазин и покажет результат.

Для изменения нужна точная команда. Укажите, что нужно изменить и какое значение установить. Например: «Подними цены всех товаров на 20%». Ассистент не будет самостоятельно придумывать цену, остаток, срок или другое решение.

Повторное подтверждение не требуется. Точная команда уже считается разрешением на действие.

Это правило относится к ассистенту. Само AI-приложение может отдельно показывать кнопку Allow перед вызовом инструмента. При подключении можно один раз включить «Работу без остановок»: AI-приложение разрешит все текущие и будущие инструменты Yandex KIT, включая удаления, заказы, промо и настройки магазина. Сами навыки по-прежнему меняют магазин только по вашей точной команде.

Результат проверяется. Перед изменением ассистент посмотрит текущее состояние объекта, выполнит команду и затем проверит, что получилось.

Неясная операция не повторяется. Если во время изменения пропадёт связь и результат нельзя будет подтвердить, ассистент сообщит об этом, но не станет повторять команду вслепую.

Автоматической отмены нет. Ассистент не сохраняет копию состояния магазина перед каждым изменением, поэтому вернуть всё одной командой «как было» нельзя.

Обратите внимание

Все изменения происходят в рабочем магазине. Отдельного тестового магазина или пробного режима нет.

Ассистент не следит за магазином постоянно. Он проверяет состояние магазина и выполняет действия только тогда, когда вы ставите ему задачу.

С заказами доступны не все действия. Ассистент может просматривать, подтверждать и отменять заказы. Для самовывоза и собственной доставки при выключенной автоматизации он может завершить доставку; произвольные статусы доставки и статусы оплаты недоступны. Он не может создавать заказы, свободно менять содержимое заказа, оформлять возвраты или писать покупателям.

Готовность к открытию проверяется не полностью автоматически. Ассистент не видит настройки оплаты и доставки и не может самостоятельно оформить и оплатить тестовый заказ. Эту часть проверки выполняет владелец магазина.

После ошибки связи команда не повторяется автоматически. Сначала ассистент попробует проверить, выполнилось ли изменение. Если подтвердить результат не получится, он сообщит об этом и остановится, чтобы случайно не выполнить действие дважды.

Охват списка виден в ответе. Ассистент укажет, сколько объектов проверено, а непроверенные объекты или участки отметит отдельно. Если данных не хватает, он не назовёт результат полным. Для большого списка может понадобиться несколько обращений к магазину.

Списки заказов и клиентов можно выгрузить в CSV. Попросите выгрузить список с выбранными полями, например: «Выгрузи заказы в CSV с датой, суммой и статусом». Если список получен не полностью, ассистент скажет об этом.

Персональные данные можно скрыть в ответе. Попросите показать заказы, клиентов или подарочные карты без имён, телефонов, email, адресов и заметок. Это изменяет только показанный ответ — данные магазина сохраняются как есть.

MCP-сервер (Model Context Protocol)

Этот репозиторий содержит рабочий MCP-сервер для API Яндекс KIT — не только навыки и плагины для AI-клиентов.

• Реализация. Сервер написан на TypeScript с официальным пакетом @modelcontextprotocol/sdk, создаётся через McpServer и подключается к AI-клиенту через StdioServerTransport.
• Возможности MCP. Сервер предоставляет 92 инструмента (tools) для работы с товарами, вариантами (включая массовое обновление цен), категориями, характеристиками, видео, новостями, заказами, клиентами и их корзинами, складами, коллекциями, файлами, скидками, промокодами, подарочными картами, алертами и вебхуками. Ресурсы (resources) и промты (prompts) не объявляются: операции API предоставляются как MCP-инструменты.
• Полное покрытие API. Специализированные инструменты дополняют search_operations, get_operation_schema и kit_request, через которые доступны все 169 операций API Яндекс KIT.
• Транспорт. Локальный MCP-сервер работает через stdio.
• Публикация. Сервер доступен как npm-пакет mcp-yandex-kit и запускается через npx на Node.js 20.11 и новее.
• Навыки. Навыки из этого репозитория добавляют готовые рабочие сценарии и правила безопасного выполнения операций поверх MCP-инструментов, но не заменяют сам MCP-сервер.

Исходный код: packages/mcp/src/index.ts · packages/mcp/src/tools · список инструментов · README MCP-пакета.

Ниже показано прямое подключение самого MCP-сервера. Оно добавляет MCP-инструменты для работы с API Яндекс KIT, но не устанавливает готовые навыки из этого репозитория.

Codex — подключить MCP-сервер

1. Добавьте сервер командой:

   codex mcp add yandex-kit \
     --env YANDEX_KIT_TOKEN=ваш_токен \
     -- npx -y mcp-yandex-kit@latest
   

2. Начните новую задачу Codex.

3. Проверьте подключение простым запросом:

   Проверь, подключился ли магазин. Покажи, сколько товаров в каталоге, и скажи, на что стоит обратить внимание в первую очередь.

Cursor — подключить MCP-сервер

1. Откройте ~/.cursor/mcp.json и добавьте сервер:

   {
     "mcpServers": {
       "yandex-kit": {
         "command": "npx",
         "args": ["-y", "mcp-yandex-kit"],
         "env": {
           "YANDEX_KIT_TOKEN": "ваш_токен"
         }
       }
     }
   }
   

2. Перезагрузите окно Cursor.

3. Проверьте подключение простым запросом:

   Проверь, подключился ли магазин. Покажи, сколько товаров в каталоге, и скажи, на что стоит обратить внимание в первую очередь.

Claude Code — подключить MCP-сервер

1. Добавьте сервер командой:

   claude mcp add yandex-kit \
     -e YANDEX_KIT_TOKEN=ваш_токен \
     -- npx -y mcp-yandex-kit@latest
   

2. Начните новую сессию Claude Code.

3. Проверьте подключение простым запросом:

   Проверь, подключился ли магазин. Покажи, сколько товаров в каталоге, и скажи, на что стоит обратить внимание в первую очередь.

Установка через маркетплейсы

Выберите AI-приложение, в котором хотите управлять магазином. Каждый вариант устанавливает полный комплект: подключение Яндекс KIT, API-навыки и четыре готовых сценария.

Если способ установки не важен, используйте быстрый старт — там достаточно одной команды.

Codex — установить через Marketplace

1. Добавьте маркетплейс и установите полный комплект:

   codex plugin marketplace add ztemerbekov/a1-yandex-kit-skills
   codex plugin add a1-yandex-kit-skills@a1-yandex-kit-skills
   

2. Начните новую задачу Codex, чтобы загрузились установленные навыки.

3. Подключите магазин:

   $a1-yandex-kit-skills:a1-yandex-kit-setup
   

Следуйте вопросам установщика — он проверит окружение, подключит магазин и выполнит первый вызов.

Cursor — установить через Marketplace

1. Добавьте маркетплейс:

   cursor-agent plugin marketplace add https://github.com/ztemerbekov/a1-yandex-kit-skills
   

2. Запустите Cursor Agent, откройте /plugin и выберите маркетплейс A1 Яндекс KIT.

3. Установите плагин A1 Яндекс KIT, затем выберите навык a1-yandex-kit-setup и следуйте вопросам подключения.

Claude Code — установить через Marketplace

1. Добавьте маркетплейс и установите полный комплект:

   /plugin marketplace add ztemerbekov/a1-yandex-kit-skills
   /plugin install a1-yandex-kit-skills@a1-yandex-kit-skills
   

2. Загрузите установленные навыки:

   /reload-plugins
   

3. Подключите магазин:

   /a1-yandex-kit-skills:a1-yandex-kit-setup
   

Следуйте вопросам установщика — он проверит окружение, подключит магазин и выполнит первый вызов.

---

Обновление

Обновляйте пакет тем же способом, которым установили его.

Если вы использовали быстрый старт, получите свежую версию навыков одной командой:

npx skills update

Если вы устанавливали пакет через маркетплейс, обновите плагин A1 Яндекс KIT в том же AI-приложении. После обновления начните новую задачу, чтобы приложение загрузило свежую версию навыков.

---

Документация

• Как установить и подключить магазин — пошаговая настройка, поддерживаемые приложения и помощь, если подключение не заработало.
• Как устроен Yandex KIT Skills — к чему подключается ассистент, какие действия ему доступны и какие есть ограничения.
• Документация API Яндекс KIT — официальный справочник Яндекса для разработчиков.

---

Помощь и обратная связь

Нужна помощь, что-то не работает или есть идея? Напишите нам в Telegram —  Yandex KIT Skills ^β.

Вы дочитали до конца!