MCP server for Yandex Market Partner API — orders, offers, prices, stocks, analytics
Quick Install
Automated & IDE SetupCopy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.
Not yet automatically verified
We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.
Manual Client & Custom JSON ConfigExpand JSON ▾
Client Config & Setup
Choose your client or environment
Target File:
💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.
Documentation Overview
mcp-server-yandex-market-seller
MCP-сервер, CLI-утилита и библиотека Pydantic-моделей для Yandex Market Partner API.
- MCP-сервер — интеграция с Claude Code, Claude Desktop и другими MCP-клиентами
- CLI-утилита — работа с API из терминала, скрипты и автоматизация
- Pydantic-модели — типизированные модели API для использования в своих Python-программах
Все данные остаются на вашем компьютере — токен никуда не передаётся.
Оглавление
- Архитектура
- Доступные действия (131)
- MCP-сервер
- CLI-утилита
- Pydantic-модели
- Переменные окружения
- Разработка
- Лицензия
Архитектура
Сервер использует паттерн search + execute — вместо 131 отдельного инструмента предоставляет 3:
| Инструмент | Описание |
|---|---|
ym_search | Поиск действий по описанию на естественном языке |
ym_execute | Выполнение действия по ID |
ym_execute_file | Выполнение действия со скачиванием файла |
Как это работает
Доступные действия (131)
| Домен | Кол-во | Описание |
|---|---|---|
campaigns | 6 | Кампании и настройки бизнеса |
orders | 28 | Заказы: список, детали, статусы, этикетки, документы |
returns | 9 | Возвраты: решения, заявления |
shipments | 14 | Отгрузки: акты, накладные, паллеты |
warehouses | 4 | Склады бизнеса и Яндекс Маркета |
offers | 8 | Товары: offer-mappings, скрытые, штрихкоды |
offer_cards | 3 | Карточки товаров и рекомендации |
prices | 6 | Цены и карантин цен |
stocks | 2 | Остатки товаров |
delivery | 4 | Службы доставки и точки логистики |
feedbacks | 5 | Отзывы покупателей и комментарии |
questions | 3 | Вопросы покупателей |
quality | 2 | Рейтинг качества продавца |
promos | 4 | Акции и промо |
bids | 5 | Ставки (бизнес и кампания) |
outlets | 6 | Точки продаж и лицензии |
geo | 4 | Регионы и страны |
categories | 3 | Категории Маркета и параметры |
tariffs | 1 | Расчёт тарифов и комиссий |
chats | 5 | Чаты с покупателями |
reports | 3 | Асинхронные отчёты |
stats | 2 | Статистика заказов и SKU |
supply | 3 | Заявки на поставку |
operations | 1 | Асинхронные операции |
MCP-сервер
Установка
Шаг 1. Получить API-ключ
- Откройте личный кабинет Яндекс Маркета
- Перейдите в Настройки → API-ключи
- Создайте новый ключ с нужными правами
- Скопируйте API-ключ
Альтернативно можно использовать OAuth-токен.
Шаг 2. Узнать ID кампании и бизнеса
Запишите campaignId и businessId из вывода.
Шаг 3. Подключить MCP-сервер
Подключение к Claude Code
Способ 1: через uvx (не требует установки пакета)
Требуется uv — если не установлен:
Способ 2: через pip
Для удаления:
Подключение к Claude Desktop
Добавьте в конфигурационный файл:
| Клиент | ОС | Путь к файлу |
|---|---|---|
| Claude Code | все | ~/.claude/settings.json (секция mcpServers) |
| Claude Desktop | macOS | ~/Library/Application Support/Claude/claude_desktop_config.json |
| Claude Desktop | Windows | %APPDATA%\Claude\claude_desktop_config.json |
| Claude Desktop | Linux | ~/.config/Claude/claude_desktop_config.json |
Через uvx:
Через pip (после pip install mcp-server-yandex-market-seller):
Подключение через --mcp-config
Подключает сервер только на время одной сессии Claude, не сохраняя в настройки. Токен хранится в отдельном .env.mcp файле, а не в конфиге Claude.
Из JSON-строки:
Из файла:
Пример ~/mcp-servers.json:
Пример ~/.env.mcp:
Шаг 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)
Переменные окружения YM_TOKEN, YM_CAMPAIGN_ID и YM_BUSINESS_ID должны быть установлены:
Или через файл:
Формат файла — KEY=VALUE, по одной переменной на строку, #-комментарии.
Использование (CLI)
Без аргументов запускается MCP-сервер, с командой — CLI. Все команды выводят JSON.
Переменная окружения YM_TOKEN должна быть установлена:
Или через файл:
Формат файла — KEY=VALUE, по одной переменной на строку, #-комментарии.
Примеры команд
Related MCP Servers
Reviews
No reviews yet — be the first to share how this listing worked for you.
Frequently Asked Questions about Yandex Market Seller
AllMCPs Directory Badge
Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.
Badge Style:
Live Dynamic SVG Preview
Markdown (GitHub README)
[](https://allmcps.com/mcp/yandex-market-seller)HTML Embed
<a href="https://allmcps.com/mcp/yandex-market-seller"><img src="https://allmcps.com/api/badge/yandex-market-seller?style=directory" alt="Yandex Market Seller on AllMCPs" /></a>Technical Specs & Signals
CategoryDeveloper Tools
36Quality signal: Fair · 36/100How this signal is calculated ▾
Server availabilityNot measured
Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.
Verified ownership10/20
Documentation & tools16/30
Adoption & activity1/15
Community engagement0/10
A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.
Supply-chain signal
No high-severity advisories surfaced by our automated scan.
Critical 0High 0Medium 0Low 0
Scanned 23h ago via OSV.dev · mcp-server-yandex-market-seller (PyPI)
Own this project?
This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.
Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.
Claim & get free dofollowShare & Embed
Add our SVG badge (dark/light directory styles) or embeddable widget to your site.