MCP-сервер Wildberries на OpenAPI
Wildberries MCP Server
Локальный MCP-сервер Wildberries Seller API на 279 методов из OpenAPI-каталога, вызовы по умолчанию в режиме dry-run
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Каталог покрывает и операции записи по заказам, ценам и контенту, доступные через явный флаг allow_write
- wb_raw_request позволяет вызывать произвольные эндпоинты вне каталога
Установка
Ручная установка
git clone https://github.com/Jerardx/wildberries-mcp-server.gitКлонирование, дальше нужны виртуальное окружение и requirements.txt.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер устроен как тонкий адаптер поверх общего клиента wb_client.py: авторизация, лимиты запросов, повтор при 429 и защита от записи собраны в одном месте, а MCP только отдает инструменты агенту. Каталог из OpenAPI-спецификаций Wildberries покрывает 279 операций по категориям аналитика, коммуникации, финансы, заказы FBS, DBS, DBW и FBW, товары, продвижение, отчеты, тарифы, и для каждого метода известен лимит запросов. Агент сначала ищет нужный метод через wb_search_methods или готовый бизнес-рецепт wb_get_recipe, читает его описание через wb_describe_method, а вызывает через wb_call_method или wb_raw_request. По умолчанию любой вызов идет в режиме dry_run, реальная запись требует явного allow_write.
Для кого. Для разработчиков и продавцов, которым нужен полный охват Wildberries Seller API с безопасным режимом проверки вызова перед реальной записью.
Подходит, если
- Нужен полный каталог методов Wildberries Seller API с известными лимитами по каждому
- Важно, чтобы агент сначала проверил вызов в режиме dry-run и только потом писал данные
- Нужны готовые русские бизнес-рецепты вроде продаж, остатков или FBS-заказов
Не подходит, если
- Нужен готовый пакет с релизом, а не установка из исходников приватного репозитория
- Нужны только несколько операций, а не весь каталог из 279 методов
Пример запроса к агенту
Найди метод Wildberries для получения остатков на складах и покажи, какой у него лимит запросовОграничения
README сам называет репозиторий приватным, установка только из исходников через git clone и виртуальное окружение Python. Лицензия не указана. Секреты и реальные бизнес-выгрузки в репозиторий не входят, токен нужно завести самостоятельно.
Как отключить. Удалите сервер wildberries из конфигурации MCP клиента.
MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| WILDBERRIES_API обязательная, секрет | Токен продавца Wildberries |
Проверка безопасности
- Каталог покрывает и операции записи по заказам, ценам и контенту, доступные через явный флаг allow_write
- wb_raw_request позволяет вызывать произвольные эндпоинты вне каталога
Коротко о README
README перечисляет состав репозитория, текущее покрытие в 279 операций и 279 скриптов-обверток без методов без указанного лимита, шаги установки через виртуальное окружение и .env, подключение как MCP-сервер для универсального клиента, Claude Desktop, Cursor, Windsurf и Hermes Agent, список инструментов MCP и рекомендуемый порядок вызова для агента.
Частые вопросы
Может ли агент сразу писать данные в Wildberries?
Нет, вызовы по умолчанию идут в режиме dry_run, для реальной записи нужно явно передать allow_write.
Как агенту найти нужный метод среди 279?
Через wb_search_methods по описанию или через wb_get_recipe с готовым русским бизнес-сценарием.
Похожие
Официальный MCP-сервер Salesforce DX: работа с org, метаданными, данными, пользователями и тестами Apex из агента
Официальный набор скиллов Яндекса: каталог, цены, остатки, заказы, витрина и еженедельная ревизия магазина на Яндекс.Кит через Claude Code или Codex
YouGile MCP от Indalo
YouGile MCP
Полное покрытие API YouGile из 65 операций с настраиваемыми правами, подтверждением записи и общим лимитом на компанию
Официальный MCP конкретного портала Битрикс24: внешний агент по OAuth или токену читает и меняет задачи, сделки, встречи и письма