用途
Marketplaces MCP RU 是一款 MCP（Model Context Protocol）服务器，把 Wildberries、Ozon、Yandex Market 和 Avito 的卖家 API 转换成 AI 助手可直接调用的工具。用户用自己的话提问，助手便从这些渠道的 Seller API 直接取回销售、订单、库存、价格、财务和评价数据，而不是凭猜测编造数字，也无需通过浏览器操作。
主要能力
- 覆盖四个平台：Wildberries Seller API、Ozon Seller API、Ozon Performance、Yandex Market Partner API、Avito API。
- 提供 1022 个 schema 驱动的方法（根据官方 OpenAPI 规范生成），并使用通用元工具（前缀 wb_、ozon_、ozon_perf_、ym_、avito_）而非每个端点一个工具，保持接口紧凑。
- 提供常用任务的类型化工具，如 wb_get_sales、wb_get_stocks、ozon_get_products、ozon_get_prices、ym_get_orders、ym_set_price、avito_get_orders、avito_update_stock 等。
- 内置安全门：每个方法提前标注风险等级——read（直接执行）、write（需 confirm_write=true）、destructive（需 confirm_write=true 和 i_understand_this_modifies_data=true）。修改价格、库存等操作前需确认。
- 支持多店铺：可在对话中通过 *_add_cabinet / *_use_cabinet 添加并切换多个店铺。
- 每个平台的预置场景：Wildberries 有销售脉搏、库存健康、价格审计、补货计划、ABC 分析、评价汇总；Ozon 有缺货风险、价格分析、单位经济、目录同步、内容审计、ABC 与评价；Yandex Market 有缺货风险、价格分析、评价分析、质量指数；Avito 有订单确认、广告健康、支出对比效果、评价分析。
使用方式
- Claude Desktop 一键安装：从 GitHub Releases 下载 .mcpb 文件并双击，Claude Desktop 会自动安装并在设置窗口询问密钥。
- 让 AI 安装：对 Claude 或 Cowork 说“安装 marketplaces-mcp-ru”。
- 通过技能目录：npx skills add ilyautov/marketplaces-mcp-ru
- 下载双击：从 GitHub Releases 获取 marketplaces-mcp-ru-v<版本>.zip，解压后双击 install.command（macOS）或 install.bat（Windows），填入密钥。
- 终端安装：git clone https://github.com/ilyautov/marketplaces-mcp-ru，然后 python3 install.py --client <客户端>。
- 开发者方式：npx -y marketplaces-mcp-ru 或 uvx marketplaces-mcp-ru；单独服务器命令为 wb-mcp / ozon-mcp / ozon-perf-mcp / yandex-mcp / avito-mcp。
- Docker：docker run -i --rm -e WB_API_TOKEN=… -e OZON_CLIENT_ID=… -e OZON_API_KEY=… ghcr.io/ilyautov/marketplaces-mcp-ru；远程访问可加 -e MCP_TRANSPORT=http -e MCP_HTTP_HOST=0.0.0.0 -p 8000:8000，服务在 http://…:8000/mcp。HTTP 模式没有自带鉴权，需用代理或防火墙保护。
- 密钥获取：Wildberries 在 seller.wildberries.ru → Настройки → Доступ к API；Ozon 在 seller.ozon.ru → Настройки → API-ключи；Yandex Market 在 partner.market.yandex.ru → Настройки → Доступ к API (Api-Key)；Avito 在 avito.ru → Для бизнеса → Интеграции → API (client_id + client_secret)。密钥保存在本地 ~/.marketplace-mcp/cabinets.json（chmod 600），不进入仓库也不进入对话。
适用场景
适合在多个俄罗斯电商平台经营的卖家，希望用自然语言让 AI 助手查询销售、库存、价格、财务、评价，或执行受控的价格与库存修改。
限制
- 当前为 alpha 版本。核心功能（销售、库存、价格、财务、评价）已在真实店铺上校验；其余方法从规范导入，HTTP 动词不一定准确，可能将 GET 标错为 POST。
- Yandex Market 和 Avito 在 0.5.0 版本加入，目录来自官方 OpenAPI 文档，但尚未在真实店铺上实际运行验证，字段名可能有误。
- Ozon 接口版本会变动（list v3、attributes v4、prices v5），遇到 404 需检查版本。
- Ozon Performance 目前为目录制品加 OAuth 包装，token 端点契约未在实机验证。
- 服务器本地运行，密钥存储在本地，任何修改操作都需用户确认。项目为 MIT 许可的开源代码。
- 具体的定价、收费和支持平台等细节以项目资料为准，资料未提供更多信息。
