mcpField
Y
yandex-market-seller

yandex-market-seller

本地服务
github.com/dontsovcmc商业与营销125 周前更新
代码仓库

关于 yandex-market-seller

yandex-market-seller 为 Yandex Market Partner API 提供 MCP 服务、CLI 和 Pydantic 模型，面向管理 Market 商店的开发者与卖家。它通过搜索动作再执行的方式覆盖订单、商品、库存和分析等操作，也支持下载文件。

主要功能

  1. 01搜索并执行 API 动作
  2. 02管理订单、退货和发货
  3. 03处理商品、价格与库存
  4. 04执行报告和统计操作
  5. 05支持文件下载及类型化 Pydantic 模型

适用场景

  1. 01查询订单并更新订单状态
  2. 02下载订单标签或文件
  3. 03调整商品价格和库存
  4. 04查看退货、评价或销售统计

MCP 相关

MCP 服务使用 `ym_search` 查找动作，再由 `ym_execute` 执行；`ym_execute_file` 可执行动作并下载文件，连接 Yandex Market Partner API。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "dontsovcmc-yandex-market-seller": {
      "command": "uvx",
      "args": [
        "mcp-server-yandex-market-seller"
      ],
      "env": {
        "YM_TOKEN": "<YM_TOKEN>",
        "YM_CAMPAIGN_ID": "<YM_CAMPAIGN_ID>",
        "YM_BUSINESS_ID": "<YM_BUSINESS_ID>",
        "YM_AUTH_TYPE": "<YM_AUTH_TYPE>"
      }
    }
  }
}
启动命令uvx mcp-server-yandex-market-seller
需要配置的环境变量
YM_TOKEN密钥
YM_CAMPAIGN_ID
YM_BUSINESS_ID
YM_AUTH_TYPE密钥

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
pypimcp-server-yandex-market-seller0.6.0

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

mcp-server-yandex-market-seller

Version

用于 Yandex Market Partner API 的 MCP 服务、CLI 工具和 Pydantic 模型库。

  • MCP 服务 — 与 Claude Code、Claude Desktop 和其他 MCP 客户端集成
  • CLI 工具 — 在终端中使用 API、编写脚本和实现自动化
  • Pydantic 模型 — 可在自己的 Python 程序中使用的类型化 API 模型

所有数据都保留在您的计算机上，令牌不会传输到任何地方。

目录

架构

服务采用 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业务仓库和 Yandex Market 仓库
offers8商品：offer-mappings、已隐藏商品、条形码
offer_cards3商品卡片和推荐
prices6价格和价格隔离
stocks2商品库存
delivery4配送服务和物流点
feedbacks5买家评价和评论
questions3买家问题
quality2卖家质量评分
promos4促销和推广
bids5出价（业务和活动）
outlets6销售网点和许可证
geo4地区和国家
categories3Market 类目和参数
tariffs1费率和佣金计算
chats5与买家的聊天
reports3异步报告
stats2订单和 SKU 统计
supply3供货申请
operations1异步操作

MCP 服务

安装
第 1 步：获取 API 密钥
  1. 打开 Yandex Market 个人账户
  2. 前往 设置 → API 密钥
  3. 创建具有所需权限的新密钥
  4. 复制 API 密钥

也可以使用 OAuth 令牌。

第 2 步：查找活动 ID 和业务 ID
# После установки и настройки токена:
mcp-server-yandex-market-seller campaigns

记下输出中的 campaignId 和 businessId。

第 3 步：连接 MCP 服务
Подключение к Claude Code

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

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

curl -LsSf https://astral.sh/uv/install.sh | sh

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

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

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

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:

{
  "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):

{
  "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-строки:

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

Из файла:

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

Пример ~/mcp-servers.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=12345
YM_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)
pip install mcp-server-yandex-market-seller

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

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

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

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

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

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

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

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

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

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

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

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

# Версия
mcp-server-yandex-market-seller --version

# Справка
mcp-server-yandex-market-seller --help
mcp-server-yandex-market-seller <command> --help
Примеры команд
# Кампании
mcp-server-yandex-market-seller campaigns
mcp-server-yandex-market-seller campaign
mcp-server-yandex-market-seller campaign-settings
mcp-server-yandex-market-seller business-settings

# Заказы
mcp-server-yandex-market-seller orders
mcp-server-yandex-market-seller orders --status PROCESSING
mcp-server-yandex-market-seller order 12345
mcp-server-yandex-market-seller order-status 12345 DELIVERY
mcp-server-yandex-market-seller order-labels 12345 labels.pdf
mcp-server-yandex-market-seller order-items 12345
mcp-server-yandex-market-seller order-buyer 12345
mcp-server-yandex-market-seller order-tracking 12345
mcp-server-yandex-market-seller order-documents 12345
mcp-server-yandex-market-seller order-stats --date-from 2026-04-01

# Возвраты
mcp-server-yandex-market-seller returns
mcp-server-yandex-market-seller return 12345 67890

# Отгрузки
mcp-server-yandex-market-seller shipments
mcp-server-yandex-market-seller shipment 12345
mcp-server-yandex-market-seller shipment-orders 12345
mcp-server-yandex-market-seller shipment-act 12345 act.pdf

# Товары
mcp-server-yandex-market-seller offers
mcp-server-yandex-market-seller offers --offer-ids SKU1,SKU2
mcp-server-yandex-market-seller offer-cards
mcp-server-yandex-market-seller campaign-offers
mcp-server-yandex-market-seller hidden-offers

# Цены и остатки
mcp-server-yandex-market-seller prices
mcp-server-yandex-market-seller prices --offer-ids SKU1
mcp-server-yandex-market-seller price-quarantine
mcp-server-yandex-market-seller stocks

# Акции и ставки
mcp-server-yandex-market-seller promos
mcp-server-yandex-market-seller promo-offers cf_137460
mcp-server-yandex-market-seller bids
mcp-server-yandex-market-seller bid-recommendations

# Склады и доставка
mcp-server-yandex-market-seller warehouses
mcp-server-yandex-market-seller all-warehouses
mcp-server-yandex-market-seller logistics-points
mcp-server-yandex-market-seller delivery-services

# Покупатели
mcp-server-yandex-market-seller feedbacks
mcp-server-yandex-market-seller feedback-comments 12345
mcp-server-yandex-market-seller questions
mcp-server-yandex-market-seller chats
mcp-server-yandex-market-seller chat-history 12345
mcp-server-yandex-market-seller chat-send 12345 "Ваш заказ отправлен"

# Точки продаж
mcp-server-yandex-market-seller outlets
mcp-server-yandex-market-seller outlet 12345

# Аналитика
mcp-server-yandex-market-seller quality
mcp-server-yandex-market-seller quality-details
mcp-server-yandex-market-seller sku-stats
mcp-server-yandex-market-seller report-status abc123

# Справочники
mcp-server-yandex-market-seller regions Москва
mcp-server-yandex-market-seller region 213
mcp-server-yandex-market-seller countries
mcp-server-yandex-market-seller categories
mcp-server-yandex-market-seller category-params 12345

# Поставки
mcp-server-yandex-market-seller supply-requests
mcp-server-yandex-market-seller operations

Pydantic-модели

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

Установка (библиотеки)
pip install mcp-server-yandex-market-seller
Использование в своих программах
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 как параметр — это позволяет работать с несколькими магазинами в одной сессии.

Разработка

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

Лицензия

MIT

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。