Ozon Seller

mcp-server-ozon-seller

[Version]

MCP-сервер, CLI-утилита и библиотека Pydantic-моделей для Ozon Seller API.

• MCP-сервер — интеграция с Claude Code, Claude Desktop и другими MCP-клиентами
• CLI-утилита — работа с API из терминала, скрипты и автоматизация
• Pydantic-модели — типизированные модели API для использования в своих Python-программах

Все данные остаются на вашем компьютере — ключи API никуда не передаются.

Оглавление

• Архитектура
• Доступные действия
• MCP-сервер
  • Установка
  • Подключение к Claude Code
  • Подключение к Claude Desktop
  • Подключение через --mcp-config
  • Примеры
• CLI-утилита
  • Установка
  • Использование
  • Примеры команд
• Pydantic-модели
  • Установка
  • Использование в своих программах
• Переменные окружения
• Разработка
• Лицензия

Архитектура

Сервер использует паттерн search + execute — вместо 111 отдельных инструментов предоставляет 3:

Как это работает

LLM: ozon_search("отменить отправление fbs")→ [{"id": "fbs-posting-cancel", "params_schema": {"posting_number": "str", ...}, ...}]
LLM: ozon_execute("fbs-posting-cancel", '{"posting_number": "12345678-0001-1", "cancel_reason_id": 352}')→ {"result": true}

Доступные действия (111)

MCP-сервер

Установка

Шаг 1. Получить API-ключи

1. Войдите в Ozon Seller
2. Перейдите в Настройки → API-ключи
3. Создайте ключ (Admin)
4. Скопируйте Client-Id и Api-Key

Шаг 2. Подключить MCP-сервер

Подключение к Claude Code

Способ 1: через uvx (не требует установки пакета)

Требуется uv — если не установлен:

bash

curl -LsSf https://astral.sh/uv/install.sh | sh

claude mcp add ozon-seller \  -e OZON_CLIENT_ID=ваш_client_id \  -e OZON_API_KEY=ваш_api_key \  -- uvx mcp-server-ozon-seller

Способ 2: через pip

pip install mcp-server-ozon-seller
claude mcp add ozon-seller \  -e OZON_CLIENT_ID=ваш_client_id \  -e OZON_API_KEY=ваш_api_key \  -- mcp-server-ozon-seller

Для удаления:

claude mcp remove ozon-seller

Подключение к Claude Desktop

Добавьте в конфигурационный файл:

Через uvx:

{  "mcpServers": {    "ozon-seller": {      "command": "uvx",      "args": ["mcp-server-ozon-seller"],      "env": {        "OZON_CLIENT_ID": "ваш_client_id",        "OZON_API_KEY": "ваш_api_key"      }    }  }}

Через pip (после pip install mcp-server-ozon-seller):

{  "mcpServers": {    "ozon-seller": {      "command": "mcp-server-ozon-seller",      "env": {        "OZON_CLIENT_ID": "ваш_client_id",        "OZON_API_KEY": "ваш_api_key"      }    }  }}

Подключение через --mcp-config

Подключает сервер только на время одной сессии Claude, не сохраняя в настройки. Токен хранится в отдельном .env.mcp файле, а не в конфиге Claude.

Из JSON-строки:

claude --mcp-config '{"ozon-seller":{"command":"bash","args":["-c","source ~/.env.mcp && exec uvx mcp-server-ozon-seller"]}}'

Из файла:

claude --mcp-config ~/mcp-servers.json

Пример ~/mcp-servers.json:

{  "ozon-seller": {    "command": "bash",    "args": ["-c", "source ~/.env.mcp && exec uvx mcp-server-ozon-seller"]  }}

Пример ~/.env.mcp:

OZON_CLIENT_ID=ваш_client_idOZON_API_KEY=ваш_api_key

Шаг 3. Проверить

Попросите Claude: «покажи мои товары на Ozon» — он вызовет ozon_search, затем ozon_execute.

Примеры (MCP)

• «покажи мои товары на Ozon» → ozon_search("products list") → ozon_execute("product-list")
• «отмени FBS отправление 12345678-0001-1» → ozon_execute("fbs-posting-cancel", ...)
• «скачай акт приёмки №42» → ozon_execute_file("fbs-act-pdf", ...)
• «какие FBS заказы ещё не собраны?» → ozon_execute("fbs-postings-list", ...)
• «покажи финансовые транзакции за апрель» → ozon_execute("finance-transactions", ...)

CLI-утилита

Установка (CLI)

pip install mcp-server-ozon-seller

Переменные окружения OZON_CLIENT_ID и OZON_API_KEY должны быть установлены:

export OZON_CLIENT_ID=ваш_client_idexport OZON_API_KEY=ваш_api_key

Или через файл:

ozon-seller-cli --env /path/to/.env <command>

Формат файла — KEY=VALUE, по одной переменной на строку, #-комментарии.

Использование (CLI)

Без аргументов запускается MCP-сервер, с командой — CLI. Все команды выводят JSON.

# Версияozon-seller-cli --version
# Справкаozon-seller-cli --helpozon-seller-cli <command> --help

Примеры команд

# Товарыozon-seller-cli product-list --limit 10ozon-seller-cli product-info --offer-id SKU-001ozon-seller-cli product-stocks-info
# FBS-отправленияozon-seller-cli fbs-listozon-seller-cli fbs-cancel-reasonsozon-seller-cli fbs-label 12345678-0001-1
# FBOozon-seller-cli fbo-listozon-seller-cli fbo-supply-list
# Финансы и аналитикаozon-seller-cli finance-transactions '{"date": {"from": "2026-04-01", "to": "2026-04-25"}}'ozon-seller-cli analytics-stock
# Возвратыozon-seller-cli returns-fbsozon-seller-cli returns-fbo
# Другоеozon-seller-cli warehousesozon-seller-cli categoriesozon-seller-cli ratingozon-seller-cli reviewsozon-seller-cli brands

Pydantic-модели

Пакет содержит типизированные Pydantic-модели всех объектов API. Модели можно использовать в своих Python-программах для валидации данных и автодополнения в IDE.

Установка (библиотеки)

pip install mcp-server-ozon-seller

Использование в своих программах

from mcp_server_ozon_seller.models import FbsPostingsListParams
# Валидация данныхparams = FbsPostingsListParams.model_validate({    "filter_dict": {"status": "awaiting_packaging"},    "limit": 50,})print(params.model_dump_json())
# Создание объектаparams = FbsPostingsListParams(limit=10)print(params.limit)  # type-safe доступ к полям

Все модели используют extra="allow" для forward compatibility — неизвестные поля API не вызывают ошибок.

Полный список моделей: models.py

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

Получить ключи: Ozon Seller → Настройки → API-ключи.

Разработка

pip install -e ".[test]"ruff check src/ tests/pytest tests/ -v

Лицензия

MIT