Ozon MCP Server
MCP-сервер для Ozon Seller API и Performance API: цены, акции, реклама, заказы, возвраты и финансы для нескольких магазинов
Установка
uvx ozon-mcp-serverЗапуск по stdio. Также можно pip install ozon-mcp-server и затем ozon-mcp.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер дает агенту управление магазином на Ozon: товары и остатки, цены и стратегии, акции, заказы FBS и FBO, возвраты, отзывы и чаты, отчеты и финансы. В отличие от многих аналогов он работает и с рекламным Performance API: кампании, ставки, бюджеты и статистика. Каждый вызов принимает shop_id, так что одно правило можно применить сразу к нескольким кабинетам. В Docker-режиме есть веб-панель на русском со статистикой вызовов, управлением ключами и диагностикой, которая заранее показывает, какие методы Ozon перестали отвечать.
Для кого. Селлерам и агентствам, которые ведут один или несколько магазинов на Ozon.
Подходит, если
- Нужно сравнить индекс цен с конкурентами и поправить цены
- Нужно посмотреть расход рекламы за неделю и остановить убыточные кампании
- Нужно ответить на новые отзывы или разобрать возвраты rFBS
- Одни и те же правила нужно применить к нескольким кабинетам
Не подходит, если
- Нужен только просмотр данных, а давать агенту право менять цены и рекламу нельзя
- Магазин на Wildberries: для него у автора отдельный сервер
Пример запроса к агенту
Какие мои товары в магазине alpha Ozon планирует добавить в акции и где индекс цен хуже конкурентов?Ограничения
Нужны Client-Id и API-ключ Seller API, для рекламы отдельно Client-Id и Client-Secret Performance API. Все кабинеты ходят в Ozon с одного IP, поэтому при большом числе магазинов можно упереться в лимиты. Веб-панель и /api не защищены токеном, порт 8000 нельзя открывать в интернет. Инструкции по клиентам в docs только на русском. Автор обновляет проект под свои задачи.
Как отключить. Удалите сервер из конфигурации клиента, например claude mcp remove ozon. Docker-версию остановите командой docker compose down, данные останутся в томе ozon_data.
MCP
- Транспорт
- stdio, sse
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| OZON_CLIENT_ID | Client-Id Seller API для запуска по stdio |
| OZON_API_KEY секрет | API-ключ Seller API для запуска по stdio |
| DATA_DIR | Каталог для магазинов, ключей и статистики, по умолчанию /data |
| MCP_AUTH_TOKEN секрет | Токен для защиты SSE-эндпоинта в Docker-режиме |
Проверка безопасности
- Меняет цены, участие в акциях, ставки и бюджеты рекламы в рабочих кабинетах
- Работает с финансовыми данными и ключами нескольких магазинов
- Веб-панель без авторизации позволяет добавить магазин любому, кто видит порт
Коротко о README
README на английском, русском и китайском описывает группы инструментов от акций и цен до финансов и рейтинга продавца. Предложены запуск через uvx или pip по stdio и Docker-вариант с веб-панелью и SSE на порту 8000. Для каждого популярного клиента есть отдельная инструкция с готовым JSON. Подробно разобраны мультимагазинность, шифрование ключей, ограничения по IP и что именно защищает MCP_AUTH_TOKEN. Лицензия MIT.
Частые вопросы
Где хранятся ключи магазинов?
В DATA_DIR в файле shops.json, зашифрованными ключом Fernet из того же каталога. При переносе сервера копируйте весь каталог или том, иначе ключ шифрования потеряется.
Нужен ли Docker?
Нет, uvx ozon-mcp-server запускает сервер по stdio. Docker нужен только для веб-панели, диагностики и SSE.
Похожие
Официальный MCP-сервер Salesforce DX: работа с org, метаданными, данными, пользователями и тестами Apex из агента
E-Commerce Skills
E-Commerce Skills by Nexscope
Большой набор текстовых скиллов для продавцов Amazon, Shopify, eBay, Etsy, TikTok Shop и Walmart: цены, листинги, реклама, рост
153 скилла для кросс-бордер e-commerce через API LinkFox: Amazon, Ozon, TikTok Shop, 1688, ключевые слова, реклама и патенты
MCP-сервер для контактов и сделок CRM Битрикс24 через входящий вебхук: поиск, списки и смена стадии сделки