yandex-market-mcp-ru

<!-- mcp-name: io.github.ilyautov/yandex-market-mcp-ru -->

API Яндекс Маркета (Partner API) для ИИ-ассистентов: заказы и возвраты, товары и карточки, цены и тарифы, отчёты, отзывы и чаты. Каталог исполняется сервером.

<p align="center"> <a href="https://marketplaces-mcp-ru.aifrontier.tech/yandex-market-api.html"> <img src="assets/social-preview.png" alt="yandex-market-mcp-ru: API Яндекс Маркета в ИИ-ассистенте. 165 методов" width="760"> </a> </p>

Пакет поднимает один сервер, Яндекс Маркет, и ничего больше. Сервер, каталог и ядро приходят зависимостью из marketplaces-mcp-ru: здесь имя, точка входа и документация под один маркетплейс.

Установка

Пакет на PyPI, поэтому строка одна:

uvx yandex-market-mcp-ru

Если нужна ветка main, а не релиз:

uvx --from git+https://github.com/ilyautov/yandex-market-mcp-ru yandex-market-mcp-ru

Claude Desktop, claude_desktop_config.json:

{
  "mcpServers": {
    "ym": {
      "command": "uvx",
      "args": ["yandex-market-mcp-ru"],
      "env": { "YANDEX_MARKET_API_KEY": "..." }
    }
  }
}

Третий путь, если агент умеет скиллы: он поставит сервер и настроит клиент сам.

npx skills add ilyautov/yandex-market-mcp-ru

Ключи

Где взять Api-Key. Кабинет партнёра partner.market.yandex.ru, раздел Настройки, пункт Доступ к API. Ключ уходит в заголовок Api-Key, хост api.partner.market.yandex.ru.

Бизнес и кампания это разные идентификаторы. Часть методов адресуется идентификатором бизнеса, часть номером кампании (магазина). Подставить один вместо другого даёт не ошибку доступа, а пустой ответ, что путает сильнее.

Где он лежит. В ~/.marketplace-mcp/cabinets.json с правами chmod 600, локально.

| переменная | секрет | что это | |---|---|---| | YANDEX_MARKET_API_KEY | да | API-ключ из кабинета партнёра, раздел Настройки → API. |

Ключи можно не держать в окружении: сервер умеет кабинеты и кладёт их в ~/.marketplace-mcp/cabinets.json с правами 600, вне репозитория. Магазинов подключается сколько нужно, переключение прямо из чата.

Карта методов

Каталог лежит в зависимости как yandex_mcp/endpoints.yaml: 165 методов, из них 109 на чтение, 49 на запись и 7 необратимых. Сервер исполняет ровно этот файл, поэтому таблица не может разойтись с кодом.

| тема | методов | чтение | запись | необратимые | |---|---:|---:|---:|---:| | Заказы, возвраты и невыкупы | 38 | 19 | 19 | 0 | | Отчёты | 27 | 27 | 0 | 0 | | Товары и карточки | 22 | 11 | 8 | 3 | | Отгрузки, поставки и склады | 21 | 15 | 6 | 0 | | Отзывы, вопросы и чаты | 18 | 11 | 6 | 1 | | Самовывоз и регионы доставки | 15 | 10 | 3 | 2 | | Цены, тарифы и карантин | 10 | 6 | 4 | 0 | | Продвижение и реклама | 8 | 4 | 3 | 1 | | Кабинет и служебное | 6 | 6 | 0 | 0 |

Подробный разбор с параметрами и лимитами: https://marketplaces-mcp-ru.aifrontier.tech/yandex-market-api.html

Что спросить в чате

• покажи заказы на Яндекс Маркете за неделю
• какой у меня индекс качества и что его роняет
• собери отчёт по продажам за месяц
• покажи товары в карантине цен

Частые ошибки

Пустой ответ вместо данных. Чаще всего перепутаны идентификатор бизнеса и номер кампании. Ошибки доступа при этом не будет, ответ придёт корректный и пустой.

Ошибка в имени поля. Каталог методов собран из официального OpenAPI-документа, а живой прогон на реальных кабинетах ещё не делался. Неточности в именах полей возможны. describe_method покажет схему, ym_get_raw даст поправить запрос на месте.

Метод не находится по названию. Ищите по теме, а не по имени: спросите агента «что ты умеешь по Яндекс Маркету», он покажет разделы и подберёт метод сам.

Чем это отличается от marketplaces-mcp-ru

Ничем, кроме состава. marketplaces-mcp-ru ставит четыре маркетплейса сразу и держит их под одним сервером, yandex-market-mcp-ru ставит один. Код общий: правка в ядре доезжает сюда обновлением зависимости, а не копированием.

| нужно | пакет | |---|---| | только Яндекс Маркет | yandex-market-mcp-ru | | все четыре маркетплейса | marketplaces-mcp-ru |

Кто это сделал

Илья Утов, лаборатория AI Frontier. Как эти инструменты устроены внутри, пишу в Telegram и LinkedIn.

Рядом стоят business-mcp-ru (hh.ru, VK, Диадок, СБИС, Честный знак), moysklad-mcp-ru и humanizer-ru.

Все проекты одним списком, разобранные по назначению: ilyautov.github.io.

Лицензия

MIT, см. LICENSE.