VirusTotal Project

A powerful tool to scan and analyze URLs using VirusTotal. This project supports a Hybrid Mode, allowing it to function both with an official API Key and via browser-based scraping.

Features

• Hybrid Scanning Mode:
  • API Mode: Uses the official vt-py library for fast, detailed, and reliable JSON results (Requires API Key).
  • Scraper Mode: Fallback mode using Playwright (Headless Browser) to scrape results from the VirusTotal website (No API Key required, but slower).
• Bulk Scanning: Accepts a list of URLs to process in one go.
• Local Storage: Results are saved locally in the storage directory.

Installation & Setup

1. Prerequisites

• Python 3.8+
• (Optional) A VirusTotal API Key

2. Installation

1. Clone the repository:

   git clone <your-repo-url>
   cd VirusTotal
   

2. Install dependencies:

   $pip install -r requirements.txt
   

3. Install Playwright browsers (required for Scraper Mode):

   $playwright install
   

Usage

1. Configuration

To configure the run, edit the input file located at: storage/key_value_stores/default/INPUT.json

Example configuration:

{
    "startUrls": [
        "http://example.com",
        "https://www.google.com"
    ],
    "apiKey": "YOUR_VT_API_KEY_HERE", 
    "verbose": true
}

Note: If you leave apiKey empty or remove it, the tool will automatically switch to Scraper Mode.

2. Running the Scanner

Run the main script:

$python main.py

3. Viewing Results

Output data will be saved in the storage/datasets/default directory as JSON files. If running in Scraper Mode, screenshots may be saved in storage/key_value_stores/default.

4. Accessing Output on Apify

When running on Apify platform, all export files are automatically uploaded to the Key-Value Store:

1. Go to your Actor run page on Apify
2. Click on the "Storage" tab
3. Navigate to "Key-value store"
4. Download the following files:
   • RESULTS_CSV - Spreadsheet-friendly format
   • RESULTS_JSON - Full structured data
   • RESULTS_CEF - SIEM integration format

These files are also available via the Apify API for automated workflows.

---

Created by Ruturaj Sharbidre