Ozon MCP: Документация

Подключение

Только из исходников: git clone https://github.com/PCDCK/ozon-mcp, uv sync, запуск uv run ozon-mcp (stdio, нужен Python 3.12+ и uv). ⚠️ Одноимённый пакет ozon-mcp на PyPI — другой, несвязанный проект (браузерная автоматизация Ozon); ставить через pip install ozon-mcp не нужно.

Auth: OZON_CLIENT_ID + OZON_API_KEY из seller.ozon.ru → Настройки → API-ключи; для рекламы дополнительно — OZON_PERFORMANCE_CLIENT_ID + OZON_PERFORMANCE_CLIENT_SECRET.

Что умеет

15 мета-инструментов вместо отдельной команды на каждое действие — доступ к каталогу из 466 методов (420 Seller + 46 Performance, 55 разделов):

• ozon_call_method / ozon_fetch_all — вызвать метод / автоматически пройти все страницы курсора.
• ozon_search_methods / ozon_describe_method / ozon_get_examples — найти метод и получить его схему с примером.
• ozon_list_sections / ozon_get_section / ozon_get_related_methods — навигация по разделам API.
• ozon_list_workflows / ozon_get_workflow — 13 готовых сценариев (oos_risk_analysis, pricing_analysis, content_audit, cabinet_health_check и др.) с пошаговым планом и типичными ошибками.
• ozon_get_subscription_status / ozon_list_methods_for_subscription — проверка тарифа кабинета до вызова закрытого метода.
• ozon_get_rate_limits / ozon_get_swagger_meta / ozon_get_error_catalog — лимиты, актуальность спецификаций, справочник ошибок.

Сценарий для агента

«Запусти oos_risk_analysis — какие товары рискуют закончиться на складе?», «собери все товары через ozon_fetch_all и сравни с прошлой неделей», «проверь cabinet_health_check — что не так с рейтингом продавца?».

Ограничения

43 деструктивных метода дважды подтверждаются, вызов метода недоступного тарифа блокируется до отправки запроса. Разработка идёт неравномерно — последний коммит в апреле 2026.

Важно

Community-проект, не официальный продукт Ozon. Есть альтернативные реализации (woyaxnini, Oxonomy) с другим набором инструментов.