Wildberries MCP (RU)

io.github.ilyautovPublished by GitHub account ilyautovv0.6.0Updated Oct 24, 2026

API Wildberries в ИИ-ассистенте: продажи, остатки, карточки, цены, отчёты

VerifiedSTDIODesktop onlyFinanceData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

Local MCP server that connects an AI assistant to the Wildberries seller API for sales, stock, product cards, prices, ads, reviews and financial reports.

What you can do
Read sales, orders, stock and seller analytics, including search queries and storage data, and pull financial reports and balances from the statistics and finance hosts. Manage product cards, characteristics, categories, media and labels on the content host. Work with prices, discounts and promotion calendars, and with advertising campaigns, bids and search clusters. Handle FBS, DBS and DBW assembly tasks, supplies and warehouse deliveries, plus returns, buyer chat, seller documents and user rights. Read and pin customer reviews and questions, and manage digital goods and activation keys.
When to use it
Use it when you sell on Wildberries and want an assistant to answer questions about sales, stock coverage, out-of-stock risk, financial reports, pricing, promotions or reviews without leaving the chat. It is the single-marketplace package; choose the multi-marketplace package if you also need other platforms.
Requirements
Runs locally as a Python package launched with uvx (Python tooling required). A Wildberries seller account API token is required in the WB_API_TOKEN environment variable, taken from the seller cabinet under Settings, API access. The token's access categories must cover the hosts you use. Cabinets can also be stored locally in a configuration file. Network access to Wildberries API hosts is needed.
Before you install
The server exposes 307 Wildberries methods, of which 108 are write operations and 12 are irreversible, so assistant actions can change listings, prices, promotions, supplies and ad campaigns. The WB_API_TOKEN is a seller credential sent in the Authorization header without a Bearer prefix; it is stored locally in a cabinets file with restricted permissions. Request limits are per method and can be as strict as one call per minute, and an active cabinet entry can override environment variables.

Installation

In SourceWeft

  1. Open Wildberries MCP (RU) in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

wildberries-mcp-ru

API Wildberries для ИИ-ассистентов: продажи и остатки, карточки и характеристики, цены и акции, финансовые отчёты, отзывы. Семнадцать хостов WB разложены по каталогу.

[PyPI] [CI] [License: MIT] [Методов] [Сайт] [Звёзды]

[wildberries-mcp-ru: API Wildberries в ИИ-ассистенте. 307 методов]

Пакет поднимает один сервер, Wildberries, и ничего больше. Сервер, каталог и ядро приходят зависимостью из marketplaces-mcp-ru: здесь имя, точка входа и документация под один маркетплейс.

Установка

Пакет на PyPI, поэтому строка одна:

bash
uvx wildberries-mcp-ru

Если нужна ветка main, а не релиз:

bash
uvx --from git+https://github.com/ilyautov/wildberries-mcp-ru wildberries-mcp-ru

Claude Desktop, claude_desktop_config.json:

json
{  "mcpServers": {    "wb": {      "command": "uvx",      "args": ["wildberries-mcp-ru"],      "env": { "WB_API_TOKEN": "..." }    }  }}

Третий путь, если агент умеет скиллы: он поставит сервер и настроит клиент сам.

bash
npx skills add ilyautov/wildberries-mcp-ru

Ключи

Где взять токен. Кабинет seller.wildberries.ru, раздел Настройки, пункт Доступ к API. Токен один на все хосты, но при создании выбираются категории доступа: выданный только под контент токен не пустят в статистику.

Как он уходит в запрос. В заголовок Authorization, и это важный нюанс: сервер шлёт raw-токен без префикса Bearer. Подтверждено на практике. Если авторизация падает при верном токене, проверьте это первым.

Где он лежит. В ~/.marketplace-mcp/cabinets.json с правами chmod 600, локально. В репозиторий и в чат токен не попадает.

переменнаясекретчто это
WB_API_TOKENдаТокен из кабинета seller.wildberries.ru, Настройки → Доступ к API. Уходит в Authorization без Bearer.

Ключи можно не держать в окружении: сервер умеет кабинеты и кладёт их в ~/.marketplace-mcp/cabinets.json с правами 600, вне репозитория. Магазинов подключается сколько нужно, переключение прямо из чата.

Карта методов

Каталог лежит в зависимости как wb_mcp/endpoints.yaml: 307 методов, из них 187 на чтение, 108 на запись и 12 необратимых. Сервер исполняет ровно этот файл, поэтому таблица не может разойтись с кодом.

хостметодовчто там
marketplace-api.wildberries.ru100Сборочные задания и поставки FBS, DBS, DBW, самовывоз
seller-analytics-api.wildberries.ru40Аналитика продавца: поисковые запросы, остатки, удержания, платное хранение
content-api.wildberries.ru31Карточки товаров, характеристики, категории, медиа, ярлыки
advert-api.wildberries.ru30Рекламные кампании, ставки, поисковые кластеры
devapi-digital.wildberries.ru22Цифровые товары: контент, предложения, ключи активации
feedbacks-api.wildberries.ru20Отзывы, вопросы, закреплённые отзывы
discounts-prices-api.wildberries.ru13Цены, скидки, календарь акций
common-api.wildberries.ru10Информация о продавце, тарифы, комиссии, новости
supplies-api.wildberries.ru7Поставки на склад WB и данные для их формирования
finance-api.wildberries.ru7Финансовые отчёты и баланс
statistics-api.wildberries.ru5Статистика: продажи, заказы, остатки, отчёт о реализации
user-management-api.wildberries.ru4Пользователи продавца и их права
advert-media-api.wildberries.ru4Медиа в рекламе и статистика по ним
dp-calendar-api.wildberries.ru4Календарь акций и участие в них
buyer-chat-api.wildberries.ru4Чат с покупателями
documents-api.wildberries.ru4Документы продавца
returns-api.wildberries.ru2Возвраты покупателями

Подробный разбор с параметрами и лимитами: https://marketplaces-mcp-ru.aifrontier.tech/wildberries-api.html

Что спросить в чате

  • покажи продажи на WB за неделю
  • вытащи финотчёт реализации за прошлый месяц
  • что пора дозаказать, посчитай дни покрытия
  • какие товары рискуют уйти в out-of-stock

Частые ошибки

401 при верном токене. Две причины по частоте. Первая: WB ждёт raw-токен в Authorization без Bearer. Вторая: активный кабинет в ~/.marketplace-mcp/cabinets.json имеет приоритет над переменными окружения и затеняет то, что вы экспортировали.

404 или пустой ответ на рабочем методе. Проверьте хост. У WB семнадцать доменов по назначению, и статистика на домене контента не отвечает. Таблица хостов выше.

429, превышен лимит запросов. Лимиты у WB заданы поштучно и местами очень жёсткие: у части методов это один запрос в минуту, у отчётов бывает и реже. Лимит привязан к методу, а не к аккаунту целиком, поэтому упереться можно на одном отчёте, пока остальное работает.

Чем это отличается от marketplaces-mcp-ru

Ничем, кроме состава. marketplaces-mcp-ru ставит четыре маркетплейса сразу и держит их под одним сервером, wildberries-mcp-ru ставит один. Код общий: правка в ядре доезжает сюда обновлением зависимости, а не копированием.

нужнопакет
только Wildberrieswildberries-mcp-ru
все четыре маркетплейсаmarketplaces-mcp-ru

Кто это сделал

Илья Утов, лаборатория AI Frontier. Как эти инструменты устроены внутри, пишу в Telegram и LinkedIn.

Рядом стоят business-mcp-ru (hh.ru, VK, Диадок, СБИС, Честный знак), moysklad-mcp-ru и humanizer-ru.

Все проекты одним списком, разобранные по назначению: ilyautov.github.io.

Лицензия

MIT, см. LICENSE.

Source: README.md at commit 7198790

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.6.0LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts