用途：为非技术卖家安装 marketplaces-mcp-ru，使用户在 AI 客户端中获得操作卖家后台的工具，流程为「扔仓库 → 代理安装」，无需手动编辑 JSON、无需 pip install。依赖由 serve.py 首次启动时在本地 venv 自行安装。
主要能力：仓库 https://github.com/ilyautov/marketplaces-mcp-ru 提供 wb（Wildberries Seller API）、ozon（Ozon Seller API）、yandex（Yandex Market Partner API）、avito（Avito API）四个 MCP 服务器，以及可选的 ozon-perf（Ozon Performance 广告）。install.py 会把应用复制到 ~/.marketplace-mcp/app 并让配置指向该处，因此源文件夹可移动或删除而不影响 MCP。密钥仅存本地 ~/.marketplace-mcp/cabinets.json（chmod 600），不写入客户端配置或仓库。
使用方式：先判断环境。本地 CLI（如 Claude Code）中 bash 即用户机器，可自行克隆、运行 python3 install.py --client claude-code、收集密钥并执行 serve.py --selfcheck。在 Cowork 中 bash 是隔离 Linux 沙箱，无法写入宿主机 MCP 配置，应改走 Claude Code 命令、双击安装器（install.command / install.bat / install.sh）或逐条口头指引。安装按客户端执行：claude-desktop 直接写配置并备份；claude-code 与 codex 只打印 * mcp add 命令，需真实执行；opencode 写 ~/.config/opencode/opencode.json；--print 仅查看配置片段。密钥可用交互式（3 个字段，Enter 跳过）或 --wb-token、--ozon-client-id、--ozon-api-key 等标志传入，多个店铺用 --cabinet 区分。验证以重启后的 MCP 工具实际调用为准（如 ozon_check_auth、ozon_get_products、wb_get_stocks），而非读取配置文件；install.py 会在 ~/.marketplace-mcp/last_install.json 留下不含密钥的记录。
适用场景与限制：适合想把 WB、Ozon、Yandex Market、Avito 账号接入 AI 客户端的卖家，尤其是多店铺管理与免命令行安装。限制包括：需 Python 3.10+；Cowork 沙箱无法直接安装；macOS 下载的 install.command 可能被 Gatekeeper 拦截，需右键「打开」或 xattr -d com.apple.quarantine；WB Statistics API 限流约每分钟 1 次，429 时等待约 60 秒；Ozon API 版本存在漂移，可能出现 404/405，可通过 *_get_raw 处理；平台本身及收费信息暂未提供。切勿把密钥回显到聊天，若泄露应尽快在卖家后台重发。