Wildberries Agent Integration MCP Server

Вызывайте, когда пользователь хочет подключить, добавить или переподключить кабинет Wildberries. Инструмент создаёт безопасный браузерный переход Seller, но сам не завершает подключение. Пользователь вводит персональный токен Wildberries только на странице Seller; инструмент никогда не принимает и не возвращает токен. Не вызывайте для простой проверки уже существующего подключения — используйте wb_connection_status.

Вызывайте, когда пользователь хочет подключить Telegram к Seller для уведомлений. Инструмент только запускает безопасный сценарий привязки и не настраивает типы, расписание или правила уведомлений. Не обещайте, что правила уведомлений изменены, если отдельного инструмента для этого нет.

Вызывайте, когда пользователь спрашивает, где товары продаются лучше или хуже, либо просит продажи по регионам. Группирует региональные записи Seller за включительный период date_from—date_to; относительные даты преобразуйте по общим правилам сервера и сообщите точный период. Не используйте веб-поиск. Записи Sales включают возвраты и сторно и поэтому не являются чистыми продажами.

Вызывайте, когда пользователь просит проверить связь температуры или погоды с продажами товара. Сопоставляет публичный погодный ряд с дневными записями Sales из Seller по артикулу, региону и включительному периоду. Публичную погоду разрешено получить из открытого источника, но продажи нельзя заменять веб-поиском. Всегда сообщайте размер совпавшей выборки и не называйте корреляцию влиянием или причиной.

Вызывайте для пользовательских запросов о заказах, продажах, возвратах, выручке, комиссиях, логистике или общей аналитике торговли за период. Не оценивайте эти показатели самостоятельно и не заменяйте их веб-поиском. date_from и date_to включительны; относительный период преобразуйте по общим правилам сервера и сообщите точные даты. Разницу между выручкой и расходами WB не называйте чистой прибылью без себестоимости, налогов и прочих затрат.

Всегда вызывайте для расчёта конкурентного ценового диапазона по известным ценам, даже если арифметику можно выполнить в ответе модели. Инструмент детерминированно рассчитывает межквартильный коридор, позицию цены и целевой ориентир, а при наличии себестоимости и маржи — нижнюю границу. Ничего не записывает. Комиссии, логистика и прочие расходы в границу не входят; для полной экономики используйте wb_unit_economics.

Вызывайте, когда пользователь просит сравнить свой товар с похожими предложениями или понять, дороже ли он рынка. Инструмент получает похожие товары из принадлежащего Seller источника и рассчитывает прозрачное сравнение цен; переданные competitor_rows имеют приоритет. Не заменяйте недоступные закрытые данные веб-поиском и не выдумывайте цены. Для расчёта только по уже известному списку цен без поиска товаров используйте wb_competitive_price.

Вызывайте, когда пользователь спрашивает, подключён ли кабинет Wildberries, или когда данные Seller недоступны. Возвращает состояние подключения текущего аккаунта без учётных данных. Не утверждайте, что требуется переподключение, пока этот инструмент не вернул соответствующий статус.

Вызывайте, когда пользователь просит определить, какие товары срочно пополнить, сколько отправить и на какие склады или регионы, исходя из его кабинета Seller. Читает доступный спрос и остатки, затем возвращает прозрачный прогноз с допущениями на заданный горизонт. Не заменяйте закрытые данные веб-поиском и не обещайте будущие продажи; для расчёта одного количества только по заданным числам используйте wb_replenishment_math.

Вызывайте, когда пользователь просит обновить, синхронизировать или сделать свежей аналитику кабинета. Ставит фоновое обновление статистики выбранного поставщика в очередь Seller, но не ждёт завершения отчёта. period — число последних дней от 1 до 366; постановка задачи не требует подтверждения и не удаляет данные.

Всегда вызывайте для точного расчёта количества к отправке по средним дневным продажам, текущему остатку, товару в пути, целевому покрытию и страховочному запасу, даже если модель может посчитать сама. Использует фиксированную формулу и округление вверх; не читает Seller и не распределяет товар по складам. Для рекомендаций на основе кабинета и складов используйте wb_inventory_forecast.

Всегда вызывайте, когда пользователь просит проверить SEO карточки, оценить заголовок, описание или ключевые слова, даже если модель может дать общие советы сама. Возвращает детерминированный score, разбивку и приоритетные улучшения по прозрачной эвристике. Ничего не публикует и не обещает позицию в поиске Wildberries.

Вызывайте, когда пользователь просит показать подключённые кабинеты Wildberries, а также перед инструментом с обязательным supplier_id_wb, если кабинет ещё не определён. Возвращает только доступные текущему пользователю кабинеты без учётных данных и токенов; если кабинет один, используйте его без дополнительного вопроса.

Всегда вызывайте для расчёта прибыли с единицы, маржи, рентабельности, точки безубыточности или целевой цены, даже если модель может выполнить арифметику сама. Детерминированно учитывает только явно переданные цену, скидку, себестоимость, комиссию, логистику, хранение, рекламу, налог и прочие затраты; отсутствующие затраты считает нулевыми и не должен выдавать неполный расчёт за фактическую чистую прибыль.

Вызывайте, когда пользователь просит установить или изменить себестоимость товара в Seller. Это двухшаговая перезапись: первый вызов всегда делайте с confirm=false, покажите пользователю кабинет, артикул и сумму из confirmation_required, затем остановитесь. Только после отдельного сообщения с явным подтверждением пользователя повторите тот же вызов с confirm=true и выданным confirmation_token. Не используйте ранее данное общее согласие. Если кабинет, артикул или сумма изменились, получите новый preview с confirm=false.

Вызывайте, когда пользователь спрашивает текущие остатки товара, наличие по складам или где заканчивается запас. Читает Seller/Wildberries для 1–1000 артикулов и не изменяет остатки. Не заменяйте недоступные складские данные веб-поиском; прогноз будущего пополнения выполняет wb_inventory_forecast.

Вызывайте этот резервный инструмент для разрешённых чтений Seller/Wildberries, у которых нет специализированного инструмента, например отзывов, карточек или статуса обновления. Для аналитики, конкурентов, регионов, остатков и прогнозов используйте соответствующий специализированный wb_* инструмент, а не этот прокси. Не заменяйте ошибку закрытого источника веб-поиском. Агент передаёт только operation и payload: URL, HTTP-метод и токен модели недоступны.