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 分

    請在儲存庫或註冊中心條目中宣告授權條款。