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

Yandex KIT Skills ^β

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

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

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

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

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

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

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

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

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

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

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

После подключения:

Вы: Что сейчас требует внимания в магазине?

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

Вы: Выгрузи заказы в CSV с датой, суммой и статусом.

Ассистент: Подготовил выгрузку и указал её охват. Если список получен не полностью, это отмечено в результате.

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

Ассистент: Цены всех 12 товаров повышены с 999 ₽ до 1 199 ₽. Базовые и итоговые цены обновлены и проверены.

Вы: [прикладывает семь PDF-файлов]

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

Ассистент: Разобрал содержимое семи документов и сопоставил их с каталогом по названиям моделей и SKU:

«Кресло Urban Relax» — инструкция по сборке и технический паспорт;

«Nordic Comfort Lounge Chair» — инструкция по сборке и спецификация материалов;

«Black Force», «Pink Dream» и «Champion Spirit» — декларация соответствия для каждого парфюма.

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

Содержание

Быстрый старт
Подробнее о сценариях
Как ассистент взаимодействует с магазином
Обратите внимание
MCP-сервер
Установка через маркетплейсы
Обновление
Документация
Помощь и обратная связь

Быстрый старт

Откройте терминал и установите пакет навыков:
Terminal
```
npx skills@latest add ztemerbekov/a1-yandex-kit-skills -y
```
Чтобы позже получить свежие обновления, выполните npx skills update.
Явно вызовите установщик навыком a1-yandex-kit-setup. В Codex вызов выглядит так:
text
```
$a1-yandex-kit-setup
```
В другом приложении выберите навык с этим именем в списке команд.
Следуйте вопросам установщика. Он проверит окружение и токен, подключит магазин к выбранному приложению и выполнит первый вызов.
После сообщения об успешном подключении рабочие сценарии можно вызывать обычными фразами — голосом или текстом. Начните с простого вопроса:

Как дела в магазине?

Установщик работает с Claude Code, Claude Desktop, Cursor, OpenAI Codex и другими приложениями. Пакет также можно установить через маркетплейс приложения. Если подключение не завершилось, откройте подробную инструкцию: там есть полный список платформ, ручная настройка и способы устранения ошибок.

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

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

Понять, что требует внимания в магазине

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

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

Как дела в магазине? С чего начать сегодня?

Я три дня не заглядывал в магазин. Разбери заказы за это время и покажи, что требует внимания.

Перед выходными проверь заказы, каталог и действующие акции. Какие вопросы нужно решить в первую очередь?

Что получите: разбор заказов, состояния каталога, промо и вебхуков с фактами из магазина. Ассистент отдельно укажет, что не удалось проверить.

Привести в порядок карточки, цены и остатки

Пришла поставка, изменился прайс или в каталоге накопились ошибки. Доктор каталога (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. Сервер предоставляет 88 инструментов (tools) для работы с товарами, вариантами (включая массовое обновление цен), категориями, характеристиками, видео, новостями, заказами, клиентами, складами, коллекциями, файлами, скидками, промокодами, подарочными картами, алертами и вебхуками. Ресурсы (resources) и промты (prompts) не объявляются: операции API предоставляются как MCP-инструменты.
Полное покрытие API. Специализированные инструменты дополняют search_operations, get_operation_schema и kit_request, через которые доступны все 166 операций 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-сервер

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

bash

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

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

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

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

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

config.json

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

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

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

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

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

Terminal

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

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

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

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

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

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

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

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

bash

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

Начните новую задачу Codex, чтобы загрузились установленные навыки.
Подключите магазин:
text
```
$a1-yandex-kit-skills:a1-yandex-kit-setup
```

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

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

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

bash

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

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

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

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

text

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

Загрузите установленные навыки:
text
```
/reload-plugins
```
Подключите магазин:
text
```
/a1-yandex-kit-skills:a1-yandex-kit-setup
```

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

Обновление

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

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

Terminal

npx skills update

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

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

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

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

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

Две Моны дают пять

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