Skip to content

About

A simple heuristic scanner to detect phishing attempts via emails by explicitly extracting URLs and checking them against VirusTotal's threat intelligence database.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

6 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 

Repository files navigation

Phishing Email Analyzer

Overview

A Python-based tool that analyzes suspicious emails to detect phishing attempts by extracting URLs, evaluating sender domains, and querying VirusTotal threat intelligence.

Tools & Technologies

  • Python 3
  • VirusTotal API (v3)
  • OpenPhish threat intelligence feed
  • Requests
  • Standard libraries: re, email, argparse

Features

  • Extracts and un-defangs URLs from plain text and HTML emails
  • Strips trailing punctuation from extracted URLs
  • Detects deceptive links (anchor text vs target URL mismatch)
  • Checks URLs against antivirus engines via VirusTotal API
  • Automatic fallback to OpenPhish feed and local heuristics if VirusTotal is unavailable
  • Analyzes sender domains for brand impersonation and display name spoofing
  • Parses .eml files, raw text, or single URLs via CLI flags
  • Generates structured threat reports with SAFE, SUSPICIOUS, or MALICIOUS verdicts

How It Works

  1. Provide email text, a .eml file, or a specific URL to the tool
  2. Tool extracts and normalizes all URLs using regex and HTML parsing
  3. Each URL is checked against VirusTotal or secondary threat intelligence feeds
  4. Sender identity is verified for spoofing and brand impersonation
  5. A full threat report is generated with clear verdicts

Usage

Install dependencies:

pip install -r requirements.txt

Run interactive mode or sample analysis:

python analyzer.py

Command line options:

python analyzer.py --file email.eml
python analyzer.py --url "http://suspicious-link.com"
python analyzer.py --sender "support@secure-bank-verify.com"

Skills Demonstrated

  • Python scripting and API integration
  • Threat intelligence and phishing detection
  • Email header analysis
  • Security tool development

Screenshots

Untitled

About

A simple heuristic scanner to detect phishing attempts via emails by explicitly extracting URLs and checking them against VirusTotal's threat intelligence database.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages