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. Не нашли нужного сценария? Расскажите, какой задачи вам не хватает, и следите за новыми возможностями.

1分でわかる動作の様子

接続後：

あなた： ショップで今、対応が必要なことはありますか？

アシスタント： 利用可能な注文、カタログ、プロモーション、Webhookを確認しました。見つかったリスクを示し、完全には確認できなかった項目も別途記載しました。

あなた： 日付、金額、ステータスを含めて注文をCSVにエクスポートして。

アシスタント： エクスポートを作成し、対象範囲を示しました。一覧を完全に取得できなかった場合は、結果にその旨を記載しています。

あなた： すべての商品を20%値上げして。

アシスタント： 12商品の価格をすべて999 ₽から1 199 ₽に値上げしました。基本価格と最終価格を更新し、確認しました。

あなた： ［PDFファイルを7つ添付］

ここに説明書、技術パスポート、証明書があります。ファイル名がわかりにくいです。それぞれの書類がどの商品に該当するか整理して、添付してください。

アシスタント： 7つの書類の内容を確認し、モデル名と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）が利用可能なデータを確認し、見つかったリスクを緊急度順に整理します。

次のように入力できます：

ショップの状況はどうですか？今日は何から始めればよいですか？

3日間ショップを確認していません。その間の注文を整理して、対応が必要なものを示してください。

週末前に注文、カタログ、実施中のプロモーションを確認してください。優先して解決すべきことは何ですか？

得られる結果： ショップのデータに基づく、注文、カタログの状態、プロモーション、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 ^β.

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