WB MCP Server

Управляйте магазинами Wildberries из чата с ИИ-ассистентом. 202 инструмента Seller API — карточки, цены, реклама, поставки, отзывы, финансы, аналитика — доступны Claude, Cursor, Copilot, Gemini CLI и любому другому MCP-клиенту. Для продавцов WB, у которых один или несколько кабинетов и нет желания кликать в личном кабинете то, что можно спросить словами.

Торгуете ещё и на Ozon? Есть такой же сервер для Ozon.

Сервер в ежедневной работе больше пяти месяцев, на порядка двадцати кабинетах WB, 202 инструмента. Это личный рабочий инструмент автора, и обновляется он по мере собственной необходимости — как именно.

Ты: Какие мои карточки заблокированы и почему?
Ты: Покажи ДРР по всем кампаниям за неделю и выключи те, где он выше 15%.
Ты: На каких складах коэффициент приёмки сейчас 0 или 1?
Ты: Ответь на все новые отзывы с оценкой 5 благодарностью.

Что умеет

202 инструмента, сгруппированные по разделам Wildberries Seller API. Полный нумерованный список с описанием каждого — в docs/tools.md.

Три вещи, которых обычно нет у похожих серверов:

• Мульти-магазин. Каждый вызов принимает shop_id, поэтому два кабинета WB живут в одном диалоге. Если магазин один — shop_id можно не указывать.
• Диагностика WB API. Сервер сам пингует хосты WB, делает лёгкие пробные запросы по каждой категории, разбирает срок действия и права токена и подсвечивает «деградации»: инструмент раньше работал, а теперь стабильно падает — верный признак, что WB изменил API.
• Шифрование токенов. Токены WB лежат зашифрованными (Fernet), а не в конфиге клиента.

Быстрый старт

Вариант 1: одна команда, без Docker

Сервер работает по stdio — так его подключают Claude Desktop, Cursor, VS Code и другие MCP-клиенты. Ничего собирать не нужно:

uvx wb-mcp-server

Или через pip:

pip install wb-mcp-server
wb-mcp

Конфигурация клиента (например, claude_desktop_config.json):

{
  "mcpServers": {
    "wildberries": {
      "command": "uvx",
      "args": ["wb-mcp-server"],
      "env": {
        "WB_API_TOKEN": "ваш токен Wildberries API",
        "DATA_DIR": "~/.wb-mcp"
      }
    }
  }
}

DATA_DIR укажите на любой доступный для записи каталог — там хранятся магазины, ключи и статистика. По умолчанию используется /data (путь для Docker).

Вариант 2: Docker с веб-интерфейсом

Нужен, если хотите дашборд, диагностику WB API и удобное добавление магазинов через браузер. Понадобится Docker (Docker Desktop или OrbStack) и токен Wildberries Seller API.

git clone https://github.com/DeviceIngineering/wb-mcp-server.git
cd wb-mcp-server
cp .env.example .env          # для локального запуска можно оставить как есть
docker compose up -d --build

Проверка:

curl -s http://localhost:8001/api/health
# {"status":"ok","auth_enabled":false,"health_check_interval_min":30,...}

Что открылось:

Дальше:

1. Откройте http://localhost:8001/shops → Добавить магазин → вставьте токен WB → Проверить. Токен берётся в портале продавца: Настройки → Доступ к API → Создать токен (срок жизни 180 дней, остаток виден на странице диагностики).
2. Подключите MCP-клиент — см. следующий раздел.
3. Спросите ассистента: «покажи список моих магазинов на Wildberries» — должен сработать инструмент wb_list_shops.

Разбор команды запуска:

Остановить: docker compose down (данные останутся в томе wb_data). Логи: docker compose logs -f.

git clone https://github.com/DeviceIngineering/wb-mcp-server.git
cd wb-mcp-server
python3 -m venv .venv && source .venv/bin/activate
pip install .
DATA_DIR=./data PORT=8001 python -m wb_mcp.app

Установка в клиенты

Сервер отдаёт MCP по SSE: GET /sse — поток событий, POST /messages — сообщения клиента. Поддержка SSE у клиентов разная, поэтому под каждый есть отдельная инструкция — с путями к конфигу на macOS, Linux и Windows, готовым JSON и вариантами с токеном и без.

Общий обзор и таблица совместимости — docs/README.md.

Где у клиента есть команда, настраивающая подключение самостоятельно, инструкция начинается с неё, а правка JSON идёт вторым способом. Самый короткий вариант — Claude Code:

claude mcp add --transport sse wildberries http://localhost:8001/sse
claude mcp list      # ожидается: wildberries ... ✔ Connected

Мульти-магазин и безопасность

Несколько кабинетов. Магазины добавляются на /shops, каждый получает свой shop_id. Инструмент wb_list_shops возвращает список; 200 из 202 инструментов принимают shop_id первым параметром (исключения — wb_list_shops и wb_degradations). Если магазин один, параметр можно опустить: сервер подставит единственный доступный.

Read the full README on GitHub →