Odel
MCP server: One MCP server.

Wildberries

@dontsovcmcMCP server · External

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

Marketplace sellingv0.1.1Python
Freeno charge per call
How to install

Runs on your machine from its package; the steps are below.

What it does

  1. Reads
  2. Writes
  3. High impact

At most: creates or changes data: records, files, settings.

What it costs

Free

Odel charges nothing per call. The publisher may charge for its own service.

Runs locally over stdio

This server isn't hosted — your MCP client launches it from a package registry. Use one of the commands below, or drop the config into your client (e.g. Claude Desktop).

PyPImcp-server-wildberriesv0.1.1

Run

uvx mcp-server-wildberries

MCP client config

{
  "mcpServers": {
    "wildberries": {
      "command": "uvx",
      "args": [
        "mcp-server-wildberries"
      ]
    }
  }
}
README4 min read

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=%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:

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

Similar modules

Browse Marketplace selling