Ozon MCP

ozon-mcp

MCP-сервер для Ozon Seller API и Performance API: поиск методов, вызовы с защитой от случайной записи и готовые сценарии аналитики

MCP-серверВысокий рискРоссийский стек

pcdck/ozon-mcp

Установка

git clone https://github.com/PCDCK/ozon-mcp.git
cd ozon-mcp
uv sync

Нужны Python 3.12+ и uv.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Вместо сотен отдельных инструментов сервер дает агенту компактный набор: поиск по методам Seller и Performance API на русском и английском, описание метода со схемой, примерами и лимитами, универсальный вызов и автоматический обход пагинации. Каждый метод размечен как чтение, запись или разрушающее действие, и запись требует явного флага подтверждения, а разрушающие методы два флага. Сервер учитывает уровень подписки кабинета, повторяет запросы при 429 и держит очередь для методов с жесткими лимитами. Есть готовые сценарии, например анализ риска out-of-stock по оборачиваемости.

Для кого. Для продавцов Ozon и аналитиков, которые хотят работать с кабинетом продавца через агента.

Подходит, если

  • Нужно выгрузить все товары, остатки или цены без ручной пагинации
  • Нужно найти товары с риском закончиться на складе
  • Нужно разобраться, какой метод API решает задачу и какие у него лимиты

Не подходит, если

  • Нужна работа с Wildberries или другими маркетплейсами
  • Агенту нельзя давать ключ, которым можно менять цены и товары

Пример запроса к агенту

Запусти сценарий oos_risk_analysis и покажи товары, которые закончатся на складе раньше чем через неделю

Ограничения

Нужны Client-Id и Api-Key продавца, для рекламной статистики отдельные ключи Performance API. Сервер ставится из клона через uv и требует Python 3.12 или 3.13. Спецификации API лежат в репозитории снимком и со временем устаревают. Часть методов доступна только на старших тарифах подписки Ozon.

Как отключить. Выполните claude mcp remove ozon или удалите блок ozon из конфигурации клиента. Ключи API можно отозвать в настройках кабинета продавца.

MCP

Транспорт
stdio
Авторизация
API-ключ
Переменные окружения
Переменные окружения
OZON_CLIENT_ID
обязательная
Client-Id кабинета продавца
OZON_API_KEY
обязательная, секрет
Api-Key Seller API
OZON_PERFORMANCE_CLIENT_ID
Client ID для Performance API
OZON_PERFORMANCE_CLIENT_SECRET
секрет
Секрет Performance API

Проверка безопасности

  • Может менять цены, товары и остатки в кабинете продавца
  • Требует секретные ключи Seller API
  • Рекламные методы Performance API связаны с расходом бюджета

Коротко о README

README начинается с требований и установки через uv, затем приводит конфигурации для популярных MCP-клиентов. Примеры показывают выгрузку всех товаров и сценарий анализа остатков с реальной формой ответа. Описаны инструменты, формат ошибок, классификация методов по безопасности и порядок обновления снимка спецификаций. Лицензия MIT.

Частые вопросы

Может ли агент случайно изменить цены?

Для записи нужен флаг confirm_write, для разрушающих методов еще и i_understand_this_modifies_data. Без них вызов отклоняется.

Какие клиенты поддерживаются?

README дает конфигурации для Claude Desktop, Claude Code, Cursor, Windsurf, Cline, Continue и общий вариант для любого stdio-клиента.

Выбор редакции

Официальный MCP-сервер Salesforce DX: работа с org, метаданными, данными, пользователями и тестами Apex из агента

MCP-серверВысокий риск469

E-Commerce Skills

E-Commerce Skills by Nexscope

Большой набор текстовых скиллов для продавцов Amazon, Shopify, eBay, Etsy, TikTok Shop и Walmart: цены, листинги, реклама, рост

СкиллНизкий риск930

153 скилла для кросс-бордер e-commerce через API LinkFox: Amazon, Ozon, TikTok Shop, 1688, ключевые слова, реклама и патенты

СкиллСредний риск102

MCP-сервер для контактов и сделок CRM Битрикс24 через входящий вебхук: поиск, списки и смена стадии сделки

MCP-серверВысокий рискРоссийский стек64