Skip to content

xdrew87/PhantomTrace

🔍 PhantomTrace

Python License Platform Status

🌐 osintintelligence.xyz/phantomtrace — Official page & Pro version

PhantomTrace is a professional, modular OSINT (Open Source Intelligence) CLI framework for gathering publicly available intelligence on individuals and digital assets. Built with Python and Rich for a clean, production-grade experience.

⚠️ For authorized and legal use only. Always obtain proper consent before investigating any individual. Misuse is your sole responsibility.


Screenshots

Main Menu

PhantomTrace Main Menu PhantomTrace Main Menu

Username Lookup

Username Lookup

IP Lookup Result

IP Lookup IP Lookup

HTML Report Export

Report


Features

  • Username Lookup — Search 50+ platforms for username presence
  • Email Intelligence — Breach detection (HIBP), MX records, domain analysis
  • IP Lookup — Geolocation via FrostedServices GeoIP + ip-api.com, ASN, ISP, proxy/VPN detection
  • Phone Lookup — Carrier, region, line type via phonenumbers + optional NumVerify
  • Domain Lookup — WHOIS, DNS (A/MX/NS/TXT/SOA/CNAME), HTTP headers
  • Social Media Scan — Public profile discovery across 15 major platforms
  • Full Profile Scan — Run all modules against a single target
  • Report Export — JSON and styled HTML reports saved locally
  • Scoring System — Risk/profile completeness scores per module
  • Activity Logging — All sessions logged to logs/

Installation

git clone https://github.com/xdrew87/PhantomTrace.git
cd PhantomTrace
pip install -r requirements.txt
cp config/.env.example config/.env
# Edit config/.env with your optional API keys
python main.py

Configuration

The tool works without any API keys — keys unlock additional data sources.

Copy config/.env.example to config/.env and optionally add keys:

Variable Service Notes
HIBP_API_KEY HaveIBeenPwned Email breach lookup
NUMVERIFY_API_KEY NumVerify Enhanced phone data
HUNTER_API_KEY Hunter.io Email verification

IP geolocation uses the built-in FrostedServices GeoIP API — no key needed.


Usage

python main.py

Select modules from the interactive menu. Results are displayed in formatted tables and optionally exported to reports/.


Project Structure

PhantomTrace/
├── main.py              # Entry point & CLI menu
├── modules/             # OSINT modules (one per data type)
│   ├── username_lookup.py
│   ├── email_intel.py
│   ├── ip_lookup.py
│   ├── phone_lookup.py
│   ├── domain_lookup.py
│   └── social_media.py
├── utils/               # Helpers: API, logging, formatting, reporting
├── config/              # Settings & API key configuration
├── reports/             # Exported reports (JSON & HTML)
└── logs/                # Activity logs

Disclaimer

PhantomTrace is intended for legal OSINT research only — penetration testers, security researchers, journalists, and investigators with proper authorization. The authors accept no liability for misuse.


License

MIT — see LICENSE

Releases

No releases published

Packages

 
 
 

Contributors