用途:把 Яндекс Маркет 接入 AI 助手,在聊天中直接操作合作伙伴后台。服务器名为 yandex-market-mcp-ru,封装官方 API 的 165 个方法(读取 109、写入 49、不可逆 7)。方法目录以 YAML 保存并由服务器执行,因此代理获得的是少量通用工具,而不是每个方法一个函数。
主要能力:ym_search_methods 用自然语言搜索方法;ym_describe_method 查看参数、分页与访问级别;ym_call_method 执行调用,读取直接执行,写入需确认,不可逆操作需两次确认;ym_check_auth 验证密钥是否生效。
安装与配置:首个 PyPI 版本以标签 v0.5.3 发布,此前可直接从仓库安装:uvx --from git+https://github.com/ilyautov/yandex-market-mcp-ru yandex-market-mcp-ru。发布后可用 uvx yandex-market-mcp-ru。客户端(Claude Desktop、Cursor、Claude Code)配置中 command 为 uvx,args 为 --from git+https://github.com/ilyautov/yandex-market-mcp-ru yandex-market-mcp-ru,env 中设置 YANDEX_MARKET_API_KEY。
密钥来源:YANDEX_MARKET_API_KEY 取自合作伙伴后台的“设置 → API”。另一种方式是不用环境变量,启动服务器后调用 ym_add_cabinet,密钥写入 ~/.marketplace-mcp/cabinets.json,权限 600,不离开本机;同样可接入第二个店铺。
使用建议:先用目录搜索方法,不要猜测方法名;写入前先向人展示将发送到 API 的内容并等待同意;不要对返回的数字四舍五入或心算重算;若方法返回空列表,如实说明。
限制:资料未提供价格、平台支持范围、速率限制或错误处理细节。若需同时使用多个平台,可安装 marketplaces-mcp-ru,它在一个服务器中集成 Wildberries、Ozon、Яндекс Маркет 和 Авито。