Ozon Seller MCP Server

mcp-ozon-seller

Ozon Seller API 用の MCP サーバーです。ロシア最大のマーケットプレイスに対応しています。

AI クライアント（Claude Desktop、Cursor、n8n）を Ozon のセラーアカウントに接続し、商品管理、価格と在庫の更新、注文の確認、分析データの取得、財務状況と返品の監視を行えます。

Ozon Seller API に対応する初の MCP サーバーです。

26 個のツール · 7 グループ · 2 つのモード：ローカル（stdio）＋リモート（HTTP）

---

ツール

A. アカウント

ツール	説明
get_seller_info	認証情報を検証し、アカウント情報を取得します

B. 商品

ツール	説明
list_products	ステータスで絞り込んだ商品一覧を取得します
get_product	商品カード：属性、ステータス、画像
create_product	新しい商品を作成します（一度に最大 100 件）
update_product	商品の属性と説明を更新します
archive_product	商品をストアフロントから非表示にします
unarchive_product	商品を販売中の状態に戻します

C. 価格と在庫

ツール	説明
get_prices	現在の価格と価格指数を取得します
update_prices	価格を更新します（一度に最大 1000 商品）
get_stocks	すべての倉庫の在庫数を取得します
update_stocks	FBS 倉庫の在庫を更新します

D. 注文

ツール	説明
list_fbo_orders	FBO 注文一覧を取得します
get_fbo_order	FBO 注文の詳細を取得します
list_fbs_orders	FBS 注文一覧を取得します
get_fbs_order	FBS 注文の詳細を取得します
get_fbs_awaiting	発送待ちの FBS 注文を取得します

E. 分析

ツール	説明
get_analytics	任意の期間の売上、収益、閲覧数、返品を取得します
get_warehouse_stocks	回転率データ付きで Ozon 倉庫の在庫を取得します

F. 財務

ツール	説明
get_finance_report	指定期間のキャッシュフローレポートを取得します
list_transactions	取引一覧：入金、手数料、支払い
get_transactions_totals	取引の合計概要を取得します

G. 返品と評価

ツール	説明
list_fbo_returns	FBO 返品：商品、理由、金額
list_fbs_returns	FBS 返品：商品、理由、金額
get_seller_rating	セラー品質指数を取得します
get_seller_rating_history	セラー評価の推移を取得します
list_warehouses	セラー倉庫一覧（在庫更新に必要な ID）

---

クイックスタート

モード 1：ローカル（stdio）— Claude Desktop / Cursor

ステップ 1： API 認証情報を取得します Ozon Seller → Settings → API Integrations → Seller API → Create key（ロール：Admin）

ステップ 2： Claude Desktop の設定に追加します：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "ozon-seller": {
      "command": "npx",
      "args": ["-y", "@woyax/mcp-ozon-seller"],
      "env": {
        "OZON_CLIENT_ID": "123456",
        "OZON_API_KEY": "your-api-key-here"
      }
    }
  }
}

ステップ 3： Claude Desktop を再起動します。「先週の収益上位 10 商品を表示して」と尋ねてみましょう。

---

モード 2：リモート（HTTP）— VPS でホスト

サーバーを起動します：

MCP_PORT=3000 npx @woyax/mcp-ozon-seller --transport http

任意の MCP クライアントから接続します：

http://your-server.com:3000/mcp?client_id=123456&api_key=your-api-key

複数のユーザーが同時に接続できます。認証情報はリクエストごとに渡されます。

---

n8n 連携

URL を指定してカスタム MCP ノードを追加します：

http://your-server.com:3000/mcp?client_id=CLIENT_ID&api_key=API_KEY

---

プロンプトの例

Show my revenue and orders for the last 7 days

List all products that are out of stock

Update the price for offer_id ABC-123 to 1990 rubles

Show all FBS orders that are waiting to be shipped

What's my current seller rating?

Show finance report for last month

---

環境変数

変数	必須	説明
OZON_CLIENT_ID	はい	Ozon の個人アカウントに記載されている数値のセラー ID
OZON_API_KEY	はい	Ozon の個人アカウントで取得した API キー（UUID）
MCP_TRANSPORT	いいえ	stdio（デフォルト）または http
MCP_PORT	いいえ	HTTP モードのポート（デフォルト：3000）

---

API 認証情報

1. Ozon Seller にアクセスします
2. Settings → API Integrations → Seller API を開きます
3. ロール Admin で新しいキーを作成します（26 個すべてのツールで必要です）
4. Client-Id（数値）と Api-Key（UUID）を保存します

---

レート制限

Ozon API にはレート制限があります。このサーバーは、429 エラーが発生すると指数バックオフ（1s → 2s → 4s）で自動的に再試行します。

⚠️ get_warehouse_stocks にはより厳しい制限があります。短い間隔で繰り返し呼び出さないでください。

---

作者とサポート

Oleg Alekseev が開発しました — ERP／AI 統合アーキテクトです。

• 📧 [email protected] · [email protected]
• 💬 Telegram：@ale_oleg · チャンネル：@woyax_ai
• 💬 MAX：max.ru/id503610654564_biz

ERP、CRM、または Ozon と AI エージェントの統合についてサポートが必要ですか？カスタム MCP サーバー、n8n ワークフロー、AI 自動化については、お問い合わせください。

---

Woyax AI Stack — ロシア企業向けの法人用 AI スイート

このパッケージは Woyax AI Stack の一部です。ロシアの法人環境におけるビジネスプロセス自動化のための MCP サーバーと AI エージェントのコレクションです。

コンポーネント	機能	リンク
mcp-max-messenger	MAX メッセンジャーとの AI 統合：通知、承認、ボット	ユースケース · 記事
mcp-chestnyi-znak	商品ラベリング向けの正式な API アクセス：マーキングコード、書類、残高	ユースケース
mcp-ozon-seller	Ozon ストア管理：商品、価格、注文、財務、分析	GitHub
Woyax AI Process Auditor	従業員に体系的な聞き取りを行い、企業の AI 自動化マップを作成する Telegram ボット	記事

---

ライセンス

MIT + Commons Clause © Oleg Alekseev

個人利用および法人利用は無料です。ホスト型サービスとして販売するには、作者の許可が必要です。詳細は LICENSE をご覧ください。