{
  "markdown": "# Скажите, что должно получиться в&nbsp;Яндекс&nbsp;KIT, — ассистент сделает и проверит\n\nКогда магазин держится на вас, даже небольшие задачи съедают время и внимание: не забыть условия промокода, разобрать документы, найти нужные товары, всё правильно настроить и перепроверить.\n\nПросто опишите, какой результат нужен. Ассистент выполнит работу в вашем магазине и проверит, что получилось.\n\n**Промокод FIRST500 — создан и проверен через API**\n\n> **Вы:** Создай промокод FIRST500: скидка 500 ₽ при заказе от 25 000 ₽, только на первую покупку, без лимита использований. Привяжи его ко всем товарам и покажи на карточках.\n>\n> **Ассистент:** Промокод FIRST500 создан и активирован. Он привязан ко всем товарам и показывается на их карточках. Размер скидки, минимальная сумма заказа, ограничение на первую покупку и фактический статус проверены через API.\n\n**Все документы распознаны и прикреплены к товарам**\n\n> **Вы:** Здесь семь PDF-файлов: инструкции, технические паспорта и сертификаты. Названия непонятные. Разбери, к каким товарам относится каждый документ, и прикрепи их.\n>\n> **Ассистент:** Разобрал содержимое документов, сопоставил их с товарами по моделям и SKU, дал понятные названия и прикрепил к нужным карточкам. Прикреплено 7 из 7 документов, нераспознанных файлов нет.\n\n**Вы решаете, что изменить в магазине, — ассистент выполняет и проверяет.** Без прямой команды он ничего не меняет и не придумывает цены, остатки или условия.\n\n[Подключить магазин](#быстрый-старт) · [Посмотреть, что ещё можно поручить](#что-уже-умеет-ассистент) · [Подписаться на Telegram-канал](https://t.me/a1_yandex_kit_skills)\n\n---\n\n# AI-ассистент для Яндекс KIT\n\n<img src=\"./assets/images/a1-logo.svg\" alt=\"A1\" width=\"22\">&nbsp;**Yandex KIT Skills** <sup>β</sup> позволяет управлять магазином из привычного приложения (Claude, Cursor, Codex и других). Вы ставите задачи обычными словами, а ассистент проверяет текущее состояние магазина, находит то, что требует внимания, и выполняет команды.\n\n- **Четыре готовых сценария.** Операционные риски и приоритеты, ошибки каталога, запуск акций и готовность магазина к открытию.\n- **Голосом или текстом.** Формулируйте рабочие задачи естественным языком. Пишите или диктуйте, если приложение поддерживает голосовой ввод. При желании можно вызвать нужный навык напрямую.\n- **Изменения только по команде.** Проверки ничего не меняют, а цены, остатки, сроки и другие бизнес-значения ассистент не придумывает.\n\n## Что уже умеет ассистент\n\n1. **Оператор** (`a1-yandex-kit-operator`) проводит операционный разбор магазина: находит всё, из-за чего можно потерять заказ, деньги или репутацию, расставляет риски по срочности и формирует точный план действий.\n2. **Доктор каталога** (`a1-yandex-kit-catalog-doctor`) находит ошибки, из-за которых товары теряют видимость и продажи, и по команде владельца исправляет их.\n3. **Запуск промо** (`a1-yandex-kit-promo-launcher`) превращает заданные условия в готовую акцию: создаёт, изменяет и запускает скидки, промокоды и подарки в магазине.\n4. **Проверка запуска** (`a1-yandex-kit-launch-check`) определяет, готов ли магазин к открытию и приёму заказов: находит блокеры и перечисляет всё, что ещё нужно подтвердить.\n5. **Специализированные навыки.** `a1-yandex-kit-orders`, `a1-yandex-kit-catalog`, `a1-yandex-kit-promotions`, `a1-yandex-kit-store` и `a1-yandex-kit-webhooks` — для отдельных задач по заказам, каталогу, акциям, ресурсам магазина и вебхукам.\n6. <img src=\"./assets/images/binoculars.png\" alt=\"Бинокль\" width=\"30\"> Не нашли нужного сценария? [Расскажите, какой задачи вам не хватает, и следите за новыми возможностями.](https://t.me/a1_yandex_kit_skills)\n\n## Увидеть работу за минуту\n\n> **Вы:** Давай подключим мой магазин.\n>\n> **Ассистент:** Для подключения нужен токен Яндекс KIT. Откройте в кабинете **Настройки → API**, скопируйте ключ и вставьте его сюда.\n>\n> **Вы:** [вставляет токен]\n>\n> **Ассистент:** Готово — Яндекс KIT подключён. Проверка прошла: вижу магазин «Название магазина».\n>\n> **Вы:** Чё, как дела?\n>\n> **Ассистент:** Проверил магазин. Сегодня пришли три заказа: два уже оплачены, один ждёт оплаты.\n>\n> **Вы:** Создай категорию «Есть на чем присесть» и добавь туда два кресла.\n>\n> **Ассистент:** Категория «Есть на чем присесть» создана. В неё добавлены «Кресло Urban Relax» и «Nordic Comfort Lounge Chair».\n>\n> **Вы:** Создай коллекцию «Я чувствую тебя» и перекинь туда всё, что связано с парфюмом.\n>\n> **Ассистент:** Создал активную коллекцию и добавил в неё три парфюма. Из прежних коллекций товары не удалял.\n>\n> **Вы:** Создай промокод FIRST500: скидка 500 ₽ при заказе от 25 000 ₽, только на первую покупку, без лимита использований. Привяжи его ко всем товарам и покажи на карточках товаров.\n>\n> **Ассистент:** Промокод FIRST500 создан и активирован. Он привязан ко всем товарам и показывается на их карточках. Размер скидки, минимальная сумма заказа, ограничение на первую покупку и фактический статус проверены через API.\n>\n> **Вы:** Подними все цены на 20%.\n>\n> **Ассистент:** Цены всех 12 товаров повышены с 999 ₽ до 1 199 ₽. Базовые и итоговые цены обновлены и проверены.\n>\n> **Вы:** [прикладывает семь PDF-файлов]\n>\n> Здесь инструкции, технические паспорта и сертификаты. Названия файлов непонятные. Разбери, к каким товарам относится каждый документ, и прикрепи их, пожалуйста.\n>\n> **Ассистент:** Разобрал содержимое семи документов и сопоставил их с каталогом по названиям моделей и SKU:\n>\n> - «Кресло Urban Relax» — инструкция по сборке и технический паспорт;\n> - «Nordic Comfort Lounge Chair» — инструкция по сборке и спецификация материалов;\n> - «Black Force», «Pink Dream» и «Champion Spirit» — декларация соответствия для каждого парфюма.\n>\n> Все совпадения однозначные. Прикрепил 7 из 7 документов, дал им понятные названия и проверил список документов у каждого товара. Нераспознанных файлов нет.\n\n---\n\n## Содержание\n\n- [Быстрый старт](#быстрый-старт)\n- [Подробнее о сценариях](#подробнее-о-сценариях)\n- [Как ассистент взаимодействует с магазином](#как-ассистент-взаимодействует-с-магазином)\n- [Обратите внимание](#обратите-внимание)\n- [MCP-сервер](#mcp-сервер-model-context-protocol)\n- [Установка через маркетплейсы](#установка-через-маркетплейсы)\n- [Обновление](#обновление)\n- [Документация](#документация)\n- [Помощь и обратная связь](#помощь-и-обратная-связь)\n\n## Быстрый старт\n\n1. Откройте терминал и установите пакет навыков:\n\n   ```bash\n   npx skills@latest add ztemerbekov/a1-yandex-kit-skills -y\n   ```\n\n   Чтобы позже получить свежие обновления, выполните `npx skills update`.\n\n2. **Явно вызовите** установщик навыком `a1-yandex-kit-setup`. В Codex вызов выглядит так:\n\n   ```text\n   $a1-yandex-kit-setup\n   ```\n\n   В другом приложении выберите навык с этим именем в списке команд.\n\n3. Следуйте вопросам установщика. Он проверит окружение и токен, подключит магазин к выбранному приложению и выполнит первый вызов.\n\n4. После сообщения об успешном подключении рабочие сценарии можно вызывать обычными фразами — голосом или текстом. Начните с простого вопроса:\n\n   > Как дела в магазине?\n\nУстановщик работает с Claude Code, Claude Desktop, Cursor, OpenAI Codex и другими приложениями. Пакет также можно установить через [маркетплейс приложения](#установка-через-маркетплейсы). Если подключение не завершилось, откройте [подробную инструкцию](docs/INSTALLATION.md): там есть полный список платформ, ручная настройка и способы устранения ошибок.\n\n## Подробнее о сценариях\n\n<details open>\n<summary><strong>Оператор — риски и приоритеты магазина</strong></summary>\n\n<br>\n\n**Оператор** (`a1-yandex-kit-operator`) помогает вовремя увидеть всё, из-за чего магазин может потерять заказ, деньги или репутацию, не обходя вручную разделы кабинета.\n\n**Что на выходе:** приоритетный разбор заказов, быстрого состояния каталога, промо и вебхуков за выбранный период. Каждый пункт опирается на факты из магазина; недоступные данные остаются явным ограничением.\n\n> **Попробуйте спросить:**\n>\n> «Как дела в магазине?» · «Что срочного?» · «Покажи заказы за сегодня и их статусы оплаты».\n\n</details>\n\n<details>\n<summary><strong>Доктор каталога — ошибки, мешающие товарам продаваться</strong></summary>\n\n<br>\n\n**Доктор каталога** (`a1-yandex-kit-catalog-doctor`) помогает поддерживать корректные карточки, цены и остатки, не открывая вручную каждый товар.\n\n**Что на выходе:** полный аудит выбранных областей с точным покрытием, найденными объектами и разделением на блокеры, риски и рекомендации. По отдельной точной команде навык исправляет одиночные или массовые значения из указанного пользователем источника.\n\n> **Попробуйте спросить:**\n>\n> «Проведи полный аудит каталога» · «Установи остаток у кроп-топа Summer Breeze: 13 штук» · «Исправь остатки по этому файлу».\n\n</details>\n\n<details>\n<summary><strong>Запуск промо — акции по заданным условиям</strong></summary>\n\n<br>\n\n**Запуск промо** (`a1-yandex-kit-promo-launcher`) помогает запустить скидку, промокод или подарок точно на нужные товары и срок, не потеряв заданные условия при настройке.\n\n**Что на выходе:** проверенные товары и существующие промо, выполнение разрешённой последовательности действий и повторное чтение итогового статуса. Механику, размер скидки, область действия, сроки, лимиты и статус задаёт пользователь; при нехватке условий запись не начинается.\n\n> **Попробуйте спросить:**\n>\n> «Создай промокод SMPT10 “Сентябрь 10”: скидка 10% на все товары с 1 по 30 сентября 2026 года по Москве, без лимита использований. Активируй сразу».\n\n</details>\n\n<details>\n<summary><strong>Проверка запуска — готовность магазина к открытию</strong></summary>\n\n<br>\n\n**Проверка запуска** (`a1-yandex-kit-launch-check`) помогает перед запуском убедиться, что покупатель сможет найти товар и пройти доступные этапы покупки без подтверждённых критических проблем.\n\n**Что на выходе:** статус **«не готов»**, **«условно готов»** или **«готов»** с отдельными блокерами, рисками и непроверенными участками. Навык проверяет данные каталога и промо, подтверждения checkout, а при наличии web-доступа у приложения — публичную витрину. Статус **«готов»** не ставится только по данным API.\n\n> **Попробуйте спросить:**\n>\n> «Проверь, готов ли магазин к открытию».\n\n</details>\n\n## Как ассистент взаимодействует с магазином\n\n**Проверка ничего не изменяет.** Если вы просите «покажи», «проверь», «разбери» или «найди», ассистент только проверит магазин и покажет результат.\n\n**Для изменения нужна точная команда.** Укажите, что нужно изменить и какое значение установить. Например: «Подними цены всех товаров на 20%». Ассистент не будет самостоятельно придумывать цену, остаток, срок или другое решение.\n\n**Повторное подтверждение не требуется.** Точная команда уже считается разрешением на действие.\n\nЭто правило относится к ассистенту. Само AI-приложение может отдельно показывать\nкнопку Allow перед вызовом инструмента. При подключении можно один раз включить\n«Работу без остановок»: AI-приложение разрешит все текущие и будущие инструменты\nYandex KIT, включая удаления, заказы, промо и настройки магазина. Сами навыки\nпо-прежнему меняют магазин только по вашей точной команде.\n\n**Результат проверяется.** Перед изменением ассистент посмотрит текущее состояние объекта, выполнит команду и затем проверит, что получилось.\n\n**Неясная операция не повторяется.** Если во время изменения пропадёт связь и результат нельзя будет подтвердить, ассистент сообщит об этом, но не станет повторять команду вслепую.\n\n**Автоматической отмены нет.** Ассистент не сохраняет копию состояния магазина перед каждым изменением, поэтому вернуть всё одной командой «как было» нельзя.\n\n## Обратите внимание\n\n**Все изменения происходят в рабочем магазине.** Отдельного тестового магазина или пробного режима нет.\n\n**Ассистент не следит за магазином постоянно.** Он проверяет состояние магазина и выполняет действия только тогда, когда вы ставите ему задачу.\n\n**С заказами доступны не все действия.** Ассистент может просматривать, подтверждать и отменять заказы. Он не может создавать заказы, свободно менять их содержимое, устанавливать статусы оплаты и доставки, оформлять возвраты или писать покупателям.\n\n**Готовность к открытию проверяется не полностью автоматически.** Ассистент не видит настройки оплаты и доставки и не может самостоятельно оформить и оплатить тестовый заказ. Эту часть проверки выполняет владелец магазина.\n\n**После ошибки связи команда не повторяется автоматически.** Сначала ассистент попробует проверить, выполнилось ли изменение. Если подтвердить результат не получится, он сообщит об этом и остановится, чтобы случайно не выполнить действие дважды.\n\n## MCP-сервер (Model Context Protocol)\n\nЭтот репозиторий содержит рабочий MCP-сервер для API Яндекс KIT — не только навыки и плагины для AI-клиентов.\n\n- **Реализация.** Сервер написан на TypeScript с официальным пакетом [`@modelcontextprotocol/sdk`](https://www.npmjs.com/package/@modelcontextprotocol/sdk), создаётся через `McpServer` и подключается к AI-клиенту через `StdioServerTransport`.\n- **Возможности MCP.** Сервер предоставляет 88 инструментов (`tools`) для работы с товарами, вариантами (включая массовое обновление цен), категориями, характеристиками, видео, новостями, заказами, клиентами, складами, коллекциями, файлами, скидками, промокодами, подарочными картами, алертами и вебхуками. Ресурсы (`resources`) и промты (`prompts`) не объявляются: операции API предоставляются как MCP-инструменты.\n- **Полное покрытие API.** Специализированные инструменты дополняют `search_operations`, `get_operation_schema` и `kit_request`, через которые доступны все 166 операций API Яндекс KIT.\n- **Транспорт.** Локальный MCP-сервер работает через `stdio`.\n- **Публикация.** Сервер доступен как npm-пакет [`mcp-yandex-kit`](https://www.npmjs.com/package/mcp-yandex-kit) и запускается через `npx` на Node.js 20 и новее.\n- **Навыки.** Навыки из этого репозитория добавляют готовые рабочие сценарии и правила безопасного выполнения операций поверх MCP-инструментов, но не заменяют сам MCP-сервер.\n\nИсходный код: [`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).\n\nНиже показано прямое подключение самого MCP-сервера. Оно добавляет MCP-инструменты для работы с API Яндекс KIT, но не устанавливает готовые навыки из этого репозитория.\n\n<details>\n<summary><strong>Codex — подключить MCP-сервер</strong></summary>\n\n<br>\n\n1. Добавьте сервер командой:\n\n   ```bash\n   codex mcp add yandex-kit \\\n     --env YANDEX_KIT_TOKEN=ваш_токен \\\n     -- npx -y mcp-yandex-kit@latest\n   ```\n\n2. Начните новую задачу Codex.\n\n3. Проверьте подключение простым запросом:\n\n   > Проверь, подключился ли магазин. Покажи, сколько товаров в каталоге, и скажи, на что стоит обратить внимание в первую очередь.\n\n</details>\n\n<details>\n<summary><strong>Cursor — подключить MCP-сервер</strong></summary>\n\n<br>\n\n1. Откройте `~/.cursor/mcp.json` и добавьте сервер:\n\n   ```json\n   {\n     \"mcpServers\": {\n       \"yandex-kit\": {\n         \"command\": \"npx\",\n         \"args\": [\"-y\", \"mcp-yandex-kit\"],\n         \"env\": {\n           \"YANDEX_KIT_TOKEN\": \"ваш_токен\"\n         }\n       }\n     }\n   }\n   ```\n\n2. Перезагрузите окно Cursor.\n\n3. Проверьте подключение простым запросом:\n\n   > Проверь, подключился ли магазин. Покажи, сколько товаров в каталоге, и скажи, на что стоит обратить внимание в первую очередь.\n\n</details>\n\n<details>\n<summary><strong>Claude Code — подключить MCP-сервер</strong></summary>\n\n<br>\n\n1. Добавьте сервер командой:\n\n   ```bash\n   claude mcp add yandex-kit \\\n     -e YANDEX_KIT_TOKEN=ваш_токен \\\n     -- npx -y mcp-yandex-kit@latest\n   ```\n\n2. Начните новую сессию Claude Code.\n\n3. Проверьте подключение простым запросом:\n\n   > Проверь, подключился ли магазин. Покажи, сколько товаров в каталоге, и скажи, на что стоит обратить внимание в первую очередь.\n\n</details>\n\n## Установка через маркетплейсы\n\nВыберите AI-приложение, в котором хотите управлять магазином. Каждый вариант устанавливает полный комплект: подключение Яндекс KIT, API-навыки и четыре готовых сценария.\n\nЕсли способ установки не важен, используйте [быстрый старт](#быстрый-старт) — там достаточно одной команды.\n\n<details>\n<summary><strong>Codex — установить через Marketplace</strong></summary>\n\n<br>\n\n1. Добавьте маркетплейс и установите полный комплект:\n\n   ```bash\n   codex plugin marketplace add ztemerbekov/a1-yandex-kit-skills\n   codex plugin add a1-yandex-kit-skills@a1-yandex-kit-skills\n   ```\n\n2. Начните новую задачу Codex, чтобы загрузились установленные навыки.\n\n3. Подключите магазин:\n\n   ```text\n   $a1-yandex-kit-skills:a1-yandex-kit-setup\n   ```\n\nСледуйте вопросам установщика — он проверит окружение, подключит магазин и выполнит первый вызов.\n\n</details>\n\n<details>\n<summary><strong>Cursor — установить через Marketplace</strong></summary>\n\n<br>\n\n1. Добавьте маркетплейс:\n\n   ```bash\n   cursor-agent plugin marketplace add https://github.com/ztemerbekov/a1-yandex-kit-skills\n   ```\n\n2. Запустите Cursor Agent, откройте `/plugin` и выберите маркетплейс **A1 Яндекс KIT**.\n\n3. Установите плагин **A1 Яндекс KIT**, затем выберите навык `a1-yandex-kit-setup` и следуйте вопросам подключения.\n\n</details>\n\n<details>\n<summary><strong>Claude Code — установить через Marketplace</strong></summary>\n\n<br>\n\n1. Добавьте маркетплейс и установите полный комплект:\n\n   ```text\n   /plugin marketplace add ztemerbekov/a1-yandex-kit-skills\n   /plugin install a1-yandex-kit-skills@a1-yandex-kit-skills\n   ```\n\n2. Загрузите установленные навыки:\n\n   ```text\n   /reload-plugins\n   ```\n\n3. Подключите магазин:\n\n   ```text\n   /a1-yandex-kit-skills:a1-yandex-kit-setup\n   ```\n\nСледуйте вопросам установщика — он проверит окружение, подключит магазин и выполнит первый вызов.\n\n</details>\n\n---\n\n## Обновление\n\nОбновляйте пакет тем же способом, которым установили его.\n\nЕсли вы использовали [быстрый старт](#быстрый-старт), получите свежую версию навыков одной командой:\n\n```bash\nnpx skills update\n```\n\nЕсли вы устанавливали пакет через маркетплейс, обновите плагин **A1 Яндекс KIT** в том же AI-приложении. После обновления начните новую задачу, чтобы приложение загрузило свежую версию навыков.\n\n---\n\n## Документация\n\n- [Как установить и подключить магазин](https://github.com/ztemerbekov/a1-yandex-kit-skills/blob/codex/readme-for-store-managers/docs/INSTALLATION.md) — пошаговая настройка, поддерживаемые приложения и помощь, если подключение не заработало.\n- [Как устроен Yandex KIT Skills](https://github.com/ztemerbekov/a1-yandex-kit-skills/blob/codex/readme-for-store-managers/docs/TECHNICAL.md) — к чему подключается ассистент, какие действия ему доступны и какие есть ограничения.\n- [Документация API Яндекс KIT](https://yandex.ru/dev/kit/ru/) — официальный справочник Яндекса для разработчиков.\n\n---\n\n## Помощь и обратная связь\n\nНужна помощь, что-то не работает или есть идея? Напишите нам в Telegram — <img src=\"./assets/images/a1-logo.svg\" alt=\"A1\" width=\"22\">&nbsp;[**Yandex KIT Skills** <sup>β</sup>](https://t.me/a1_yandex_kit_skills).\n\n<br>\n\n<p align=\"center\">\n  <img src=\"./assets/images/mona-hifive-yandex-kit-warm.gif\" alt=\"Две Моны дают пять\" width=\"256\">\n</p>\n\n<p align=\"center\">\n  Вы дочитали до конца!\n</p>\n",
  "bytes": 19128,
  "sha": "a474fc08d2d05c12bf119940e630bf2dfeca695779ad5a65e5b15f5c295b6be3",
  "repo_slug": "ztemerbekov/a1-yandex-kit-skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_gistrec_mcp_yandex_kit_1f29a8b9/readme"
}