WB MCP Server
MCP-сервер Seller API Wildberries: карточки, цены, акции, реклама, заказы, поставки, отзывы и финансы для нескольких кабинетов
Установка
{
"mcpServers": {
"wildberries": {
"command": "uvx",
"args": ["wb-mcp-server"],
"env": {
"WB_API_TOKEN": "your Wildberries API token",
"DATA_DIR": "~/.wb-mcp"
}
}
}
}Режим stdio без Docker. DATA_DIR должен указывать на папку с правом записи.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер покрывает большую часть Seller API Wildberries: карточки товаров и карточки с ошибками, цены и скидки, акции, рекламные кампании со ставками и минус-фразами, аналитику и воронку продаж, сборочные задания FBS и DBS, поставки FBW с коэффициентами приемки, склады и остатки, отчеты о реализации, отзывы, вопросы и чаты с покупателями. Каждый вызов принимает shop_id, поэтому несколько кабинетов доступны в одном диалоге. В Docker-режиме есть веб-панель со статистикой вызовов, добавлением магазинов и диагностикой токенов и API WB, которая замечает, когда метод, работавший раньше, начал стабильно падать. Токены магазинов хранятся зашифрованными.
Для кого. Для продавцов и менеджеров Wildberries, которые ведут один или несколько кабинетов и хотят управлять ими словами.
Подходит, если
- Нужно найти заблокированные карточки и причины блокировки
- Нужно посмотреть ДРР по кампаниям и остановить неэффективные
- Нужно выбрать склад с низким коэффициентом приемки
- Нужно ответить на новые отзывы по шаблону
Не подходит, если
- Торгуете на Ozon или Яндекс Маркете: у автора есть отдельный сервер для Ozon
- Нет возможности держать сервер в закрытой сети: веб-панель не защищена токеном
Пример запроса к агенту
Какие мои карточки заблокированы и почему? И на каких складах сейчас коэффициент приемки 0 или 1?Ограничения
Нужен токен Seller API Wildberries, он действует 180 дней, права на запись выдаются отдельно. У WB жесткие лимиты: часть методов допускает несколько запросов в минуту, ответ 4XX считается за десять запросов, а все кабинеты на одном сервере делят лимит одного IP. Веб-интерфейс не закрыт токеном и не должен быть доступен из интернета, HTTPS сервер не терминирует. Ключ шифрования лежит рядом с данными. Автор развивает сервер под свои задачи.
Как отключить. Выполните claude mcp remove wildberries или удалите блок из конфигурации клиента, для Docker остановите docker compose down. Токен WB отзовите в портале продавца.
MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| WB_API_TOKEN секрет | Токен Seller API, в Docker-режиме магазины удобнее добавить через веб-панель |
| DATA_DIR | Папка для магазинов, ключа и статистики, по умолчанию /data |
| MCP_AUTH_TOKEN секрет | Токен для /sse и /messages, обязателен при доступе из внешней сети |
Проверка безопасности
- Меняет цены, ставки и рекламный бюджет в рабочих кабинетах
- Хранит токены нескольких магазинов
- Веб-панель без авторизации опасна в открытой сети
Коротко о README
README на английском, русском и китайском описывает разделы Seller API и число инструментов в каждом, полный список вынесен в docs/tools.md. Показаны два пути: запуск через uvx или pip со stdio и Docker с веб-панелью и SSE. Для одиннадцати клиентов есть отдельные инструкции на русском. Большой раздел посвящен мультикабинету, лимитам WB, хранению токенов и тому, чего сервер не защищает. Лицензия MIT.
Частые вопросы
Сколько кабинетов можно подключить?
В коде ограничения нет, но все кабинеты ходят в WB с одного IP и делят лимиты. Автор считает безопасным около двадцати кабинетов на адрес.
Нужен ли Docker?
Нет, stdio-режим запускается командой uvx wb-mcp-server. Docker нужен для веб-панели, диагностики и SSE.
Похожие
Официальный 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 через входящий вебхук: поиск, списки и смена стадии сделки