ozon-seller

Name: ozon-seller
Author: dontsovcmc

ローカル

github.com/dontsovcmcビジネス・マーケティング225 週間前に更新

リポジトリ

ozon-seller について

ozon-sellerは、Ozon Seller API向けのMCPサーバー、CLI、Pydanticモデルを提供し、出品者やPython開発者を対象としています。検索してから実行する方式で、商品、注文、財務、分析、返品などの操作を行います。

主な機能

01API操作の検索と実行
02商品、注文、在庫への対応
03財務、分析、返品の処理
04JSON出力に対応したCLI
05型付きPydanticモデル

活用シーン

01Ozonの商品情報の確認や更新
02FBS・FBOの出荷と返品の管理
03ターミナルスクリプトからAPIを呼び出す
04PythonプログラムでAPIパラメーターを検証

MCP 対応

MCPサーバーはozon_searchで操作を探し、ozon_executeまたはozon_execute_fileで実行します。Ozon Seller APIの複数の業務領域にわたる操作をMCPクライアントに公開します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定

{
  "mcpServers": {
    "dontsovcmc-ozon-seller": {
      "command": "uvx",
      "args": [
        "mcp-server-ozon-seller"
      ],
      "env": {
        "OZON_CLIENT_ID": "<OZON_CLIENT_ID>",
        "OZON_API_KEY": "<OZON_API_KEY>"
      }
    }
  }
}

起動コマンドuvx mcp-server-ozon-seller

設定が必要な環境変数

OZON_CLIENT_IDシークレット

OZON_API_KEYシークレット

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ

pypimcp-server-ozon-seller0.3.1stdio

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

mcp-server-ozon-seller

Ozon Seller API 用の MCP サーバー、CLI ユーティリティ、Pydantic モデルライブラリです。

MCP サーバー — Claude Code、Claude Desktop、その他の MCP クライアントとの連携
CLI ユーティリティ — ターミナルからの API 操作、スクリプト、自動化
Pydantic モデル — 独自の Python プログラムで使用できる、型付きの API モデル

すべてのデータはお使いのコンピューターに保持され、API キーが外部に送信されることはありません。

アーキテクチャ

サーバーは 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 キーを取得する

Ozon Seller にログインします
設定 → API キー に移動します
キーを作成します（Admin）
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

Markdown 対応

ログインしてコメント

基本情報

作者: dontsovcmc
言語: python
バージョン: 0.3.1
トランスポート: stdio
掲載日: 2026年5月11日
最終更新: 25 週間前
公式 Registry: io.github.dontsovcmc/ozon-seller

問題を報告

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

入門ガイドを読む

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。