Skip to main content

A stealthy domain reconnaissance tool for subdomain discovery and intelligence gathering

Project description

๐Ÿ‘ป GhostPeek

GhostPeek Banner License: MIT Python Downloads

GhostPeek is a stealthy domain reconnaissance tool that silently collects intelligence on web domains. Like a ghost, it reveals hidden digital footprints without drawing attention.

What is GhostPeek and it's Features?

GhostPeek is a Python tool I made to learn more about web domains. Give it a domain name, and it will quietly gather all sorts of interesting information:

  • ๐Ÿ” Subdomain Discovery - Finds subdomains you didn't know existed
  • โ„น๏ธ WHOIS Intelligence - Shows domain ownership and registration details
  • ๐ŸŒ DNS Mapping - Maps out all DNS records (A, NS, MX, CNAME, etc.)
  • ๐Ÿ–ฅ๏ธ IP Resolution - Discovers IP addresses and ASN information
  • ๐Ÿ”ง Technology Detection - Identifies web technologies and frameworks
  • ๐Ÿ“ธ Visual Screenshots - Captures website screenshots automatically
  • ๐Ÿ“Š HTML Reports - Generates comprehensive, browsable reports
  • โšก Multi-threading - Fast concurrent scanning
  • ๐ŸŽจ Rich Terminal UI - Beautiful command-line interface

Why I Made This

I created GhostPeek as a personal project to learn more about how websites are structured and to practice my Python skills. It combines a bunch of different tools into one simple command, saving you time when you want to check out a website's technical details. Make sure to retry again in few mins if it catches 0 subdomains.

๐Ÿš€ Quick Start

Installation

pip install ghostpeek

One-Line Installation

# User installation
curl -sSL https://raw.githubusercontent.com/kaizoku73/Ghostpeek/main/install.sh | bash

# System-wide installation (requires sudo)
curl -sSL https://raw.githubusercontent.com/kaizoku73/Ghostpeek/main/install.sh | sudo bash

# After installation, simply run:
ghostpeek -d example.com

Manual Installation

# Clone the repo
git clone https://github.com/kaizoku73/Ghostpeek.git
cd ghostpeek

# Install requirements
pip install -r requirements.txt

Requirements

  • Python 3.6+
  • requests
  • dnspython
  • python-whois
  • rich
  • selenium
  • python-Wappalyzer
  • setuptools

Basic Usage

# Scan a domain
python ghostpeek.py -d example.com

# Interactive mode
python ghostpeek.py

# Custom output directory
python ghostpeek.py -d example.com -o /path/to/output

# Adjust threading
python ghostpeek.py -d example.com -t 20

# Disable threading for sequential processing
python ghostpeek.py -d example.com --no-threading

Options

-d, --domain    Target domain to investigate
-o, --output    Custom output directory (optional)
-t, --threads   Number of threads to use (default: 10)
--no-threading  Disable threading for sequential processing

Example Output

When you run GhostPeek, you'll see a beautiful ASCII banner followed by real-time scanning progress:

โ–„โ–ˆโ–ˆโ–ˆโ–ˆ โ–ˆโ–ˆโ–‘ โ–ˆโ–ˆ โ–’โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆ โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆ โ–„โ–„โ–„โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–“ โ–ˆโ–ˆโ–“โ–ˆโ–ˆโ–ˆ โ–“โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆ โ–“โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆ โ–ˆโ–ˆ โ–„โ–ˆโ–€
โ–ˆโ–ˆโ–’ โ–€โ–ˆโ–’โ–“โ–ˆโ–ˆโ–‘ โ–ˆโ–ˆโ–’โ–’โ–ˆโ–ˆโ–’ โ–ˆโ–ˆโ–’โ–’โ–ˆโ–ˆ โ–’ โ–“ โ–ˆโ–ˆโ–’ โ–“โ–’โ–“โ–ˆโ–ˆโ–‘ โ–ˆโ–ˆโ–’โ–“โ–ˆ โ–€ โ–“โ–ˆ โ–€ โ–ˆโ–ˆโ–„โ–ˆโ–’
...

Give your desire domain: example.com
Your secrets will be stored in: recon_example.com_20250825_143022

โœ“ Revealing WHOIS secrets for example.com
โœ“ Hunting for subdomains of example.com
โœ“ Found 15 unique domains
โœ“ Unmasking domains and resolving IPs
โœ“ Decoding DNS secrets
โœ“ Identifying technology fingerprints
โœ“ Capturing visual evidence

Mission accomplished! ๐ŸŽ‰
Your intelligence report awaits: recon_example.com_20250825_143022/report.html

The HTML Report

After GhostPeek finishes, it will automatically open an HTML report in your browser with tabs for:

  • ๐Ÿ“Š Overview - Summary of findings and key metrics
  • โ„น๏ธ WHOIS Details - Domain registration and ownership info
  • ๐Ÿ” Subdomains - Complete list of discovered subdomains
  • ๐ŸŒ DNS Records - Detailed DNS information for each domain
  • ๐Ÿ”ง Technologies - Identified web technologies and frameworks
  • ๐Ÿ“ธ Screenshots - Visual captures of all accessible websites

Disclaimer

This tool is designed for educational purposes and authorized security testing only.

  • Only scan domains you own or have explicit permission to test
  • Respect robots.txt and website terms of service
  • Be mindful of rate limiting to avoid overwhelming target servers
  • Use responsibly and ethically

License

This project is licensed under the MIT License - see the LICENSE file for details.

๐Ÿ”— Connect


Made with โค๏ธ by kaizoku

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ghostpeek-1.0.1.tar.gz (18.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

ghostpeek-1.0.1-py3-none-any.whl (14.1 kB view details)

Uploaded Python 3

File details

Details for the file ghostpeek-1.0.1.tar.gz.

File metadata

  • Download URL: ghostpeek-1.0.1.tar.gz
  • Upload date:
  • Size: 18.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for ghostpeek-1.0.1.tar.gz
Algorithm Hash digest
SHA256 8a2135347f167edc1866ee6caf0ba66fad015a27f22039a1789a30d2b87cb592
MD5 542377d956dba6fb3ffb1918c64e0cf0
BLAKE2b-256 be64ad1595923c596666d7613b21542b347d65d5327bbf4d0aa66e8267dfa5db

See more details on using hashes here.

File details

Details for the file ghostpeek-1.0.1-py3-none-any.whl.

File metadata

  • Download URL: ghostpeek-1.0.1-py3-none-any.whl
  • Upload date:
  • Size: 14.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for ghostpeek-1.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 454181431c5a0b736293e5f13981aa9bdc8aa26f6139f4551046e8f114490cdc
MD5 06239e7b5fe2952dd30f0820a957271a
BLAKE2b-256 50232373368f5b06d859fe42067c45797d0e052b843927a7e386cead3fefb474

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page