mcp-ozon-seller

MCP-сервер для Ozon Seller API — крупнейшего российского маркетплейса.

Подключите AI-клиенты (Claude Desktop, Cursor, n8n) к кабинету продавца Ozon: управляйте товарами, обновляйте цены и остатки, просматривайте заказы, получайте аналитику, контролируйте финансы и возвраты.

Первый в мире MCP-сервер для Ozon Seller API.

26 инструментов · 7 групп · Два режима: локальный (stdio) + удалённый (HTTP)

Инструменты

A. Аккаунт

| Инструмент | Описание | |------------|----------| | get_seller_info | Проверка ключей, информация об аккаунте |

B. Товары

| Инструмент | Описание | |------------|----------| | list_products | Список товаров с фильтрами по статусу | | get_product | Карточка товара: атрибуты, статус, изображения | | create_product | Создать новые товары (до 100 за раз) | | update_product | Изменить атрибуты и описание товара | | archive_product | Скрыть товар с витрины | | unarchive_product | Вернуть товар в продажу |

C. Цены и остатки

| Инструмент | Описание | |------------|----------| | get_prices | Текущие цены и индекс цены | | update_prices | Обновить цены (до 1000 товаров за раз) | | get_stocks | Остатки по всем складам | | update_stocks | Обновить остатки на складах FBS |

D. Заказы

| Инструмент | Описание | |------------|----------| | list_fbo_orders | Список заказов FBO | | get_fbo_order | Детали заказа FBO | | list_fbs_orders | Список заказов FBS | | get_fbs_order | Детали заказа FBS | | get_fbs_awaiting | Заказы FBS, ожидающие отгрузки |

E. Аналитика

| Инструмент | Описание | |------------|----------| | get_analytics | Продажи, выручка, просмотры, возвраты — за любой период | | get_warehouse_stocks | Остатки на складах Ozon с оборачиваемостью |

F. Финансы

| Инструмент | Описание | |------------|----------| | get_finance_report | Отчёт о движении денег за период | | list_transactions | Транзакции: начисления, комиссии, выплаты | | get_transactions_totals | Итоговые суммы по транзакциям |

G. Возвраты и рейтинг

| Инструмент | Описание | |------------|----------| | list_fbo_returns | Возвраты FBO: товары, причины, суммы | | list_fbs_returns | Возвраты FBS: товары, причины, суммы | | get_seller_rating | Рейтинг продавца (индекс качества) | | get_seller_rating_history | История изменений рейтинга | | list_warehouses | Склады продавца (ID нужны для обновления остатков) |

Быстрый старт

Режим 1: Локальный (stdio) — Claude Desktop / Cursor

Шаг 1: Получите API-ключи Кабинет продавца Ozon → Настройки → API интеграции → Seller API → Создать ключ (роль: Admin)

Шаг 2: Добавьте в конфиг Claude Desktop:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "ozon-seller": {
      "command": "npx",
      "args": ["-y", "@woyax/mcp-ozon-seller"],
      "env": {
        "OZON_CLIENT_ID": "123456",
        "OZON_API_KEY": "ваш-api-ключ"
      }
    }
  }
}

Шаг 3: Перезапустите Claude Desktop. Спросите: «Покажи топ-10 товаров по выручке за прошлую неделю»

Режим 2: Удалённый (HTTP) — на вашем сервере

Запуск сервера:

MCP_PORT=3000 npx @woyax/mcp-ozon-seller --transport http

Подключение из любого MCP-клиента:

http://ваш-сервер.ru:3000/mcp?client_id=123456&api_key=ваш-api-ключ

Несколько пользователей могут подключаться одновременно — ключи передаются в каждом запросе.

Интеграция с n8n

Добавьте custom MCP-узел с URL:

http://ваш-сервер.ru:3000/mcp?client_id=CLIENT_ID&api_key=API_KEY

Примеры запросов к AI

Покажи выручку и заказы за последние 7 дней

Список всех товаров с нулевым остатком

Обнови цену для артикула ABC-123 на 1990 рублей

Какие FBS-заказы ожидают отгрузки?

Какой сейчас рейтинг продавца?

Финансовый отчёт за прошлый месяц

Переменные окружения

| Переменная | Обязательна | Описание | |------------|-------------|----------| | OZON_CLIENT_ID | Да | Числовой ID продавца из кабинета Ozon | | OZON_API_KEY | Да | API-ключ (UUID) из кабинета Ozon | | MCP_TRANSPORT | Нет | stdio (по умолчанию) или http | | MCP_PORT | Нет | Порт для HTTP-режима (по умолчанию: 3000) |

Получение ключей API

1. Войдите в кабинет продавца Ozon
2. Настройки → API интеграции → Seller API
3. Создайте ключ с ролью Admin (нужна для всех 26 инструментов)
4. Сохраните Client-Id (число) и Api-Key (UUID)

Rate Limits

Ozon API ограничивает количество запросов. Сервер автоматически повторяет запросы при ошибке 429 с экспоненциальной задержкой (1с → 2с → 4с).

⚠️ get_warehouse_stocks имеет более строгие ограничения — не вызывайте в цикле.

Автор и поддержка

Разработал Oleg Alekseev — архитектор ERP/AI-интеграций.

• 📧 [email protected] · [email protected]
• 💬 Telegram: @ale_oleg · Канал: @woyax_ai
• 💬 MAX: max.ru/id503610654564_biz

Нужна помощь с интеграцией AI-агентов с ERP, CRM или Ozon? Кастомные MCP-серверы, n8n-воркфлоу, AI-автоматизация — пишите.

Woyax AI Stack — корпоративный AI-контур для российского бизнеса

Этот пакет — часть Woyax AI Stack: набора MCP-серверов и AI-агентов для автоматизации бизнес-процессов в российском корпоративном контуре.

| Компонент | Что даёт | Ссылки | |---|---|---| | mcp-max-messenger | AI-интеграция с мессенджером MAX: уведомления, согласования, боты | Применимость · Статья | | mcp-chestnyi-znak | Доступ к True API маркировки: КМ, документы, остатки, участники | Применимость | | mcp-ozon-seller | Управление магазином Ozon: товары, цены, заказы, финансы, аналитика | GitHub | | Woyax AI Process Auditor | Telegram-бот проводит структурированные интервью с сотрудниками и формирует карту AI-автоматизации компании | Статья |

Лицензия

MIT + Commons Clause © Oleg Alekseev

Свободно для личного и корпоративного использования. Перепродажа в виде хостируемого сервиса требует разрешения автора. Подробнее — LICENSE.