API Яндекс Маркета: ключ и карта методов
У Яндекс Маркета одна точка входа и один ключ, так что подключение проще, чем у соседей. Тонкость в другом: методы адресуются не только магазином, но и бизнесом, и перепутать эти два идентификатора легко.
Как получить доступ
Где взять Api-Key
Кабинет партнёра partner.market.yandex.ru, раздел Настройки, пункт Доступ к API. Ключ уходит в заголовок Api-Key, хост api.partner.market.yandex.ru.
Бизнес и кампания это разные идентификаторы
Часть методов адресуется идентификатором бизнеса, часть номером кампании (магазина). Подставить один вместо другого даёт не ошибку доступа, а пустой ответ, что путает сильнее.
Где он лежит
В ~/.marketplace-mcp/cabinets.json с правами chmod 600, локально.
Карта методов
Таблицы собраны из того же каталога, который грузит сервер, поэтому они не расходятся с кодом. Колонки показывают, как метод классифицирует safety-гейт: перед записью агент предупреждает, перед необратимым действием требует подтверждения.
| Раздел | Методов | Чтение | Запись | Необратимые |
|---|---|---|---|---|
| Заказы, возвраты и невыкупы | 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 |
| Всего | 165 |
Курированное ядро выверено на живых кабинетах. Остальное импортировано из спецификаций: пути надёжны, HTTP-глаголы не всегда, считайте такие записи картой для разведки. Официальная документация: yandex.ru/dev/market/partner-api.
Частые ошибки и что они значат
Пустой ответ вместо данных
Чаще всего перепутаны идентификатор бизнеса и номер кампании. Ошибки доступа при этом не будет, ответ придёт корректный и пустой.
Ошибка в имени поля
Каталог методов собран из официального OpenAPI-документа, а живой прогон на реальных кабинетах ещё не делался. Неточности в именах полей возможны. describe_method покажет схему, call_raw даст поправить запрос на месте.
Метод не находится по названию
Ищите по теме, а не по имени: спросите агента «что ты умеешь по Яндекс Маркету», он покажет разделы и подберёт метод сам.
То же самое одной фразой
Если разбираться с методами руками не хочется, всё перечисленное выше вызывается из чата обычными словами. Проект и есть MCP-сервер: он отдаёт эти методы ИИ-ассистенту как инструменты, а тот подбирает нужный сам.
Скажите так
покажи заказы на Яндекс Маркете за неделю какой у меня индекс качества и что его роняет собери отчёт по продажам за месяц покажи товары в карантине ценЧто для этого нужно
Ключи из первого раздела и одна строка установки. Нужен только Яндекс Маркет: отдельный пакет yandex-market-mcp-ru, тот же сервер одним маркетплейсом. Нужны все четыре: npx -y marketplaces-mcp-ru или uvx marketplaces-mcp-ru, а в Claude Desktop бандл .mcpb из релизов ставится в один клик.
Частые вопросы
Как получить API-ключ Яндекс Маркета?
partner.market.yandex.ru, раздел Настройки, пункт Доступ к API. Ключ уходит в заголовок Api-Key, хост api.partner.market.yandex.ru.
Почему Partner API возвращает пустой ответ?
Чаще всего перепутаны идентификатор бизнеса и номер кампании. Часть методов адресуется бизнесом, часть кампанией, и подстановка одного вместо другого даёт не ошибку доступа, а корректный пустой ответ.
Сколько методов Яндекс Маркета поддерживает marketplaces-mcp-ru?
165, собранных из официального OpenAPI-документа: заказы, отчёты, поставки, товары, цены, отзывы, чаты и индекс качества. Живой прогон на реальных кабинетах пока не делался, поэтому неточности в именах полей возможны.
Можно поставить только Яндекс Маркет, без остальных маркетплейсов?
Да, для этого есть отдельный пакет yandex-market-mcp-ru: он поднимает один сервер Яндекс Маркет, без остальных площадок. Внутри тот же код и тот же каталог, что в marketplaces-mcp-ru, они приходят зависимостью. Строка установки лежит в его репозитории.
Каталог методов открыт. Берите, форкайте, улучшайте.
Всё это лежит в репозитории под MIT, включая машиночитаемые каталоги, из которых собраны таблицы на этой странице. Нашли неточность в методе, поправьте или заведите issue.