io.github.DeviceIngineering/wb-mcp-server

PYPI · WB-MCP-SERVER · SCANNED AUG 22

Wildberries Seller API: 202 tools — products, prices, orders, ads, supplies, finance.

Available components

48 48 Trust /100

Trust breakdown (6 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score →

Supply Chain Security50

Malware scan not yet available for this package.Unverified
No known CVEs affecting this package version or its production dependencies.Pass
Runs hatchling.build at install time, a recognised native-build step with no shell scripting around it. View diagnostics → Pass
1 of 38 dependencies flagged as unhealthy. View diagnostics → Partial

Provenance & Transparency32

Source repository is publicly reachable at the declared URL. View diagnostics → Pass
Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
License check failed: the license (MIT License) isn't a recognized OSI-approved license. See how to fix → Fail
Actively maintained (last published 0 days ago).Pass
Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail

Schema Quality & AI Usability65

AI-judged instruction clarity (good).Pass
Tool/resource definitions use about 14601 tokens (~72/item across 202 items; 202 tools + 0 resources), lean.Pass
Usage-examples check failed: none of the tools include examples. See how to fix → Fail

Stability & Change Management3

Stability observed for 1 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial

Tool Coverage86

100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
58% of tool parameters carry a description.Partial

Capabilities100

Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass

Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

pypi · wb-mcp-server

Claude Codex opencode OpenClaw Hermes Other

# add to Claude Code

claude mcp add deviceingineering-wb-mcp-server -- uvx wb-mcp-server

# add to Codex CLI

codex mcp add deviceingineering-wb-mcp-server -- uvx wb-mcp-server

// opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "deviceingineering-wb-mcp-server": {
      "type": "local",
      "command": [
        "uvx",
        "wb-mcp-server"
      ],
      "enabled": true
    }
  }
}

# add to OpenClaw

openclaw mcp add deviceingineering-wb-mcp-server --command uvx --arg wb-mcp-server

# ~/.hermes/config.yaml

mcp_servers:
  deviceingineering-wb-mcp-server:
    command: "uvx"
    args: ["wb-mcp-server"]

// mcp.json

{
  "mcpServers": {
    "deviceingineering-wb-mcp-server": {
      "command": "uvx",
      "args": [
        "wb-mcp-server"
      ]
    }
  }
}

Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

22 Aug 26 0
- Stability: unverified → 0.03 ▲ functional
- Package version: 2.2.1 → 2.2.2 functional
21 Aug 26 48

First indexed and scored.

Show 1 earlier entry Hide earlier entries

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 22 Aug 2026 · Analysed pypi/wb-mcp-server@2.2.2

Provenance No attestation

The registry publishes no build provenance for this version, so there is nothing to verify.

Result	No attestation
Ecosystem	pypi

Install scripts 1 script

Hook	Tier	Command
build_backend	allowlisted	`hatchling.build`

Dependencies 38 packages

Packages resolved	38
Stale	1
Tree resolution	Complete

MCP tools · 202 exposed · ~14,601 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.

Tool Tokens

wb_feedbacks_list ~104

[P1] Список отзывов. Негативные отзывы без ответа снижают рейтинг и конверсию.

Input Output Examples

Name	Type	Req	Description
is_answered	boolean	–	Фильтр: true=отвеченные, false=неотвеченные (опц.)
nm_id	integer	–	Фильтр по nmID товара (опц.)
shop_id	string	yes	ID магазина (из wb_list_shops)
take	integer	–	–

No output schema declared.

No examples provided.

wb_feedbacks_pins ~57

[P2] Закреплённые отзывы — показываются первыми на карточке. Используй лучшие отзывы для увеличения конверсии.

Input Output Examples

Name	Type	Req	Description
shop_id	string	yes	ID магазина (из wb_list_shops)

No output schema declared.

No examples provided.

wb_feedbacks_pins_count ~48

[P2] Количество закреплённых отзывов (лимит 3 на nmID).

Input Output Examples

Name	Type	Req	Description
shop_id	string	yes	ID магазина (из wb_list_shops)

No output schema declared.

No examples provided.

wb_feedbacks_pins_delete ~50

[P2] Открепить закреплённые отзывы.

Input Output Examples

Name	Type	Req	Description
feedback_ids	array	yes	–
shop_id	string	yes	ID магазина (из wb_list_shops)

No output schema declared.

No examples provided.

wb_feedbacks_pins_set ~61

[P1] Закрепить отзывы (≤3 на nmID). Выбирай самые подробные позитивные отзывы.

Input Output Examples

Name	Type	Req	Description
feedback_ids	array	yes	–
shop_id	string	yes	ID магазина (из wb_list_shops)

No output schema declared.

No examples provided.

wb_finance_acquiring_detailed ~81

[P1] Детализация издержек эквайринга за период.

Input Output Examples

Name	Type	Req	Description
date_from	string	yes	YYYY-MM-DD
date_to	string	yes	–
limit	integer	–	–
rrd_id	integer	–	–
shop_id	string	yes	ID магазина (из wb_list_shops)

No output schema declared.

No examples provided.

wb_finance_acquiring_list ~95

[P1] Список отчётов по издержкам эквайринга (комиссии за оплату картой).

Input Output Examples

Name	Type	Req	Description
date_from	string	yes	YYYY-MM-DD
date_to	string	yes	–
limit	integer	–	–
offset	integer	–	–
period	string	–	–
shop_id	string	yes	ID магазина (из wb_list_shops)

No output schema declared.

No examples provided.

wb_finance_balance ~58

[P0] Баланс продавца (к выводу, в пути и т.д.). Требует категорию «Финансы» в токене.

Input Output Examples

Name	Type	Req	Description
shop_id	string	yes	ID магазина (из wb_list_shops)

No output schema declared.

No examples provided.

wb_finance_report ~144

[P0] Детальный отчёт по реализации за период (новый finance-api с fallback на старый эндпоинт). Содержит ВСЕ: комиссии, логистику, хранение, штрафы, к оплате. КРИТИЧНО: единственный способ увидеть реальную прибыль. Для детального контроля используй wb_finance_reports_list + wb_finance_report_detailed.

Input Output Examples

Name	Type	Req	Description
date_from	string	yes	YYYY-MM-DD
date_to	string	yes	–
limit	integer	–	–
rrd_id	integer	–	–
shop_id	string	yes	ID магазина (из wb_list_shops)

No output schema declared.

No examples provided.

wb_finance_report_detailed ~109

[P0] Детализация отчёта реализации по ID (finance-api v1). Вызывай после wb_finance_reports_list. Содержит: комиссии, логистика, хранение, штрафы, к оплате. Пагинация через rrd_id.

Input Output Examples

Name	Type	Req	Description
limit	integer	–	–
report_id	string	yes	–
rrd_id	integer	–	–
shop_id	string	yes	ID магазина (из wb_list_shops)

No output schema declared.

No examples provided.

wb_finance_reports_list ~119

[P0] Список отчётов реализации (finance-api v1). Используй для навигации по периодам — затем вызови wb_finance_report_detailed с нужным reportId. Данные с 01.01.2025.

Input Output Examples

Name	Type	Req	Description
date_from	string	yes	YYYY-MM-DD
date_to	string	yes	–
limit	integer	–	–
offset	integer	–	–
period	string	–	–
shop_id	string	yes	ID магазина (из wb_list_shops)

No output schema declared.

No examples provided.

wb_goods_return_report ~69

[P2] Аналитический отчёт по возвратам товаров продавцу (макс. 31 день).

Input Output Examples

Name	Type	Req	Description
date_from	string	yes	YYYY-MM-DD
date_to	string	yes	–
shop_id	string	yes	ID магазина (из wb_list_shops)

No output schema declared.

No examples provided.

wb_jam_subscription ~59

[P2] Информация о подписке WB Джем (активна/истекает). Используй для проверки доступности Джем-инструментов.

Input Output Examples

Name	Type	Req	Description
shop_id	string	yes	ID магазина (из wb_list_shops)

No output schema declared.

No examples provided.

wb_list_shops ~37

Список зарегистрированных магазинов Wildberries. Возвращает shop_id и название. Используй shop_id для всех остальных инструментов.

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

wb_media_upload ~88

[P1] Загрузить фото/видео в карточку по ссылкам. ВНИМАНИЕ: полностью ЗАМЕНЯЕТ существующие медиа карточки!

Input Output Examples

Name	Type	Req	Description
links	array	yes	Ссылки на изображения (≥700x900px)
nm_id	integer	yes	–
shop_id	string	yes	ID магазина (из wb_list_shops)

No output schema declared.

No examples provided.

wb_media_upload_file ~101

[P1] Загрузить медиа ФАЙЛОМ по ссылке (сервер скачает и отправит). photo_number с 1; видео = 1; новое фото — номер больше уже загруженных.

Input Output Examples

Name	Type	Req	Description
file_url	string	yes	URL файла для скачивания
nm_id	integer	yes	–
photo_number	integer	yes	–
shop_id	string	yes	ID магазина (из wb_list_shops)

No output schema declared.

No examples provided.

wb_new_feedbacks_questions ~61

[P1] Флаги непросмотренных отзывов/вопросов (hasNewFeedbacks/hasNewQuestions) — для регулярного мониторинга.

Input Output Examples

Name	Type	Req	Description
shop_id	string	yes	ID магазина (из wb_list_shops)

No output schema declared.

No examples provided.

wb_nm_report ~115

[P1] Отчёт по номенклатуре: выручка, заказы, возвраты, конверсии по каждому nmID (task-based, ждёт до 3 мин). Отчёт хранится 3 дня.

Input Output Examples

Name	Type	Req	Description
date_from	string	–	YYYY-MM-DD (опц.)
date_to	string	–	(опц.)
nm_ids	array	–	Фильтр (опц.)
shop_id	string	yes	ID магазина (из wb_list_shops)

No output schema declared.

No examples provided.

wb_order_cancel ~55

[P1] ОТМЕНИТЬ сборочное задание FBS (необратимо).

Input Output Examples

Name	Type	Req	Description
order_id	integer	yes	–
shop_id	string	yes	ID магазина (из wb_list_shops)

No output schema declared.

No examples provided.

wb_order_meta_delete ~68

[P2] Удалить метаданные заказа FBS по ключу (imei|uin|gtin|sgtin).

Input Output Examples

Name	Type	Req	Description
key	string	yes	–
order_id	integer	yes	–
shop_id	string	yes	ID магазина (из wb_list_shops)

No output schema declared.

No examples provided.

wb_order_meta_get ~61

[P1] Метаданные/маркировка заказа FBS (доступные ключи — из requiredMeta заказа).

Input Output Examples

Name	Type	Req	Description
order_id	integer	yes	–
shop_id	string	yes	ID магазина (из wb_list_shops)

No output schema declared.

No examples provided.

wb_order_meta_set ~120

[P0] Задать маркировку заказа FBS: meta_type = sgtin|uin|imei|gtin|expiration. Только в статусе confirm. КРИТИЧНО для маркированных товаров.

Input Output Examples

Name	Type	Req	Description
meta_type	string	yes	–
order_id	integer	yes	–
shop_id	string	yes	ID магазина (из wb_list_shops)
value	–	yes	sgtin — массив Data Matrix; uin/imei/gtin — строка; expiration — dd.mm.yyyy

No output schema declared.

No examples provided.

wb_orders_archive ~82

[P2] Архивные FBS-заказы за период (завершённые/отменённые).

Input Output Examples

Name	Type	Req	Description
date_from	string	yes	RFC3339
date_to	string	–	RFC3339 (опц.)
limit	integer	–	–
shop_id	string	yes	ID магазина (из wb_list_shops)

No output schema declared.

No examples provided.

wb_orders_client_info ~54

[P2] Данные покупателя (трансграничные заказы из Турции).

Input Output Examples

Name	Type	Req	Description
order_ids	array	yes	–
shop_id	string	yes	ID магазина (из wb_list_shops)

No output schema declared.

No examples provided.

wb_orders_external_stickers ~54

[P2] Стикеры трансграничной доставки (≤100, статус complete).

Input Output Examples

Name	Type	Req	Description
order_ids	array	yes	–
shop_id	string	yes	ID магазина (из wb_list_shops)

No output schema declared.

No examples provided.

wb_orders_list ~81

[P1] Все заказы за период.

Input Output Examples

Name	Type	Req	Description
date_from	string	yes	RFC3339 (2024-01-01T00:00:00Z)
date_to	string	–	RFC3339 (опц.)
limit	integer	–	–
shop_id	string	yes	ID магазина (из wb_list_shops)

No output schema declared.

No examples provided.

wb_orders_new ~41

[P1] Новые заказы FBS — ожидают сборки.

Input Output Examples

Name	Type	Req	Description
shop_id	string	yes	ID магазина (из wb_list_shops)

No output schema declared.

No examples provided.

wb_orders_status ~45

[P1] Статусы конкретных заказов.

Input Output Examples

Name	Type	Req	Description
order_ids	array	yes	–
shop_id	string	yes	ID магазина (из wb_list_shops)

No output schema declared.

No examples provided.

wb_orders_status_history ~54

[P2] История статусов заказов (трансграничные, ≤100).

Input Output Examples

Name	Type	Req	Description
order_ids	array	yes	–
shop_id	string	yes	ID магазина (из wb_list_shops)

No output schema declared.

No examples provided.

wb_orders_stickers ~91

[P1] Стикеры для сборочных заданий FBS (≤100 за запрос). Форматы: svg, zplv, zplh, png.

Input Output Examples

Name	Type	Req	Description
height	integer	–	–
order_ids	array	yes	–
shop_id	string	yes	ID магазина (из wb_list_shops)
sticker_type	string	–	–
width	integer	–	–

No output schema declared.

No examples provided.

wb_paid_storage ~88

[P0] Отчёт по платному хранению на складах WB. КРИТИЧНО: товары с нулевыми продажами и высокой стоимостью хранения = прямые убытки!

Input Output Examples

Name	Type	Req	Description
date_from	string	yes	YYYY-MM-DD
date_to	string	yes	–
shop_id	string	yes	ID магазина (из wb_list_shops)

No output schema declared.

No examples provided.

wb_pass_create ~83

[P2] Создать пропуск на склад (действует 48 ч).

Input Output Examples

Name	Type	Req	Description
car_model	string	yes	–
car_number	string	yes	–
first_name	string	yes	–
last_name	string	yes	–
office_id	integer	yes	–
shop_id	string	yes	ID магазина (из wb_list_shops)

No output schema declared.

No examples provided.

wb_pass_delete ~43

[P2] Удалить пропуск.

Input Output Examples

Name	Type	Req	Description
pass_id	integer	yes	–
shop_id	string	yes	ID магазина (из wb_list_shops)

No output schema declared.

No examples provided.

wb_pass_update ~83

[P2] Обновить пропуск.

Input Output Examples

Name	Type	Req	Description
car_model	string	yes	–
car_number	string	yes	–
first_name	string	yes	–
last_name	string	yes	–
office_id	integer	yes	–
pass_id	integer	yes	–
shop_id	string	yes	ID магазина (из wb_list_shops)

No output schema declared.

No examples provided.

wb_passes_list ~40

[P2] Список действующих пропусков на склад.

Input Output Examples

Name	Type	Req	Description
shop_id	string	yes	ID магазина (из wb_list_shops)

No output schema declared.

No examples provided.

wb_passes_offices ~43

[P2] Офисы/склады, требующие пропуск.

Input Output Examples

Name	Type	Req	Description
shop_id	string	yes	ID магазина (из wb_list_shops)

No output schema declared.

No examples provided.

wb_prices_b2b_set ~69

[P2] Установить оптовые B2B скидки. Каждый элемент: {nmID, wholesaleDiscount}.

Input Output Examples

Name	Type	Req	Description
data	array	yes	[{nmID, wholesaleDiscount}, ...]
shop_id	string	yes	ID магазина (из wb_list_shops)

No output schema declared.

No examples provided.

wb_prices_club_discount ~63

[P1] Установить скидки WB Клуба (≤1000 товаров за запрос).

Input Output Examples

Name	Type	Req	Description
data	array	yes	[{nmID, clubDiscount}, ...]
shop_id	string	yes	ID магазина (из wb_list_shops)

No output schema declared.

No examples provided.

wb_prices_list ~90

[P0] Текущие цены и скидки на все товары. КРИТИЧНО: мониторинг для контроля маржинальности.

Input Output Examples

Name	Type	Req	Description
filter_nm_id	integer	–	Фильтр по конкретному nmID (опц.)
limit	integer	–	–
offset	integer	–	–
shop_id	string	yes	ID магазина (из wb_list_shops)

No output schema declared.

No examples provided.

wb_prices_quarantine ~74

[P0] Товары в ценовом карантине — цена снижена слишком сильно (≥3x), новая цена НЕ применяется. Проверяй регулярно!

Input Output Examples

Name	Type	Req	Description
limit	integer	–	–
offset	integer	–	–
shop_id	string	yes	ID магазина (из wb_list_shops)

No output schema declared.

No examples provided.

wb_prices_set ~72

[P0] Установить/обновить цены и скидки. Каждый элемент: {nmID, price, discount}.

Input Output Examples

Name	Type	Req	Description
data	array	yes	Массив: [{nmID, price, discount}, ...]
shop_id	string	yes	ID магазина (из wb_list_shops)

No output schema declared.

No examples provided.

wb_prices_size_list ~54

[P2] Цены по размерам конкретного товара.

Input Output Examples

Name	Type	Req	Description
limit	integer	–	–
nm_id	integer	yes	–
shop_id	string	yes	ID магазина (из wb_list_shops)

No output schema declared.

No examples provided.

wb_prices_upload_status ~95

[P1] Статус загрузки цен по uploadID (из wb_prices_set). buffer=true — для отложенных загрузок (скидки к будущей акции).

Input Output Examples

Name	Type	Req	Description
buffer	boolean	–	–
details	boolean	–	true = детализация по товарам с ошибками
shop_id	string	yes	ID магазина (из wb_list_shops)
upload_id	integer	yes	–

No output schema declared.

No examples provided.

wb_promotion_exit ~85

[P0] Выйти из акции/автоакции — восстановить цену и скидку (отдельного API выхода у WB нет, делается через Prices API).

Input Output Examples

Name	Type	Req	Description
data	array	yes	[{nmID, price, discount}, ...] — доакционные значения
shop_id	string	yes	ID магазина (из wb_list_shops)

No output schema declared.

No examples provided.

wb_promotions_add_products ~88

[P1] Добавить товары в акцию. upload_now=false — отложенно (применится при старте акции). Возвращает uploadID для отслеживания.

Input Output Examples

Name	Type	Req	Description
nm_ids	array	yes	–
promotion_id	integer	yes	–
shop_id	string	yes	ID магазина (из wb_list_shops)
upload_now	boolean	–	–

No output schema declared.

No examples provided.

wb_promotions_audit ~187

[P0] Аудит участия: в какие акции WB УЖЕ добавил мои товары и каков ценовой эффект (price→planPrice, % падения, скидка). ВАЖНО: для автоакций состав товаров WB через API не отдаёт (помечаются nomenclaturesAvailable=false) — контроль цен через wb_prices_list/wb_prices_quarantine. Авто-throttle под лимит 10 req/6 сек.

Input Output Examples

Name	Type	Req	Description
end	string	yes	RFC3339
max_promotions	integer	–	Сколько акций проверить (защита от лимита)
only_auto	boolean	–	true = только автоакции (состав недоступен); false = все акции
shop_id	string	yes	ID магазина (из wb_list_shops)
start	string	yes	RFC3339

No output schema declared.

No examples provided.

wb_promotions_auto ~90

[P0] ТОЛЬКО автоакции (type=auto) за период — WB добавляет товары автоматически. Используй для регулярного мониторинга, чтобы цены не упали без твоего ведома.

Input Output Examples

Name	Type	Req	Description
end	string	yes	RFC3339
shop_id	string	yes	ID магазина (из wb_list_shops)
start	string	yes	RFC3339

No output schema declared.

No examples provided.

wb_promotions_details ~66

[P1] Детали акций: даты, условия (ranging/boost), слоты участников, participationPercentage, бонусы (advantages), type.

Input Output Examples

Name	Type	Req	Description
promotion_ids	array	yes	–
shop_id	string	yes	ID магазина (из wb_list_shops)

No output schema declared.

No examples provided.

wb_promotions_list ~173

[P0] Список акций WB за период. type акции: 'auto' = АВТОАКЦИЯ (WB добавляет товары сам!), 'regular' = обычная. КРИТИЧНО: мониторь автоакции регулярно.

Input Output Examples

Name	Type	Req	Description
all_promo	boolean	–	false = только доступные для участия, true = все
end	string	yes	RFC3339
limit	integer	–	1–1000
offset	integer	–	–
promo_type	string	–	Фильтр по типу: auto \| regular (опц.)
shop_id	string	yes	ID магазина (из wb_list_shops)
start	string	yes	RFC3339 (2026-06-01T00:00:00Z)

No output schema declared.

No examples provided.

wb_promotions_products ~109

[P1] Товары, подходящие для акции. in_action: true = уже участвуют, false = не участвуют. Возвращает price/planPrice и discount/planDiscount.

Input Output Examples

Name	Type	Req	Description
in_action	boolean	–	Фильтр участия (опц.)
limit	integer	–	1–1000
offset	integer	–	–
promotion_id	integer	yes	–
shop_id	string	yes	ID магазина (из wb_list_shops)

No output schema declared.

No examples provided.

On this page

Handy links

Scoring key

80+ high trust
60–79 medium
below 60 low

How we score

Score history · last 30 days

21 Aug 22 Aug