MCP Server for Wildberries Seller API

MCP server io.github.dontsovcmc/wildberries provides access to Wildberries Seller API functions for products, orders, supplies, analytics, advertising, and finance. It is built from the official Wildberries API documentation and covers all sections of the WB API with 235 supported actions.

🛠️ Key Features

Wildberries Seller API coverage: products, orders, supplies, analytics, advertising, finance
235 actions across WB API sections
Built using the official Wildberries API documentation
Implements a “search + execute” pattern instead of exposing 235 separate tools

🚀 Use Cases

Retrieve or manage product data via WB Seller API
Work with orders and supply-related endpoints
Access analytics and advertising capabilities
Use finance-related API functionality

⚡ Developer Benefits

Simplified tool surface: 3 tools total using search + execute
Designed to align with WB API Swagger/general reference

⚠️ Limitations

Provides 3 tools rather than 235 individual tools, so action granularity is handled via the search + execute workflow

mcp-server-wildberries

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.

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

code

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=%b
claude 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=%b
mcp-server-wildberries ping

Запуск через uvx (без установки)

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

bash

# Подключение к Claude Code
claude mcp add wildberries -e WB_TOKEN=ваш-токен -- uvx mcp-server-wildberries

# CLI
WB_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:

code

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. Подробное описание каждого действия — в документации по разделам:

Домен	Кол-во	Описание
`general`	9	Ping, информация о продавце, пользователи
`content`	18	Категории, карточки товаров, теги, бренды
`fbs_orders`	31	FBS-заказы, стикеры, поставки, пропуска, метаданные
`dbw_orders`	16	DBW-заказы (доставка WB)
`dbs_orders`	20	DBS-заказы (дропшиппинг)
`pickup_orders`	16	Самовывоз (click & collect)
`fbw_supplies`	7	FBW-поставки на склад WB
`advertising`	26	Рекламные кампании, ставки, статистика
`communications`	22	Вопросы, отзывы, чаты
`tariffs`	5	Комиссии, тарифы на доставку
`analytics`	17	Воронка продаж, поисковые запросы, остатки
`reports`	24	Заказы, продажи, остатки, маркировка
`finance`	12	Баланс, отчёты, эквайринг, документы
`wbd`	12	Цифровые товары, ключи активации

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

code

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 ping
mcp-server-wildberries seller-info
mcp-server-wildberries fbs-orders-new
mcp-server-wildberries tariff-commissions
mcp-server-wildberries fbs-orders --date-from 2025-01-01 --limit 10
mcp-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

io.github.dontsovcmc/wildberries

MCP Server for Wildberries Seller API

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

mcp-server-wildberries

Архитектура

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

Настройка

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

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

macOS / Linux

Windows

Запуск через uvx (без установки)

Запуск через --mcp-config (на одну сессию)

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

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

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

CLI

Пример

Pydantic-модели

Разработка

Лицензия

Install

Configuration

Related servers