Wildberries

io.github.dontsovcmcPublished by GitHub account dontsovcmcv0.1.1Updated Oct 24, 2026

MCP server for Wildberries Seller API — products, orders, supplies, analytics, advertising

VerifiedSTDIODesktop onlyData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

Local MCP server for the Wildberries Seller API that lets an assistant search and run 235 seller actions covering products, orders, supplies, analytics, ads and

What you can do
Search seller actions by natural-language description and run them by ID, with a separate tool for actions that download files (reports, CSV). Manage product content: categories, cards, tags and brands. Handle orders and fulfilment across FBS, DBW, DBS and pickup, plus FBW supplies. Work with advertising campaigns, bids and statistics. Read communications (questions, reviews, chats), tariffs, analytics, reports and finance data, and digital goods.
When to use it
Useful for Wildberries sellers who want an assistant to look up and act on their own store data — orders, stock, ad campaigns, reviews or financial reports — without switching to the seller portal.
Requirements
Runs locally as a Python package (pip install or uvx). Requires a Wildberries seller API token (JWT) supplied in the WB_TOKEN environment variable, created in the seller account under API access. Optional WB_TIMEOUT and WB_FILE_TIMEOUT variables set HTTP and file-download timeouts. Network access to the Wildberries API.
Before you install
The WB_TOKEN is a seller API credential granting access to your store; keep it out of shared configs and prefer a separate env file. Many of the 235 actions change data — cancelling orders, renaming campaigns, managing supplies and prices — and some download reports. All requests go to Wildberries' API.

Installation

In SourceWeft

  1. Open Wildberries 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

mcp-server-wildberries

[Version]

mcp-name: io.github.dontsovcmc/wildberries

MCP-сервер для Wildberries Seller API — товары, заказы, поставки, аналитика, реклама, финансы.

235 действий, покрывающих все разделы WB API.

Построен по официальной документации Wildberries API.

Архитектура

Сервер использует паттерн search + execute — вместо 235 отдельных инструментов предоставляет 3:

ИнструментОписание
wb_searchПоиск действий по описанию на естественном языке
wb_executeВыполнение действия по ID
wb_execute_fileВыполнение действия со скачиванием файла

Это экономит токены в контексте LLM — схемы 3 инструментов вместо 235.

Как это работает

LLM: wb_search("cancel fbs order")→ [{"id": "fbs-order-cancel", "params_schema": {"order_id": "int"}, ...}]
LLM: wb_execute("fbs-order-cancel", '{"order_id": 12345}')→ {"status": "ok"}

Настройка

1. Получите API-токен Wildberries

Откройте Личный кабинет продавца WB → Настройки → Доступ к API → Создать токен.

2. Установите и подключите

macOS / Linux

Установка:

bash
pip install mcp-server-wildberries

Подключение к Claude Code (токен в командной строке):

bash
claude mcp add wildberries -e WB_TOKEN=ваш-токен -- mcp-server-wildberries

Подключение к Claude Code (токен из .env файла):

bash
source .env && claude mcp add wildberries -e WB_TOKEN -- mcp-server-wildberries

Удаление MCP-сервера:

bash
claude mcp remove wildberries

CLI без Claude (токен в командной строке):

bash
WB_TOKEN=ваш-токен mcp-server-wildberries ping

CLI без Claude (токен из .env файла):

bash
source .env && mcp-server-wildberries ping
Windows

Установка:

cmd
pip install mcp-server-wildberries

Подключение к Claude Code (токен в командной строке):

cmd
set WB_TOKEN=ваш-токен && claude mcp add wildberries -e WB_TOKEN -- mcp-server-wildberries

Подключение к Claude Code (токен из .env файла):

cmd
for /f "tokens=1,2 delims==" %a in (.env) do set %a=%bclaude mcp add wildberries -e WB_TOKEN -- mcp-server-wildberries

Удаление MCP-сервера:

cmd
claude mcp remove wildberries

CLI без Claude (токен в командной строке):

cmd
set WB_TOKEN=ваш-токен && mcp-server-wildberries ping

CLI без Claude (токен из .env файла):

cmd
for /f "tokens=1,2 delims==" %a in (.env) do set %a=%bmcp-server-wildberries ping
Запуск через uvx (без установки)

Если не хотите устанавливать пакет глобально, используйте uvx — он скачает и запустит автоматически:

bash
# Подключение к Claude Codeclaude mcp add wildberries -e WB_TOKEN=ваш-токен -- uvx mcp-server-wildberries
# CLIWB_TOKEN=ваш-токен uvx mcp-server-wildberries ping
Запуск через --mcp-config (на одну сессию)

Подключает сервер только на время одной сессии Claude, не сохраняя в настройки. Токен хранится в отдельном .env.mcp файле, а не в конфиге Claude.

Из JSON-строки:

bash
claude --mcp-config '{"wildberries":{"command":"bash","args":["-c","source ~/.env.mcp && exec uvx mcp-server-wildberries"]}}'

Из файла:

bash
claude --mcp-config ~/mcp-servers.json

Только указанные серверы, без сохранённых:

bash
claude --strict-mcp-config --mcp-config ~/mcp-servers.json

Пример ~/mcp-servers.json:

json
{  "wildberries": {    "command": "bash",    "args": ["-c", "source ~/.env.mcp && exec uvx mcp-server-wildberries"]  }}

Пример ~/.env.mcp:

WB_TOKEN=ваш-токен

Плюсы:

  • Токены в отдельном файле .env.mcp, а не в настройках Claude
  • Один файл mcp-servers.json на все проекты — легко делиться конфигом в команде
  • --strict-mcp-config — запуск с точным набором серверов, без лишних
  • Не засоряет глобальные настройки при экспериментах

Минусы:

  • Сервер не сохраняется между сессиями — нужно указывать флаг при каждом запуске
  • Длинная команда запуска, если без файла

После подключения перезапустите Claude Code.

Переменные окружения

ПеременнаяОбязательнаяПо умолчаниюОписание
WB_TOKENДа—API-токен Wildberries (JWT)
WB_TIMEOUTНет30Таймаут HTTP-запросов к API (секунды)
WB_FILE_TIMEOUTНет60Таймаут скачивания файлов (секунды)

Доступные действия (235)

Все действия доступны через wb_search → wb_execute. Подробное описание каждого действия — в документации по разделам:

ДоменКол-воОписание
general9Ping, информация о продавце, пользователи
content18Категории, карточки товаров, теги, бренды
fbs_orders31FBS-заказы, стикеры, поставки, пропуска, метаданные
dbw_orders16DBW-заказы (доставка WB)
dbs_orders20DBS-заказы (дропшиппинг)
pickup_orders16Самовывоз (click & collect)
fbw_supplies7FBW-поставки на склад WB
advertising26Рекламные кампании, ставки, статистика
communications22Вопросы, отзывы, чаты
tariffs5Комиссии, тарифы на доставку
analytics17Воронка продаж, поисковые запросы, остатки
reports24Заказы, продажи, остатки, маркировка
finance12Баланс, отчёты, эквайринг, документы
wbd12Цифровые товары, ключи активации

Примеры поиска

wb_search("новые заказы fbs")wb_search("баланс")wb_search("отзывы", domain="communications")wb_search("download report", domain="reports")

CLI

bash
# MCP-сервер (по умолчанию, без аргументов)mcp-server-wildberries
# Все доступные командыmcp-server-wildberries --help
# Справка по конкретной командеmcp-server-wildberries fbs-orders --help
# Примеры командmcp-server-wildberries pingmcp-server-wildberries seller-infomcp-server-wildberries fbs-orders-newmcp-server-wildberries tariff-commissionsmcp-server-wildberries fbs-orders --date-from 2025-01-01 --limit 10mcp-server-wildberries advert-campaign-rename 12345 "Новое название"mcp-server-wildberries analytics-csv-download dl_abc report.csv
# Версияmcp-server-wildberries --version

Пример

bash
$ WB_TOKEN=ваш-токен mcp-server-wildberries ping{"TS": "2026-05-06T18:06:30Z", "Status": "OK"}
$ WB_TOKEN=ваш-токен mcp-server-wildberries seller-info{"name": "ИП Иванов И.И.", "sid": "...", "tradeMark": "MyBrand"}

Pydantic-модели

Модели параметров доступны как отдельная библиотека для использования в своих Python-программах:

bash
pip install mcp-server-wildberries
python
from mcp_server_wildberries.models import FbsOrdersParams, SubjectsListParams
params = FbsOrdersParams(date_from="2025-01-01", limit=50)# params.model_dump() → {"date_from": "2025-01-01", "date_to": "", "limit": 50, ...}

62 Pydantic-модели покрывают параметры всех 235 действий. Полный список — в src/mcp_server_wildberries/models.py.

Разработка

bash
pip install -e ".[test]"ruff check src/ tests/pytest tests/ -v

Лицензия

MIT

Source: README.md at commit 41e392c

Tools

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

Version history

1
  1. v0.1.1LatestSep 16, 2026

Score

40% 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

    Declare a license in the repository or the registry entry.