VirusTotal 스캐너

VirusTotal API를 사용하여 모든 파일을 분석하는 Python 스크립트로, 폴더와 하위 폴더를 재귀적으로 스캔합니다. Windows에 최적화되었습니다.

기능

폴더와 하위 폴더의 모든 파일을 스캔합니다.
.env 파일을 통한 구성 - API 키와 설정을 저장합니다.
대화형 모드 - .env 파일 없이도 작동합니다.
Windows에 최적화 - 올바른 경로 처리 및 UTF-8 인코딩
완전한 로깅 - 모든 이벤트와 오류를 .log 파일에 기록
CSV 내보내기 - 결과를 CSV 파일로 저장 (세미콜론으로 구분)
시간 예측 - 남은 시간과 경과 시간을 실시간으로 표시
무료 API의 분당 4개 파일 제한을 준수
각 파일에 대한 VirusTotal 분석 URL 표시
X/Y 형식으로 결과 표시 (예: 0/70 = 70개의 안티바이러스 엔진 중 0개 양성)
강력한 오류 처리 (잠긴 파일, 권한 없음 등)
백분율을 포함한 실시간 진행 카운터
완료 시 통계 및 총 시간이 포함된 상세 요약
건너뛴 파일 목록과 이유
업로드 전 해시 조회 - 파일이 이미 VirusTotal에 있는지 확인하여 시간과 대역폭 절약

요구 사항

Python 3.6 이상
VirusTotal API 키 (무료)
Windows (최적화되었지만 다른 시스템에서도 작동)

설치

파일을 컴퓨터에 다운로드하세요.
종속성 설치:

pip install -r requirements.txt

VirusTotal API 키 받기:
- https://www.virustotal.com/gui/my-apikey 로 이동
- 등록 또는 로그인 (무료)
- API 키 복사

사용법

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

vt-py-scanner

인기

옵션 1: .env 파일 사용 (권장)

옵션 2: 대화형 모드 (.env 없이)

Windows에서 유효한 경로 예시:

생성되는 파일

virustotal_scan.log

virustotal_results.csv

출력 예시

제한 사항 및 고려 사항

무료 API 제한:

건너뛰는 파일:

중요한 보안 참고 사항

스크립트가 하는 일

문제 해결

라이선스