Yandex Market Seller README
The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Yandex Market Seller listing page.
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, по одной переменной на строку, #-комментарии.
Примеры команд
Pydantic-модели
Пакет содержит типизированные Pydantic-модели параметров API. Модели можно использовать в своих Python-программах для валидации данных и автодополнения в IDE.
Установка (библиотеки)
Использование в своих программах
Все модели используют extra="allow" для forward compatibility — неизвестные поля API не вызывают ошибок.
Полный список моделей: models.py
Переменные окружения
| Переменная | Обязательная | По умолчанию | Описание |
|---|---|---|---|
YM_TOKEN | да | — | API-ключ или OAuth-токен |
YM_AUTH_TYPE | нет | api-key | api-key или oauth |
YM_CAMPAIGN_ID | да | — | ID кампании (магазина) |
YM_BUSINESS_ID | да | — | ID бизнеса |
YM_TIMEOUT | нет | 30 | Таймаут HTTP-запросов (секунды) |
YM_FILE_TIMEOUT | нет | 60 | Таймаут файловых операций (секунды) |
Каждый инструмент также принимает campaign_id/business_id как параметр — это позволяет работать с несколькими магазинами в одной сессии.
Разработка
Лицензия
MIT