Яндекс Маркет MCP (RU)

io.github.ilyautovPublished by GitHub account ilyautovv0.6.0Updated Oct 24, 2026

API Яндекс Маркета в ИИ-ассистенте: заказы, товары, цены, отчёты, отзывы

VerifiedSTDIODesktop onlyData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

Local MCP server exposing the Yandex Market Partner API so an assistant can work with orders, products, prices, reports, reviews and chats.

What you can do
Read and manage orders, returns and unclaimed items, including write operations on orders and shipments, supplies and warehouses, plus pickup points and delivery regions. Look up products and cards, prices, tariffs and price quarantine, and run promotion and advertising methods. Pull reports and cabinet/service data, and read or answer reviews, questions and chats. Inspect method schemas and send raw requests to adjust calls on the spot.
When to use it
Use it when you sell on Yandex Market and want an assistant to answer questions about orders, quality index, sales reports or quarantined products, and to perform partner-API operations from chat for a single marketplace.
Requirements
Runs locally as a stdio process, installed with uvx from PyPI (Python). Needs a Yandex Market partner account API key supplied as the YANDEX_MARKET_API_KEY environment variable; keys can alternatively be stored in a local cabinets file. Network access to the Yandex Market partner API host is required.
Before you install
The API key is a secret granting access to your partner cabinet; keep it out of shared configs. The catalog includes 49 write methods and 7 irreversible ones across orders, products, prices, reviews and advertising, so assistant actions can change or delete marketplace data. Business ID and campaign number are distinct and mixing them returns empty results rather than an error. Field names come from the OpenAPI document and have not been verified against live cabinets.

Installation

In SourceWeft

  1. Open Яндекс Маркет MCP (RU) in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

yandex-market-mcp-ru

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

[PyPI] [CI] [License: MIT] [Методов] [Сайт] [Звёзды]

[yandex-market-mcp-ru: API Яндекс Маркета в ИИ-ассистенте. 165 методов]

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

Установка

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

bash
uvx yandex-market-mcp-ru

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

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

Claude Desktop, claude_desktop_config.json:

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

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

bash
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 необратимых. Сервер исполняет ровно этот файл, поэтому таблица не может разойтись с кодом.

темаметодовчтениезаписьнеобратимые
Заказы, возвраты и невыкупы3819190
Отчёты272700
Товары и карточки221183
Отгрузки, поставки и склады211560
Отзывы, вопросы и чаты181161
Самовывоз и регионы доставки151032
Цены, тарифы и карантин10640
Продвижение и реклама8431
Кабинет и служебное6600

Подробный разбор с параметрами и лимитами: 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.

Source: README.md at commit f98759d

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.6.0LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts