Ozon Seller MCP Server

mcp-ozon-seller

适用于 Ozon Seller API 的 MCP 服务——俄罗斯最大的电商平台。

将 AI 客户端（Claude Desktop、Cursor、n8n）连接到你的 Ozon 卖家账户：管理商品、更新价格和库存、查看订单、获取分析数据、监控财务和退货。

首个适用于 Ozon Seller API 的 MCP 服务。

26 个工具 · 7 个分组 · 两种模式：本地（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 集成

添加自定义 MCP 节点，并设置 URL：

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

需要帮助将 AI Agent 与 ERP、CRM 或 Ozon 集成吗？定制 MCP 服务、n8n 工作流、AI 自动化——联系我。

---

Woyax AI Stack — 面向俄罗斯企业的企业级 AI 套件

此软件包是 Woyax AI Stack 的一部分：一系列用于俄罗斯企业环境中业务流程自动化的 MCP 服务和 AI Agent。

组件	功能	链接
mcp-max-messenger	与 MAX Messenger 集成 AI：通知、审批、机器人	使用场景 · 文章
mcp-chestnyi-znak	商品标签的真实 API 访问：标记代码、文档、余额	使用场景
mcp-ozon-seller	Ozon 店铺管理：商品、价格、订单、财务、分析	GitHub
Woyax AI Process Auditor	Telegram 机器人，通过与员工进行结构化访谈，构建公司 AI 自动化地图	文章

---

许可证

MIT + Commons Clause © Oleg Alekseev

可免费用于个人和企业用途。作为托管服务出售须获得作者许可。详情请参阅 LICENSE。