The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Яндекс Маркет MCP (RU) listing page.
API Яндекс Маркета (Partner API) для ИИ-ассистентов: заказы и возвраты, товары и карточки, цены и тарифы, отчёты, отзывы и чаты. Каталог исполняется сервером.
Пакет поднимает один сервер, Яндекс Маркет, и ничего больше. Сервер, каталог и
ядро приходят зависимостью из marketplaces-mcp-ru:
здесь имя, точка входа и документация под один маркетплейс.
Пакет на PyPI, поэтому строка одна:
Если нужна ветка main, а не релиз:
Claude Desktop, claude_desktop_config.json:
Третий путь, если агент умеет скиллы: он поставит сервер и настроит клиент сам.
Где взять 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 ставит четыре маркетплейса сразу и держит их
под одним сервером, 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.