ozon-mcp
ozon-mcp — MCP-сервер сообщества (автор — PCDCK). API Ozon Seller и Performance: автопагинация, обработка лимитов и аналитика остатков, контента и цен. Лицензия MIT.
Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026
Кратко о сервере
- Разработчик
- PCDCK
- Лицензия
- MIT
- Транспорт
- stdio
- Авторизация
- token_env
- ОС
- linux, macos, windows
- Языки
- python
Уровень риска: high
Ozon Seller и Performance API: 466 методов, сценарии аналитики, двойное подтверждение разрушительных вызовов.
Настройка клиентов
{
"code": "{\n \"mcpServers\": {\n \"ozon\": {\n \"command\": \"uv\",\n \"args\": [\"--directory\", \"/absolute/path/to/ozon-mcp\",\n \"run\", \"ozon-mcp\"]\n }\n }\n}",
"file": "~/.cursor/mcp.json",
"lang": "json",
"verified": "docs"
}
Что умеет
ozon-mcp — MCP-сервер для Ozon Seller API и Performance API, который подключает ИИ-агента к кабинету продавца на Ozon. Весь инструментарий продавца сведён в 15 инструментов: агент ищет нужный метод по-русски или по-английски, открывает любой из 466 методов с полностью развёрнутой JSON-схемой и выполняет вызовы со встроенной защитой.
Ключевые цифры из README: 466 проиндексированных методов (420 Seller и 46 Performance) в 55 разделах, 5 моделируемых уровней подписки, 38 эндпоинтов с автоматическим постраничным обходом, 43 разрушительных метода с двойным подтверждением и 13 готовых сценариев для типовых задач продавца.
Основные инструменты: ozon_call_method (вызов любого метода с проверками безопасности и подписки), ozon_fetch_all (все страницы результата), ozon_describe_method, ozon_search_methods (поиск BM25 со стеммингом), ozon_list_workflows и ozon_get_workflow, ozon_get_rate_limits, ozon_get_subscription_status, ozon_get_error_catalog.
Готовые сценарии:
| Сценарий | Что решает |
|---|---|
oos_risk_analysis |
Товары, которые скоро закончатся |
cabinet_health_check |
Все показатели рейтинга продавца за раз |
content_audit |
Карточки с низким контент-рейтингом и что в них дополнить |
pricing_analysis |
Товары с неконкурентной ценой |
warehouse_stock_distribution |
Остатки FBO по складам |
sync_orders_fbo, sync_orders_fbs |
Инкрементальная выгрузка заказов |
sync_finance_transactions |
Финансовые операции для юнит-экономики |
sync_advertising_campaigns |
Рекламные кампании из Performance API |
Сервер знает, какие методы доступны только на премиальных тарифах (от LITE до PREMIUM_PRO), и отклоняет такой вызов ещё до отправки, экономя квоту. При ответе 429 он повторяет запрос с экспоненциальной задержкой, учитывает Retry-After и сам ставит в очередь параллельные вызовы медленных методов. Постраничный обход поддерживает все четыре схемы Ozon и не зацикливается, если сервер дважды вернёт тот же курсор. Ошибки приходят в едином формате.
Кому подойдёт
Продавцам на Ozon и их аналитикам, которые хотят проверять остатки, рейтинг, цены и заказы через ИИ-агента. Похожие серверы — в категории бизнес и 1С.
Установка
Нужны Python 3.12 или 3.13, менеджер uv и ключи Seller API (Client-Id и Api-Key) из настроек кабинета продавца. Клонируйте репозиторий, выполните uv sync и проверьте запуск командой uv run ozon-mcp --help. Для рекламы нужны отдельные ключи Performance API.
Подключение к клиентам
Конфигурации из README. Подробнее — в инструкции как подключить MCP.
{
"mcpServers": {
"ozon": {
"command": "uv",
"args": ["--directory", "/absolute/path/to/ozon-mcp",
"run", "ozon-mcp"],
"env": {
"OZON_CLIENT_ID": "your-seller-client-id",
"OZON_API_KEY": "your-seller-api-key",
"OZON_PERFORMANCE_CLIENT_ID": "your-perf-client-id",
"OZON_PERFORMANCE_CLIENT_SECRET": "your-perf-secret"
}
}
}
}Для Claude Desktop файл — claude_desktop_config.json, для Cursor — ~/.cursor/mcp.json. Тот же JSON, что для Cursor, README приводит и для Windsurf (~/.codeium/windsurf/mcp_config.json).
Проверка
Попросите: «Какой уровень подписки у моего кабинета Ozon?» — сработает ozon_get_subscription_status.
Примеры задач
Запусти сценарий oos_risk_analysis и покажи товары, которые закончатся меньше чем через две недели.Проверь здоровье моего кабинета Ozon по сценарию cabinet_health_check.Риски
- Изменения в кабинете. Через
ozon_call_methodдоступны методы записи; каждый метод помечен как чтение, запись или разрушительный. Запись требуетconfirm_write=True, разрушительные — ещё иi_understand_this_modifies_data=True. - Ключи API дают доступ к кабинету продавца — храните их только в конфигурации клиента.
- Квоты Ozon. Массовые выгрузки расходуют лимиты запросов.
Частые вопросы
Можно ли искать методы по-русски?
Да, поиск работает на русском и английском.
Что будет при вызове метода не своего тарифа?
Сервер вернёт ошибку subscription_gate без запроса к Ozon.
Насколько свежи описания API?
Спецификации поставляются с сервером; ozon_get_swagger_meta показывает их свежесть.
Основы протокола — на странице что такое MCP-сервер.
Похожие MCP-серверы
1C MCP Toolkit
MCP и REST API сервер для баз 1С во внешней обработке: запросы, метаданные, журнал, справка BSL и выполнение кода.
MCP BSL Platform Context
MCP-сервер со справкой по синтаксису и объектной модели платформы 1С, без доступа к базе.
Spree Commerce: открытая платформа электронной коммерции для B2B и маркетплейсов
Открытая платформа электронной коммерции Spree для B2B и маркетплейсов.
Spree Commerce: документация для ИИ-агентов
Документация Spree Commerce для агентов-программистов.