marketplaces-mcp-ru
MCP-серверы для кабинетов продавца Wildberries, Ozon, Яндекс Маркета и Авито через официальные API с подтверждением записи
Установка
uvx marketplaces-mcp-ruЗапуск объединенного сервера из PyPI, ключи через переменные окружения или инструменты *_add_cabinet.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Пакет поднимает пять MCP-серверов на общем ядре: Wildberries, Ozon Seller, Ozon Performance, Яндекс Маркет и Авито. Вместо сотен отдельных инструментов агент ищет нужный метод в каталоге по-русски или по-английски, читает его описание и вызывает, есть и типизированные инструменты для частых задач вроде продаж. Данные о продажах, заказах, остатках, ценах, финансах и отзывах берутся из API кабинетов по токенам, без браузера. Каждый метод размечен как чтение, запись или удаление: запись требует явного подтверждения, удаление двойного. Готовые сценарии помогают с дозаказом, аудитом цен, ABC-анализом и разбором отзывов, поддерживаются несколько магазинов.
Для кого. Для продавцов на маркетплейсах и их менеджеров, которые ведут несколько площадок сразу.
Подходит, если
- Нужно сравнить продажи за неделю на Wildberries и Ozon одним запросом
- Нужно посчитать, какие товары пора дозаказывать по остаткам и продажам
- Нужно собрать и сгруппировать плохие отзывы по товарам
Не подходит, если
- Нужна рыночная аналитика по чужим товарам без собственного кабинета
- Нельзя давать агенту ключи API кабинетов с правами на изменение
Пример запроса к агенту
Покажи продажи за неделю на WB и Ozon, сравни их и посчитай дни покрытия по остаткамОграничения
Нужны ключи API своих кабинетов: токен Wildberries, Client-Id и Api-Key Ozon, Api-Key Яндекс Маркета, client_id и client_secret Авито. Автор помечает проект как альфу: вручную выверено ядро с продажами, остатками, ценами, финансами и отзывами, остальные методы импортированы из спецификаций. У HTTP-режима в Docker нет своей авторизации.
Как отключить. Удалите сервер из конфигурации MCP клиента или расширение из Claude Desktop, затем удалите папку ~/.marketplace-mcp с сохраненными ключами и отзовите ключи в кабинетах.
MCP
- Транспорт
- stdio, http
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| WB_API_TOKEN секрет | Токен API Wildberries |
| OZON_CLIENT_ID | Client-Id кабинета Ozon |
| OZON_API_KEY секрет | Api-Key кабинета Ozon |
| YANDEX_MARKET_API_KEY секрет | Api-Key кабинета Яндекс Маркета |
| AVITO_CLIENT_ID | client_id API Авито |
| AVITO_CLIENT_SECRET секрет | client_secret API Авито |
| MCP_TRANSPORT | http включает Streamable HTTP вместо stdio |
Проверка безопасности
- Может менять цены, остатки и заказы в кабинетах продавца
- Хранит ключи API кабинетов локально
- Методы вне проверенного ядра импортированы из спецификаций и не выверены вручную
Коротко о README
README объясняет, чем подход через API кабинетов лучше браузера, и приводит примеры вопросов агенту. Описаны способы установки: расширение .mcpb для Claude Desktop, скилл-установщик, архив с установщиком, uvx, npx, кнопки для VS Code и Cursor и Docker. Разобраны где брать ключи, проверка командой doctor, уровни риска методов и устройство мета-инструментов поверх каталога. Лицензия MIT.
Частые вопросы
Может ли агент случайно изменить цены?
Методы записи требуют параметра confirm_write=true, удаление еще и отдельного подтверждения. В CI проверяется, что изменяющий метод не помечен как чтение.
Можно ли поставить только одну площадку?
Да, есть отдельные пакеты ozon-mcp-ru, wildberries-mcp-ru, yandex-market-mcp-ru и avito-mcp-ru на том же ядре.
Где хранятся ключи?
Локально в ~/.marketplace-mcp/cabinets.json с правами только для владельца, либо в переменных окружения.
Похожие
Официальный MCP-сервер Salesforce DX: работа с org, метаданными, данными, пользователями и тестами Apex из агента
E-Commerce Skills
E-Commerce Skills by Nexscope
Большой набор текстовых скиллов для продавцов Amazon, Shopify, eBay, Etsy, TikTok Shop и Walmart: цены, листинги, реклама, рост
153 скилла для кросс-бордер e-commerce через API LinkFox: Amazon, Ozon, TikTok Shop, 1688, ключевые слова, реклама и патенты
MCP-сервер для контактов и сделок CRM Битрикс24 через входящий вебхук: поиск, списки и смена стадии сделки