wb-mcp
Connects an AI assistant to a Wildberries seller account so it can search, inspect, read, and safely modify real WB Seller API data.
Search and describe WB API methods with
wb_searchandwb_describe.Read orders, sales, stocks, products, prices, reviews, questions, ads, supplies, finances, and documents with
wb_get.Make changes such as prices, stocks, review replies, and ad rates with
wb_call, with confirmation and read-only safeguards.Inspect available API sections, token coverage, and token metadata via
wb_sectionsandwb_token_info.Send raw HTTP requests only to allowed
*.wildberries.ruhosts viawb_request.Refresh the local API method catalog from Wildberries OpenAPI specs with
wb_refresh.Work with multiple seller accounts, encrypted local token storage, rate-limit handling/retries, and large-report saving.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@wb-mcp покажи неотвеченные отзывы и предложи ответы"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
wb-mcp
Подключает кабинет Wildberries к вашему ИИ-ассистенту (Cursor, Claude, Codex, Gemini, VS Code). Ассистент работает с настоящими заказами, остатками, продажами, отзывами и ценами из WB — а не придумывает их.
Зачем это нужно
Ассистент сам знает, что спросить у Wildberries. Не нужно объяснять ему команды и пути к методам API — он находит нужное по обычной просьбе: «сколько заказов вчера», «почему упали продажи», «какие товары заканчиваются».
Работает с реальными данными кабинета: заказы, продажи, остатки, товары и цены, отзывы и вопросы, реклама, поставки, финансы, документы.
Может не только читать, но и менять. Цены, остатки, ответы на отзывы, ставки в рекламе — но каждое изменение ассистент сначала показывает вам, а делает только после подтверждения.
Всё на вашем компьютере. Сервер запускается локально, ваш токен хранится в зашифрованном виде и не отправляется никуда, кроме самого Wildberries. Платить за хостинг не нужно.
Не ломает ваш кабинет. Учитывает лимиты Wildberries, повторяет запрос, если WB попросил подождать, и сохраняет большие отчёты в файл, чтобы они не занимали весь чат.
Установка занимает пару минут, а каталог методов обновляется одной командой, когда WB меняет API.
Related MCP server: marketplace-mcp
Установка
1. Получите токен Wildberries
Кабинет продавца → Настройки → Интеграции по API → Создать токен. Для начала достаточно режима «Только чтение» и минимума категорий — так ассистент не сможет ничего испортить, даже если ошибается.
2. Установите сервер
Самый простой путь — универсальный установщик. Он найдёт ваши клиенты, пропишет их конфиги, скачает каталог методов и сохранит токен в зашифрованном виде:
node install.mjs --client all --token <ваш_токен>Если репозиторий не скачан:
npx -y -p wildberries-seller-mcp wb-mcp-install --client all --token <ваш_токен>Или установите в конкретный клиент
Все установочные файлы лежат на странице Releases → catalog.
Клиент | Что сделать |
Claude Desktop | Скачайте wb-mcp.mcpb и откройте файл двойным кликом. Claude сам предложит окно, куда нужно вставить токен. |
Cursor | Установить в Cursor — откроется окно установки в Cursor. После этого откройте конфигурацию MCP и замените текст |
VS Code | Установить в VS Code — откроется окно подтверждения установки. Если окно не открылось, запустите универсальный установщик выше, результат будет тот же. |
Claude Code |
|
Codex CLI |
|
Gemini CLI |
|
Без установки | Скачайте wb-mcp-portable.zip, распакуйте и запустите |
Можно поручить установку ассистенту
Не хотите ставить руками — дайте ассистенту ссылку на репозиторий и попросите:
«Подключи wb-mcp из https://github.com/Gregory-mcbit/wildberries-mcp по инструкции AGENT-INSTALL.md»
Ассистент откроет AGENT-INSTALL.md,
скачает репозиторий, запустит установщик, сохранит токен в зашифрованном виде и проверит подключение
через doctor. Токен он спросит у вас.
3. Перезапустите ассистента и проверьте
Напишите ассистенту: «покажи разделы WB API». Если всё подключено, он покажет список разделов кабинета.
Если что-то не работает, выполните проверку — она подскажет, в чём дело:
node ~/.wb-mcp/app/doctor.mjsЧто можно попросить у ассистента
«Сколько заказов и продаж было за вчера и позавчера?»
«Почему упали продажи за неделю?»
«Какие товары скоро закончатся на складах?»
«Покажи неотвеченные отзывы и предложи ответы»
«Измени цену на этот товар на 5% ниже» — ассистент покажет, что именно изменит.
«Сделай недельный отчёт по магазину»
В комплекте есть готовые сценарии на такие задачи: полный разбор роста продаж, разбор падения
заказов, проверка остатков, работа с отзывами и недельный отчёт. В Cursor и Claude они доступны
как команды вида /sales-accelerator.
Несколько магазинов
Установите все токены сразу — каждый сохранится в отдельный зашифрованный файл, а в конфиг
попадёт только список путей WB_TOKEN_FILES:
node install.mjs --client all --accounts '{"основной":"<токен1>","второй":"<токен2>"}'Ассистент увидит все аккаунты в wb_sections и wb_token_info, а в запросе укажет account.
Файлы аккаунтов получают уникальные имена (имя + хэш), поэтому даже похожие названия не смешиваются.
Обновление
node ~/.wb-mcp/app/sync.mjs # заново скачать свежие описания методов WildberriesИли попросите ассистента: «обнови каталог Wildberries».
Безопасность
Токен хранится в зашифрованном файле (AES-256-GCM); в настройках клиента — только путь к нему. Ключ шифрования защищён системным keychain: DPAPI на Windows, Keychain на macOS, libsecret на Linux.
Запросы уходят только на адреса Wildberries и только по HTTPS —
http://блокируется.Изменяющие запросы требуют подтверждения: сервер сам останавливает запись, пока ассистент не передаст одноразовый код (действует 5 минут), а если клиент умеет — запрашивает согласие человека через
elicitation; ответ модели черезsamplingразбирается строго (любое «не» = отказ).Режим «только чтение» (
WB_READONLY=1) блокирует запись и через обычный вызов, и через сырой запросwb_request.Чтение и изменение разделены: ассистент не может незаметно что-то поменять. Если токен создан в режиме «Только чтение», изменить данные через него невозможно вообще.
Логи не содержат ваших данных: ни тел запросов, ни ответов.
Честно про подтверждение: гарантировать согласие человека может только клиент, который умеет
спрашивать пользователя (elicitation). Если клиент умеет только sampling — это запрос к модели,
и сервер страхуется строгим разбором ответа. Если клиент не умеет ни того, ни другого, остаётся
двухэтапное подтверждение агентом с одноразовым кодом, и сервер явно помечает это в ответе
(humanApproval: "unavailable"). Для максимально строгого режима задайте WB_CONFIRM_HUMAN=require:
тогда запись разрешена только при подтверждении человеком через elicitation, иначе сервер отказывает.
Честно про хранение токена: ключ шифрования хранится в системном keychain — DPAPI на Windows,
Keychain на macOS, libsecret на Linux (если сервис секретов недоступен, ключ останется файлом рядом
с данными). От вредоносной программы, работающей под вашим пользователем, ни одна из схем всё равно
не спасает. Не передавайте токен аргументом --token — он останется в истории команд; вместо этого
задайте переменную окружения WB_API_TOKEN или установите через интерактивную установку.
Лицензия
MIT — см. LICENSE. Английская версия — README.en.md.
Available Tools
8 toolswb_callWildberries API: вызов методаADestructive
Вызвать ИЗМЕНЯЮЩИЙ метод Wildberries API по id (создание/обновление/удаление: цены, карточки, заказы, поставки, реклама, ответы на отзывы). Перед вызовом предупреди пользователя о последствиях. Для чтения используй wb_get — он не требует подтверждения. Параметры path/query/header передавай в "params" по их именам из wb_describe, JSON-тело — в "body".
Inputs: id (required), body, params, account.
wb_describeWildberries API: описание методаARead-only
Показать полную схему метода: URL, обязательные параметры, тело запроса, схему ответа, лимиты и типы токенов. Используй после wb_search перед вызовом.
Inputs: id (required).
wb_getWildberries API: чтение (read-only)ARead-only
Вызвать READ-ONLY метод Wildberries API по id. Используй этот инструмент для любых чтений (диагностика, отчёты, списки, остатки, отзывы) — он не требует подтверждения и работает с токеном «Только чтение». Параметры path/query/header — в "params", тело — в "body". Для изменяющих методов используй wb_call.
Inputs: id (required), body, params, account.
wb_refreshWildberries API: обновить каталогA
Скачать свежие OpenAPI-спеки с dev.wildberries.ru и пересобрать каталог методов (когда WB меняет API). Требует сеть; занимает несколько секунд.
Inputs: lang, fromDir.
wb_requestWildberries API: сырой запросADestructive
Прямой HTTP-запрос к любому хосту *.wildberries.ru — на случай нового метода, которого ещё нет в каталоге. Разрешены только хосты wildberries.ru. Указывай url (или host+path), query, body.
Inputs: method (required), url, body, host, +4 more.
wb_searchWildberries API: поиск методаARead-only
Найти метод Wildberries Seller API по словам (например "остатки", "отзывы", "поставки", "цены"). Начни с этого инструмента. Возвращает id, метод, путь, признак readonly и краткое описание. Дальше: wb_describe для схемы, wb_call для вызова.
Inputs: query (required), mode, limit, section. Returns: object
wb_sectionsWildberries API: разделы и покрытиеARead-only
Обзор каталога: разделы WB API, число методов в каждом, состояние токенов и дата сборки каталога. Полезно в начале работы, чтобы понять какие разделы доступны.
Inputs: no named parameters. Returns: object
wb_token_infoWildberries API: информация о токенеARead-only
Локально декодирует WB API токен (без запросов в WB): тип токена, срок действия, категории доступа, признак «только чтение» и ID продавца. Помогает понять, почему метод возвращает 403.
Inputs: no named parameters. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
The core split between wb_get (read-only) and wb_call (mutating) is explicit and reinforced in both descriptions, and search/describe/sections serve clearly different discovery stages. The only fuzzy boundary is wb_request, which as a raw HTTP escape hatch can overlap with wb_get/wb_call for already-catalogued methods, though its 'new method not in catalog' framing mitigates this.
All tools uniformly use the wb_ prefix in lowercase snake_case, making the set instantly readable as one family. Minor deviation: most names are single verbs (search, describe, get, call, refresh) but wb_sections and wb_token_info are noun/noun+verb forms, so the pattern is not a pure verb_noun scheme.
Eight tools is tightly scoped for a catalog-and-invoke proxy: discovery (sections, search, describe), execution (get, call), auth diagnostics (token_info), and maintenance (refresh, request). Each tool has a distinct role and none feels redundant.
The search → describe → get/call workflow covers the full read and write lifecycle, with token diagnostics, catalog refresh, and a raw-request fallback for uncatalogued endpoints. Minor gaps: no way to enumerate all methods in a section (only counts), and no batch/pagination helper for high-volume reads.
Maintenance
Related MCP Connectors
Connect AI to store orders, products and inventory with scoped access and human approvals.
Connect AI clients to Seller Assistant workflows for Amazon wholesale operations.
Connect authorized ad accounts to AI assistants for audits, reporting, and approval-gated changes.
Amazon Ads, Seller Central, Vendor Central and AMC data for AI agents. Read-only by default.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceConnects AI assistants to Wildberries and Ozon seller accounts for real-time access to sales, stocks, prices, finances, and reviews through official APIs.MIT
- AlicenseAqualityCmaintenanceEnables AI agents to read and work with Wildberries, Ozon, and Yandex Market seller accounts through typed tools, multi-account support, unified data schemas, rate limiting, audit, and encrypted credential storage.1751 npmMIT
- AlicenseAqualityCmaintenanceEnables read-only analytics and product search for a Wildberries seller account, covering items, advertising, sales, stock, reviews, finances, and tariffs through MCP clients like ChatGPT or Cursor.12MIT
- AlicenseAqualityBmaintenanceWildberries seller API in your AI assistant: sales and stocks, product cards, prices and promotions, financial reports and reviews. 307 methods across all 17 Wildberries hosts live in a YAML catalog the server executes, the agent searches it in plain language, and every method carries an access class so writes and irreversible calls ask for confirmation.2561 PyPI5MIT