wb-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| WB_API_TOKEN | Yes | Your Wildberries seller API token (Кабинет продавца → Настройки → Интеграции по API → Создать токен). A read-only token with minimal categories is recommended to start. | |
| WB_AUTO_SYNC | No | Enables automatic syncing of the Wildberries API method catalog (set to "1" in the client configuration). | 1 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
Wildberries Seller API (полное покрытие официальных OpenAPI-спеков). Как работать:
wb_search — найди метод по словам ("остатки", "отзывы", "поставки").
wb_describe — посмотри параметры, тело запроса и лимиты метода.
wb_call — вызови метод: params = параметры по именам из wb_describe, body = JSON-тело. Дополнительно: wb_sections (обзор), wb_token_info (что умеет токен), wb_request (сырой запрос), wb_refresh (обновить каталог). Большие ответы автоматически сохраняются в файл; предупреждай пользователя перед методами записи.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": true,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| wb_searchA | Найти метод Wildberries Seller API по словам (например "остатки", "отзывы", "поставки", "цены"). Начни с этого инструмента. Возвращает id, метод, путь, признак readonly и краткое описание. Дальше: wb_describe для схемы, wb_call для вызова. |
| wb_describeA | Показать полную схему метода: URL, обязательные параметры, тело запроса, схему ответа, лимиты и типы токенов. Используй после wb_search перед вызовом. |
| wb_getA | Вызвать READ-ONLY метод Wildberries API по id. Используй этот инструмент для любых чтений (диагностика, отчёты, списки, остатки, отзывы) — он не требует подтверждения и работает с токеном «Только чтение». Параметры path/query/header — в "params", тело — в "body". Для изменяющих методов используй wb_call. |
| wb_callA | Вызвать ИЗМЕНЯЮЩИЙ метод Wildberries API по id (создание/обновление/удаление: цены, карточки, заказы, поставки, реклама, ответы на отзывы). Перед вызовом предупреди пользователя о последствиях. Для чтения используй wb_get — он не требует подтверждения. Параметры path/query/header передавай в "params" по их именам из wb_describe, JSON-тело — в "body". |
| wb_sectionsA | Обзор каталога: разделы WB API, число методов в каждом, состояние токенов и дата сборки каталога. Полезно в начале работы, чтобы понять какие разделы доступны. |
| wb_token_infoA | Локально декодирует WB API токен (без запросов в WB): тип токена, срок действия, категории доступа, признак «только чтение» и ID продавца. Помогает понять, почему метод возвращает 403. |
| wb_requestA | Прямой HTTP-запрос к любому хосту *.wildberries.ru — на случай нового метода, которого ещё нет в каталоге. Разрешены только хосты wildberries.ru. Указывай url (или host+path), query, body. |
| wb_refreshA | Скачать свежие OpenAPI-спеки с dev.wildberries.ru и пересобрать каталог методов (когда WB меняет API). Требует сеть; занимает несколько секунд. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| sales-accelerator | Глубокая диагностика роста: воронка и CTR, контент карточек, SEO/поисковые запросы, цены, реклама и ставки, акции, остатки, отзывы/рейтинг, возвраты. На выходе — таблица потерь в ₽, приоритеты impact/effort и план на 7/30 дней с конкретными методами WB. |
| diagnose-orders-drop | Пошаговая диагностика падения заказов: сравнить заказы/продажи по дням, проверить воронку, остатки на складах WB, статус рекламных кампаний и блокировки карточек. |
| check-stock | Найти товары с нулевым или низким остатком на складах WB и на складах продавца, подсказать, что нужно пополнить. |
| reply-reviews | Найти неотвеченные отзывы и вопросы покупателей, показать их и подготовить ответы (публикация — только после подтверждения пользователя через wb_call). |
| weekly-report | Собрать сводку: заказы, продажи, выкупы, остатки, возвраты и реклама за неделю. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
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.