Wildberries

io.github.dontsovcmc由 GitHub 帳號 dontsovcmc 發布v0.1.1更新於 Oct 24, 2026

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

已驗證STDIO僅桌面資料與分析商業與電商

概覽

AI 產生的概覽

面向 Wildberries 賣家 API 的本機 MCP 伺服器，讓助理搜尋並執行 235 項賣家操作，涵蓋商品、訂單、供貨、分析、廣告與財務。

可以做什麼
以自然語言描述搜尋賣家操作，並依 ID 執行，另有專門工具執行含檔案下載的操作（報表、CSV）。管理商品內容：類別、商品卡、標籤與品牌。處理 FBS、DBW、DBS 與自取訂單及履約，以及 FBW 入倉供貨。操作廣告活動、出價與統計。讀取溝通（提問、評價、聊天）、費率、分析、報表、財務資料與數位商品。
適用情境
適合 Wildberries 賣家讓助理查詢並操作自家店鋪資料——訂單、庫存、廣告活動、評價或財務報表——而不必切換到賣家後台。
執行需求
以 Python 套件在本機執行（pip install 或 uvx）。需要 Wildberries 賣家 API 權杖（JWT），透過環境變數 WB_TOKEN 提供，在賣家後台的 API 存取中建立。選用 WB_TIMEOUT 與 WB_FILE_TIMEOUT 設定 HTTP 與檔案下載逾時。需能連線至 Wildberries API 的網路。
安裝前請注意
WB_TOKEN 是可存取店鋪的賣家 API 憑證，應避免寫入共用設定，建議放在獨立的 env 檔案中。235 項操作中許多會修改資料——取消訂單、重新命名廣告活動、管理供貨與價格——部分還會下載報表。所有請求都送往 Wildberries 的 API。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Wildberries，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

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

來源：README.md，提交 41e392c

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.1.1最新Sep 16, 2026

評分

已滿足適用檢查項的 40%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。