На главную
Войти

WB Reports Helper: Инструкция по установке и использованию

Браузерное расширение для автоматического перехвата токенов авторизации Wildberries, пакетного скачивания отчетов и парсинга СПП с интеграцией в Google Таблицы.

🚀 Авторизоваться и скачать 📋 Шаблон таблицы WBTool
✅ Для Chromium браузеров ✅ Безопасный перехват токенов ✅ Интеграция с WBTool

Описание расширения

WB Reports Helper (v5.0) — специализированное браузерное расширение для Chromium-совместимых браузеров (Chrome, Edge, Opera, Yandex Browser). Разработано для автоматизации рутинных операций при работе с личным кабинетом продавца Wildberries и синхронизации данных с аналитической таблицей WBTool.

Основные функции:

  • Перехват сессионных токенов авторизации: Извлечение параметров authorizev3, wb-seller-lk, x-supplier-id-external и сессионных куки (cookie) при обычном посещении портала продавца. Токены используются для авторизации внешних скриптов автоматизации.
  • Пакетное скачивание финансовых отчетов: Автоматическая загрузка еженедельных детализированных отчетов в формате ZIP. Включает обход лимитов API, автоматические повторные попытки при ошибках и настраиваемую задержку в 5 секунд для исключения блокировок по HTTP 429.
  • Парсинг СПП (Скидки Постоянного Покупателя): Запрос розничных цен и расчет фактического процента СПП по списку артикулов через внутреннее API Wildberries.
  • Двусторонняя синхронизация с Google Таблицами: Загрузка списка артикулов из таблицы, фоновый расчет СПП и автоматическая запись результатов обратно в таблицу через эмуляцию буфера обмена.

Установка расширения

Пошаговое руководство по ручной установке в режиме разработчика

📢 Обратите внимание

Поскольку расширение является служебным инструментом разработчика и не опубликовано в Chrome Web Store, его установка выполняется в режиме разработчика.

  1. Скачайте архив с расширением по ссылке: Авторизоваться и скачать ZIP архив.
  2. Распакуйте архив в отдельную постоянную папку на вашем компьютере (например, C:\Tools\wb-reports-helper\).
    *Не удаляйте и не перемещайте эту папку после установки.*
  3. Откройте страницу расширений в браузере. Для этого перейдите по адресу: chrome://extensions/ (или зайдите в Меню браузера → Настройки → Расширения).
  4. Включите «Режим разработчика» (Developer mode) с помощью переключателя в правом верхнем углу страницы.
  5. Загрузите расширение: Нажмите кнопку «Загрузить распакованное расширение» (Load unpacked) в левом верхнем углу.
  6. Укажите путь: В диалоговом окне выберите папку, в которую вы распаковали архив на шаге 2 (папка должна содержать файл manifest.json).
  7. Проверьте установку: В списке расширений должна появиться карточка WB Reports Helper версии 5.0. Закрепите иконку расширения на панели инструментов браузера для быстрого доступа.
Страница расширений Chrome с включенным режимом разработчика и установленной карточкой WB Reports Helper 5.0
Рисунок 1. Установленное расширение в режиме разработчика в браузере Chrome
⚠️ Важно

Обновление расширения происходит путем замены файлов в папке установки и нажатия кнопки «Обновить» (значок круговой стрелки) на карточке расширения в chrome://extensions/.

Инструкция по использованию

Функциональные возможности разделены на две вкладки: «Отчёты» и «СПП»

📑 Вкладка 1: Отчёты (Получение токенов и выгрузка)

Предназначена для копирования авторизационных данных для внешних скриптов и скачивания финансовых отчетов в формате ZIP.

1. Авторизация и перехват токенов:

  • Откройте в браузере страницу еженедельных отчетов Wildberries: seller.wildberries.ru/.../reports-weekly-new.
  • Откройте всплывающее окно расширения. В верхней части статус-бар сменится на «Токены активны» (зеленый индикатор).
  • При необходимости ручного копирования токенов во внешние скрипты используйте кнопки «Копировать» напротив соответствующих полей (authorizev3, wb-seller-lk, cookie, x-supplier-id).

2. Скачивание финансовых отчетов:

  • В блоке «Скачать отчеты» укажите даты начала и конца периода (в формате ГГГГ-ММ-ДД). Если оставить поля пустыми, будут скачаны все доступные отчеты за историю кабинета.
  • Нажмите кнопку «Скачать отчеты».
  • Расширение начнет фоновый процесс скачивания. Лог операций отображается в нижней части интерфейса. ZIP-архивы сохраняются в стандартную папку загрузок вашего браузера в подкаталог Wildberries_Reports/.
Интерфейс расширения на вкладке Отчёты со статусом Токены активны
Рисунок 2. Интерфейс вкладки «Отчёты» расширения WB Reports Helper

🏷️ Вкладка 2: СПП (Парсинг скидок и цен)

Используется для получения данных о скидках постоянного покупателя (СПП) и автоматической синхронизации с Google Таблицей.

Вкладка СПП расширения с рассчитанными ценами и списком артикулов
Рисунок 3. Вкладка «СПП» с рассчитанными ценами и списком артикулов

Сценарий А: Получение данных через буфер обмена (Вручную)

  1. Скопируйте из вашей системы список артикулов в буфер обмена. Форматы ввода:
    • Только артикулы (каждый с новой строки) — для получения розничной цены Wildberries.
    • Артикул и розничная цена продавца через знак табуляции (или скопированные две колонки из Excel/Google Таблицы) — для вычисления точного процента СПП.
  2. Откройте вкладку «СПП» в расширении и нажмите «Вставить из буфера».
  3. Нажмите «Получить цены». Расширение поочередно отправит запросы к Wildberries партиями по 50 артикулов.
  4. После завершения парсинга нажмите «Копировать» для копирования результатов в буфер обмена и последующей вставки в вашу таблицу.

Сценарий Б: Автоматическая синхронизация с Google Таблицей WBTool (Рекомендуется)

  1. Откройте в соседней вкладке браузера вашу рабочую копию Google Таблицы WBTool.
  2. Откройте расширение WB Reports Helper на вкладке «СПП».
  3. Кнопка «Обновить из таблицы» станет активной (расширение автоматически обнаружит лист ТекущиеЦеныWB в активной таблице).
  4. Нажмите «Обновить из таблицы». Расширение самостоятельно:
    • Считает список артикулов и установленные цены со скрытого/видимого листа ТекущиеЦеныWB.
    • Запустит фоновый парсинг цен на Wildberries.
    • Закроет всплывающее окно расширения, сфокусирует ячейку в Google Таблице и автоматически вставит рассчитанные проценты СПП в колонку «Скидка WB».
    • Выведет на странице Google Таблицы всплывающее уведомление (Toast) о статусе завершения операции.
Уведомление в правом нижнем углу Google Таблицы: Успешно обновлено значений
Рисунок 4. Уведомление об успешной синхронизации данных в Google Таблице

Начните автоматизацию прямо сейчас

Браузерное расширение WB Reports Helper предоставляется абсолютно бесплатно для всех пользователей аналитической экосистемы WBTool.

🎯 Авторизоваться и скачать бесплатно