Wildberries MCP

ilyautov/marketplaces-mcp-ru· Проверено 12.11.2026· 62на GitHub

Подключает агента к кабинету продавца Wildberries через Seller API: продажи, заказы, остатки, цены, поставки FBS, финотчёт, отзывы, вопросы и реклама. Агент отвечает цифрами из API, без браузера и капчи.

2 реализации:

Один сервер на Wildberries, Ozon, Яндекс Маркет и Авито: 307 методов WB через мета-инструменты, готовые сценарии и запись только с подтверждением.

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

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

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

WB_API_TOKEN

seller.wildberries.ru → Настройки → Доступ к API

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

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

claude mcp add --env 'WB_API_TOKEN=<токен WB>' --transport stdio wildberries \
  -- uvx marketplaces-mcp-ru

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

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.wildberries]
command = "uvx"
args = ["marketplaces-mcp-ru"]

[mcp_servers.wildberries.env]
WB_API_TOKEN = "<токен WB>"

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "wildberries": {
      "command": "uvx",
      "args": ["marketplaces-mcp-ru"],
      "env": {
        "WB_API_TOKEN": "<токен WB>"
      }
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "wildberries": {
      "type": "stdio",
      "command": "uvx",
      "args": ["marketplaces-mcp-ru"],
      "env": {
        "WB_API_TOKEN": "<токен WB>"
      }
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "wildberries": {
      "command": "uvx",
      "args": ["marketplaces-mcp-ru"],
      "env": {
        "WB_API_TOKEN": "<токен WB>"
      }
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "wildberries": {
      "command": "uvx",
      "args": ["marketplaces-mcp-ru"],
      "env": {
        "WB_API_TOKEN": "<токен WB>"
      }
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "wildberries": {
        "type": "local",
        "command": ["uvx", "marketplaces-mcp-ru"],
        "environment": {
          "WB_API_TOKEN": "<токен WB>"
        }
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

{
  "mcpServers": {
    "wildberries": {
      "command": "uvx",
      "args": ["marketplaces-mcp-ru"],
      "env": {
        "WB_API_TOKEN": "<токен WB>"
      }
    }
  }
}

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "wildberries": {
      "command": "uvx",
      "args": ["marketplaces-mcp-ru"],
      "env": {
        "WB_API_TOKEN": "<токен WB>"
      }
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

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

wb_check_authпроверяет наличие ключей

wb_search_methodsищет метод API по-русски

wb_describe_methodописывает метод и его лимиты

wb_call_methodвыполняет метод на чтение

wb_write_methodвносит изменения с подтверждением

wb_delete_methodудаляет с двойным подтверждением

wb_get_rawчитает любой путь API

wb_fetch_allсобирает все страницы ответа

wb_get_salesвыгружает продажи

wb_get_stocksвыгружает остатки

Только Wildberries: 30 готовых инструментов на Node.js, от поставок FBS до ABC-анализа и рекламного баланса.

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

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

Node.js с npx

WB_API_TOKEN

seller.wildberries.ru → Настройки → Доступ к API; JWT живёт 180 дней, включите в нём нужные категории доступа

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

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

claude mcp add --env 'WB_API_TOKEN=<токен WB>' --transport stdio wildberries-mcp \
  -- npx -y @theyahia/wildberries-mcp

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.wildberries-mcp]
command = "npx"
args = ["-y", "@theyahia/wildberries-mcp"]

[mcp_servers.wildberries-mcp.env]
WB_API_TOKEN = "<токен WB>"

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "wildberries-mcp": {
      "command": "npx",
      "args": ["-y", "@theyahia/wildberries-mcp"],
      "env": {
        "WB_API_TOKEN": "<токен WB>"
      }
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "wildberries-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@theyahia/wildberries-mcp"],
      "env": {
        "WB_API_TOKEN": "<токен WB>"
      }
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "wildberries-mcp": {
      "command": "npx",
      "args": ["-y", "@theyahia/wildberries-mcp"],
      "env": {
        "WB_API_TOKEN": "<токен WB>"
      }
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "wildberries-mcp": {
      "command": "npx",
      "args": ["-y", "@theyahia/wildberries-mcp"],
      "env": {
        "WB_API_TOKEN": "<токен WB>"
      }
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "wildberries-mcp": {
        "type": "local",
        "command": ["npx", "-y", "@theyahia/wildberries-mcp"],
        "environment": {
          "WB_API_TOKEN": "<токен WB>"
        }
      }
    }
  }
}

{
  "mcpServers": {
    "wildberries-mcp": {
      "command": "npx",
      "args": ["-y", "@theyahia/wildberries-mcp"],
      "env": {
        "WB_API_TOKEN": "<токен WB>"
      }
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "wildberries-mcp": {
      "command": "npx",
      "args": ["-y", "@theyahia/wildberries-mcp"],
      "env": {
        "WB_API_TOKEN": "<токен WB>"
      }
    }
  }
}

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

list_productsперечисляет карточки товаров

update_pricesменяет цены

update_stocksменяет остатки FBS

get_ordersчитает заказы

get_new_ordersпоказывает новые заказы

get_salesпоказывает продажи

get_fbw_stocksпоказывает остатки на складах WB

create_supplyсоздаёт поставку FBS

add_orders_to_supplyдобавляет заказы в поставку

deliver_supplyзакрывает поставку на отгрузку

get_supply_barcodeвыдаёт штрихкод поставки

get_statisticsстроит отчёт о реализации

get_abc_analysisделает ABC-анализ

get_funnelпоказывает воронку карточки

get_paid_storageсчитает платное хранение

get_commissionпоказывает комиссии

get_feedbacksчитает отзывы

reply_feedbackотвечает на отзыв

reply_questionотвечает на вопрос

get_campaign_statsпоказывает статистику рекламы

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

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

«Покажи первые 50 товаров каталога с текущими ценами»В wildberries-mcp агент вызовет list_products

«Сделай ABC-анализ за последние 30 дней: какие товары дают 80% выручки?»В wildberries-mcp агент вызовет get_abc_analysis

«Создай поставку FBS «<название>», добавь заказы <номера>, закрой её на отгрузку и дай штрихкод»Агент вызовет create_supply, add_orders_to_supply, deliver_supply и get_supply_barcode

«Вытащи финотчёт реализации WB за прошлый месяц»В marketplaces-mcp-ru агент найдёт метод через wb_search_methods и выгрузит отчёт wb_fetch_all, в wildberries-mcp вызовет get_statistics

«Что пора дозаказать? Посчитай дни покрытия по остаткам и продажам»Агент вызовет wb_get_stocks и wb_get_sales и разделит остаток на средние продажи в день

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

Вытащить финотчёт реализации WB за прошлый месяц

Посчитать дни покрытия по остаткам и продажам и подсказать, что дозаказать

Сделать ABC-анализ и найти товары, которые дают 80% выручки

Создать поставку FBS, добавить в неё заказы и получить штрихкод

Показать неотвеченные вопросы и набросать ответы

Проверить рекламный баланс и активные кампании

Ограничения

Токену нужны категории доступа под каждую задачу: без категории соответствующий хост API ответит 401

Wildberries считает запросы по каждой категории отдельно и за всплески штрафует ответом 409

marketplaces-mcp-ru в статусе alpha: вживую выверено ядро (продажи, остатки, цены, финансы, отзывы), у импортированных методов HTTP-глагол бывает неверным

Токен WB живёт 180 дней, потом его нужно выпустить заново

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

Один инструмент падает с 401 и адресом хоста, например advert-api.wildberries.ru, а остальные работают

У токена нет категории доступа для этого хоста. Выпустите токен с нужными категориями в кабинете продавца: Настройки → Доступ к API.

API отвечает 409

Wildberries штрафует за всплески запросов отдельно по каждой категории. Сервер сам читает X-Ratelimit-Retry-After и повторяет запрос после паузы.

В marketplaces-mcp-ru не проходит авторизация WB

Сервер отправляет токен как есть, без префикса Bearer: проверьте это первым делом.

Необъяснимый 401 в marketplaces-mcp-ru, хотя ключ в переменных окружения верный

Активный кабинет в ~/.marketplace-mcp/cabinets.json главнее переменных окружения: проверьте токен в этом файле.

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
marketplaces-mcp-ru	Илья Утов	62	локально	токен	10	11 ноября 2026
wildberries-mcp	theYahia	16	локально	токен	30	6 сентября 2026

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

Где взять токен Wildberries?

В кабинете продавца: seller.wildberries.ru → Настройки → Доступ к API. При выпуске отметьте категории: Контент, Цены и скидки, Маркетплейс, Статистика, Аналитика, Отзывы и вопросы, Возвраты, Реклама.

Почему авторизация падает с 401?

Обычно в токене нет категории для этого раздела API, и ошибка придёт только от его хоста. marketplaces-mcp-ru шлёт токен без префикса Bearer; если в cabinets.json задан другой активный кабинет, он важнее переменной окружения.

Какой вариант выбрать?

wildberries-mcp даёт 30 понятных инструментов под частые задачи продавца и ставится через npx. marketplaces-mcp-ru покрывает 307 методов WB и ещё три площадки, а перед изменением цены или остатка просит подтверждение.

Какие готовые сценарии есть для WB?

В marketplaces-mcp-ru: пульс продаж, здоровье остатков, аудит цен, планировщик дозаказа, ABC-анализ и сводка отзывов. Спросите агента «что ты умеешь по моему кабинету», и он их покажет.

Работает ли сервер из России?

Оба сервера запускаются на вашем компьютере и обращаются к Seller API по токену из кабинета; зарубежные аккаунты не нужны.

Wildberries MCP

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

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

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

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

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

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

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

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

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

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

Ограничения

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

Какую реализацию выбрать

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

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