Ozon MCP
ozon-mcp
MCP-сервер для Ozon Seller API и Performance API: поиск методов, вызовы с защитой от случайной записи и готовые сценарии аналитики
Установка
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 из агента
E-Commerce Skills
E-Commerce Skills by Nexscope
Большой набор текстовых скиллов для продавцов Amazon, Shopify, eBay, Etsy, TikTok Shop и Walmart: цены, листинги, реклама, рост
153 скилла для кросс-бордер e-commerce через API LinkFox: Amazon, Ozon, TikTok Shop, 1688, ключевые слова, реклама и патенты
MCP-сервер для контактов и сделок CRM Битрикс24 через входящий вебхук: поиск, списки и смена стадии сделки