Yandex Market Seller

io.github.dontsovcmcPublished by GitHub account dontsovcmcv0.6.0Updated Oct 25, 2026

MCP server for Yandex Market Partner API — orders, offers, prices, stocks, analytics

VerifiedSTDIODesktop onlyData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

Local MCP server for the Yandex Market Partner API that lets an assistant search and run seller actions on orders, offers, prices, stocks, returns and analytics

What you can do
Search a catalog of 131 Yandex Market seller actions by natural-language description and run the chosen one by ID, with an optional file-download variant for labels and documents. Work with orders, returns, shipments, warehouses and supply requests. Manage offers, product cards, prices, price quarantine and stocks. Read buyer feedback, questions and chats, and send chat messages. Pull quality ratings, order and SKU statistics, reports, promos, bids, outlets, regions and categories.
When to use it
Useful when a seller or marketplace operator wants an assistant to inspect and act on their Yandex Market storefront from Claude Code or Claude Desktop, for example listing orders, downloading labels, updating stocks or checking reviews.
Requirements
Runs locally as a Python package via uvx or pip, so Python and uv (for uvx) are needed. Requires a Yandex Market API key or OAuth token in YM_TOKEN, plus YM_CAMPAIGN_ID and YM_BUSINESS_ID; YM_AUTH_TYPE selects api-key or oauth. Network access to the Yandex Market Partner API is required.
Before you install
YM_TOKEN is a live seller credential granting access to the store's data and operations; keep it out of shared configs. Many actions change data, such as order status updates, stock updates, price changes, bids and sending chat messages to buyers, and the assistant can trigger them. Requests go to the Yandex Market Partner API.

Installation

In SourceWeft

  1. Open Yandex Market Seller 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

mcp-server-yandex-market-seller

[Version]

MCP-сервер, CLI-утилита и библиотека Pydantic-моделей для Yandex Market Partner API.

  • MCP-сервер — интеграция с Claude Code, Claude Desktop и другими MCP-клиентами
  • CLI-утилита — работа с API из терминала, скрипты и автоматизация
  • Pydantic-модели — типизированные модели API для использования в своих Python-программах

Все данные остаются на вашем компьютере — токен никуда не передаётся.

Оглавление

Архитектура

Сервер использует паттерн search + execute — вместо 131 отдельного инструмента предоставляет 3:

ИнструментОписание
ym_searchПоиск действий по описанию на естественном языке
ym_executeВыполнение действия по ID
ym_execute_fileВыполнение действия со скачиванием файла

Как это работает

LLM: ym_search("скачать этикетки заказа")→ [{"id": "order_labels", "params_schema": {"order_id": "int"}, ...}]
LLM: ym_execute_file("order_labels", "/tmp/labels.pdf", '{"order_id": 12345}')→ {"path": "/tmp/labels.pdf", "size": 48392}

Доступные действия (131)

ДоменКол-воОписание
campaigns6Кампании и настройки бизнеса
orders28Заказы: список, детали, статусы, этикетки, документы
returns9Возвраты: решения, заявления
shipments14Отгрузки: акты, накладные, паллеты
warehouses4Склады бизнеса и Яндекс Маркета
offers8Товары: offer-mappings, скрытые, штрихкоды
offer_cards3Карточки товаров и рекомендации
prices6Цены и карантин цен
stocks2Остатки товаров
delivery4Службы доставки и точки логистики
feedbacks5Отзывы покупателей и комментарии
questions3Вопросы покупателей
quality2Рейтинг качества продавца
promos4Акции и промо
bids5Ставки (бизнес и кампания)
outlets6Точки продаж и лицензии
geo4Регионы и страны
categories3Категории Маркета и параметры
tariffs1Расчёт тарифов и комиссий
chats5Чаты с покупателями
reports3Асинхронные отчёты
stats2Статистика заказов и SKU
supply3Заявки на поставку
operations1Асинхронные операции

MCP-сервер

Установка

Шаг 1. Получить API-ключ
  1. Откройте личный кабинет Яндекс Маркета
  2. Перейдите в Настройки → API-ключи
  3. Создайте новый ключ с нужными правами
  4. Скопируйте API-ключ

Альтернативно можно использовать OAuth-токен.

Шаг 2. Узнать ID кампании и бизнеса
bash
# После установки и настройки токена:mcp-server-yandex-market-seller campaigns

Запишите campaignId и businessId из вывода.

Шаг 3. Подключить MCP-сервер

Подключение к Claude Code

Способ 1: через uvx (не требует установки пакета)

Требуется uv — если не установлен:

bash
curl -LsSf https://astral.sh/uv/install.sh | sh
bash
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

Способ 2: через pip

bash
pip install 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 \  -- python -m mcp_server_yandex_market_seller

Для удаления:

bash
claude mcp remove yandex-market-seller

Подключение к Claude Desktop

Добавьте в конфигурационный файл:

КлиентОСПуть к файлу
Claude Codeвсе~/.claude/settings.json (секция mcpServers)
Claude DesktopmacOS~/Library/Application Support/Claude/claude_desktop_config.json
Claude DesktopWindows%APPDATA%\Claude\claude_desktop_config.json
Claude DesktopLinux~/.config/Claude/claude_desktop_config.json

Через uvx:

json
{  "mcpServers": {    "yandex-market-seller": {      "command": "uvx",      "args": ["mcp-server-yandex-market-seller"],      "env": {        "YM_TOKEN": "ваш_api_ключ",        "YM_CAMPAIGN_ID": "12345",        "YM_BUSINESS_ID": "67890"      }    }  }}

Через pip (после pip install mcp-server-yandex-market-seller):

json
{  "mcpServers": {    "yandex-market-seller": {      "command": "python",      "args": ["-m", "mcp_server_yandex_market_seller"],      "env": {        "YM_TOKEN": "ваш_api_ключ",        "YM_CAMPAIGN_ID": "12345",        "YM_BUSINESS_ID": "67890"      }    }  }}

Подключение через --mcp-config

Подключает сервер только на время одной сессии Claude, не сохраняя в настройки. Токен хранится в отдельном .env.mcp файле, а не в конфиге Claude.

Из JSON-строки:

bash
claude --mcp-config '{"yandex-market-seller":{"command":"bash","args":["-c","source ~/.env.mcp && exec uvx mcp-server-yandex-market-seller"]}}'

Из файла:

bash
claude --mcp-config ~/mcp-servers.json

Пример ~/mcp-servers.json:

json
{  "yandex-market-seller": {    "command": "bash",    "args": ["-c", "source ~/.env.mcp && exec uvx mcp-server-yandex-market-seller"]  }}

Пример ~/.env.mcp:

YM_TOKEN=ваш_api_ключYM_CAMPAIGN_ID=12345YM_BUSINESS_ID=67890
Шаг 4. Проверить

Попросите Claude: «покажи мои заказы на Маркете» — он вызовет ym_search, затем ym_execute.

Примеры (MCP)

  • «покажи мои заказы» → ym_search("list orders") → ym_execute("orders")
  • «отправь заказ 12345» → ym_execute("order_status", '{"order_id": 12345, "status": "DELIVERY"}')
  • «скачай этикетки для заказа 12345» → ym_execute_file("order_labels", "/tmp/labels.pdf", '{"order_id": 12345}')
  • «какие цены на SKU1?» → ym_execute("prices", '{"offer_ids": ["SKU1"]}')
  • «обнови остатки SKU1 до 50 шт.» → ym_execute("stocks_update", '{"skus": [{"shopSku": "SKU1", "warehouseId": 111, "items": [{"count": 50, "type": "FIT"}]}]}')
  • «покажи возвраты» → ym_execute("returns")
  • «покажи отзывы» → ym_execute("feedbacks")
  • «сгенерируй отчёт united-netting» → ym_execute("report_generate", '{"report_type": "united-netting"}')

CLI-утилита

Установка (CLI)

bash
pip install mcp-server-yandex-market-seller

Переменные окружения YM_TOKEN, YM_CAMPAIGN_ID и YM_BUSINESS_ID должны быть установлены:

bash
export YM_TOKEN=ваш_api_ключexport YM_CAMPAIGN_ID=12345export YM_BUSINESS_ID=67890

Или через файл:

bash
mcp-server-yandex-market-seller --env /path/to/.env <command>

Формат файла — KEY=VALUE, по одной переменной на строку, #-комментарии.

Использование (CLI)

Без аргументов запускается MCP-сервер, с командой — CLI. Все команды выводят JSON.

Переменная окружения YM_TOKEN должна быть установлена:

bash
export YM_TOKEN=ваш_api_ключexport YM_CAMPAIGN_ID=12345export YM_BUSINESS_ID=67890

Или через файл:

bash
mcp-server-yandex-market-seller --env /path/to/.env <command>

Формат файла — KEY=VALUE, по одной переменной на строку, #-комментарии.

bash
# Версияmcp-server-yandex-market-seller --version
# Справкаmcp-server-yandex-market-seller --helpmcp-server-yandex-market-seller <command> --help

Примеры команд

bash
# Кампанииmcp-server-yandex-market-seller campaignsmcp-server-yandex-market-seller campaignmcp-server-yandex-market-seller campaign-settingsmcp-server-yandex-market-seller business-settings
# Заказыmcp-server-yandex-market-seller ordersmcp-server-yandex-market-seller orders --status PROCESSINGmcp-server-yandex-market-seller order 12345mcp-server-yandex-market-seller order-status 12345 DELIVERYmcp-server-yandex-market-seller order-labels 12345 labels.pdfmcp-server-yandex-market-seller order-items 12345mcp-server-yandex-market-seller order-buyer 12345mcp-server-yandex-market-seller order-tracking 12345mcp-server-yandex-market-seller order-documents 12345mcp-server-yandex-market-seller order-stats --date-from 2026-04-01
# Возвратыmcp-server-yandex-market-seller returnsmcp-server-yandex-market-seller return 12345 67890
# Отгрузкиmcp-server-yandex-market-seller shipmentsmcp-server-yandex-market-seller shipment 12345mcp-server-yandex-market-seller shipment-orders 12345mcp-server-yandex-market-seller shipment-act 12345 act.pdf
# Товарыmcp-server-yandex-market-seller offersmcp-server-yandex-market-seller offers --offer-ids SKU1,SKU2mcp-server-yandex-market-seller offer-cardsmcp-server-yandex-market-seller campaign-offersmcp-server-yandex-market-seller hidden-offers
# Цены и остаткиmcp-server-yandex-market-seller pricesmcp-server-yandex-market-seller prices --offer-ids SKU1mcp-server-yandex-market-seller price-quarantinemcp-server-yandex-market-seller stocks
# Акции и ставкиmcp-server-yandex-market-seller promosmcp-server-yandex-market-seller promo-offers cf_137460mcp-server-yandex-market-seller bidsmcp-server-yandex-market-seller bid-recommendations
# Склады и доставкаmcp-server-yandex-market-seller warehousesmcp-server-yandex-market-seller all-warehousesmcp-server-yandex-market-seller logistics-pointsmcp-server-yandex-market-seller delivery-services
# Покупателиmcp-server-yandex-market-seller feedbacksmcp-server-yandex-market-seller feedback-comments 12345mcp-server-yandex-market-seller questionsmcp-server-yandex-market-seller chatsmcp-server-yandex-market-seller chat-history 12345mcp-server-yandex-market-seller chat-send 12345 "Ваш заказ отправлен"
# Точки продажmcp-server-yandex-market-seller outletsmcp-server-yandex-market-seller outlet 12345
# Аналитикаmcp-server-yandex-market-seller qualitymcp-server-yandex-market-seller quality-detailsmcp-server-yandex-market-seller sku-statsmcp-server-yandex-market-seller report-status abc123
# Справочникиmcp-server-yandex-market-seller regions Москваmcp-server-yandex-market-seller region 213mcp-server-yandex-market-seller countriesmcp-server-yandex-market-seller categoriesmcp-server-yandex-market-seller category-params 12345
# Поставкиmcp-server-yandex-market-seller supply-requestsmcp-server-yandex-market-seller operations

Pydantic-модели

Пакет содержит типизированные Pydantic-модели параметров API. Модели можно использовать в своих Python-программах для валидации данных и автодополнения в IDE.

Установка (библиотеки)

bash
pip install mcp-server-yandex-market-seller

Использование в своих программах

python
from mcp_server_yandex_market_seller.models import OrdersListParams
# Валидация данныхparams = OrdersListParams.model_validate({    "status": "PROCESSING",    "page": 1,    "page_size": 50,})print(params.model_dump_json())
# Создание объектаparams = OrdersListParams(status="DELIVERY", page_size=100)print(params.status)  # type-safe доступ к полям

Все модели используют extra="allow" для forward compatibility — неизвестные поля API не вызывают ошибок.

Полный список моделей: models.py

Переменные окружения

ПеременнаяОбязательнаяПо умолчаниюОписание
YM_TOKENда—API-ключ или OAuth-токен
YM_AUTH_TYPEнетapi-keyapi-key или oauth
YM_CAMPAIGN_IDда—ID кампании (магазина)
YM_BUSINESS_IDда—ID бизнеса
YM_TIMEOUTнет30Таймаут HTTP-запросов (секунды)
YM_FILE_TIMEOUTнет60Таймаут файловых операций (секунды)

Каждый инструмент также принимает campaign_id/business_id как параметр — это позволяет работать с несколькими магазинами в одной сессии.

Разработка

bash
pip install -e ".[test]"ruff check src/ tests/pytest tests/ -v

Лицензия

MIT

Source: README.md at commit c1c0398

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

40% 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

    Declare a license in the repository or the registry entry.