Skip to main content
Glama
io.github.dontsovcmc/ozon-seller

io.github.dontsovcmc/ozon-seller

by dontsovcmc

mcp-server-ozon-seller

Version

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

  • MCP-сервер — интеграция с Claude Code, Claude Desktop и другими MCP-клиентами

  • CLI-утилита — работа с API из терминала, скрипты и автоматизация

  • Pydantic-модели — типизированные модели API для использования в своих Python-программах

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

Оглавление

Related MCP server: amazon-mcp

Архитектура

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

Инструмент

Описание

ozon_search

Поиск действий по описанию на естественном языке

ozon_execute

Выполнение действия по ID

ozon_execute_file

Выполнение действия со скачиванием файла

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

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)

Домен

Кол-во

Описание

products

21

Товары: создание, обновление, цены, остатки, атрибуты

fbs

17

FBS-отправления: списки, отмены, этикетки, акты

fbo

9

FBO: отправления, поставки, склады

categories

4

Категории и атрибуты товаров

finance

4

Финансы: транзакции, итоги, движение средств

analytics

3

Аналитика: данные, остатки, оборачиваемость

warehouses

2

Склады и способы доставки

returns

8

Возвраты FBO/FBS/rFBS

chats

6

Чаты с покупателями

promos

6

Акции и промо

strategies

4

Ценовые стратегии

rating

3

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

reports

4

Отчёты

reviews

4

Отзывы покупателей

questions

3

Вопросы покупателей

cancellations

4

Заявки на отмену

certificates

6

Сертификаты

barcodes

2

Штрихкоды

brands

1

Бренды


MCP-сервер

Установка

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

  1. Войдите в Ozon Seller

  2. Перейдите в Настройки → API-ключи

  3. Создайте ключ (Admin)

  4. Скопируйте Client-Id и Api-Key

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

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

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

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

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

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

Клиент

ОС

Путь к файлу

Claude Code

все

~/.claude/settings.json (секция mcpServers)

Claude Desktop

macOS

~/Library/Application Support/Claude/claude_desktop_config.json

Claude Desktop

Windows

%APPDATA%\Claude\claude_desktop_config.json

Claude Desktop

Linux

~/.config/Claude/claude_desktop_config.json

Через 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_id
OZON_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_id
export 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 --help
ozon-seller-cli <command> --help

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

# Товары
ozon-seller-cli product-list --limit 10
ozon-seller-cli product-info --offer-id SKU-001
ozon-seller-cli product-stocks-info

# FBS-отправления
ozon-seller-cli fbs-list
ozon-seller-cli fbs-cancel-reasons
ozon-seller-cli fbs-label 12345678-0001-1

# FBO
ozon-seller-cli fbo-list
ozon-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-fbs
ozon-seller-cli returns-fbo

# Другое
ozon-seller-cli warehouses
ozon-seller-cli categories
ozon-seller-cli rating
ozon-seller-cli reviews
ozon-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_CLIENT_ID

да

—

Client-Id из личного кабинета Ozon Seller

OZON_API_KEY

да

—

Api-Key из личного кабинета Ozon Seller

OZON_TIMEOUT

нет

30

Таймаут HTTP-запросов к API (секунды)

OZON_FILE_TIMEOUT

нет

60

Таймаут скачивания файлов (секунды)

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

Разработка

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

Лицензия

MIT

Available Tools

3 tools
ozon_executeA

Execute an Ozon Seller API action by ID.

Use ozon_search first to find the action ID and its parameter schema.

Args: action: action ID from ozon_search results (e.g. "product-list") params_json: JSON object with action parameters matching the schema

Inputs: action (required), params_json. Returns: result

ozon_execute_fileC

Execute an Ozon Seller API action that downloads a file.

Args: action: action ID for download actions file_path: local file path to save the downloaded file params_json: JSON object with action parameters

Inputs: action (required), file_path (required), params_json. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.8/5.0

    Scored across 3 tools

    Disambiguation5/5

    Each tool has a distinct purpose: ozon_search discovers actions, ozon_execute executes general API calls, and ozon_execute_file handles file downloads. No overlap in core functionality.

    Naming Consistency5/5

    All tools follow the consistent pattern of 'ozon_' prefix with a verb_noun structure (search, execute, execute_file). No mixing of conventions.

    Tool Count4/5

    Only 3 tools, but they are designed as a meta-interface to a large API. The minimal set is appropriate for the gateway pattern, though it may feel thin for complex workflows.

    Completeness4/5

    The meta-approach covers the entire Ozon Seller API via search and execute, with a dedicated tool for file downloads. Minor gap: no direct tools for common operations, but the discovery mechanism mitigates this.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server for Amazon Selling Partner API and Advertising API, enabling access to orders, inventory, pricing, ads, and reports via natural language.
      1
      MIT
    • F
      license
      A
      quality
      D
      maintenance
      MCP server for Ozon Seller API that enables AI clients to manage products, prices, stocks, orders, analytics, and finances on Ozon marketplace.
      26
      57 npm
      7
      -
    • A
      license
      A
      quality
      D
      maintenance
      MCP server for Wildberries Seller API enabling management of products, orders, supplies, analytics, advertising, and finance through natural language commands.
      3
      2
      MIT