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. 01API操作の検索と実行
  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_executeID を指定してアクションを実行
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 サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。