wildberries-mcp-ru
MCP server for the Wildberries seller API: it exposes 307 catalog methods across 17 WB hosts for discovery, safe execution, pagination, credential management, and ready-made analytics workflows.
Check credentials and manage multiple seller cabinets (list, add, switch, rotate keys, remove), stored locally with chmod 600.
Explore the API catalog: list sections, list endpoints in a section, search methods in Russian/English, view an entity map, and describe individual methods (host, path, params, rate limit, safety).
Execute any catalog endpoint by operation_id; read endpoints run immediately, write endpoints require
confirm_write=true, destructive ones need an extra confirmation.Call arbitrary raw API paths outside the catalog with HTTP-verb-based safety inference.
Auto-paginate read endpoints and fetch all rows in one response (
wb_fetch_all, capped at 10,000 items by default).Use built-in convenience tools: sales and returns, current stocks, new FBS orders, prices and discounts, and set price/discount for one product.
Browse ready-made analytical workflows and get step-by-step execution plans with interpretation guidance and common mistakes.
wildberries-mcp-ru
API Wildberries для ИИ-ассистентов: продажи и остатки, карточки и характеристики, цены и акции, финансовые отчёты, отзывы. Семнадцать хостов WB разложены по каталогу.
Пакет поднимает один сервер, Wildberries, и ничего больше. Сервер, каталог и
ядро приходят зависимостью из marketplaces-mcp-ru:
здесь имя, точка входа и документация под один маркетплейс.
Установка
Пакет на PyPI, поэтому строка одна:
uvx wildberries-mcp-ruЕсли нужна ветка main, а не релиз:
uvx --from git+https://github.com/ilyautov/wildberries-mcp-ru wildberries-mcp-ruClaude Desktop, claude_desktop_config.json:
{
"mcpServers": {
"wb": {
"command": "uvx",
"args": ["wildberries-mcp-ru"],
"env": { "WB_API_TOKEN": "..." }
}
}
}Третий путь, если агент умеет скиллы: он поставит сервер и настроит клиент сам.
npx skills add ilyautov/wildberries-mcp-ruRelated MCP server: marketplace-mcp
Ключи
Где взять токен. Кабинет seller.wildberries.ru, раздел Настройки, пункт Доступ к API. Токен один на все хосты, но при создании выбираются категории доступа: выданный только под контент токен не пустят в статистику.
Как он уходит в запрос. В заголовок Authorization, и это важный нюанс: сервер шлёт raw-токен без префикса Bearer. Подтверждено на практике. Если авторизация падает при верном токене, проверьте это первым.
Где он лежит. В ~/.marketplace-mcp/cabinets.json с правами chmod 600, локально. В репозиторий и в чат токен не попадает.
переменная | секрет | что это |
| да | Токен из кабинета seller.wildberries.ru, Настройки → Доступ к API. Уходит в Authorization без Bearer. |
Ключи можно не держать в окружении: сервер умеет кабинеты и кладёт их в
~/.marketplace-mcp/cabinets.json с правами 600, вне репозитория. Магазинов
подключается сколько нужно, переключение прямо из чата.
Карта методов
Каталог лежит в зависимости как wb_mcp/endpoints.yaml:
307 методов, из них 187 на чтение, 108 на запись и 12 необратимых.
Сервер исполняет ровно этот файл, поэтому таблица не может разойтись с кодом.
хост | методов | что там |
| 100 | Сборочные задания и поставки FBS, DBS, DBW, самовывоз |
| 40 | Аналитика продавца: поисковые запросы, остатки, удержания, платное хранение |
| 31 | Карточки товаров, характеристики, категории, медиа, ярлыки |
| 30 | Рекламные кампании, ставки, поисковые кластеры |
| 22 | Цифровые товары: контент, предложения, ключи активации |
| 20 | Отзывы, вопросы, закреплённые отзывы |
| 13 | Цены, скидки, календарь акций |
| 10 | Информация о продавце, тарифы, комиссии, новости |
| 7 | Поставки на склад WB и данные для их формирования |
| 7 | Финансовые отчёты и баланс |
| 5 | Статистика: продажи, заказы, остатки, отчёт о реализации |
| 4 | Пользователи продавца и их права |
| 4 | Медиа в рекламе и статистика по ним |
| 4 | Календарь акций и участие в них |
| 4 | Чат с покупателями |
| 4 | Документы продавца |
| 2 | Возвраты покупателями |
Подробный разбор с параметрами и лимитами: https://marketplaces-mcp-ru.aifrontier.tech/wildberries-api.html
Что спросить в чате
покажи продажи на WB за неделю
вытащи финотчёт реализации за прошлый месяц
что пора дозаказать, посчитай дни покрытия
какие товары рискуют уйти в out-of-stock
Частые ошибки
401 при верном токене. Две причины по частоте. Первая: WB ждёт raw-токен в Authorization без Bearer. Вторая: активный кабинет в ~/.marketplace-mcp/cabinets.json имеет приоритет над переменными окружения и затеняет то, что вы экспортировали.
404 или пустой ответ на рабочем методе. Проверьте хост. У WB семнадцать доменов по назначению, и статистика на домене контента не отвечает. Таблица хостов выше.
429, превышен лимит запросов. Лимиты у WB заданы поштучно и местами очень жёсткие: у части методов это один запрос в минуту, у отчётов бывает и реже. Лимит привязан к методу, а не к аккаунту целиком, поэтому упереться можно на одном отчёте, пока остальное работает.
Чем это отличается от marketplaces-mcp-ru
Ничем, кроме состава. marketplaces-mcp-ru ставит четыре маркетплейса сразу и держит их
под одним сервером, wildberries-mcp-ru ставит один. Код общий: правка в ядре доезжает
сюда обновлением зависимости, а не копированием.
нужно | пакет |
только Wildberries |
|
все четыре маркетплейса |
|
Кто это сделал
Илья Утов, лаборатория AI Frontier. Как эти инструменты устроены внутри, пишу в Telegram и LinkedIn.
Рядом стоят business-mcp-ru (hh.ru, VK, Диадок, СБИС, Честный знак), moysklad-mcp-ru и humanizer-ru.
Все проекты одним списком, разобранные по назначению: ilyautov.github.io.
Лицензия
MIT, см. LICENSE.
Available Tools
25 toolswb_add_cabinetAIdempotent
Add or update a cabinet (a named set of API credentials), from chat.
⚠️ This puts the key into the chat transcript — requires i_understand_key_goes_to_chat=true. The terminal-free safe alternative is the installer (install.py / double-click), where the key never enters chat.
Args: credentials: dict with the required fields for this service ({fields}). For Ozon: {{"client_id": "...", "api_key": "..."}}; for WB: {{"token": "..."}}. name: optional label. If omitted, the cabinet is named after the real shop name fetched from the marketplace (falls back to "main"). i_understand_key_goes_to_chat: must be true to proceed. Saved to ~/.marketplace-mcp/cabinets.json (local, chmod 600), never echoed.
Inputs: credentials (required), name, i_understand_key_goes_to_chat. Returns: result
wb_call_methodARead-only
Execute one READ endpoint from the catalog by operation_id.
Target API: https://dev.wildberries.ru/en/openapi/api-information.
Reads only: nothing here changes data, so it runs without confirmation. To change data use wb_write_method, to delete use wb_delete_method.
Args: operation_id: id from the catalog (see wb_search_methods). path_values: values for {placeholders} in the path. query: query-string parameters. body: JSON request body (a few read endpoints take one). Returns JSON: {"ok": true, "status", "data"} or the error envelope.
Inputs: operation_id (required), body, query, path_values. Returns: result
wb_check_authARead-only
Check whether the required credentials are present in the environment.
Does NOT reveal secret values — only reports which variables are set. Returns JSON: {"ready": bool, "missing": [str], "required": [str]}.
Inputs: no named parameters. Returns: result
wb_delete_methodADestructive
Execute one DESTRUCTIVE endpoint: deletes or irreversibly changes data.
Target API: https://dev.wildberries.ru/en/openapi/api-information.
Both confirm_write=true and i_understand_this_modifies_data=true are required; nothing is sent without both.
Args: operation_id: id from the catalog (see wb_search_methods). path_values: values for {placeholders} in the path. query: query-string parameters. body: JSON request body. confirm_write: must be true. i_understand_this_modifies_data: must be true. Returns JSON: {"ok": true, "status", "data"} or the error envelope.
Inputs: operation_id (required), body, query, path_values, +2 more. Returns: result
wb_delete_rawADestructive
Delete data at ANY path, including paths not in the catalog.
Target API: https://dev.wildberries.ru/en/openapi/api-information.
DELETE only. Both confirm_write=true and i_understand_this_modifies_data=true are required.
Args: path: full path beginning with '/'. method: DELETE. host: host override; defaults to the service's default host. query: query-string parameters. body: JSON request body. confirm_write: must be true. i_understand_this_modifies_data: must be true. Returns JSON: {"ok": true, "status", "data"} or the error envelope.
Inputs: path (required), body, host, query, +3 more. Returns: result
wb_describe_methodARead-only
Return the full catalog record for one endpoint: method, host, path, scope, safety level, pagination style, rate limit, params and doc URL.
Inputs: operation_id (required). Returns: result
wb_fetch_allARead-only
Auto-paginate a read endpoint and return every row in one response.
Handles offset, last_id, cursor (Ozon v4/v5), page and WB lastChangeDate styles. The array path is taken from the catalog automatically.
Args: operation_id: a read endpoint from the catalog. query / body / path_values: base parameters (cursor fields are managed). items_path: override the array path (default: the endpoint's own). limit: page size to request. max_items: hard cap to protect context (default 10000). Returns JSON: {"ok", "items", "total_fetched", "pages_fetched", "truncated"}.
Inputs: operation_id (required), body, limit, query, +3 more. Returns: result
wb_get_new_ordersARead-only
Get new FBS assembly orders awaiting processing (Marketplace API).
Returns JSON: {"ok": true, "data": {"orders": [...]}} — each order has id, rid, article, skus, createdAt, warehouseId.
Inputs: no named parameters. Returns: result
wb_get_pricesARead-only
Get current prices and discounts for products (Discounts-Prices API).
Args: limit: page size (<=1000). offset: pagination offset. filter_nm_id: optional single nmID to filter by. Returns JSON: {"ok": true, "data": {"listGoods": [{nmID, sizes, discount, ...}]}}.
Inputs: limit, offset, filter_nm_id. Returns: result
wb_get_rawARead-only
Read ANY endpoint by path, including ones missing from the catalog.
Target API: https://dev.wildberries.ru/en/openapi/api-information.
Safe verbs only (GET, HEAD, OPTIONS). To change data use wb_write_raw, to delete use wb_delete_raw.
Args: path: full path beginning with '/', e.g. "/ping". method: safe verb, GET by default. host: host override; defaults to the service's default host. query: query-string parameters. body: JSON request body (rare on reads; some APIs want one). Returns JSON: {"ok": true, "status", "data"} or the error envelope.
Inputs: path (required), body, host, query, +1 more. Returns: result
wb_get_salesARead-only
Get Wildberries sales and returns since a date (Statistics API, 1 req/min).
Args: date_from: RFC3339 date/time in MSK, e.g. "2026-06-01" or "2026-06-01T00:00:00". flag: 0 = rows changed since date_from (incremental); 1 = rows dated on date_from. Returns JSON: {"ok": true, "status", "data": [ sale rows ]} or error envelope. Each row includes saleID, srid, nmId, totalPrice, forPay, lastChangeDate.
Inputs: date_from (required), flag. Returns: result
wb_get_sectionARead-only
List all endpoints in one section.
Args: section: section name (see wb_list_sections), e.g. "statistics". Returns JSON list of {operation_id, method, path, safety, summary}.
Inputs: section (required). Returns: result
wb_get_stocksARead-only
Get the current Wildberries stock snapshot (Statistics API, 1 req/min).
Stocks have no history — this is a point-in-time snapshot. Use an early date_from to get the full current set.
Args: date_from: RFC3339 date; default "2020-01-01" returns everything in stock now. Returns JSON: {"ok": true, "data": [ stock rows ]} with quantity, warehouseName, nmId.
Inputs: date_from. Returns: result
wb_get_workflowARead-only
Return the full plan for one workflow: ordered steps (each naming a catalog operation_id and why), interpretation guidance, and common mistakes to avoid.
Args: name: workflow name (see {svc}_list_workflows).
Inputs: name (required). Returns: result
wb_list_cabinetsARead-only
List configured cabinets for this marketplace and which one is active.
Returns JSON: {"active": str|null, "cabinets": [names], "fields_needed": [...]}. Secret values are never returned.
Inputs: no named parameters. Returns: result
wb_list_sectionsARead-only
List API sections and how many catalog endpoints each contains.
Inputs: no named parameters. Returns: result
wb_list_workflowsARead-only
List ready-made analytical workflows (recipes) for this marketplace.
Returns JSON: [{name, category, when_to_use}]. Use {svc}_get_workflow to fetch the full step-by-step plan for one.
Inputs: no named parameters. Returns: result
wb_mapARead-only
The big picture: business entities this API covers and the go-to methods for each. Call with no args to see the whole map ("you are here"); pass entity="reviews" (or stocks/prices/orders/…) to list every method of one entity. Use this before guessing — it orients you fast.
Inputs: entity. Returns: result
wb_remove_cabinetADestructive
Delete a stored cabinet. If it was active, another becomes active.
Args: name: the cabinet to remove.
Inputs: name (required). Returns: result
wb_search_methodsARead-only
Search the endpoint catalog by keyword (works in Russian and English).
Args: query: free text, e.g. "остатки", "stocks", "update price". limit: max results (1-50). Returns JSON list of matching endpoints (best first).
Inputs: query (required), limit. Returns: result
wb_set_keyAIdempotent
Change / rotate the API key from chat (e.g. the old one expired or leaked).
⚠️ The key goes into the chat transcript — requires i_understand_key_goes_to_chat=true. The safe, terminal-free alternative is the installer, where the key never enters chat. Use a scoped key and rotate it in the seller cabinet if it was exposed.
Args: credentials: dict with the required fields ({fields}). cabinet: which cabinet to update. Default: the active one (so "my key expired" just works). If there is none, the cabinet is named from the marketplace's shop name, else "main". i_understand_key_goes_to_chat: must be true to proceed. On success the key is validated against the marketplace and the shop name is reported. Saved locally (chmod 600), never echoed back.
Inputs: credentials (required), cabinet, i_understand_key_goes_to_chat. Returns: result
wb_set_priceA
Set price and discount for ONE product (Discounts-Prices API). WRITE.
Requires confirm_write=true (this changes your live price). A new price 3x below the old one lands the product in WB price quarantine.
Args: nm_id: product nmID. price: new base price in rubles (integer). discount: discount percent (0-99). confirm_write: must be true to actually send the change. Returns JSON: {"ok": true, "data": {"id": uploadID}} — poll wb_prices_history_tasks.
Inputs: nm_id (required), price (required), discount, confirm_write. Returns: result
wb_use_cabinetAIdempotent
Switch the active cabinet. Subsequent API calls use its credentials.
Args: name: the cabinet to activate (see wb_list_cabinets).
Inputs: name (required). Returns: result
wb_write_methodA
Execute one WRITE endpoint from the catalog: create or update data.
Target API: https://dev.wildberries.ru/en/openapi/api-information.
Requires confirm_write=true; nothing is sent without it. Irreversible operations live in wb_delete_method, reads in wb_call_method.
Args: operation_id: id from the catalog (see wb_search_methods). path_values: values for {placeholders} in the path. query: query-string parameters. body: JSON request body. confirm_write: must be true. Returns JSON: {"ok": true, "status", "data"} or the error envelope.
Inputs: operation_id (required), body, query, path_values, +1 more. Returns: result
wb_write_rawA
Create or update data at ANY path, including paths not in the catalog.
Target API: https://dev.wildberries.ru/en/openapi/api-information.
POST, PUT and PATCH only; requires confirm_write=true.
Args: method: POST, PUT or PATCH. path: full path beginning with '/'. host: host override; defaults to the service's default host. query: query-string parameters. body: JSON request body. confirm_write: must be true. Returns JSON: {"ok": true, "status", "data"} or the error envelope.
Inputs: path (required), method (required), body, host, +2 more. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 25 tools
Each tool has a distinct role: discovery, catalog-based execution, raw path-based execution, credentials, workflows, and high-level business operations. The main ambiguity risk is between call/write/delete_method and the raw variants, but the descriptions clearly differentiate operation_id-based vs path-based invocation.
All tools share the wb_ prefix and mostly follow a verb_noun pattern (list_cabinets, search_methods, set_price). wb_map is a minor deviation, and list vs get is used consistently for collections vs single items.
25 tools sits at the upper boundary of the borderline-heavy range. The count is justified by the server's broad purpose as a full Wildberries API gateway with discovery, execution, credentials, workflows, and convenience operations, but it still feels dense for an agent to navigate.
The raw read/write/delete tools cover any path and HTTP verb, so no Wildberries endpoint is unreachable. Catalog discovery, pagination, credential lifecycle, and workflow recipes cover the surrounding operational needs, leaving no obvious dead ends.
Maintenance
Related MCP Connectors
Russian APIs for AI agents: YooKassa, CDEK, Bitrix24 and more. Ready scenarios with code. No key.
SEO score and checks for Wildberries, Ozon, Yandex Market product cards; AI card generation.
Connect your AI agent to 300+ methods and 100+ live tools
Live data for AI agents. Search the catalog, read the price, call the tool; keys stay server-side.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceConnects AI assistants to Wildberries and Ozon seller accounts for real-time access to sales, stocks, prices, finances, and reviews through official APIs.MIT
- AlicenseAqualityCmaintenanceEnables AI agents to read and work with Wildberries, Ozon, and Yandex Market seller accounts through typed tools, multi-account support, unified data schemas, rate limiting, audit, and encrypted credential storage.1751 npmMIT
- AlicenseAqualityBmaintenanceOzon Seller API in your AI assistant: products, FBS and FBO orders, prices, stocks, finance and reviews. 441 methods live in a YAML catalog the server executes, the agent searches it in plain language and calls a method through three generic tools, and every method carries an access class so writes and irreversible calls ask for confirmation.2561 PyPI3MIT
- AlicenseAqualityBmaintenanceYandex Market Partner API in your AI assistant: orders and returns, products and cards, prices and tariffs, reports, reviews and chats. 165 methods live in a YAML catalog the server executes, the agent searches it in plain language, and every method carries an access class so writes and irreversible calls ask for confirmation.2665 PyPI4MIT