Ozon Seller MCP (RU)

io.github.ilyautovPublished by GitHub account ilyautovv0.6.0Updated Oct 25, 2026

API Ozon Seller в ИИ-ассистенте: товары, заказы, цены, остатки, финансы, отзывы

VerifiedSTDIODesktop onlyFinanceData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

Local MCP server exposing the Ozon Seller API to an AI assistant: products, FBS/FBO orders, prices, stock, finances and reviews.

What you can do
Read and manage FBS orders and delivery, plus FBO orders and warehouses, including cross-dock FBP flows and returns or cancellations. Work with products and listings, prices and stock, and promotions. Retrieve finances and reports, and analytics figures. Read and reply to reviews, questions and chats. Manage seller account and service settings, with a raw request call for methods that misbehave.
When to use it
Useful for Ozon sellers who want to query sales, prices, stock, payouts and reviews, or act on orders and listings, from a chat assistant instead of the seller dashboard. Choose this package if only Ozon Seller is needed; a sibling package bundles four marketplaces.
Requirements
Runs locally via uvx from the PyPI package ozon-mcp-ru (Python tooling required). Needs an Ozon Seller API key pair: OZON_CLIENT_ID and OZON_API_KEY, sent as same-named headers to api-seller.ozon.ru. Keys can be entered on first run and stored in a local cabinets file. Network access to Ozon. Advertising API uses separate OAuth credentials and is not part of this package.
Before you install
The catalog covers 441 methods, of which 240 write and 11 are irreversible, so assistant actions can change or delete real seller data. Credentials OZON_CLIENT_ID and OZON_API_KEY are stored in a local cabinets file that takes priority over environment variables. Several shops can be connected and switched from chat, so confirm the active cabinet before acting. Some documented methods have wrong HTTP verbs and may need the raw call.

Installation

In SourceWeft

  1. Open Ozon Seller MCP (RU) in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

ozon-mcp-ru

API Ozon Seller для ИИ-ассистентов: товары, заказы FBS и FBO, цены, остатки, финансы, отзывы. Каталог исполняется сервером, у каждого метода класс доступа.

[PyPI] [CI] [License: MIT] [Методов] [Сайт] [Звёзды]

[ozon-mcp-ru: API Ozon Seller в ИИ-ассистенте. 441 метод]

Пакет поднимает один сервер, Ozon Seller, и ничего больше. Сервер, каталог и ядро приходят зависимостью из marketplaces-mcp-ru: здесь имя, точка входа и документация под один маркетплейс.

Установка

Пакет на PyPI, поэтому строка одна:

bash
uvx ozon-mcp-ru

Если нужна ветка main, а не релиз:

bash
uvx --from git+https://github.com/ilyautov/ozon-mcp-ru ozon-mcp-ru

Claude Desktop, claude_desktop_config.json:

json
{  "mcpServers": {    "ozon": {      "command": "uvx",      "args": ["ozon-mcp-ru"],      "env": { "OZON_CLIENT_ID": "...", "OZON_API_KEY": "..." }    }  }}

Третий путь, если агент умеет скиллы: он поставит сервер и настроит клиент сам.

bash
npx skills add ilyautov/ozon-mcp-ru

Ключи

Seller API: Client-Id и Api-Key. Зайдите в кабинет seller.ozon.ru, откройте Настройки, раздел API-ключи. Ozon выдаёт пару: Client-Id (число) и Api-Key. Оба уходят в заголовки одноимённых имён, хост запроса api-seller.ozon.ru.

Performance API: client_id и client_secret. Рекламный кабинет живёт отдельно и авторизуется по OAuth2: пара client_id и client_secret меняется на токен, хост api-performance.ozon.ru. Ключи Seller API там не работают, и наоборот.

Куда положить, чтобы не хранить в открытую. Сервер спросит ключи при первом запуске и положит их в ~/.marketplace-mcp/cabinets.json с правами chmod 600. В репозиторий и в чат они не попадают. Магазинов можно подключить несколько и переключаться между ними прямо из чата.

переменнаясекретчто это
OZON_CLIENT_IDдаClient-Id из кабинета seller.ozon.ru, Настройки → API-ключи.
OZON_API_KEYдаApi-Key из той же пары. Оба уходят в одноимённые заголовки.

Ключи можно не держать в окружении: сервер умеет кабинеты и кладёт их в ~/.marketplace-mcp/cabinets.json с правами 600, вне репозитория. Магазинов подключается сколько нужно, переключение прямо из чата.

Карта методов

Каталог лежит в зависимости как ozon_mcp/endpoints.yaml: 441 метод, из них 190 на чтение, 240 на запись и 11 необратимых. Сервер исполняет ровно этот файл, поэтому таблица не может разойтись с кодом.

темаметодовчтениезаписьнеобратимые
Заказы FBS и доставка11237732
Заказы FBO и склады6437252
Товары и карточки5530241
Кросс-док FBP4515273
Акции и продвижение319211
Возвраты и отмены3011190
Отзывы, вопросы и чаты2710161
Финансы и отчёты2511140
Кабинет и служебное221291
Цены и остатки2111100
Аналитика9720

Подробный разбор с параметрами и лимитами: https://marketplaces-mcp-ru.aifrontier.tech/ozon-api.html

Что спросить в чате

  • покажи продажи на Ozon за неделю по дням
  • какие товары с красным индексом цены
  • вытащи отчёт о начислениях за прошлый месяц
  • собери отзывы ниже 4 звёзд и сгруппируй жалобы

Частые ошибки

401 или «Client-Id should be positive integer», хотя ключ верный. Первым делом смотрите не переменные окружения, а ~/.marketplace-mcp/cabinets.json: активный кабинет в этом файле имеет приоритет над env и молча затеняет то, что вы экспортировали в терминале.

404 на методе, который точно существует. Ozon дрейфует по версиям, и разные разделы живут на разных: список товаров на v3, атрибуты на v4, цены на v5. При 404 проверяйте версию в пути раньше всего остального.

405 Method Not Allowed. Скорее всего это метод, импортированный из спецификации: путь у таких записей надёжный, а HTTP-глагол не всегда. Живая проба находила методы, помеченные GET, которые на деле POST. Сверьтесь с документацией или вызовите через ozon_get_raw.

Чем это отличается от marketplaces-mcp-ru

Ничем, кроме состава. marketplaces-mcp-ru ставит четыре маркетплейса сразу и держит их под одним сервером, ozon-mcp-ru ставит один. Код общий: правка в ядре доезжает сюда обновлением зависимости, а не копированием.

Рекламный кабинет Ozon это отдельный API с другой авторизацией. Он тоже есть в marketplaces-mcp-ru, команда ozon-perf-mcp, 45 методов.

нужнопакет
только Ozon Sellerozon-mcp-ru
все четыре маркетплейсаmarketplaces-mcp-ru

Кто это сделал

Илья Утов, лаборатория AI Frontier. Как эти инструменты устроены внутри, пишу в Telegram и LinkedIn.

Рядом стоят business-mcp-ru (hh.ru, VK, Диадок, СБИС, Честный знак), moysklad-mcp-ru и humanizer-ru.

Все проекты одним списком, разобранные по назначению: ilyautov.github.io.

Лицензия

MIT, см. LICENSE.

Source: README.md at commit 6203eed

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.6.0LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts