io.github.BearsCLOUD/wildberries-agent-integration

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

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

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

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

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

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

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

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

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