API Wildberries: токен, хосты и ошибки
Главная засада Wildberries не в токене, а в адресе. Единого api.wildberries.ru не существует: у каждого назначения свой хост, и запрос на неверный домен выглядит как сломанная авторизация. Ниже полная таблица хостов из каталога, который грузит сервер.
Как получить доступ
Где взять токен
Кабинет seller.wildberries.ru, раздел Настройки, пункт Доступ к API. Токен один на все хосты, но при создании выбираются категории доступа: выданный только под контент токен не пустят в статистику.
Как он уходит в запрос
В заголовок Authorization, и это важный нюанс: сервер шлёт raw-токен без префикса Bearer. Подтверждено на практике. Если авторизация падает при верном токене, проверьте это первым.
Где он лежит
В ~/.marketplace-mcp/cabinets.json с правами chmod 600, локально. В репозиторий и в чат токен не попадает.
Карта методов
Таблицы собраны из того же каталога, который грузит сервер, поэтому они не расходятся с кодом. Колонки показывают, как метод классифицирует safety-гейт: перед записью агент предупреждает, перед необратимым действием требует подтверждения.
| Хост | Методов | За что отвечает |
|---|---|---|
| marketplace-api.wildberries.ru | 100 | Сборочные задания и поставки FBS, DBS, DBW, самовывоз |
| seller-analytics-api.wildberries.ru | 40 | Аналитика продавца: поисковые запросы, остатки, удержания, платное хранение |
| content-api.wildberries.ru | 31 | Карточки товаров, характеристики, категории, медиа, ярлыки |
| advert-api.wildberries.ru | 30 | Рекламные кампании, ставки, поисковые кластеры |
| devapi-digital.wildberries.ru | 22 | Цифровые товары: контент, предложения, ключи активации |
| feedbacks-api.wildberries.ru | 20 | Отзывы, вопросы, закреплённые отзывы |
| discounts-prices-api.wildberries.ru | 13 | Цены, скидки, календарь акций |
| common-api.wildberries.ru | 10 | Информация о продавце, тарифы, комиссии, новости |
| supplies-api.wildberries.ru | 7 | Поставки на склад WB и данные для их формирования |
| finance-api.wildberries.ru | 7 | Финансовые отчёты и баланс |
| statistics-api.wildberries.ru | 5 | Статистика: продажи, заказы, остатки, отчёт о реализации |
| user-management-api.wildberries.ru | 4 | Пользователи продавца и их права |
| advert-media-api.wildberries.ru | 4 | Медиа в рекламе и статистика по ним |
| dp-calendar-api.wildberries.ru | 4 | Календарь акций и участие в них |
| buyer-chat-api.wildberries.ru | 4 | Чат с покупателями |
| documents-api.wildberries.ru | 4 | Документы продавца |
| returns-api.wildberries.ru | 2 | Возвраты покупателями |
Курированное ядро выверено на живых кабинетах. Остальное импортировано из спецификаций: пути надёжны, HTTP-глаголы не всегда, считайте такие записи картой для разведки. Официальная документация: dev.wildberries.ru.
Частые ошибки и что они значат
401 при верном токене
Две причины по частоте. Первая: WB ждёт raw-токен в Authorization без Bearer. Вторая: активный кабинет в ~/.marketplace-mcp/cabinets.json имеет приоритет над переменными окружения и затеняет то, что вы экспортировали.
404 или пустой ответ на рабочем методе
Проверьте хост. У WB семнадцать доменов по назначению, и статистика на домене контента не отвечает. Таблица хостов выше.
429, превышен лимит запросов
Лимиты у WB заданы поштучно и местами очень жёсткие: у части методов это один запрос в минуту, у отчётов бывает и реже. Лимит привязан к методу, а не к аккаунту целиком, поэтому упереться можно на одном отчёте, пока остальное работает.
То же самое одной фразой
Если разбираться с методами руками не хочется, всё перечисленное выше вызывается из чата обычными словами. Проект и есть MCP-сервер: он отдаёт эти методы ИИ-ассистенту как инструменты, а тот подбирает нужный сам.
Скажите так
покажи продажи на WB за неделю вытащи финотчёт реализации за прошлый месяц что пора дозаказать, посчитай дни покрытия какие товары рискуют уйти в out-of-stockЧто для этого нужно
Ключи из первого раздела и одна строка установки. Нужен только Wildberries: отдельный пакет wildberries-mcp-ru, тот же сервер одним маркетплейсом. Нужны все четыре: npx -y marketplaces-mcp-ru или uvx marketplaces-mcp-ru, а в Claude Desktop бандл .mcpb из релизов ставится в один клик.
Частые вопросы
Как получить API-токен Wildberries?
seller.wildberries.ru, раздел Настройки, пункт Доступ к API. Токен один на все хосты, но при создании выбираются категории доступа: выданный только под контент токен не пустят в статистику.
Почему API Wildberries отвечает 401, хотя токен верный?
Wildberries ждёт raw-токен в заголовке Authorization без префикса Bearer. Вторая частая причина: активный кабинет в ~/.marketplace-mcp/cabinets.json имеет приоритет над переменными окружения и молча затеняет их.
Какой адрес у API Wildberries?
Единого адреса нет. У Wildberries семнадцать хостов по назначению: marketplace-api для сборочных заданий, statistics-api для продаж и остатков, content-api для карточек, discounts-prices-api для цен, seller-analytics-api для аналитики, feedbacks-api для отзывов и так далее. Полная таблица есть на этой странице.
Что делать при «превышен лимит запросов к API Wildberries»?
Лимиты заданы поштучно, у части методов это один запрос в минуту. Лимит привязан к методу, а не к аккаунту, поэтому упереться можно на одном отчёте, пока остальные методы работают. Помогает кэшировать ответ и не дёргать отчёт в цикле.
Можно поставить только Wildberries, без остальных маркетплейсов?
Да, для этого есть отдельный пакет wildberries-mcp-ru: он поднимает один сервер Wildberries, без остальных площадок. Внутри тот же код и тот же каталог, что в marketplaces-mcp-ru, они приходят зависимостью. Строка установки лежит в его репозитории.
Каталог методов открыт. Берите, форкайте, улучшайте.
Всё это лежит в репозитории под MIT, включая машиночитаемые каталоги, из которых собраны таблицы на этой странице. Нашли неточность в методе, поправьте или заведите issue.