Ozon Seller MCP (RU)

ozon-mcp-ru

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

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

Установка

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

uvx ozon-mcp-ru

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

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

Claude Desktop, claude_desktop_config.json:

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

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

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 и доставка	112	37	73	2
Заказы FBO и склады	64	37	25	2
Товары и карточки	55	30	24	1
Кросс-док FBP	45	15	27	3
Акции и продвижение	31	9	21	1
Возвраты и отмены	30	11	19	0
Отзывы, вопросы и чаты	27	10	16	1
Финансы и отчёты	25	11	14	0
Кабинет и служебное	22	12	9	1
Цены и остатки	21	11	10	0
Аналитика	9	7	2	0

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

チャットで質問すること

• Ozonの週間売上を日別に表示してください
• 価格指数が赤い商品はどれですか
• 先月の発生額レポートを取得してください
• 星4つ未満のレビューを集めて、苦情を分類してください

よくあるエラー

401、またはキーが正しいのに「Client-Id should be positive integer」と表示される。 まず環境変数ではなく、~/.marketplace-mcp/cabinets.jsonを確認してください。このファイル内のアクティブなキャビネットは環境変数より優先され、ターミナルでエクスポートした値を黙って上書きします。

確実に存在するはずのメソッドで404になる。 Ozonではバージョンが変遷しており、セクションごとに異なるバージョンが使われています。商品一覧はv3、属性はv4、価格はv5です。404が発生したら、まずパス内のバージョンを確認してください。

405 Method Not Allowed。 おそらく仕様からインポートしたメソッドです。このようなエントリーではパスの信頼性は高い一方、HTTPメソッドは必ずしも正しくありません。実際に試したところ、GETと記載されているメソッドが実際にはPOSTでした。ドキュメントを確認するか、ozon_get_raw経由で呼び出してください。

marketplaces-mcp-ruとの違い

パッケージの構成以外に違いはありません。marketplaces-mcp-ruは4つのマーケットプレイスをまとめてインストールし、1つのサーバーで管理します。ozon-mcp-ruは1つだけをインストールします。コードは共通です。コアの修正はコピーではなく、依存関係の更新によってこちらにも反映されます。

Ozonの広告管理画面は、別の認証方式を使う独立したAPIです。こちらもmarketplaces-mcp-ruに含まれており、コマンドはozon-perf-mcp、メソッド数は45です。

必要なもの	パッケージ
Ozon Sellerのみ	ozon-mcp-ru
4つすべてのマーケットプレイス	marketplaces-mcp-ru

開発者

イリヤ・ウトフ、AI Frontierラボ。このツールの内部構造については、TelegramとLinkedInで発信しています。

関連プロジェクト：business-mcp-ru（hh.ru、VK、Диадок、СБИС、Честный знак）、[moysklad-mcp-ru](https://github.com/ilyautov/moysklad-mcp-ru）、[**humanizer-ru**](https://github.com/ilyautov/humanizer-ru)。

すべてのプロジェクトを用途別にまとめた一覧： ilyautov.github.io。

ライセンス

MIT。LICENSEを参照してください。