Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ReconPulse v4

Passive Domain Intelligence Framework

ReconPulse is a modular passive reconnaissance CLI toolkit designed to gather domain intelligence safely and ethically. It performs DNS resolution, HTTP fingerprinting, SSL certificate lifecycle analysis, Certificate Transparency lookup, passive subdomain enumeration, WHOIS metadata extraction, and DNS record enumeration — all with structured reporting support.

Built for educational purposes and authorized security testing.

🔍 Core Features

  • DNS Resolution & IP Identification
  • TCP Service Validation (Port 443)
  • HTTP Header Fingerprinting
  • Server Technology Detection
  • SSL Certificate Inspection (Issuer, Expiry, Validity)
  • Certificate Transparency Analysis (crt.sh)
  • Passive Subdomain Enumeration
  • WHOIS Metadata Extraction
  • DNS Record Enumeration (A, AAAA, MX, NS, TXT, CNAME)
  • Asynchronous Concurrent Execution
  • Markdown Report Generation
  • JSON Export Option
  • Structured Logging System

⚙️ Installation

🪟 Windows (PowerShell)

git clone https://github.com/SYCO7/ReconPulse.git
cd ReconPulse

python -m venv .venv
.venv\Scripts\activate

pip install -r requirements.txt

🐧 Linux / macOS

git clone https://github.com/SYCO7/ReconPulse.git
cd ReconPulse

python3 -m venv venv
source venv/bin/activate

pip install -r requirements.txt

🚀 Usage

Basic Scan

python -m reconpulse.main --target example.com

Performs:

  • DNS resolution
  • TCP validation
  • HTTP header collection
  • SSL certificate inspection

Export JSON Report

python -m reconpulse.main --target example.com --json

Generates:

  • Markdown report
  • JSON structured report

Enable Subdomain Intelligence

python -m reconpulse.main --target example.com --subs

Uses crt.sh to gather passive subdomains.

Enable Certificate Transparency Analysis

python -m reconpulse.main --target example.com --ct

Extracts:

  • Certificate count
  • First seen
  • Last observed

Enable WHOIS & DNS Enumeration

python -m reconpulse.main --target example.com --whois --dns

Extracts:

  • Registrar
  • Creation date
  • Expiry date
  • Name servers
  • DNS A, MX, NS, TXT, CNAME records

Full Intelligence Mode

python -m reconpulse.main --target example.com --subs --ct --whois --dns --json

Runs complete passive intelligence collection and exports structured reports.

📁 Output Structure

Reports are saved in:

/reports

Generated files:

  • example.com_recon_<timestamp>.md
  • example.com_recon_<timestamp>.json

Logs are saved in:

/logs/reconpulse.log

🧠 How It Works (Technical Overview)

ReconPulse uses:

  • socket → DNS resolution & TCP connectivity
  • ssl → SSL certificate extraction
  • requests / aiohttp → HTTP & passive data retrieval
  • crt.sh API → Certificate Transparency & subdomain intelligence
  • python-whois → WHOIS metadata parsing
  • dnspython → DNS record enumeration
  • asyncio → Concurrent execution for performance

All reconnaissance techniques are passive and non-intrusive.

🎯 Use Cases

ReconPulse can assist with:

  • Initial domain reconnaissance during authorized engagements
  • Passive information gathering before web testing
  • SSL lifecycle monitoring
  • DNS infrastructure analysis
  • Bug bounty preparation research
  • Red team reconnaissance labs
  • Cybersecurity learning environments

This tool is designed for defensive learning and authorized assessments only.

📂 Project Structure

ReconPulse/
│
├── reconpulse/
│   ├── main.py
│   ├── scanner.py
│   ├── reporter.py
│   ├── utils.py
│
├── reports/
├── logs/
├── requirements.txt
└── README.md

⚠️ Ethical Use Disclaimer

ReconPulse is intended for educational purposes and authorized security testing only.

Do not use this tool against systems without explicit permission. Unauthorized reconnaissance may violate laws or service terms.

The author assumes no liability for misuse.

🛣 Future Roadmap

  • WHOIS caching system
  • DNSSEC validation checks
  • Rate limiting support
  • Config file support
  • Passive OSINT module expansion

👨‍💻 Author

Tanmoy Mondal
GitHub: https://github.com/SYCO7

LinkedIn: https://www.linkedin.com/in/tanmoy-mondal-11070334b/

🏷 Version

ReconPulse v4
Passive Domain Intelligence Framework

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages