VirusTotal Scanner

Python-скрипт для анализа ВСЕХ файлов с помощью VirusTotal API, сканирующий папки и подпапки рекурсивно. Оптимизирован для Windows.

Возможности

• Сканирует ВСЕ файлы в папке и её подпапках
• Настройка через файл .env — сохраните ваш API-ключ и параметры
• Интерактивный режим — также работает без файла .env
• Оптимизирован для Windows — корректная обработка путей и кодировка UTF-8
• Полное логирование — записывает все события и ошибки в .log файл
• Экспорт в CSV — сохраняет результаты в CSV-файл (с разделителем-точкой с запятой)
• Оценка времени — показывает оставшееся и прошедшее время в реальном времени
• Соблюдает лимит бесплатного API: 4 файла в минуту
• Показывает URL анализа VirusTotal для каждого файла
• Показывает результаты в формате X/Y (например, 0/70 = 0 положительных результатов из 70 антивирусных движков)
• Надёжная обработка ошибок (заблокированные файлы, отсутствие прав и т.д.)
• Счётчик прогресса в реальном времени с процентом выполнения
• Подробная сводка по завершении со статистикой и общим временем
• Список пропущенных файлов с причинами
• Проверка хэша перед загрузкой — экономит время и трафик, проверяя, существует ли файл в VirusTotal

Требования

• Python 3.6 или выше
• API-ключ VirusTotal (бесплатный)
• Windows (оптимизировано, но работает и на других системах)

Установка

1. Скачайте файлы на ваш компьютер

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

pip install -r requirements.txt

3. Получите ваш API-ключ VirusTotal:
   • Перейдите на https://www.virustotal.com/gui/my-apikey
   • Зарегистрируйтесь или войдите (это бесплатно)
   • Скопируйте ваш API-ключ

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

Вариант 1: Использование файла .env (рекомендуется)

1. Скопируйте файл .env.example в .env:

   root@kitploit:~

   cp .env.example .env
   

2. Отредактируйте файл .env и добавьте вашу конфигурацию:

   root@kitploit:~

   VIRUSTOTAL_API_KEY=your_actual_api_key_here
   SCAN_FOLDER=C:\Users\username\Desktop\my_files
   

3. Запустите скрипт:

   root@kitploit:~

   python virustotal_scanner.py
   

Скрипт автоматически загрузит вашу конфигурацию из файла .env.

Вариант 2: Интерактивный режим (без .env)

Если вы предпочитаете не использовать файл .env, скрипт запросит информацию:

python virustotal_scanner.py

Скрипт запросит:

1. Ваш API-ключ VirusTotal
2. Путь к папке, которую вы хотите отсканировать

Пример использования:

Enter your VirusTotal API key: a1b2c3d4e5f6...

Enter the folder path to scan: C:\Users\username\Desktop\my_files

Do you want to continue? (y/n): y

Примеры корректных путей в Windows:

• C:\Users\username\Documents\my_files
• C:\Users\username\Desktop\folder
• . (точка = текущая папка)
• Вы можете перетащить папку в терминал

Создаваемые файлы

После запуска скрипта будут автоматически созданы следующие файлы:

virustotal_scan.log

Файл журнала со всеми событиями:

• Начало и конец сканирования
• Каждый обработанный файл
• Ошибки и предупреждения
• Итоговая статистика

virustotal_results.csv

CSV-файл с результатами (разделитель — точка с запятой):

• Дата и время анализа
• Имя файла
• Полный путь
• Размер в байтах
• SHA256-хэш
• Положительные обнаружения
• Всего антивирусных движков
• Процент обнаружений
• Статус (CLEAN/DETECTED)
• URL VirusTotal

CSV-файл можно открыть в Excel, Google Sheets или любой другой программе для работы с электронными таблицами.

Пример вывода

================================================================================
  VIRUSTOTAL SCANNER - COMPLETE FOLDER SCAN
================================================================================
Folder: C:\Users\username\Desktop\my_files
API limit: 4 files per minute
Maximum file size: 32 MB
================================================================================

Counting files...
Total files found: 15

Starting analysis...

================================================================================
Progress: [1/15]
================================================================================

[*] Analyzing: document.pdf
    Path: C:\Users\username\Desktop\my_files\document.pdf
  Uploading file...
  Waiting for analysis results...
  Analysis in progress... (attempt 1/30)

  >> URL: https://www.virustotal.com/gui/file/abc123...
  >> Detections: 0/70

================================================================================
Progress: [2/15]
================================================================================

[*] Analyzing: program.exe
    Path: C:\Users\username\Desktop\my_files\program.exe
  Uploading file...
  Waiting for analysis results...

  >> URL: https://www.virustotal.com/gui/file/def456...
  >> Detections: 2/70

[!] Rate limit reached: Waiting 15 seconds...

================================================================================
  FINAL SCAN SUMMARY
================================================================================

ANALYZED FILES:
--------------------------------------------------------------------------------

1. [CLEAN] 0/70
   File: C:\Users\username\Desktop\my_files\document.pdf
   URL: https://www.virustotal.com/gui/file/abc123...

2. [DETECTED] 2/70
   File: C:\Users\username\Desktop\my_files\program.exe
   URL: https://www.virustotal.com/gui/file/def456...

================================================================================
SKIPPED FILES:
--------------------------------------------------------------------------------

1. C:\Users\username\Desktop\my_files\large_file.iso
   Reason: File too large (650.50 MB)

2. C:\Users\username\Desktop\my_files\system.dll
   Reason: No read permissions

================================================================================
  STATISTICS
================================================================================
Total files found: 15
Files analyzed: 13
Files skipped: 2
  - Clean files (0 detections): 12
  - Files with detections: 1
================================================================================

Ограничения и примечания

Лимиты бесплатного API:

• 4 файла в минуту (скрипт ожидает автоматически)
• Максимальный размер: 32 МБ на файл
• Файлы большего размера будут пропущены автоматически

Файлы, которые пропускаются:

• Файлы размером более 32 МБ
• Пустые файлы (0 байт)
• Файлы без прав на чтение
• Файлы, заблокированные системой

Важные замечания по безопасности

• Храните ваш API-ключ в тайне — не делитесь им
• Файлы анализируются публично — не загружайте конфиденциальные файлы
• Файлы передаются сообществу специалистов по безопасности — после загрузки они становятся общедоступными
• VirusTotal предназначен для анализа безопасности — используйте его ответственно
• Не загружайте личные или чувствительные корпоративные данные

Что делает скрипт?

1. Находит ВСЕ файлы в папке и подпапках
2. Проверяет, что каждый файл подходит для анализа
3. Проверяет, существует ли хэш файла в VirusTotal (экономит время и трафик)
4. Загружает каждый файл в VirusTotal, если он не найден (соблюдая лимит 4 файла в минуту)
5. Ожидает результаты анализа
6. Показывает URL и обнаружения (например, 0/70, 5/70)
7. Создаёт полную сводку в конце

Устранение неполадок

Ошибка: "Invalid API key"

• Убедитесь, что вы правильно скопировали ваш API-ключ
• Получите новый на https://www.virustotal.com/gui/my-apikey

Ошибка: "Access denied to file"

• Некоторые системные файлы защищены
• Запустите от имени администратора, если вам нужно анализировать системные файлы

Скрипт работает очень медленно

• Это нормально: бесплатный API ограничен 4 файлами в минуту
• Если у вас 100 файлов, это займёт примерно 25 минут

Пропущенные файлы

• Проверьте итоговую сводку, чтобы узнать причину пропуска
• Файлы размером >32 МБ не могут быть проанализированы с помощью бесплатного API

Лицензия

MIT License — Copyright (c) 2025 neorai

Этот проект является свободным и открытым. Вы можете свободно использовать, изменять и распространять его. Подробности см. в файле LICENSE.