Кейс разработки
WB-Паук — набор CLI-скриптов для быстрых ad-hoc выгрузок из API Wildberries в Excel без захода в личный кабинет
О проекте
WB-Паук — локальный инструмент категории «получить любую выборку по требованию»: каждая задача = отдельный скрипт под конкретный отчёт WB. В отличие от аналитической платформы Dashiki, паук ничего не хранит и не работает фоном — это разовые выгрузки. В одном прогоне выгружено 27 016 карточек товара.
1. Задача
Команде регулярно нужны произвольные выгрузки из Wildberries, которые неудобно или невозможно получить в ЛК:
- Любой отчёт по требованию — статистика рекламы, карточки, расходы и т.д.
- Сразу в Excel — готовый файл рядом со скриптом, без ручного копирования из кабинета.
- Массовые операции — например, унификация брендов и склейка карточек через API.
- Минимум инфраструктуры — запустил и получил результат.
2. Архитектура решения
Принцип «один скрипт = один отчёт»: каждый скрипт самодостаточен, без общего SDK — преждевременная абстракция не вводится, пока не появится 3+ повторяющихся куска.
| Параметр | Значение |
|---|---|
| Язык | Python 3.12 |
| HTTP / Excel | requests + openpyxl |
| Авторизация | JWT-токены WB (Promotion / Statistics / Content) через переменные окружения |
| Запуск | Разовый CLI (python wb_*.py), без длительных процессов |
3. Главная инженерная сложность
Сложность — в знании особенностей WB API и в безопасной работе с массовыми изменениями карточек.
| Задача | Эндпоинт / решение |
|---|---|
| Статистика рекламы | GET /adv/v3/fullstats — показы/клики/CTR/CPC/расход/CR за период |
| Выгрузка карточек | POST /content/v2/get/cards/list — курсор-пагинация по 100 |
| Смена бренда / склейки | cards/update (полная перезапись) + cards/moveNm (расклейка/склейка) с бэкапом JSON перед изменением |
Результат
Любая выборка из Wildberries получается за минуты вместо ручной работы в кабинете. Прогон выгрузки карточек: 27 016 карточек / 6236 imtID / 1686 склеек в один Excel-файл.
4. Эффект для бизнеса
- Скорость — произвольная выгрузка по требованию, без рутины в ЛК.
- Гибкость — новый отчёт = новый небольшой скрипт.
- Массовые правки — унификация брендов и склеек через API, а не руками по карточке.
5. Технологический стек — кратко
| Параметр | Значение |
|---|---|
| Язык | Python 3.12 |
| Библиотеки | requests, openpyxl |
| API | Wildberries Promotion / Statistics / Content |
| Формат | CLI-скрипты → Excel |
Кейс подготовлен на основе технической организации инструмента WB-Паук, разработанного группой 1SELLER. Описывается инженерное решение; токены и коммерческие данные не публикуются.