Escáner de VirusTotal

Script de Python para analizar TODOS los archivos con la API de VirusTotal, escaneando carpetas y subcarpetas de forma recursiva. Optimizado para Windows.

Características

Escanea TODOS los archivos de una carpeta y sus subcarpetas
Configuración mediante archivo .env - Guarda tu clave de API y ajustes
Modo interactivo - También funciona sin el archivo .env
Optimizado para Windows - Manejo correcto de rutas y codificación UTF-8
Registro completo - Documenta todos los eventos y errores en el archivo .log
Exportación CSV - Guarda los resultados en un archivo CSV (separado por punto y coma)
Estimación de tiempo - Muestra el tiempo restante y transcurrido en tiempo real
Respeta el límite de 4 archivos por minuto de la API gratuita
Muestra la URL de análisis de VirusTotal para cada archivo
Muestra los resultados en formato X/Y (p. ej., 0/70 = 0 positivos de 70 motores antivirus)
Manejo robusto de errores (archivos bloqueados, sin permisos, etc.)
Contador de progreso en tiempo real con porcentaje
Resumen detallado al finalizar con estadísticas y tiempo total
Lista de archivos omitidos con sus motivos
Consulta de hash antes de subir - Ahorra tiempo y ancho de banda al comprobar si el archivo ya existe en VirusTotal

Requisitos

Python 3.6 o superior
Clave de API de VirusTotal (gratuita)
Windows (optimizado, pero funciona en otros sistemas)

Instalación

================================================================================ 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 ================================================================================

vt-py-scanner

Más Populares

Uso

Opción 1: Usar el archivo .env (Recomendado)

Opción 2: Modo interactivo (sin .env)

Ejemplos de rutas válidas en Windows:

Archivos generados

virustotal_scan.log

virustotal_results.csv

Ejemplo de salida

Limitaciones y consideraciones

Límites de la API gratuita:

Archivos que se omiten:

Notas de seguridad importantes

¿Qué hace el script?

Solución de problemas

Licencia