Ozon Seller MCP (RU)

ozon-mcp-ru

API Ozon Seller для ИИ-ассистентов: товары, заказы FBS и FBO, цены, остатки, финансы, отзывы. Каталог исполняется сервером, у каждого метода класс доступа.

Пакет поднимает один сервер, Ozon Seller, и ничего больше. Сервер, каталог и ядро приходят зависимостью из marketplaces-mcp-ru: здесь имя, точка входа и документация под один маркетплейс.

Установка

Пакет на PyPI, поэтому строка одна:

uvx ozon-mcp-ru

Если нужна ветка main, а не релиз:

uvx --from git+https://github.com/ilyautov/ozon-mcp-ru ozon-mcp-ru

Claude Desktop, claude_desktop_config.json:

{
  "mcpServers": {
    "ozon": {
      "command": "uvx",
      "args": ["ozon-mcp-ru"],
      "env": { "OZON_CLIENT_ID": "...", "OZON_API_KEY": "..." }
    }
  }
}

Третий путь, если агент умеет скиллы: он поставит сервер и настроит клиент сам.

npx skills add ilyautov/ozon-mcp-ru

Ключи

Seller API: Client-Id и Api-Key. Зайдите в кабинет seller.ozon.ru, откройте Настройки, раздел API-ключи. Ozon выдаёт пару: Client-Id (число) и Api-Key. Оба уходят в заголовки одноимённых имён, хост запроса api-seller.ozon.ru.

Performance API: client_id и client_secret. Рекламный кабинет живёт отдельно и авторизуется по OAuth2: пара client_id и client_secret меняется на токен, хост api-performance.ozon.ru. Ключи Seller API там не работают, и наоборот.

Куда положить, чтобы не хранить в открытую. Сервер спросит ключи при первом запуске и положит их в ~/.marketplace-mcp/cabinets.json с правами chmod 600. В репозиторий и в чат они не попадают. Магазинов можно подключить несколько и переключаться между ними прямо из чата.

переменная	секрет	что это
OZON_CLIENT_ID	да	Client-Id из кабинета seller.ozon.ru, Настройки → API-ключи.
OZON_API_KEY	да	Api-Key из той же пары. Оба уходят в одноимённые заголовки.

Ключи можно не держать в окружении: сервер умеет кабинеты и кладёт их в ~/.marketplace-mcp/cabinets.json с правами 600, вне репозитория. Магазинов подключается сколько нужно, переключение прямо из чата.

Карта методов

Каталог лежит в зависимости как ozon_mcp/endpoints.yaml: 441 метод, из них 190 на чтение, 240 на запись и 11 необратимых. Сервер исполняет ровно этот файл, поэтому таблица не может разойтись с кодом.

тема	методов	чтение	запись	необратимые
Заказы FBS и доставка	112	37	73	2
Заказы FBO и склады	64	37	25	2
Товары и карточки	55	30	24	1
Кросс-док FBP	45	15	27	3
Акции и продвижение	31	9	21	1
Возвраты и отмены	30	11	19	0
Отзывы, вопросы и чаты	27	10	16	1
Финансы и отчёты	25	11	14	0
Кабинет и служебное	22	12	9	1
Цены и остатки	21	11	10	0
Аналитика	9	7	2	0

Подробный разбор с параметрами и лимитами: https://marketplaces-mcp-ru.aifrontier.tech/ozon-api.html

可以在聊天中询问什么

• 展示 Ozon 一周内按天统计的销售额
• 哪些商品的价格指数为红色
• 导出上个月的计费报告
• 汇总低于 4 星的评价，并按投诉内容分组

常见错误

401 或提示 “Client-Id should be positive integer”，尽管密钥正确。 首先检查的不是环境变量，而是 ~/.marketplace-mcp/cabinets.json：此文件中的活动店铺优先级高于 env，会悄悄覆盖你在终端中导出的内容。

某个确定存在的方法返回 404。 Ozon 的版本会变动，不同版块使用的版本也不同：商品列表使用 v3，属性使用 v4，价格使用 v5。遇到 404 时，首先检查路径中的版本。

405 Method Not Allowed。 很可能这是从规范中导入的方法：这类条目的路径可靠，但 HTTP 动词不一定正确。实际测试发现，有些标记为 GET 的方法实际上是 POST。请查阅文档，或通过 ozon_get_raw 调用。

与 marketplaces-mcp-ru 有何不同

区别仅在于包含的内容。marketplaces-mcp-ru 一次安装四个电商平台，并由一个服务统一管理；ozon-mcp-ru 只安装一个。代码是共用的：核心代码的修改会通过更新依赖同步到这里，而不是通过复制实现。

Ozon 广告账户使用的是另一套 API，授权方式也不同。marketplaces-mcp-ru 中也包含它，命令为 ozon-perf-mcp，共有 45 个方法。

需求	包
仅使用 Ozon Seller	ozon-mcp-ru
使用全部四个电商平台	marketplaces-mcp-ru

作者

Илья Утов，AI Frontier 实验室。我会在 Telegram 和 LinkedIn 上介绍这些工具的内部实现。

相关项目还有 business-mcp-ru （hh.ru、VK、Диадок、СБИС、Честный знак）、 moysklad-mcp-ru 和 humanizer-ru。

所有项目按用途分类，汇总在一个列表中： ilyautov.github.io。

许可证

MIT，参见 LICENSE。