用途:通过 MCP 协议把 Ozon Seller 卖家后台连接到 AI 助手(如 Claude Desktop、Cursor、Claude Code),在对话中直接调用官方 API 完成查询与操作。
主要能力:服务器 ozon-mcp-ru 覆盖 441 个官方 API 方法,其中读取 190 个、写入 240 个、不可逆操作 11 个。方法目录以 YAML 保存并由服务器执行,因此代理获得的是若干通用工具,而不是每个方法一个独立函数。常用工具包括 ozon_search_methods(按关键词搜索方法)、ozon_describe_method(查看参数、分页、访问级别)、ozon_call_method(执行调用)、ozon_check_auth(验证密钥是否生效)。读取类调用直接执行,写入类需要确认,不可逆操作需要二次确认。
使用方式:包已发布到 PyPI,安装命令为 uvx ozon-mcp-ru;如需 main 分支而非发布版,可用 uvx --from git+https://github.com/ilyautov/ozon-mcp-ru ozon-mcp-ru。客户端配置需在 mcpServers 中声明命令 uvx、参数 ozon-mcp-ru,并通过环境变量 OZON_CLIENT_ID 与 OZON_API_KEY 传入凭据。密钥来自 seller.ozon.ru 的“设置 → API-密钥”,Client-Id 与 Api-Key 分别写入同名请求头。另一种方式是不设环境变量,启动服务器后调用 ozon_add_cabinet,密钥会以 600 权限保存到 ~/.marketplace-mcp/cabinets.json,且不离开本机,同一方式可接入第二个店铺。
适用场景:需要从聊天界面查询 Ozon 卖家数据、批量或按需调用卖家 API 的运营与开发场景。
限制与注意:应先通过目录搜索方法名,不要猜测;写入前应向人展示将发送的请求体并等待同意。返回的数字不要四舍五入或心算换算;若方法返回空列表,应如实说明。Ozon 广告后台是另一套 API 与授权,对应命令 ozon-perf-mcp,含 45 个方法。若需同时接入 Wildberries、Ozon、Yandex Market 和 Avito,可使用 marketplaces-mcp-ru。资料未提供收费、价格与效果信息。