Скажите, что должно получиться в Яндекс KIT, — ассистент сделает и проверит

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

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

Промокод FIRST500 — создан и проверен через API

Вы: Создай промокод FIRST500: скидка 500 ₽ при заказе от 25 000 ₽, только на первую покупку, без лимита использований. Привяжи его ко всем товарам и покажи на карточках.

Ассистент: Промокод FIRST500 создан и активирован. Он привязан ко всем товарам и показывается на их карточках. Размер скидки, минимальная сумма заказа, ограничение на первую покупку и фактический статус проверены через API.

Все документы распознаны и прикреплены к товарам

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

Ассистент: Разобрал содержимое документов, сопоставил их с товарами по моделям и SKU, дал понятные названия и прикрепил к нужным карточкам. Прикреплено 7 из 7 документов, нераспознанных файлов нет.

Вы решаете, что изменить в магазине, — ассистент выполняет и проверяет. Без прямой команды он ничего не меняет и не придумывает цены, остатки или условия.

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

---

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

<img src="./assets/images/a1-logo-warm.svg" alt="A1" width="22"> 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. <img src="./assets/images/binoculars.png" alt="Бинокль" width="30"> Не нашли нужного сценария? Расскажите, какой задачи вам не хватает, и следите за новыми возможностями.

Увидеть работу за минуту

Вы: Давай подключим мой магазин.

Ассистент: Для подключения нужен токен Яндекс KIT. Откройте в кабинете Настройки → API, скопируйте ключ и вставьте его сюда.

Вы: [вставляет токен]

Ассистент: Готово — Яндекс KIT подключён. Проверка прошла: вижу магазин «Название магазина».

Вы: Чё, как дела?

Ассистент: Проверил магазин. Сегодня пришли три заказа: два уже оплачены, один ждёт оплаты.

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

Ассистент: Категория «Есть на чем присесть» создана. В неё добавлены «Кресло Urban Relax» и «Nordic Comfort Lounge Chair».

Вы: Создай коллекцию «Я чувствую тебя» и перекинь туда всё, что связано с парфюмом.

Ассистент: Создал активную коллекцию и добавил в неё три парфюма. Из прежних коллекций товары не удалял.

Вы: Создай промокод FIRST500: скидка 500 ₽ при заказе от 25 000 ₽, только на первую покупку, без лимита использований. Привяжи его ко всем товарам и покажи на карточках товаров.

Ассистент: Промокод FIRST500 создан и активирован. Он привязан ко всем товарам и показывается на их карточках. Размер скидки, минимальная сумма заказа, ограничение на первую покупку и фактический статус проверены через API.

Вы: Подними все цены на 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 и другими приложениями. Пакет также можно установить через маркетплейс приложения. Если подключение не завершилось, откройте подробную инструкцию: там есть полный список платформ, ручная настройка и способы устранения ошибок.

Подробнее о сценариях

<details open> <summary><strong>Оператор — риски и приоритеты магазина</strong></summary>

<br>

Оператор (a1-yandex-kit-operator) помогает вовремя увидеть всё, из-за чего магазин может потерять заказ, деньги или репутацию, не обходя вручную разделы кабинета.

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

Попробуйте спросить:

«Как дела в магазине?» · «Что срочного?» · «Покажи заказы за сегодня и их статусы оплаты».

</details>

<details> <summary><strong>Доктор каталога — ошибки, мешающие товарам продаваться</strong></summary>

<br>

Доктор каталога (a1-yandex-kit-catalog-doctor) помогает поддерживать корректные карточки, цены и остатки, не открывая вручную каждый товар.

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

Попробуйте спросить:

«Проведи полный аудит каталога» · «Установи остаток у кроп-топа Summer Breeze: 13 штук» · «Исправь остатки по этому файлу».

</details>

<details> <summary><strong>Запуск промо — акции по заданным условиям</strong></summary>

<br>

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

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

Попробуйте спросить:

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

</details>

<details> <summary><strong>Проверка запуска — готовность магазина к открытию</strong></summary>

<br>

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

Что на выходе: статус «не готов», «условно готов» или «готов» с отдельными блокерами, рисками и непроверенными участками. Навык проверяет данные каталога и промо, подтверждения checkout, а при наличии web-доступа у приложения — публичную витрину. Статус «готов» не ставится только по данным API.

Попробуйте спросить:

«Проверь, готов ли магазин к открытию».

</details>

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

<details> <summary><strong>Codex — подключить MCP-сервер</strong></summary>

<br>

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

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

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

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

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

</details>

<details> <summary><strong>Cursor — подключить MCP-сервер</strong></summary>

<br>

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

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

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

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

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

</details>

<details> <summary><strong>Claude Code — подключить MCP-сервер</strong></summary>

<br>

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

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

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

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

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

</details>

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

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

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

<details> <summary><strong>Codex — установить через Marketplace</strong></summary>

<br>

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
   

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

</details>

<details> <summary><strong>Cursor — установить через Marketplace</strong></summary>

<br>

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 и следуйте вопросам подключения.

</details>

<details> <summary><strong>Claude Code — установить через Marketplace</strong></summary>

<br>

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
   

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

</details>

---

Обновление

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

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

npx skills update

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

---

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

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

---

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

Нужна помощь, что-то не работает или есть идея? Напишите нам в Telegram — <img src="./assets/images/a1-logo-warm.svg" alt="A1" width="22"> Yandex KIT Skills ^β.

<br>

<p align="center"> <img src="./assets/images/mona-hifive-yandex-kit-warm.gif" alt="Две Моны дают пять" width="256"> </p>

<p align="center"> Вы дочитали до конца! </p>