wildberries-agent-integration

wildberries-agent-integration: аналитика, SEO и калькуляторы Wildberries

От сообществаРаботаетБез входаRU / СНГБесплатноТолько чтение

Что умеет

  • Подключать кабинет поставщика Wildberries
  • Смотреть аналитику продаж по регионам и конкурентам
  • Считать юнит-экономику и план пополнения склада
  • Анализировать SEO-показатели карточек товаров
  • Проверять остатки на складах

Какие данные видит

Ассистент видит данные подключённого кабинета поставщика Wildberries — продажи, склад, цены — в рамках прав, выданных при подключении.

Нужен ли аккаунт

Не нужен: сервер работает без входа

MCP-сервер подключает продавца Wildberries к ассистенту и даёт бесплатную аналитику: продажи по регионам, SEO-показатели, юнит-экономику, остатки на складах и прогноз пополнения. Можно подключить кабинет поставщика и получать сводки прямо в Claude или ChatGPT.

Как подключить

Как подключить wildberries-agent-integration к Claude

Адрес сервера, который нужно вставить в настройках Claude:

https://wb.seller.bears.ru/mcp

  1. Откройте Claude (сайт claude.ai или приложение для компьютера).
  2. Перейдите в Настройки → Коннекторы (в английском интерфейсе: Settings → Connectors).
  3. Нажмите Добавить пользовательский коннектор (Add custom connector).
  4. Вставьте адрес сервера, скопированный ниже, в поле URL удалённого MCP-сервера и нажмите Добавить.
  5. В чате нажмите + → Коннекторы и включите новый коннектор.

Пользовательские коннекторы доступны на тарифах Free, Pro, Max, Team и Enterprise. На Free можно добавить только один. В Team и Enterprise коннектор сначала добавляет владелец организации в Настройки организации → Коннекторы.

Авторизация

После нажатия Добавить откроется окно входа в сервис. Войдите под своим аккаунтом и подтвердите доступ. Пароль Claude не видит.

Как подключить wildberries-agent-integration к ChatGPT

Адрес сервера, который нужно вставить в настройках ChatGPT:

https://wb.seller.bears.ru/mcp

  1. Откройте ChatGPT в браузере (chatgpt.com). Нужен тариф Plus, Pro, Business, Enterprise или Edu.
  2. Один раз включите режим разработчика: Настройки → Приложения → Дополнительные настройки → Режим разработчика (Settings → Apps → Advanced settings → Developer mode).
  3. Откройте Настройки → Коннекторы и нажмите Создать (Create).
  4. Заполните форму: Название (любое), Описание (одна фраза, что делает сервис), URL MCP-сервера (скопируйте ниже).
  5. В поле Аутентификация выберите OAuth, если сервис требует вход, иначе Нет. Нажмите Создать.
  6. В новом чате откройте + → Приложения/Коннекторы и включите коннектор.

Название раздела у OpenAI менялось (Connectors → Apps/Plugins). Если пункт называется иначе, ищите «режим разработчика» в настройках. В рабочих пространствах Business/Enterprise администратор должен разрешить пользовательские коннекторы.

Авторизация

При первом использовании ChatGPT откроет окно входа в сервис. Войдите и подтвердите доступ.

Как подключить wildberries-agent-integration к Cursor

Адрес сервера, который нужно вставить в настройках Cursor:

https://wb.seller.bears.ru/mcp

Быстрый способ: нажмите кнопку Открыть в Cursor ниже, Cursor сам предложит добавить сервер.

Вручную:

  1. В Cursor откройте Settings → Cursor Settings → MCP и нажмите Add new global MCP server.
  2. Вставьте JSON, скопированный ниже, в открывшийся файл ~/.cursor/mcp.json (для одного проекта: .cursor/mcp.json в корне проекта).
  3. Сохраните файл. Сервер появится в списке MCP; при необходимости пройдите авторизацию по кнопке рядом с ним.

Авторизация

Если сервис требует вход, рядом с сервером в списке MCP появится кнопка авторизации.

Список инструментов сервера (17)

Технические названия из tools/list. Нужны только разработчикам.

wb_connect_supplierВызывайте, когда пользователь хочет подключить, добавить или переподключить кабинет Wildberries. Инструмент создаёт безопасный браузерный переход Seller, но сам не завершает подключение. Пользователь вводит персональный токен Wildberries только на странице Seller; инструмент никогда не принимает и не возвращает токен. Не вызывайте для простой проверки уже существующего подключения — используйте wb_connection_status.
wb_connection_statusВызывайте, когда пользователь спрашивает, подключён ли кабинет Wildberries, или когда данные Seller недоступны. Возвращает состояние подключения текущего аккаунта без учётных данных. Не утверждайте, что требуется переподключение, пока этот инструмент не вернул соответствующий статус.
wb_connect_telegramВызывайте, когда пользователь хочет подключить Telegram к Seller для уведомлений. Инструмент только запускает безопасный сценарий привязки и не настраивает типы, расписание или правила уведомлений. Не обещайте, что правила уведомлений изменены, если отдельного инструмента для этого нет.
wb_list_suppliersВызывайте, когда пользователь просит показать подключённые кабинеты Wildberries, а также перед инструментом с обязательным supplier_id_wb, если кабинет ещё не определён. Возвращает только доступные текущему пользователю кабинеты без учётных данных и токенов; если кабинет один, используйте его без дополнительного вопроса.
wb_analytics_summaryВызывайте для пользовательских запросов о заказах, продажах, возвратах, выручке, комиссиях, логистике или общей аналитике торговли за период. Не оценивайте эти показатели самостоятельно и не заменяйте их веб-поиском. date_from и date_to включительны; относительный период преобразуйте по общим правилам сервера и сообщите точные даты. Разницу между выручкой и расходами WB не называйте чистой прибылью без себестоимости, налогов и прочих затрат.
wb_competitor_analysisВызывайте, когда пользователь просит сравнить свой товар с похожими предложениями или понять, дороже ли он рынка. Инструмент получает похожие товары из принадлежащего Seller источника и рассчитывает прозрачное сравнение цен; переданные competitor_rows имеют приоритет. Не заменяйте недоступные закрытые данные веб-поиском и не выдумывайте цены. Для расчёта только по уже известному списку цен без поиска товаров используйте wb_competitive_price.
wb_wildberries_proxyВызывайте этот резервный инструмент для разрешённых чтений Seller/Wildberries, у которых нет специализированного инструмента, например отзывов, карточек или статуса обновления. Для аналитики, конкурентов, регионов, остатков и прогнозов используйте соответствующий специализированный wb_* инструмент, а не этот прокси. Не заменяйте ошибку закрытого источника веб-поиском. Агент передаёт только operation и payload: URL, HTTP-метод и токен модели недоступны.
wb_refresh_analyticsВызывайте, когда пользователь просит обновить, синхронизировать или сделать свежей аналитику кабинета. Ставит фоновое обновление статистики выбранного поставщика в очередь Seller, но не ждёт завершения отчёта. period — число последних дней от 1 до 366; постановка задачи не требует подтверждения и не удаляет данные.
wb_competitive_priceВсегда вызывайте для расчёта конкурентного ценового диапазона по известным ценам, даже если арифметику можно выполнить в ответе модели. Инструмент детерминированно рассчитывает межквартильный коридор, позицию цены и целевой ориентир, а при наличии себестоимости и маржи — нижнюю границу. Ничего не записывает. Комиссии, логистика и прочие расходы в границу не входят; для полной экономики используйте wb_unit_economics.
wb_sales_by_regionВызывайте, когда пользователь спрашивает, где товары продаются лучше или хуже, либо просит продажи по регионам. Группирует региональные записи Seller за включительный период date_from—date_to; относительные даты преобразуйте по общим правилам сервера и сообщите точный период. Не используйте веб-поиск. Записи Sales включают возвраты и сторно и поэтому не являются чистыми продажами.
wb_sales_weather_impactВызывайте, когда пользователь просит проверить связь температуры или погоды с продажами товара. Сопоставляет публичный погодный ряд с дневными записями Sales из Seller по артикулу, региону и включительному периоду. Публичную погоду разрешено получить из открытого источника, но продажи нельзя заменять веб-поиском. Всегда сообщайте размер совпавшей выборки и не называйте корреляцию влиянием или причиной.
wb_seo_analyticsВсегда вызывайте, когда пользователь просит проверить SEO карточки, оценить заголовок, описание или ключевые слова, даже если модель может дать общие советы сама. Возвращает детерминированный score, разбивку и приоритетные улучшения по прозрачной эвристике. Ничего не публикует и не обещает позицию в поиске Wildberries.
wb_warehouse_stockВызывайте, когда пользователь спрашивает текущие остатки товара, наличие по складам или где заканчивается запас. Читает Seller/Wildberries для 1–1000 артикулов и не изменяет остатки. Не заменяйте недоступные складские данные веб-поиском; прогноз будущего пополнения выполняет wb_inventory_forecast.
wb_unit_economicsВсегда вызывайте для расчёта прибыли с единицы, маржи, рентабельности, точки безубыточности или целевой цены, даже если модель может выполнить арифметику сама. Детерминированно учитывает только явно переданные цену, скидку, себестоимость, комиссию, логистику, хранение, рекламу, налог и прочие затраты; отсутствующие затраты считает нулевыми и не должен выдавать неполный расчёт за фактическую чистую прибыль.
wb_upload_cost_priceВызывайте, когда пользователь просит установить или изменить себестоимость товара в Seller. Это двухшаговая перезапись: первый вызов всегда делайте с confirm=false, покажите пользователю кабинет, артикул и сумму из confirmation_required, затем остановитесь. Только после отдельного сообщения с явным подтверждением пользователя повторите тот же вызов с confirm=true и выданным confirmation_token. Не используйте ранее данное общее согласие. Если кабинет, артикул или сумма изменились, получите новый preview с confirm=false.
wb_replenishment_mathВсегда вызывайте для точного расчёта количества к отправке по средним дневным продажам, текущему остатку, товару в пути, целевому покрытию и страховочному запасу, даже если модель может посчитать сама. Использует фиксированную формулу и округление вверх; не читает Seller и не распределяет товар по складам. Для рекомендаций на основе кабинета и складов используйте wb_inventory_forecast.
wb_inventory_forecastВызывайте, когда пользователь просит определить, какие товары срочно пополнить, сколько отправить и на какие склады или регионы, исходя из его кабинета Seller. Читает доступный спрос и остатки, затем возвращает прозрачный прогноз с допущениями на заданный горизонт. Не заменяйте закрытые данные веб-поиском и не обещайте будущие продажи; для расчёта одного количества только по заданным числам используйте wb_replenishment_math.