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 методов, сценарии аналитики, двойное подтверждение разрушительных вызовов.

Настройка клиентов

cursor
{
    "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 и выполнение кода.

Риск: high Лицензия: GPL-3.0 ★ 371

MCP BSL Platform Context

MCP-сервер со справкой по синтаксису и объектной модели платформы 1С, без доступа к базе.

Риск: medium Лицензия: MIT ★ 209

Источники