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:

O script solicitará:

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

Exemplo de uso:

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

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.