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 分

    请在仓库或注册中心条目中声明许可证。