MCPHIVE

Wildberries MCP: Документация

Обновлено:

Подключение

npx -y @theyahia/wildberries-mcp (stdio) или с флагом --http (Streamable HTTP, порт из PORT). Auth: WB_API_TOKEN — JWT продавца из seller.wildberries.ru → Настройки → Доступ к API (срок 180 дней, состоит из 9 category-скоупов, недостающий скоуп даёт 401 только от своего хоста).

Что умеет

30 инструментов по хостам WB API: товары и контент (list_products, get_product, update_prices), склад и заказы (update_stocks, get_stocks, get_orders, get_new_orders, get_warehouses, get_supply/create_supply/add_orders_to_supply/deliver_supply/get_supply_barcode), статистика (get_sales, get_incomes, get_fbw_stocks, get_statistics, get_abc_analysis), аналитика (get_funnel, get_paid_storage), тарифы (get_commission, get_tariffs), отзывы и вопросы (get_feedbacks/reply_feedback, get_questions/reply_question), возвраты и реклама (get_returns, get_balance, list_campaigns, get_campaign_stats).

Сценарий для агента

«Сделай ABC-анализ продаж за 30 дней», «собери поставку FBS и закрой на отгрузку», «покажи неотвеченные вопросы и предложи ответ на первый».

Ограничения

WB лимитирует запросы отдельно по каждой категории API и штрафует всплески кодом 409 — сервер сам выжидает нужное время по заголовкам X-Ratelimit-*, но частые операции всё равно идут по очереди.

Важно

Community-проект (автор theYahia, серия «Russian API MCP»), не официальный продукт Wildberries.