Scanner VirusTotal

Script Python per analizzare TUTTI i file con l'API di VirusTotal, analizzando cartelle e sottocartelle in modo ricorsivo. Ottimizzato per Windows.

Caratteristiche

• Analizza TUTTI i file in una cartella e le sue sottocartelle
• Configurazione tramite file .env - Salva la tua chiave API e le impostazioni
• Modalità interattiva - Funziona anche senza file .env
• Ottimizzato per Windows - Gestione corretta dei percorsi e codifica UTF-8
• Registrazione completa - Registra tutti gli eventi e gli errori in un file .log
• Esportazione CSV - Salva i risultati in un file CSV (separato da punto e virgola)
• Stima del tempo - Mostra il tempo rimanente e trascorso in tempo reale
• Rispetta il limite di 4 file al minuto dell'API gratuita
• Mostra l'URL di analisi di VirusTotal per ogni file
• Mostra i risultati in formato X/Y (es. 0/70 = 0 positivi su 70 motori antivirus)
• Gestione robusta degli errori (file bloccati, nessun permesso, ecc.)
• Contatore di avanzamento in tempo reale con percentuale
• Riepilogo dettagliato al completamento con statistiche e tempo totale
• Elenco dei file saltati con motivi
• Controllo hash prima del caricamento - Risparmia tempo e larghezza di banda verificando se il file esiste già in VirusTotal

Requisiti

• Python 3.6 o superiore
• Chiave API VirusTotal (gratuita)
• Windows (ottimizzato, ma funziona su altri sistemi)

Installazione

1. Scarica i file sul tuo computer

2. Installa le dipendenze:

pip install -r requirements.txt

3. Ottieni la tua chiave API VirusTotal:
   • Vai su https://www.virustotal.com/gui/my-apikey
   • Registrati o accedi (è gratuito)
   • Copia la tua chiave API

Utilizzo

Opzione 1: Usare il file .env (Consigliato)

1. Copia il file .env.example in .env:

   cp .env.example .env
   

2. Modifica il file .env e aggiungi la tua configurazione:

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

3. Esegui lo script:

   python virustotal_scanner.py
   

Lo script caricherà automaticamente la tua configurazione dal file .env.

Opzione 2: Modalità interattiva (senza .env)

Se preferisci non usare il file .env, lo script chiederà le informazioni:

python virustotal_scanner.py

Lo script chiederà:

1. La tua chiave API VirusTotal
2. Il percorso della cartella che vuoi analizzare

Esempio di utilizzo:

Inserisci la tua chiave API VirusTotal: a1b2c3d4e5f6...

Inserisci il percorso della cartella da analizzare: C:\Users\username\Desktop\my_files

Vuoi continuare? (y/n): y

Esempi di percorsi validi su Windows:

• C:\Users\username\Documents\my_files
• C:\Users\username\Desktop\folder
• . (punto = cartella corrente)
• Puoi trascinare e rilasciare la cartella nel terminale

File generati

Dopo aver eseguito lo script, i seguenti file verranno generati automaticamente:

virustotal_scan.log

File di log con tutti gli eventi:

• Inizio e fine dell'analisi
• Ogni file elaborato
• Errori e avvisi
• Statistiche finali

virustotal_results.csv

File CSV con i risultati (separato da punto e virgola):

• Data e ora dell'analisi
• Nome file
• Percorso completo
• Dimensione in byte
• Hash SHA256
• Rilevamenti positivi
• Totale motori antivirus
• Percentuale di rilevamento
• Stato (CLEAN/DETECTED)
• URL di VirusTotal

Il CSV può essere aperto con Excel, Fogli Google o qualsiasi programma per fogli di calcolo.

Esempio di output

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

Limitazioni e considerazioni

Limiti dell'API gratuita:

• 4 file al minuto (lo script attende automaticamente)
• Dimensione massima: 32 MB per file
• I file più grandi verranno saltati automaticamente

File che vengono saltati:

• File più grandi di 32 MB
• File vuoti (0 byte)
• File senza permessi di lettura
• File bloccati dal sistema

Note importanti sulla sicurezza

• Mantieni privata la tua chiave API - Non condividerla
• I file vengono analizzati pubblicamente - Non caricare file riservati
• I file vengono condivisi con la community di sicurezza - Una volta caricati, sono pubblici
• VirusTotal è per l'analisi di sicurezza - Usalo in modo responsabile
• Non caricare dati personali o aziendali sensibili

Cosa fa lo script?

1. Trova TUTTI i file nella cartella e nelle sottocartelle
2. Verifica che ogni file sia valido per l'analisi
3. Controlla se l'hash del file esiste già in VirusTotal (risparmia tempo e larghezza di banda)
4. Carica ogni file su VirusTotal se non trovato (rispettando il limite di 4 al minuto)
5. Attende i risultati dell'analisi
6. Mostra l'URL e i rilevamenti (es. 0/70, 5/70)
7. Genera un riepilogo completo alla fine

Risoluzione dei problemi

Errore: "Chiave API non valida"

• Verifica di aver copiato correttamente la tua chiave API
• Ottienine una nuova su https://www.virustotal.com/gui/my-apikey

Errore: "Accesso negato al file"

• Alcuni file di sistema sono protetti
• Esegui come amministratore se devi analizzare file di sistema

Lo script è molto lento

• È normale: l'API gratuita è limitata a 4 file al minuto
• Se hai 100 file, ci vorranno circa 25 minuti

File saltati

• Controlla il riepilogo finale per vedere perché sono stati saltati
• I file >32 MB non possono essere analizzati con l'API gratuita

Licenza

Licenza MIT - Copyright (c) 2025 neorai