MCP для продавцов Яндекс Маркета
mcp-server-yandex-market-seller
MCP-сервер и CLI для Partner API Яндекс Маркета: 131 действие по заказам, ценам, остаткам, отгрузкам и отзывам через паттерн поиска и выполнения
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Может менять цены и остатки товаров на боевом магазине
- Может выполнять действия с заказами, возвратами и отгрузками
- Весь API открыт через универсальный ym_execute, включая изменяющие операции
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/mcp-server-yandex-market-sellerОпределит агенты на машине, проверит риск и зафиксирует версию.
Другие способы установки
У записи высокий риск, поэтому установки в один клик нет. Посмотрите код и добавьте конфиг вручную.
Выполните в терминале
claude mcp add --transport stdio --env 'YM_TOKEN=<ваш YM_TOKEN>' yandex-market-seller -- uvx mcp-server-yandex-market-seller==0.6.0Или добавьте в файл .mcp.json, в проекте
{
"mcpServers": {
"yandex-market-seller": {
"command": "uvx",
"args": [
"mcp-server-yandex-market-seller==0.6.0"
],
"env": {
"YM_TOKEN": "<ваш YM_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
YM_TOKENсекрет, обязательнаяYM_CAMPAIGN_IDнеобязательнаяYM_BUSINESS_IDнеобязательнаяYM_AUTH_TYPEнеобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.cursor/mcp.json, для всех проектов
{
"mcpServers": {
"yandex-market-seller": {
"command": "uvx",
"args": [
"mcp-server-yandex-market-seller==0.6.0"
],
"env": {
"YM_TOKEN": "<ваш YM_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.
Ключи и настройки
YM_TOKENсекрет, обязательнаяYM_CAMPAIGN_IDнеобязательнаяYM_BUSINESS_IDнеобязательнаяYM_AUTH_TYPEнеобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Выполните в терминале
code --add-mcp '{"name":"yandex-market-seller","type":"stdio","command":"uvx","args":["mcp-server-yandex-market-seller==0.6.0"],"env":{"YM_TOKEN":"<ваш YM_TOKEN>"}}'Или добавьте в файл .vscode/mcp.json, в проекте
{
"servers": {
"yandex-market-seller": {
"type": "stdio",
"command": "uvx",
"args": [
"mcp-server-yandex-market-seller==0.6.0"
],
"env": {
"YM_TOKEN": "<ваш YM_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа servers.
Ключи и настройки
YM_TOKENсекрет, обязательнаяYM_CAMPAIGN_IDнеобязательнаяYM_BUSINESS_IDнеобязательнаяYM_AUTH_TYPEнеобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Выполните в терминале
codex mcp add yandex-market-seller --env 'YM_TOKEN=<ваш YM_TOKEN>' -- uvx mcp-server-yandex-market-seller==0.6.0Или добавьте в файл ~/.codex/config.toml, для всех проектов
[mcp_servers.yandex-market-seller]
command = "uvx"
args = ["mcp-server-yandex-market-seller==0.6.0"]
env = { YM_TOKEN = "<ваш YM_TOKEN>" }Если файл уже есть, допишите блок в конец.
Ключи и настройки
YM_TOKENсекрет, обязательнаяYM_CAMPAIGN_IDнеобязательнаяYM_BUSINESS_IDнеобязательнаяYM_AUTH_TYPEнеобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Выполните в терминале
gemini mcp add -s user -e 'YM_TOKEN=<ваш YM_TOKEN>' yandex-market-seller uvx mcp-server-yandex-market-seller==0.6.0Или добавьте в файл ~/.gemini/settings.json, для всех проектов
{
"mcpServers": {
"yandex-market-seller": {
"command": "uvx",
"args": [
"mcp-server-yandex-market-seller==0.6.0"
],
"env": {
"YM_TOKEN": "<ваш YM_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
YM_TOKENсекрет, обязательнаяYM_CAMPAIGN_IDнеобязательнаяYM_BUSINESS_IDнеобязательнаяYM_AUTH_TYPEнеобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов
{
"mcpServers": {
"yandex-market-seller": {
"command": "uvx",
"args": [
"mcp-server-yandex-market-seller==0.6.0"
],
"env": {
"YM_TOKEN": "<ваш YM_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.
Ключи и настройки
YM_TOKENсекрет, обязательнаяYM_CAMPAIGN_IDнеобязательнаяYM_BUSINESS_IDнеобязательнаяYM_AUTH_TYPEнеобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Бывший Windsurf.
Добавьте в файл cline_mcp_settings.json, для всех проектов
{
"mcpServers": {
"yandex-market-seller": {
"command": "uvx",
"args": [
"mcp-server-yandex-market-seller==0.6.0"
],
"env": {
"YM_TOKEN": "<ваш YM_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.
Ключи и настройки
YM_TOKENсекрет, обязательнаяYM_CAMPAIGN_IDнеобязательнаяYM_BUSINESS_IDнеобязательнаяYM_AUTH_TYPEнеобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл .roo/mcp.json, в проекте
{
"mcpServers": {
"yandex-market-seller": {
"command": "uvx",
"args": [
"mcp-server-yandex-market-seller==0.6.0"
],
"env": {
"YM_TOKEN": "<ваш YM_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
YM_TOKENсекрет, обязательнаяYM_CAMPAIGN_IDнеобязательнаяYM_BUSINESS_IDнеобязательнаяYM_AUTH_TYPEнеобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Форк Roo Code, папки .roo те же.
Добавьте в файл opencode.json, в проекте
{
"mcp": {
"yandex-market-seller": {
"type": "local",
"command": [
"uvx",
"mcp-server-yandex-market-seller==0.6.0"
],
"environment": {
"YM_TOKEN": "<ваш YM_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcp.
Ключи и настройки
YM_TOKENсекрет, обязательнаяYM_CAMPAIGN_IDнеобязательнаяYM_BUSINESS_IDнеобязательнаяYM_AUTH_TYPEнеобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.config/zed/settings.json, для всех проектов
{
"context_servers": {
"yandex-market-seller": {
"command": "uvx",
"args": [
"mcp-server-yandex-market-seller==0.6.0"
],
"env": {
"YM_TOKEN": "<ваш YM_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа context_servers.
Ключи и настройки
YM_TOKENсекрет, обязательнаяYM_CAMPAIGN_IDнеобязательнаяYM_BUSINESS_IDнеобязательнаяYM_AUTH_TYPEнеобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл .codeassistant/mcp.json, в проекте
{
"mcpServers": {
"yandex-market-seller": {
"command": "uvx",
"args": [
"mcp-server-yandex-market-seller==0.6.0"
],
"env": {
"YM_TOKEN": "<ваш YM_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
YM_TOKENсекрет, обязательнаяYM_CAMPAIGN_IDнеобязательнаяYM_BUSINESS_IDнеобязательнаяYM_AUTH_TYPEнеобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Получи API-ключ в личном кабинете партнера Яндекс Маркета в разделе Настройки, API-ключи, узнай campaignId и businessId командой mcp-server-yandex-market-seller campaigns, затем добавь сервер командой claude mcp add yandex-market-seller -e YM_TOKEN=ключ -e YM_CAMPAIGN_ID=id -e YM_BUSINESS_ID=id -- uvx mcp-server-yandex-market-seller.
Другие способы из описания автора
claude mcp add yandex-market-seller \
-e YM_TOKEN=ваш_api_ключ \
-e YM_CAMPAIGN_ID=12345 \
-e YM_BUSINESS_ID=67890 \
-- uvx mcp-server-yandex-market-sellerСпособ через uvx, не требует установки пакета.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер, CLI-утилита и библиотека Pydantic-моделей поверх Partner API Яндекс Маркета покрывают 131 действие в 23 доменах: заказы и их документы, возвраты, отгрузки, склады, товары и их карточки, цены, остатки, доставка, отзывы и вопросы покупателей, рейтинг качества, акции, ставки, точки продаж, регионы, категории, тарифы, чаты с покупателями, отчеты, статистика и заявки на поставку. Вместо 131 отдельного MCP-инструмента сервер дает три: ym_search находит нужное действие по описанию на естественном языке, ym_execute выполняет его по ID, а ym_execute_file выполняет действие со скачиванием файла, например этикеток заказа. Все запросы идут напрямую в API с локального компьютера, токен никуда, кроме Яндекс Маркета, не передается.
Для кого. Для продавцов на Яндекс Маркете, которые хотят вести заказы, цены и остатки через агента вместо личного кабинета.
Подходит, если
- Нужно быстро найти нужное действие среди 131 без запоминания точных названий инструментов
- Нужно скачать этикетки, акты или другие документы по заказу прямо в диалоге с агентом
- Нужен CLI для автоматизации и скриптов без запуска MCP-клиента
Не подходит, если
- Нужен отдельный ограниченный набор инструментов вместо паттерна поиска и выполнения: здесь вся поверхность API открыта через ym_search и ym_execute
- Нет API-ключа или OAuth-токена продавца Яндекс Маркета
Пример запроса к агенту
Скачай этикетки для заказа 12345 и покажи его текущий статусОграничения
Лицензия в репозитории не указана явно. Нужен API-ключ или OAuth-токен продавца, а также ID кампании и бизнеса, которые нужно узнать отдельной командой campaigns после установки. Паттерн поиска действий по естественному языку зависит от качества описаний, специфичные операции стоит проверять по документации в docs перед выполнением на боевом магазине.
Как отключить. Удалите сервер командой claude mcp remove yandex-market-seller и отзовите API-ключ в личном кабинете Яндекс Маркета в разделе Настройки, API-ключи.
MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| YM_TOKEN обязательная, секрет | API-ключ или OAuth-токен продавца Яндекс Маркета |
| YM_CAMPAIGN_ID обязательная | ID кампании продавца, узнается командой campaigns |
| YM_BUSINESS_ID обязательная | ID бизнеса продавца, узнается командой campaigns |
Проверка безопасности
- Может менять цены и остатки товаров на боевом магазине
- Может выполнять действия с заказами, возвратами и отгрузками
- Весь API открыт через универсальный ym_execute, включая изменяющие операции
Коротко о README
README на русском описывает сервер как MCP, CLI-утилиту и библиотеку Pydantic-моделей поверх Partner API Яндекс Маркета. Объясняется архитектура поиска и выполнения вместо 131 отдельного инструмента, дана таблица из 23 доменов действий со ссылками на подробную документацию по каждому. Показаны шаги получения API-ключа, узнавания campaignId и businessId, подключение к Claude Code и Claude Desktop через uvx или pip, а также временное подключение через --mcp-config без сохранения в настройках. Отдельно перечислены переменные окружения и раздел разработки с тестами.
Частые вопросы
Почему инструментов всего три, а не 131?
Сервер использует паттерн поиска и выполнения: ym_search находит нужное действие по описанию, ym_execute и ym_execute_file его выполняют, что удобнее для LLM, чем сотня отдельных инструментов.
Куда уходит токен продавца?
Только в API Яндекс Маркета, все запросы выполняются напрямую с компьютера пользователя без стороннего сервера.
Похожие
Официальный MCP-сервер Salesforce DX: работа с org, метаданными, данными, пользователями и тестами Apex из агента
Официальный набор скиллов Яндекса: каталог, цены, остатки, заказы, витрина и еженедельная ревизия магазина на Яндекс.Кит через Claude Code или Codex
YouGile MCP от Indalo
YouGile MCP
Полное покрытие API YouGile из 65 операций с настраиваемыми правами, подтверждением записи и общим лимитом на компанию
Официальный MCP конкретного портала Битрикс24: внешний агент по OAuth или токену читает и меняет задачи, сделки, встречи и письма