ozon-seller-mcp: все 482 метода Ozon Seller API для агента

ozon-seller-mcp

MCP-сервер на Node.js покрывает все методы Ozon Seller API с проверкой по схеме, шестью составными запросами и режимом только чтения

  • 0 ★ репозитория
  • Последний коммит
MCP-сервер

Расширенный доступ

Почему такой уровень

  • Ключ продавца Ozon дает доступ к товарам, остаткам, заказам и финансам магазина, а при OZON_READ_ONLY=false и к их изменению
  • Для больших магазинов составные запросы упираются в лимиты Ozon и идут долго
Все причины и проверки
Российский стек

mrsxs/ozon-seller-mcp

Установка

Сервисы

В терминале, через SkillFoxx CLI

npx skillfoxx add mcp/mrsxs-ozon-seller-mcp

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • Ключ продавца Ozon дает доступ к товарам, остаткам, заказам и финансам магазина, а при OZON_READ_ONLY=false и к их изменению
  • Для больших магазинов составные запросы упираются в лимиты Ozon и идут долго

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Сервер запускается через `npx` и работает по stdio. Он покрывает 482 метода из официальной русскоязычной спецификации OpenAPI и проверяет параметры по схеме до отправки. По умолчанию открыты 25 инструментов, а набор `OZON_TOOLSET` расширяют до всех методов. Шесть составных инструментов отвечают на частые вопросы одним вызовом: рейтинг товаров по продажам и выручке, список и карточка товара, остатки, заказы и обзор продаж. По умолчанию сервер работает только на чтение: запись включает `OZON_READ_ONLY=false`, опечатка в значении останавливает запуск. Из результатов убираются поля `customer`, `addressee`, `address`, `phone`, `email` и `legal_info`. Лимиты Ozon попадают в описания инструментов и в результат, повторные чтения кэшируются на пять минут. Скилл `ozon-seller-assistant` оформляет ответы в таблицы и офлайн-отчеты HTML.

Для кого. Селлерам Ozon и аналитикам маркетплейса, которые хотят задавать вопросы по товарам, остаткам и заказам магазина обычным языком.

Подходит, если

  • Нужен рейтинг товаров магазина по продажам и выручке с ценами, остатками и характеристиками
  • Остатки всего магазина сводят в список позиций с нулевым и низким запасом
  • Заказы FBS и FBO группируют по статусам и причинам отмены за период
  • Ответ нужен офлайн-отчетом HTML с поиском, сортировкой и экспортом в CSV

Не подходит, если

  • Нужна покупательская часть Ozon без кабинета продавца: сервер работает только с Seller API
  • Требуется Python-сервер: здесь Node.js 20.18 и новее
  • Нужны данные клиентов вроде адреса и телефона: сервер вырезает такие поля из результатов

Пример запроса к агенту

Покажи топ-20 товаров магазина по выручке за месяц с остатками и сделай офлайн-отчет

MCP

Транспорт
stdio
Авторизация
API-ключ

Переменные окружения

OZON_CLIENT_ID обязательная
Client ID продавца Ozon
OZON_API_KEY обязательная, секрет
API-ключ продавца Ozon
OZON_READ_ONLY
Режим только чтения, по умолчанию true
OZON_TOOLSET
Набор инструментов: core, minimal или all

Ограничения

Нужны Node.js 20.18 и новее, Client ID и API Key продавца Ozon, для группы Ozon Delivery отдельный `OZON_ACCESS_TOKEN`. Документация и сообщения об ошибках в основном на китайском. Лимиты Ozon жесткие: аналитика продаж допускает 1 запрос в минуту и 50 в сутки. Составные запросы на больших магазинах идут до 11 секунд. Лицензия в репозитории не указана. Один автор, версия 2.1.0, последний коммит в октябре 2026 года, звезд нет.

Как отключить. Уберите запись `ozon-seller` из настроек MCP-клиента и создайте новый API-ключ в кабинете Ozon, чтобы отозвать старый.

Частые вопросы

Как включить запись в магазине?

Задайте `OZON_READ_ONLY=false`. Любое другое значение, кроме `true` и `false`, останавливает запуск, чтобы опечатка не открыла запись.

Сколько инструментов видит агент?

По умолчанию 25: составные, общие и самые частые методы. Значения `minimal` и `all` у `OZON_TOOLSET` сужают набор или открывают все 482 метода.

Какие данные вырезаются из ответов?

Поля `customer`, `addressee`, `address`, `phone`, `email` и `legal_info`, в том числе адреса складов и телефоны. Ключ API в результатах и ошибках не показывается.

Что с лимитами Ozon?

Лимиты указаны в описании инструментов и в поле `rate_limit` результата. Повторное чтение в пределах пяти минут берется из кэша, запись сервер не повторяет.

Как проверить, что сервер работает?

Вызовите инструмент `ozon_status`: он показывает режим, набор инструментов, версию Node и наличие ключей без вывода самих значений.

Обсуждение

Вопросов и отзывов пока нет.

Ozon MCP

ozon-mcp

Российский стек

MCP-сервер для Ozon Seller API и Performance API: поиск методов, вызовы с защитой от случайной записи и готовые сценарии аналитики

MCP-серверШирокий доступ26Звезды репозитория
Российский стек

MCP-сервер для Ozon Seller API с каталогом из 441 метода, классами доступа на чтение и запись и хранением ключей вне репозитория

MCP-серверШирокий доступ3Звезды репозитория
Российский стек

MCP-сервер для Ozon Seller API: товары, цены, остатки, заказы FBO и FBS, аналитика и финансы продавца

MCP-серверШирокий доступ7Звезды репозитория
Российский стек

MCP-сервер для Ozon Seller API и Performance API: цены, акции, реклама, заказы, возвраты и финансы для нескольких магазинов

MCP-серверШирокий доступ11Звезды репозитория
Российский стек

MCP-сервер с 9 инструментами только для чтения по Ozon Seller API v3: товары, заказы FBS и FBO, аналитика, финансы и возвраты

MCP-серверРасширенный доступ
Российский стек

Go MCP-сервер для Ozon Seller API на 68 инструментов: каталог, цены, остатки, акции, аналитика, финансы, FBS и FBO, по умолчанию только чтение

MCP-серверШирокий доступ

Сравнение с похожими

Карточки с тем же главным запросом: чем они отличаются.

ИнструментОфициальныйАвторизацияЗвезды репозиторияГлавное отличие
ozon-seller-mcp: все 482 метода Ozon Seller API для агента (эта карточка)нетAPI-ключ0
MCP-сервер для Ozon Seller APIнетAPI-ключ4тот же поток задач, но здесь полный снимок спецификации и составные запросы
marketplaces-mcp-ruнетключ необязателен62здесь только Ozon Seller API, зато все 482 метода и защита персональных полей

Коротко о README

В README перечислены возможности, настройка клиента, переменные окружения, составные и общие инструменты, лимиты Ozon, проверка параметров, правила приватности и порядок разработки.

Бейдж для README

Сообщить о проблеме