Ozon Seller MCP Server

io.github.woyaxnini由 GitHub 帳號 woyaxnini 發布v1.0.0更新於 Oct 24, 2026

MCP server for Ozon Seller API. 26 tools: products, prices, orders, analytics, finance, rating.

已驗證STDIO僅桌面金融資料與分析商業與電商

概覽

AI 產生的概覽

一個本機 MCP 伺服器，將助理連接到 Ozon Seller API，用來管理商品、價格、庫存、訂單、分析與財務。

可以做什麼
驗證憑證並讀取賣家帳戶資訊、評分與評分歷史，以及倉庫清單和倉庫庫存周轉資料。列出、檢視、建立、更新、封存和還原商品，支援批次建立。讀取和更新價格以及 FBS 倉庫庫存水位。列出並檢視 FBO 和 FBS 訂單，包括待出貨的 FBS 訂單。依任意期間取得銷售、營收、瀏覽量和退貨分析。讀取財務報表、交易紀錄和交易彙總，並列出 FBO 和 FBS 退貨及原因和金額。
適用情境
適合想在 Claude Desktop、Cursor 或 n8n 等 AI 用戶端中查詢和調整店鋪的 Ozon 平台賣家，例如查看營收、找出缺貨商品或修改價格。
執行需求
透過 npx 以 stdio 在本機執行，需要 Node.js；也可用 MCP_PORT 以 HTTP 模式自行架設。需要 Ozon 賣家數字 ID（OZON_CLIENT_ID）和 Ozon Seller API 金鑰（OZON_API_KEY），兩者都在 Ozon 賣家後台產生。需要連線至 Ozon API 的網路。
安裝前請注意
API 金鑰是完整權限憑證，README 建議使用 Admin 角色金鑰，應視為敏感資訊並避免放入共用設定。多個工具會寫入線上店鋪：建立、更新和封存商品，修改價格和庫存。HTTP 模式下憑證透過請求 URL 傳遞，可能被寫入日誌；README 建議架設在自己的 VPS 上。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Ozon Seller MCP Server，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

mcp-ozon-seller

[License: MIT + Commons Clause]

MCP server for Ozon Seller API — Russia's largest marketplace.

Connect AI clients (Claude Desktop, Cursor, n8n) to your Ozon seller account: manage products, update prices and stocks, view orders, get analytics, monitor finances and returns.

First MCP server for Ozon Seller API.

26 tools · 7 groups · Two modes: local (stdio) + remote (HTTP)

Tools

A. Account

ToolDescription
get_seller_infoVerify credentials, get account info

B. Products

ToolDescription
list_productsList products with status filters
get_productProduct card: attributes, status, images
create_productCreate new products (up to 100 at once)
update_productUpdate product attributes and description
archive_productHide product from storefront
unarchive_productRestore product to active sale

C. Prices & Stocks

ToolDescription
get_pricesCurrent prices and price index
update_pricesUpdate prices (up to 1000 products at once)
get_stocksStock levels across all warehouses
update_stocksUpdate FBS warehouse stocks

D. Orders

ToolDescription
list_fbo_ordersList FBO orders
get_fbo_orderFBO order details
list_fbs_ordersList FBS orders
get_fbs_orderFBS order details
get_fbs_awaitingFBS orders waiting to be shipped

E. Analytics

ToolDescription
get_analyticsSales, revenue, views, returns — any period
get_warehouse_stocksOzon warehouse stocks with turnover data

F. Finance

ToolDescription
get_finance_reportCash flow report for a period
list_transactionsTransactions: accruals, commissions, payouts
get_transactions_totalsTransaction summary totals

G. Returns & Rating

ToolDescription
list_fbo_returnsFBO returns: items, reasons, amounts
list_fbs_returnsFBS returns: items, reasons, amounts
get_seller_ratingSeller quality index
get_seller_rating_historySeller rating history over time
list_warehousesSeller warehouses (IDs needed for stock updates)

Quick Start

Mode 1: Local (stdio) — Claude Desktop / Cursor

Step 1: Get your API credentials Ozon Seller → Settings → API Integrations → Seller API → Create key (role: Admin)

Step 2: Add to your Claude Desktop config:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
json
{  "mcpServers": {    "ozon-seller": {      "command": "npx",      "args": ["-y", "@woyax/mcp-ozon-seller"],      "env": {        "OZON_CLIENT_ID": "123456",        "OZON_API_KEY": "your-api-key-here"      }    }  }}

Step 3: Restart Claude Desktop. Ask: "Show my top 10 products by revenue for last week"

Mode 2: Remote (HTTP) — hosted on your VPS

Start the server:

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

Connect from any MCP client:

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

Multiple users can connect simultaneously — credentials are passed per-request.

n8n Integration

Add a custom MCP node with URL:

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

Example Prompts

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

Environment Variables

VariableRequiredDescription
OZON_CLIENT_IDYesNumeric seller ID from Ozon personal account
OZON_API_KEYYesAPI key (UUID) from Ozon personal account
MCP_TRANSPORTNostdio (default) or http
MCP_PORTNoPort for HTTP mode (default: 3000)

API Credentials

  1. Go to Ozon Seller
  2. Settings → API Integrations → Seller API
  3. Create new key with role Admin (required for all 26 tools)
  4. Save Client-Id (numeric) and Api-Key (UUID)

Rate Limits

Ozon API enforces rate limits. This server automatically retries on 429 errors with exponential backoff (1s → 2s → 4s).

⚠️ get_warehouse_stocks has stricter limits — avoid calling it in tight loops.

Author & Support

Built by Oleg Alekseev — ERP/AI integration architect.

Need help integrating AI agents with your ERP, CRM, or Ozon? Custom MCP servers, n8n workflows, AI automation — contact me.

Woyax AI Stack — Corporate AI Suite for Russian Business

This package is part of Woyax AI Stack: a collection of MCP servers and AI agents for business process automation in the Russian corporate environment.

ComponentWhat it doesLinks
mcp-max-messengerAI integration with MAX messenger: notifications, approvals, botsUse cases · Article
mcp-chestnyi-znakTrue API access for product labelling: marking codes, documents, balancesUse cases
mcp-ozon-sellerOzon store management: products, prices, orders, finance, analyticsGitHub
Woyax AI Process AuditorTelegram bot that conducts structured interviews with employees and builds a company AI automation mapArticle

License

MIT + Commons Clause © Oleg Alekseev

Free to use for personal and corporate purposes. Selling as a hosted service requires author's permission. See LICENSE for details.

來源：README.md，提交 763e363

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v1.0.0最新Sep 16, 2026

評分

已滿足適用檢查項的 40%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。