Skip to content
KitploitKITPLOIT
HerramientasExploitsBlog
Log in
Enviar
HerramientasExploitsBlog
Enviar

¡Herramientas de Hacking, PenTest y Ciberseguridad para tu Arsenal de Seguridad!

Kitploit es un directorio de herramientas de hacking, ciberseguridad y pentesting. Descubre las últimas actualizaciones de proyectos para encontrar vulnerabilidades, analizar sistemas, automatizar pruebas y fortalecer tu seguridad.

FeedsContactoPrivacidad© 2026 Kitploit

Directorio de Herramientas

Categorías

Ver todas las categorías
Loading categories
vt-py-scanner — Escanea carpetas de forma recursiva con la API de VirusTotal para detectar malware. Presenta búsqueda de hash, exportación CSV, progreso en tiempo real y manejo de límite de velocidad para el análisis automatizado de archivos. | Kitploit
Herramientas/GitHubGitHub/neorai/vt-py-scanner
Análisis de VulnerabilidadesAnálisis de HashAnálisis ForenseRecopilación de InformaciónAnálisis de MalwareInteligencia de Amenazas
GitHubneorai/vt-py-scanner

vt-py-scanner

Escanea carpetas de forma recursiva con la API de VirusTotal para detectar malware. Presenta búsqueda de hash, exportación CSV, progreso en tiempo real y manejo de límite de velocidad para el análisis automatizado de archivos.

Ver Repositorio
534hace 11 mesesAún no revisado
Compartir

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

  1. Descarga los archivos a tu computadora

  2. Instala las dependencias:

pip install -r requirements.txt
  1. Obtén tu clave de API de VirusTotal:
    • Ve a https://www.virustotal.com/gui/my-apikey
    • Regístrate o inicia sesión (es gratis)
    • Copia tu clave de API

Uso

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

  1. Copia el archivo .env.example a .env:

    cp .env.example .env
    
  2. Edita el archivo .env y añade tu configuración:

    VIRUSTOTAL_API_KEY=your_actual_api_key_here
    SCAN_FOLDER=C:\Users\username\Desktop\my_files
    
  3. Ejecuta el script:

    python virustotal_scanner.py
    

El script cargará automáticamente tu configuración desde el archivo .env.

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

Si prefieres no usar el archivo .env, el script te pedirá la información:

python virustotal_scanner.py

El script te pedirá:

  1. Tu clave de API de VirusTotal
  2. La ruta de la carpeta que quieres escanear

Ejemplo de uso:

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

Ejemplos de rutas válidas en Windows:

  • C:\Users\username\Documents\my_files
  • C:\Users\username\Desktop\folder
  • . (punto = carpeta actual)
  • Puedes arrastrar y soltar la carpeta en la terminal

Archivos generados

Después de ejecutar el script, se generarán automáticamente los siguientes archivos:

virustotal_scan.log

Archivo de registro con todos los eventos:

  • Inicio y fin del escaneo
  • Cada archivo procesado
  • Errores y advertencias
  • Estadísticas finales

virustotal_results.csv

Archivo CSV con los resultados (separado por punto y coma):

  • Fecha y hora del análisis
  • Nombre del archivo
  • Ruta completa
  • Tamaño en bytes
  • Hash SHA256
  • Detecciones positivas
  • Total de motores antivirus
  • Porcentaje de detección
  • Estado (CLEAN/DETECTED)
  • URL de VirusTotal

El CSV se puede abrir con Excel, Google Sheets o cualquier programa de hoja de cálculo.

Ejemplo de salida

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

Limitaciones y consideraciones

Límites de la API gratuita:

  • 4 archivos por minuto (el script espera automáticamente)
  • Tamaño máximo: 32 MB por archivo
  • Los archivos más grandes se omitirán automáticamente

Archivos que se omiten:

  • Archivos de más de 32 MB
  • Archivos vacíos (0 bytes)
  • Archivos sin permisos de lectura
  • Archivos bloqueados por el sistema

Notas de seguridad importantes

  • Mantén tu clave de API privada - No la compartas
  • Los archivos se analizan públicamente - No subas archivos confidenciales
  • Los archivos se comparten con la comunidad de seguridad - Una vez subidos, son públicos
  • VirusTotal es para análisis de seguridad - Úsalo de forma responsable
  • No subas datos personales ni información corporativa sensible

¿Qué hace el script?

  1. Encuentra TODOS los archivos de la carpeta y subcarpetas
  2. Verifica que cada archivo sea válido para el análisis
  3. Comprueba si el hash del archivo ya existe en VirusTotal (ahorra tiempo y ancho de banda)
  4. Sube cada archivo a VirusTotal si no se encuentra (respetando el límite de 4 por minuto)
  5. Espera los resultados del análisis
  6. Muestra la URL y las detecciones (p. ej., 0/70, 5/70)
  7. Genera un resumen completo al final

Solución de problemas

Error: "Clave de API no válida"

  • Verifica que copiaste tu clave de API correctamente
  • Obtén una nueva en https://www.virustotal.com/gui/my-apikey

Error: "Acceso denegado al archivo"

  • Algunos archivos del sistema están protegidos
  • Ejecuta como administrador si necesitas analizar archivos del sistema

El script es muy lento

  • Esto es normal: la API gratuita está limitada a 4 archivos por minuto
  • Si tienes 100 archivos, tardará aproximadamente 25 minutos
Descargar herramienta

Más Populares

Ver todos →

Descubre las herramientas más usadas por nuestra comunidad.

  • 1

    OsintHunter

    letox4/osinthunter

    🎯 El kit de herramientas OSINT definitivo: grafo de investigación, puntuación de confianza, familias de alias, mapa, línea de tiempo e informes. 49 módulos, más de 400 sitios, sin necesidad de claves API.

    806
  • 2

    ghostlock-app

    yukonga/ghostlock-app

    # Aplicación de Ejecución con un Solo Toque GhostLock (CVE-2026-43499)

    523
  • 3

    ARTEX

    baarai/artex

    Plataforma de pruebas de penetración autónoma multiagente basada en LLM con agentes planificadores/trabajadores, grafos de activos y de exploración, registro de tráfico MITM y reevaluación de vulnerabilidades.

    441
  • 4

    redforge

    cybersecurity91/redforge

    Kit de herramientas de red team del lado del navegador con 102 herramientas offline para reconocimiento, generación de payloads, ataques de credenciales, criptografía, codificación y elaboración de informes de compromiso.

    346
  • 5

    looking-glass

    anonghosty/looking-glass

    Plataforma CSIRT que ingiere informes de Shadowserver en MongoDB y los reproduce como mapas interactivos, análisis, hallazgos, avisos y paneles ejecutivos.

    270
  • 6

    CyberStrikeAI

    ed1s0nz/cyberstrikeai

    El sistema de acción para la ciberseguridad nativa de IA—donde la intención se convierte en ejecución gobernada, la evidencia se convierte en memoria operativa y cada operación mejora la siguiente.

    264

Explora todas las herramientas

Explora nuestra colección de herramientas

Ver todas las herramientas →