Scanner VirusTotal

Script em Python para analisar TODOS os arquivos com a API do VirusTotal, escaneando pastas e subpastas recursivamente. Otimizado para Windows.

Features

• Escaneia TODOS os arquivos em uma pasta e suas subpastas
• Configuração via arquivo .env - Salve sua chave de API e configurações
• Modo interativo - Também funciona sem o arquivo .env
• Otimizado para Windows - Tratamento correto de caminhos e codificação UTF-8
• Registro completo - Grava todos os eventos e erros em arquivo .log
• Exportação CSV - Salva resultados em arquivo CSV (separado por ponto e vírgula)
• Estimativa de tempo - Mostra tempo restante e decorrido em tempo real
• Respeita o limite de 4 arquivos por minuto da API gratuita
• Mostra URL de análise do VirusTotal para cada arquivo
• Mostra resultados no formato X/Y (ex: 0/70 = 0 positivos em 70 mecanismos antivírus)
• Tratamento robusto de erros (arquivos bloqueados, sem permissões, etc.)
• Contador de progresso em tempo real com porcentagem
• Resumo detalhado ao final com estatísticas e tempo total
• Lista de arquivos ignorados com motivos
• Consulta de hash antes do upload - Economiza tempo e largura de banda verificando se o arquivo já existe no VirusTotal

Requirements

• Python 3.6 ou superior
• Chave de API do VirusTotal (gratuita)
• Windows (otimizado, mas funciona em outros sistemas)

Installation

1. Baixe os arquivos para o seu computador

2. Instale as dependências:

pip install -r requirements.txt

3. Obtenha sua chave de API do VirusTotal:
   • Acesse https://www.virustotal.com/gui/my-apikey
   • Registre-se ou faça login (é gratuito)
   • Copie sua chave de API

Usage

Opção 1: Usando arquivo .env (Recomendado)

1. Copie o arquivo .env.example para .env:

   root@kitploit:~

   cp .env.example .env
   

2. Edite o arquivo .env e adicione sua configuração:

   root@kitploit:~

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

3. Execute o script:

   root@kitploit:~

   python virustotal_scanner.py
   

O script carregará automaticamente sua configuração do arquivo .env.

Opção 2: Modo interativo (sem .env)

Se preferir não usar o arquivo .env, o script solicitará as informações:

python virustotal_scanner.py

O script solicitará:

1. Sua chave de API do VirusTotal
2. O caminho da pasta que deseja escanear

Exemplo 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

Exemplos de caminhos válidos no Windows:

• C:\Users\username\Documents\my_files
• C:\Users\username\Desktop\folder
• . (ponto = pasta atual)
• Você pode arrastar e soltar a pasta no terminal

Generated files

Após executar o script, os seguintes arquivos serão gerados automaticamente:

virustotal_scan.log

Arquivo de log com todos os eventos:

• Início e fim da varredura
• Cada arquivo processado
• Erros e avisos
• Estatísticas finais

virustotal_results.csv

Arquivo CSV com resultados (separado por ponto e vírgula):

• Data e hora da análise
• Nome do arquivo
• Caminho completo
• Tamanho em bytes
• Hash SHA256
• Detecções positivas
• Total de mecanismos antivírus
• Porcentagem de detecção
• Status (CLEAN/DETECTED)
• URL do VirusTotal

O CSV pode ser aberto com Excel, Google Sheets ou qualquer programa de planilha.

Output example

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

Limitations and considerations

Limites da API gratuita:

• 4 arquivos por minuto (o script aguarda automaticamente)
• Tamanho máximo: 32 MB por arquivo
• Arquivos maiores serão ignorados automaticamente

Arquivos ignorados:

• Arquivos maiores que 32 MB
• Arquivos vazios (0 bytes)
• Arquivos sem permissão de leitura
• Arquivos bloqueados pelo sistema

Important security notes

• Mantenha sua chave de API privada - Não a compartilhe
• Os arquivos são analisados publicamente - Não envie arquivos confidenciais
• Os arquivos são compartilhados com a comunidade de segurança - Uma vez enviados, tornam-se públicos
• VirusTotal é para análise de segurança - Use-o com responsabilidade
• Não envie dados pessoais ou corporativos sensíveis

What does the script do?

1. Encontra TODOS os arquivos na pasta e subpastas
2. Verifica se cada arquivo é válido para análise
3. Verifica se o hash do arquivo já existe no VirusTotal (economiza tempo e largura de banda)
4. Envia cada arquivo para o VirusTotal se não encontrado (respeitando o limite de 4 por minuto)
5. Aguarda os resultados da análise
6. Mostra a URL e detecções (ex: 0/70, 5/70)
7. Gera um resumo completo ao final

Troubleshooting

Erro: "Chave de API inválida"

• Verifique se você copiou sua chave de API corretamente
• Obtenha uma nova em https://www.virustotal.com/gui/my-apikey

Erro: "Acesso negado ao arquivo"

• Alguns arquivos do sistema são protegidos
• Execute como administrador se precisar analisar arquivos do sistema

O script é muito lento

• Isso é normal: a API gratuita é limitada a 4 arquivos por minuto
• Se você tiver 100 arquivos, levará aproximadamente 25 minutos

Arquivos ignorados

• Verifique o resumo final para saber por que foram ignorados
• Arquivos >32 MB não podem ser analisados com a API gratuita

License

Licença MIT - Copyright (c) 2025 neorai

Este projeto é gratuito e de código aberto. Você pode usá-lo, modificá-lo e distribuí-lo livremente. Consulte o arquivo LICENSE para obter detalhes.