yandex-market-mcp-ru

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

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

Установка

Первый релиз на PyPI выпускается тегом v0.5.3, до этого пакет ставится прямо из репозитория:

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

После релиза строка короче:

uvx yandex-market-mcp-ru

Claude Desktop, claude_desktop_config.json:

{
  "mcpServers": {
    "ym": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/ilyautov/yandex-market-mcp-ru", "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, локально.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Лицензия

MIT, см. LICENSE.