Wildberries MCP
wildberries-mcp
MCP-сервер для API продавца Wildberries: товары, цены, остатки, заказы, поставки FBS, аналитика, отзывы и реклама
Установка
{
"mcpServers": {
"wildberries": {
"command": "npx",
"args": ["-y", "@theyahia/wildberries-mcp"],
"env": { "WB_API_TOKEN": "your_token_here" }
}
}
}Добавьте в claude_desktop_config.json. Cursor, Windsurf и VS Code используют тот же блок.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер подключает кабинет продавца Wildberries к агенту через 30 инструментов. Агент читает карточки, заказы, продажи, остатки на складах WB, отчеты о реализации, воронку и платное хранение, считает ABC-анализ. Он также может менять цены и остатки, создавать поставки FBS и добавлять в них заказы, отвечать на отзывы и вопросы. Каждый запрос уходит на хост нужной категории API, а встроенный лимитер учитывает штрафы 409 отдельно по категориям. В репозитории есть три простых скилла для Claude Code: заказы за сегодня, аналитика продаж и товары с малым остатком.
Для кого. Для продавцов Wildberries и их менеджеров, которые хотят спрашивать о кабинете обычными словами.
Подходит, если
- Нужна сводка продаж и ABC-анализ за период
- Нужно найти товары, которые заканчиваются на складе
- Нужно разобрать неотвеченные вопросы и отзывы
Не подходит, если
- Нельзя допускать изменения цен и остатков без ручной проверки
- Нужна аналитика конкурентов, а не своего кабинета
Пример запроса к агенту
Сделай ABC-анализ за последние 30 дней и покажи товары, которые дают 80% выручкиОграничения
Нужен токен API из кабинета продавца с нужными категориями доступа, срок жизни токена 180 дней. Если категории нет, инструменты этой категории вернут 401. Инструменты записи меняют реальные цены, остатки и поставки. Проект неофициальный, входит в серию WWmcp того же автора.
Как отключить. Удалите блок wildberries из конфигурации MCP клиента и при глобальной установке выполните npm uninstall -g @theyahia/wildberries-mcp.
MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| WB_API_TOKEN обязательная, секрет | Токен API продавца Wildberries (JWT) |
| WB_TIMEOUT_MS | Таймаут запроса в миллисекундах, по умолчанию 30000 |
| PORT | Порт для режима --http, по умолчанию 3000 |
Проверка безопасности
- Меняет цены и остатки в живом кабинете продавца
- Создает и закрывает поставки FBS, публикует ответы на отзывы
- Хранит токен API продавца
Коротко о README
README на русском описывает быстрый старт через npm, конфигурацию для Claude Desktop и установку через Smithery. Приведена таблица, какие категории токена нужны каждому инструменту, и схема хостов API Wildberries. Отдельный раздел объясняет, как сервер соблюдает лимиты и обрабатывает штраф 409. В конце есть примеры запросов и команды для разработки. Лицензия MIT.
Частые вопросы
Почему часть инструментов возвращает 401?
У токена нет нужной категории доступа. В тексте ошибки указан хост, по нему видно, какую категорию включить.
Можно ли запустить по HTTP?
Да, с флагом --http сервер работает через Streamable HTTP на порту из переменной PORT, по умолчанию 3000.
Похожие
Официальный 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 через входящий вебхук: поиск, списки и смена стадии сделки