Marketplaces MCP RU: Wildberries, Ozon, Маркет и Авито в Claude и Cursor

ilyautov/marketplaces-mcp-ru· Проверено 13.11.2026· 63на GitHub

Подключает агента к кабинетам продавца Wildberries, Ozon, Яндекс Маркета и Авито через их API: продажи, заказы, остатки, цены, финансы и отзывы. Цену или остаток агент меняет только после подтверждения.

Как подключить

Что сделать до подключения

1

uv для запуска через uvx; без Python подойдёт npx -y marketplaces-mcp-ru

2

Ключи хотя бы одной площадки: переменные площадок, где вы не продаёте, оставьте пустыми

3
WB_API_TOKEN

seller.wildberries.ru → Настройки → Доступ к API: создайте токен и отметьте нужные категории

4
OZON_CLIENT_ID, OZON_API_KEY

seller.ozon.ru → Настройки → API-ключи

5
YANDEX_MARKET_API_KEY

partner.market.yandex.ru → Настройки → Доступ к API

6
AVITO_CLIENT_ID, AVITO_CLIENT_SECRET

avito.ru → Для бизнеса → Интеграции → API

7
OZON_PERF_CLIENT_ID, OZON_PERF_CLIENT_SECRET

ключи Ozon Performance API для рекламы, по желанию

Конфиг для вашего клиента

Впишите ключи, и они встанут во все конфиги ниже. Конфиг собирается в браузере.

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'WB_API_TOKEN=<токен WB>' --env 'OZON_CLIENT_ID=<Client-Id Ozon>' --env 'OZON_API_KEY=<Api-Key Ozon>' --env 'YANDEX_MARKET_API_KEY=<Api-Key Маркета>' --env 'AVITO_CLIENT_ID=<client_id Авито>' --env 'AVITO_CLIENT_SECRET=<client_secret Авито>' --transport stdio marketplaces-mcp-ru \
  -- uvx marketplaces-mcp-ru

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Собрать вместе с другими серверами в одном mcp.json →

Инструменты сервера

wb_search_methodsищет метод API по-русски
wb_describe_methodописывает метод, риск и лимит
wb_call_methodвыполняет метод на чтение
wb_write_methodменяет данные с подтверждением
wb_get_rawчитает любой путь API
wb_fetch_allсобирает все страницы ответа
wb_list_workflowsперечисляет готовые сценарии
wb_get_salesвыгружает продажи и возвраты WB
wb_get_stocksпоказывает остатки WB
wb_get_new_ordersпоказывает новые заказы FBS
wb_get_pricesпоказывает цены и скидки WB
wb_set_priceменяет цену и скидку WB
ozon_get_productsперечисляет товары Ozon
ozon_get_pricesпоказывает цены и индексы цен Ozon
ozon_get_fbs_unfulfilledпоказывает несобранные отправления FBS
ym_get_campaignsперечисляет магазины на Маркете
ym_get_ordersчитает заказы магазина на Маркете
ym_get_stocksпоказывает остатки по складам Маркета
avito_get_ordersчитает заказы Авито Доставки
avito_update_stockменяет остаток объявления

Показано 20 из 106.

Что попросить агента

«Покажи продажи за неделю на WB и Ozon и сравни»Агент выгрузит продажи WB через wb_get_sales, для Ozon найдёт метод через ozon_search_methods и вызовет ozon_call_method
«Какие заказы на Яндекс Маркете ждут отгрузки сегодня?»Агент получит магазины через ym_get_campaigns и прочитает заказы через ym_get_orders
«Какие товары на Ozon с красным индексом цены?»Агент вызовет ozon_get_prices: он отдаёт цены, комиссии и индексы цен по товарам
«Что ты умеешь по моему кабинету?»Агент покажет готовые сценарии через wb_list_workflows и такие же инструменты других площадок
«Подними цену на товар <артикул> на 5%»Агент прочитает цену через wb_get_prices и подготовит wb_set_price; цена уйдёт в кабинет только с confirm_write=true после вашего подтверждения

Для каких задач

Сравнить продажи за неделю на WB и Ozon
Показать заказы на Яндекс Маркете, которые ждут отгрузки сегодня
Подтвердить новые заказы Авито Доставки и найти, где кончается остаток
Посчитать дни покрытия по остаткам и продажам и подсказать, что дозаказать
Найти товары на Ozon с красным индексом цены
Собрать отзывы ниже 4 звёзд за неделю и сгруппировать жалобы по товару

Ограничения

!

Сторонний проект одного автора, Ильи Утова, в статусе alpha: вживую выверено ядро (продажи, остатки, цены, финансы, отзывы), каталоги Яндекс Маркета и Авито на реальных кабинетах ещё не прогонялись

!

Ключи дают доступ к кабинету, где двигаются цены, остатки и деньги: запись идёт с confirm_write=true, удаление требует ещё i_understand_this_modifies_data=true

!

У импортированных из спецификаций методов HTTP-глагол бывает неверным, тогда API отвечает 405; рекламный Ozon Performance вживую не выверен

!

В HTTP-режиме своей авторизации нет: кто дотянулся до порта, работает с вашими ключами

Если не работает

Не проходит авторизация Wildberries
Сервер отправляет токен WB как есть, без префикса Bearer: проверьте это первым делом.
Необъяснимый 401 или ошибка «Client-Id should be positive integer»
Активный кабинет в ~/.marketplace-mcp/cabinets.json главнее переменных окружения: проверьте ключи в этом файле.
Метод отвечает 405
У методов, импортированных из спецификаций, глагол бывает неверным. Сверьте глагол и тело с документацией площадки или вызовите путь через raw-инструменты.
Ozon отвечает 404
Ozon меняет версии методов (list v3, attributes v4, prices v5): проверьте версию в пути.
На Windows сервер не запускается
Чаще всего мешает заглушка Python из Microsoft Store. Отключите псевдонимы python.exe и python3.exe в параметрах приложений или поставьте Python с python.org раньше WindowsApps в PATH, затем полностью перезапустите Claude Desktop.

Частые вопросы

Куда уходят ключи от кабинетов?
Они лежат локально в ~/.marketplace-mcp/cabinets.json с правами 600 и не попадают в репозиторий и в чат. Сервер работает на том же компьютере, что и ваш агент.
Как подключить несколько магазинов?
Добавьте кабинет прямо из чата инструментом *_add_cabinet, например wb_add_cabinet, и переключайтесь через *_use_cabinet. Активный кабинет из cabinets.json важнее переменных окружения.
Как проверить, что всё работает?
Выполните uvx marketplaces-mcp-ru doctor --live: команда покажет по каждому серверу, сколько инструментов загрузилось и найдены ли ключи, и сделает по одному чтению в каждый кабинет. Код возврата 0 значит, что все кабинеты ответили.
Можно поставить только одну площадку?
Да, у автора есть отдельные пакеты wildberries-mcp-ru, ozon-mcp-ru, yandex-market-mcp-ru и avito-mcp-ru с тем же кодом. Из этого пакета отдельные серверы запускаются командами wb-mcp, ozon-mcp, ozon-perf-mcp, yandex-mcp и avito-mcp.
Можно запустить сервер удалённо?
Да, через Docker-образ ghcr.io/ilyautov/marketplaces-mcp-ru с MCP_TRANSPORT=http и MCP_HTTP_HOST=0.0.0.0: сервер поднимется на порту 8000 по адресу /mcp. Закройте его прокси или файрволом, авторизации у этого режима нет.
Что такое marketplaces-mcp-ru от ilyautov?
MCP-сервер Ильи Утова (ilyautov на GitHub) для кабинетов Wildberries, Ozon, Яндекс Маркета и Авито. Внутри пять серверов на общем ядре: WB, Ozon Seller, Ozon Performance, Яндекс Маркет и Авито, в каталогах 1022 метода. Лицензия MIT.
Где скачать marketplaces-mcp-ru?
Код лежит в репозитории ilyautov/marketplaces-mcp-ru, пакет marketplaces-mcp-ru опубликован в PyPI и npm, образ — ghcr.io/ilyautov/marketplaces-mcp-ru. В GitHub Releases есть .mcpb для Claude Desktop и .zip с установщиком двойным кликом.
Как подключить Wildberries к Claude?
В Claude Desktop скачайте .mcpb из GitHub Releases и дважды кликните: расширение встанет само и спросит токен WB в настройках. В Claude Code можно попросить агента «установи marketplaces-mcp-ru» или взять команду из вкладки Claude Code. Токен WB выпускается в seller.wildberries.ru → Настройки → Доступ к API.
Есть ли MCP для WB отдельно от других площадок?
Да: пакет wildberries-mcp-ru ставит только Wildberries с тем же каталогом из 307 методов, а из marketplaces-mcp-ru сервер WB запускается командой wb-mcp. Второй сервер, wildberries-mcp на Node.js, описан на странице Wildberries MCP.
Работает ли сервер из России?
Сервер запускается на вашем компьютере и ходит в API площадок по ключам из ваших кабинетов, без браузера; зарубежные аккаунты не нужны.

Похожие серверы