VirusTotal Scanner

VirusTotal APIを使用してすべてのファイルを分析するPythonスクリプト。フォルダとサブフォルダを再帰的にスキャンします。Windows向けに最適化。

機能

フォルダとそのサブフォルダ内のすべてのファイルをスキャン
.envファイルによる設定 - APIキーと設定を保存
対話モード - .envファイルなしでも動作
Windows向けに最適化 - 正しいパス処理とUTF-8エンコーディング
完全なログ記録 - すべてのイベントとエラーを.logファイルに記録
CSVエクスポート - 結果をCSVファイルに保存（セミコロン区切り）
時間見積もり - 残り時間と経過時間をリアルタイム表示
無料APIの1分あたり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の制限:

スキップされるファイル:

重要なセキュリティ上の注意

スクリプトの動作

トラブルシューティング

ライセンス