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:

   root@kitploit:~

   cp .env.example .env
   

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

   root@kitploit:~

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

3. Esegui lo script:

   root@kitploit:~

   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:

Lo script chiederà:

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

Esempio di utilizzo:

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

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

Questo progetto è gratuito e open source. Puoi usarlo, modificarlo e distribuirlo liberamente. Vedi il file LICENSE per i dettagli.