Yandex Market Seller

io.github.dontsovcmc由 GitHub 账号 dontsovcmc 发布v0.6.0更新于 Oct 25, 2026

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

已验证STDIO仅桌面数据与分析商业与电商

概览

AI 生成的概览

面向 Yandex Market 合作伙伴 API 的本地 MCP 服务器，让助手检索并执行订单、商品、价格、库存、退货和分析等卖家操作

可以做什么
按自然语言描述检索 131 个 Yandex Market 卖家操作，并按 ID 执行，另有可下载文件的变体用于标签和单据。处理订单、退货、发货、仓库和供货申请。管理商品、商品卡、价格、价格隔离和库存。读取买家评价、提问和聊天，并可发送聊天消息。获取质量评分、订单与 SKU 统计、报告、促销、出价、销售点、地区和类目。
适用场景
适合卖家或平台运营者希望助手在 Claude Code 或 Claude Desktop 中查看并操作其 Yandex Market 店铺，例如列出订单、下载标签、更新库存或查看评价。
运行要求
以 Python 包形式本地运行，可通过 uvx 或 pip 安装，需要 Python，使用 uvx 时还需 uv。需要 Yandex Market API 密钥或 OAuth 令牌，放在 YM_TOKEN 中，并提供 YM_CAMPAIGN_ID 和 YM_BUSINESS_ID；YM_AUTH_TYPE 选择 api-key 或 oauth。需要访问 Yandex Market 合作伙伴 API 的网络。
安装前请注意
YM_TOKEN 是可访问店铺数据与操作的真实卖家凭证，不要写入共享配置。许多操作会修改数据，例如更新订单状态、更新库存、改价、出价以及向买家发送聊天消息，助手可以触发这些操作。请求会发送至 Yandex Market 合作伙伴 API。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Yandex Market Seller，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

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

来源：README.md，提交 c1c0398

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.6.0最新Sep 16, 2026

评分

已满足适用检查项的 40%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

    请在仓库或注册中心条目中声明许可证。