# Поручайте задачи магазина Яндекс KIT ассистенту A1 **Yandex KIT Skills** β Проверьте, что требует внимания, приведите каталог в порядок, разберите заказы и запустите промо обычной фразой. Ассистент читает текущее состояние магазина, выполняет изменения только по точной команде и показывает проверенный итог. - **Проверяет.** Заказы, каталог, промо, вебхуки и готовность магазина к открытию. - **Выполняет.** Обновляет заданные цены и остатки, запускает акции, работает с файлами и документами. - **Показывает результат.** Сообщает, что изменилось, что проверено полностью и где данных не хватило. **Ваш первый запрос** > Что сейчас требует внимания в магазине? Проверь заказы и каталог и укажи, какие данные удалось проверить. [Подключить магазин](#быстрый-старт) · [Посмотреть, что ещё можно поручить](#что-уже-умеет-ассистент) · [Подписаться на Telegram-канал](https://t.me/a1_yandex_kit_skills) --- # AI-ассистент для Яндекс KIT A1 **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. Бинокль Не нашли нужного сценария? [Расскажите, какой задачи вам не хватает, и следите за новыми возможностями.](https://t.me/a1_yandex_kit_skills) ## Увидеть работу за минуту После подключения: > **Вы:** Что сейчас требует внимания в магазине? > > **Ассистент:** Проверил доступные заказы, каталог, промо и вебхуки. Показал найденные риски и отдельно отметил участки, которые не удалось проверить полностью. > > **Вы:** Выгрузи заказы в CSV с датой, суммой и статусом. > > **Ассистент:** Подготовил выгрузку и указал её охват. Если список получен не полностью, это отмечено в результате. > > **Вы:** Подними цены всех товаров на 20%. > > **Ассистент:** Цены всех 12 товаров повышены с 999 ₽ до 1 199 ₽. Базовые и итоговые цены обновлены и проверены. > > **Вы:** [прикладывает семь PDF-файлов] > > Здесь инструкции, технические паспорта и сертификаты. Названия файлов непонятные. Разбери, к каким товарам относится каждый документ, и прикрепи их, пожалуйста. > > **Ассистент:** Разобрал содержимое семи документов и сопоставил их с каталогом по названиям моделей и SKU: > > - «Кресло Urban Relax» — инструкция по сборке и технический паспорт; > - «Nordic Comfort Lounge Chair» — инструкция по сборке и спецификация материалов; > - «Black Force», «Pink Dream» и «Champion Spirit» — декларация соответствия для каждого парфюма. > > Все совпадения однозначные. Прикрепил 7 из 7 документов, дал им понятные названия и проверил список документов у каждого товара. Нераспознанных файлов нет. --- ## Содержание - [Быстрый старт](#быстрый-старт) - [Подробнее о сценариях](#подробнее-о-сценариях) - [Как ассистент взаимодействует с магазином](#как-ассистент-взаимодействует-с-магазином) - [Обратите внимание](#обратите-внимание) - [MCP-сервер](#mcp-сервер-model-context-protocol) - [Установка через маркетплейсы](#установка-через-маркетплейсы) - [Обновление](#обновление) - [Документация](#документация) - [Помощь и обратная связь](#помощь-и-обратная-связь) ## Быстрый старт 1. Откройте терминал и установите пакет навыков: ```bash npx skills@latest add ztemerbekov/a1-yandex-kit-skills -y ``` Чтобы позже получить свежие обновления, выполните `npx skills update`. 2. **Явно вызовите** установщик навыком `a1-yandex-kit-setup`. В Codex вызов выглядит так: ```text $a1-yandex-kit-setup ``` В другом приложении выберите навык с этим именем в списке команд. 3. Следуйте вопросам установщика. Он проверит окружение и токен, подключит магазин к выбранному приложению и выполнит первый вызов. 4. После сообщения об успешном подключении рабочие сценарии можно вызывать обычными фразами — голосом или текстом. Начните с простого вопроса: > Как дела в магазине? Установщик работает с Claude Code, Claude Desktop, Cursor, OpenAI Codex и другими приложениями. Пакет также можно установить через [маркетплейс приложения](#установка-через-маркетплейсы). Если подключение не завершилось, откройте [подробную инструкцию](docs/INSTALLATION.md): там есть полный список платформ, ручная настройка и способы устранения ошибок. ## Подробнее о сценариях Выберите знакомую задачу и отправьте запрос ассистенту. Формулировки можно менять: подставьте свои товары, заказы, даты и условия. Для проверки достаточно описать, что вас интересует; для изменения укажите нужное значение или приложите файл, из которого его взять.
Понять, что требует внимания в магазине
Начинается рабочий день, накопились заказы или нужно быстро разобраться в состоянии магазина. **Оператор** (`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`](https://www.npmjs.com/package/@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`](https://www.npmjs.com/package/mcp-yandex-kit) и запускается через `npx` на Node.js 20.11 и новее. - **Навыки.** Навыки из этого репозитория добавляют готовые рабочие сценарии и правила безопасного выполнения операций поверх MCP-инструментов, но не заменяют сам MCP-сервер. Исходный код: [`packages/mcp/src/index.ts`](packages/mcp/src/index.ts) · [`packages/mcp/src/tools`](packages/mcp/src/tools) · [список инструментов](docs/TOOLS.md) · [README MCP-пакета](packages/mcp/README.md). Ниже показано прямое подключение самого MCP-сервера. Оно добавляет MCP-инструменты для работы с API Яндекс KIT, но не устанавливает готовые навыки из этого репозитория.
Codex — подключить MCP-сервер
1. Добавьте сервер командой: ```bash codex mcp add yandex-kit \ --env YANDEX_KIT_TOKEN=ваш_токен \ -- npx -y mcp-yandex-kit@latest ``` 2. Начните новую задачу Codex. 3. Проверьте подключение простым запросом: > Проверь, подключился ли магазин. Покажи, сколько товаров в каталоге, и скажи, на что стоит обратить внимание в первую очередь.
Cursor — подключить MCP-сервер
1. Откройте `~/.cursor/mcp.json` и добавьте сервер: ```json { "mcpServers": { "yandex-kit": { "command": "npx", "args": ["-y", "mcp-yandex-kit"], "env": { "YANDEX_KIT_TOKEN": "ваш_токен" } } } } ``` 2. Перезагрузите окно Cursor. 3. Проверьте подключение простым запросом: > Проверь, подключился ли магазин. Покажи, сколько товаров в каталоге, и скажи, на что стоит обратить внимание в первую очередь.
Claude Code — подключить MCP-сервер
1. Добавьте сервер командой: ```bash 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. Добавьте маркетплейс и установите полный комплект: ```bash codex plugin marketplace add ztemerbekov/a1-yandex-kit-skills codex plugin add a1-yandex-kit-skills@a1-yandex-kit-skills ``` 2. Начните новую задачу Codex, чтобы загрузились установленные навыки. 3. Подключите магазин: ```text $a1-yandex-kit-skills:a1-yandex-kit-setup ``` Следуйте вопросам установщика — он проверит окружение, подключит магазин и выполнит первый вызов.
Cursor — установить через Marketplace
1. Добавьте маркетплейс: ```bash 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. Добавьте маркетплейс и установите полный комплект: ```text /plugin marketplace add ztemerbekov/a1-yandex-kit-skills /plugin install a1-yandex-kit-skills@a1-yandex-kit-skills ``` 2. Загрузите установленные навыки: ```text /reload-plugins ``` 3. Подключите магазин: ```text /a1-yandex-kit-skills:a1-yandex-kit-setup ``` Следуйте вопросам установщика — он проверит окружение, подключит магазин и выполнит первый вызов.
--- ## Обновление Обновляйте пакет тем же способом, которым установили его. Если вы использовали [быстрый старт](#быстрый-старт), получите свежую версию навыков одной командой: ```bash npx skills update ``` Если вы устанавливали пакет через маркетплейс, обновите плагин **A1 Яндекс KIT** в том же AI-приложении. После обновления начните новую задачу, чтобы приложение загрузило свежую версию навыков. --- ## Документация - [Как установить и подключить магазин](docs/INSTALLATION.md) — пошаговая настройка, поддерживаемые приложения и помощь, если подключение не заработало. - [Как устроен Yandex KIT Skills](docs/TECHNICAL.md) — к чему подключается ассистент, какие действия ему доступны и какие есть ограничения. - [Документация API Яндекс KIT](https://yandex.ru/dev/kit/ru/) — официальный справочник Яндекса для разработчиков. --- ## Помощь и обратная связь Нужна помощь, что-то не работает или есть идея? Напишите нам в Telegram — A1 [**Yandex KIT Skills** β](https://t.me/a1_yandex_kit_skills).

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

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