MCP-сервер Ozon Seller
mcp-ozon-seller
MCP-сервер для Ozon Seller API: товары, цены, остатки, заказы FBO и FBS, аналитика и финансы продавца
Установка
{
"mcpServers": {
"ozon-seller": {
"command": "npx",
"args": ["-y", "@woyax/mcp-ozon-seller"],
"env": {
"OZON_CLIENT_ID": "123456",
"OZON_API_KEY": "your-api-key-here"
}
}
}
}Локальный режим stdio. Тот же конфиг подходит для Cursor.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Подключает агента к кабинету продавца Ozon через Seller API. Дает 26 инструментов: карточки товаров, обновление цен и остатков, заказы FBO и FBS, аналитика продаж, финансовые отчеты, возвраты и рейтинг продавца. Работает локально через stdio или как HTTP-сервер на своем VPS, в том числе для n8n.
Для кого. Продавцам на Ozon и интеграторам, которые хотят управлять магазином и смотреть отчеты обычными запросами к агенту.
Подходит, если
- Нужно быстро посмотреть выручку, заказы или остатки без захода в кабинет
- Массово обновить цены или остатки FBS по списку товаров
- Проверить финансовый отчет, начисления и возвраты за период
- Встроить работу с Ozon в сценарии n8n
Не подходит, если
- Нельзя выдавать ключ API с ролью Admin
- Нужна продажа сервера как хостинг-услуги: лицензия Commons Clause требует разрешения автора
Пример запроса к агенту
Покажи мою выручку и количество заказов за последние 7 дней и список товаров, которых нет в наличииОграничения
Для всех 26 инструментов нужен ключ с ролью Admin. Ozon ограничивает частоту запросов: сервер повторяет запросы при ошибке 429, а get_warehouse_stocks лимитирован строже. В HTTP-режиме ключи передаются в параметрах URL, поэтому сервер стоит держать за HTTPS и в закрытой сети. Лицензия MIT + Commons Clause.
Как отключить. Удалите блок ozon-seller из mcpServers в конфиге клиента и отзовите ключ в кабинете Ozon Seller, если он больше не нужен.
MCP
- Транспорт
- stdio, http
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| OZON_CLIENT_ID обязательная | Числовой идентификатор продавца из кабинета Ozon |
| OZON_API_KEY обязательная, секрет | API-ключ (UUID) из кабинета Ozon с ролью Admin |
| MCP_TRANSPORT | Транспорт: stdio (по умолчанию) или http |
| MCP_PORT | Порт для HTTP-режима, по умолчанию 3000 |
Проверка безопасности
- Нужен ключ Seller API с ролью Admin
- Инструменты меняют цены, остатки и карточки товаров в живом магазине
- В HTTP-режиме ключ передается в URL
Коротко о README
Сервер реализует 26 инструментов в семи группах: аккаунт, товары, цены и остатки, заказы, аналитика, финансы, возвраты и рейтинг. Поддерживает два режима: локальный stdio для Claude Desktop и Cursor и удаленный HTTP для своего сервера и n8n. В README описаны получение ключа в кабинете Ozon, переменные окружения и примеры запросов. Проект входит в набор Woyax AI Stack для российского бизнеса.
Частые вопросы
Можно ли подключить несколько продавцов к одному серверу?
Да, в HTTP-режиме учетные данные передаются в каждом запросе, и несколько пользователей могут работать одновременно.
Что делать с ошибкой 429?
Сервер сам повторяет запрос с экспоненциальной задержкой 1, 2 и 4 секунды. get_warehouse_stocks не стоит вызывать в цикле.
Похожие
153 скилла для кросс-бордер e-commerce через API LinkFox: Amazon, Ozon, TikTok Shop, 1688, ключевые слова, реклама и патенты
Битрикс24 для OpenClaw
OpenClaw Bitrix24
Плагин и скилл для OpenClaw: агент общается в мессенджере Битрикс24 и работает с CRM, задачами, календарем и диском
Скилл для Avito Business API: полный OpenAPI-спек на 245 операций, OAuth2-хелпер и CLI для поиска эндпоинтов