wb-mcp-server

Автор: Дмитрий Косик · 📢 Telegram-канал @dmkosik · 💬 Связь с автором @feeyh

MCP-сервер для Wildberries Seller API. Подключите AI-агента (Claude Desktop, OpenClaw, любой MCP-клиент) к вашему магазину на Wildberries.

Сервер переводит MCP tool calls в REST-запросы к API Wildberries (dev.wildberries.ru), позволяя AI-агентам работать с отзывами, аналитикой, заказами, остатками и рекламой.

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

1. Установите пакет

npm install -g wb-mcp-server

2. Получите WB API токен

1. Войдите в личный кабинет продавца WB
2. Перейдите в Настройки > Доступ к API
3. Создайте новый токен с нужными правами (статистика, аналитика, продвижение, отзывы)
4. Скопируйте токен

3. Добавьте в конфиг Claude Desktop

Откройте файл конфигурации Claude Desktop и добавьте:

{
  "mcpServers": {
    "wildberries": {
      "command": "wb-mcp-server",
      "env": {
        "WB_API_TOKEN": "ваш_токен"
      }
    }
  }
}

Готово! Теперь Claude может работать с вашим магазином на WB.

Windows: ошибка spawn wb-mcp-server ENOENT

Если Claude Desktop не находит команду wb-mcp-server, используйте npx:

{
  "mcpServers": {
    "wildberries": {
      "command": "npx",
      "args": ["-y", "wb-mcp-server"],
      "env": {
        "WB_API_TOKEN": "ваш_токен"
      }
    }
  }
}

Это часто случается с версией Claude Desktop из Microsoft Store, которая не видит путь к глобальным npm-пакетам.

Обновление до актуальной версии

Новые версии выходят регулярно — например, в v0.4.0 добавлено 10 новых инструментов (эквайринг, сводный финотчёт, карточки товаров, поставки FBS, документы, информация о продавце, рейтинг). Автоматически сервер не обновляется — нужно обновить вручную.

Шаг 1. Обновите пакет

Если установлен глобально (в конфиге Claude Desktop "command": "wb-mcp-server"):

npm install -g wb-mcp-server@latest

Если через npx (в конфиге "command": "npx"):

npx -y wb-mcp-server@latest

Если npx продолжает подтягивать старую версию — очистите кэш:

npm cache clean --force

Шаг 2. Полностью перезапустите Claude Desktop

Закройте приложение через иконку в трее (не просто крестик в окне), затем откройте заново. Иначе Claude продолжит использовать старый процесс сервера.

Шаг 3. Проверьте версию

npm list -g wb-mcp-server

Или спросите у Claude: «Какие инструменты wb-mcp-server тебе доступны?» — в v0.4.2 должно быть 29 инструментов.

Доступные инструменты (29)

Отзывы и вопросы

| Инструмент | Описание | Тип | |---|---|---| | get_feedbacks | Получить список отзывов покупателей | read | | reply_feedback | Ответить на отзыв покупателя | write | | get_questions | Получить список вопросов покупателей | read | | reply_question | Ответить на вопрос покупателя | write | | get_unanswered_count | Количество неотвеченных отзывов | read |

Статистика и аналитика

| Инструмент | Описание | Тип | |---|---|---| | get_stocks | Остатки товаров на складах | read | | get_orders | Список заказов | read | | get_sales | Данные о продажах (выкупах) | read | | get_incomes | Поступления товаров на склады WB (приёмки) | read | | get_financial_report | Детализация реализации: комиссии, логистика, хранение, штрафы | read | | get_nm_report | Детальный отчёт по товарам (просмотры, корзина, заказы, выкупы) | read | | get_warehouses_inventory | Актуальный отчёт по остаткам на складах (асинхронный) | read | | get_item_rating | Рейтинг продавца + прирост отзывов по звёздам | read |

Реклама

| Инструмент | Описание | Тип | |---|---|---| | get_advert_list | Список рекламных кампаний | read | | get_advert_stats | Статистика рекламных кампаний | read | | get_advert_balance | Баланс рекламного кабинета | read | | update_advert_bid | Изменить ставки в рекламной кампании | write |

Цены

| Инструмент | Описание | Тип | |---|---|---| | get_prices | Список товаров с ценами и скидками | read | | update_prices | Обновить цены и скидки | write |

Финансы

| Инструмент | Описание | Тип | |---|---|---| | get_seller_balance | Текущий баланс продавца | read | | get_sales_reports_summary | Сводные финотчёты по неделям (для дашборда) | read | | get_acquiring_report_list | Сводные отчёты по эквайрингу | read | | get_acquiring_report | Построчные комиссии банка-эквайера | read |

Карточки товаров

| Инструмент | Описание | Тип | |---|---|---| | get_content_cards | Список карточек товаров с курсорной пагинацией | read |

Поставки FBS

| Инструмент | Описание | Тип | |---|---|---| | get_supplies | Список поставок FBS | read | | create_supply | Создать новую открытую поставку FBS | write |

Документы

| Инструмент | Описание | Тип | |---|---|---| | get_documents | Список финдокументов: УПД, отчёты, акты, уведомления | read |

Информация о продавце

| Инструмент | Описание | Тип | |---|---|---| | get_seller_info | Имя, ИНН, торговая марка | read | | get_jam_subscription | Подписка Jam (требует Service token) | read |

Примеры использования

Спросите у AI-агента (после подключения MCP-сервера):

• "Сколько у меня неотвеченных отзывов?"
• "Покажи последние 10 негативных отзывов (оценка 1-2)"
• "Ответь на все вопросы покупателей"
• "Покажи продажи за последнюю неделю"
• "Какой у меня рейтинг продавца и динамика отзывов по звёздам?"
• "Дай недельную сводку по финансам: выплаты, логистика, хранение, штрафы"
• "Какие финансовые документы (УПД, акты, отчёты) пришли за месяц?"
• "Покажи комиссии эквайринга за период"
• "Какой у меня баланс и сколько можно вывести?"
• "Найди карточку товара по nmID 391083595"
• "Покажи список открытых поставок FBS"
• "Какая статистика по рекламным кампаниям?"
• "Сколько товара осталось на складах?"

Конфигурация

Переменные окружения

| Переменная | Описание | Обязательна | |---|---|---| | WB_API_TOKEN | Токен WB Seller API | Да |

Аргументы командной строки

wb-mcp-server --token=ваш_токен

Разработка

# Клонируйте репозиторий
git clone https://github.com/dmitriykosik74-rgb/wb-mcp-server.git
cd wb-mcp-server

# Установите зависимости
npm install

# Запуск в режиме разработки
WB_API_TOKEN=ваш_токен npm run dev

# Сборка
npm run build

# Тесты
npm test

Contributing

1. Форкните репозиторий
2. Создайте ветку для фичи (git checkout -b feature/my-feature)
3. Сделайте коммит (git commit -m 'feat: add my feature')
4. Запушьте ветку (git push origin feature/my-feature)
5. Создайте Pull Request

Лицензия

MIT