Wildberries Parser Frequency Bot

Telegram бот для анализа категорий Wildberries с возможностью получения статистики частоты поиска товаров.

🚀 Функциональность

• Парсинг категорий товаров Wildberries
• Поддержка Excel файлов со ссылками для парсинга
• Автоматическое удаление дубликатов ссылок
• Анализ частотности поисковых запросов через Evirma API
• Экспорт результатов в Excel файл
• Система логирования процесса парсинга
• Административный доступ по ID

🛠 Технический стек

• Node.js
• Express.js
• node-telegram-bot-api
• Axios
• XLSX
• Vercel для деплоя

💻 Основные компоненты

LogService

Сервис логирования с функциями:

• Запись логов в файл
• Отправка логов в Telegram
• Обновление сообщений с логами в реальном времени

FileService

Управление файлами:

• Создание Excel отчетов
• Отправка файлов пользователям
• Автоматическое удаление временных файлов

EvirmaClient

Взаимодействие с Evirma API:

• Отправка запросов на анализ ключевых слов
• Обработка ответов API
• Таймауты и обработка ошибок

WildberriesParser

Основной парсер:

• Получение каталога категорий
• Парсинг товаров по страницам
• Анализ данных через Evirma
• Формирование итоговых отчетов

🔧 Настройка

1. Создайте файл .env со следующими параметрами:

TELEGRAM_BOT_TOKEN=ваш_токен_бота
ADMIN_ID=id1,id2,id3
APP_URL=url_вашего_приложения
SETUP_SECRET=секретный_ключ

2. Установите зависимости:

npm install

3. Запустите бот:

npm start

📝 Использование

Парсинг по ссылкам

1. Добавьте бота в Telegram
2. Отправьте команду /start
3. Нажмите кнопку "Парсить"
4. Выберите способ добавления ссылок:
   • "Ввести ссылки текстом" - отправьте ссылки через пробел
   • "Загрузить Excel со ссылками" - загрузите Excel файл
5. Дождитесь результатов анализа в формате Excel

Формат Excel файла со ссылками

• Ссылки должны быть в первом столбце (колонка A)
• Первая строка - заголовок (будет пропущена)
• Ссылки должны начинаться с https://www.wildberries.ru/catalog/
• Дубликаты будут автоматически удалены

Пример структуры файла:

Ссылки
https://www.wildberries.ru/catalog/dom-i-dacha/vannaya/aksessuary
https://www.wildberries.ru/catalog/elektronika/avtoelektronika
https://www.wildberries.ru/catalog/0/search.aspx?search=геймерское+кресло

Парсинг Excel с товарами

1. Нажмите кнопку "Парсить Excel"
2. Загрузите Excel файл с названиями товаров в колонке "Название"
3. Выберите действие (добавить/обновить частоту или количество товаров)
4. Получите обновленный файл с данными

🔒 Безопасность

• Доступ только для авторизованных администраторов
• Защита webhook через секретный ключ
• Временные файлы автоматически удаляются

🌐 API Endpoints

• GET /api/health - проверка работоспособности
• POST /api/webhook - endpoint для Telegram webhook
• GET /api/setup - настройка webhook (требует секретный ключ)

⚡ Развертывание

Проект настроен для деплоя на Vercel:

1. Подключите репозиторий к Vercel
2. Настройте переменные окружения
3. Активируйте webhook через /api/setup?token=ваш_секретный_ключ