Cyber Recon Toolkit
Project description
Cyber Recon Toolkit
๐ฆ Install directly from PyPI
pip install cyber-recon-toolkit
cyber-recon
Cyber Recon Toolkit is a modular Python-based cybersecurity framework that provides reconnaissance, network analysis, automated security assessment, forensic utilities, and professional report generation through a unified command-line interface.
Overview
This toolkit combines multiple reconnaissance, scanning, forensic, and reporting utilities into a single integrated Python platform. It is designed for practical cybersecurity workflows, clean CLI interaction, modular expansion, and evidence-oriented reporting.
Features
Reconnaissance Modules
- WHOIS Lookup
- DNS Enumeration
- Ping Sweep
Scanning Modules
- TCP Port Scanner
- Log Analyzer
Utility Modules
- Hash Generator
- Phishing URL Checker
- Combined Report Generator
Security Assessment
- Automated Security Assessment
- Risk Classification (LOW / MEDIUM / HIGH)
- Executive Summary Generation
- Consolidated Security Reporting
- JSON Assessment Reports
- PDF Assessment Reports
Reporting Features
- JSON report export
- CSV report export
- PDF report export
- Timestamped forensic reports
- PDF watermarking
- Consolidated evidence collection
- Cross-module report aggregation
Project Structure
Cyber-Recon-Toolkit/
โโโ cyber_recon_toolkit/
โ โโโ modules/
โ โ โโโ dns_enum.py
โ โ โโโ hash_generator.py
โ โ โโโ log_analyzer.py
โ โ โโโ phishing_checker.py
โ โ โโโ ping_sweep.py
โ โ โโโ port_scanner.py
โ โ โโโ report_generator.py
โ โ โโโ security_assessment.py
โ โ โโโ whois_lookup.py
โ โโโ __init__.py
โ โโโ __main__.py
โ โโโ toolkit.py
โโโ README.md
โโโ pyproject.toml
โโโ requirements.txt
โโโ run.sh
โโโ screenshots/
โโโ reports/
โโโ logs/
Requirements
- Python 3.10 or higher
- Linux-based environment recommended
- Tested on Kali Linux
Installation
Install from PyPI
The toolkit is published on PyPI and can be installed with a single command:
pip install cyber-recon-toolkit
cyber-recon
Install from Source
Clone the repository for development:
git clone https://github.com/kvr585/Cyber-Recon-Toolkit.git
cd Cyber-Recon-Toolkit
./run.sh
The launcher automatically:
- Creates a virtual environment (
.venv) - Activates the environment
- Installs required dependencies
- Starts the toolkit
Quick Start
After installation, launch the toolkit:
cyber-recon
Or if running from source:
./run.sh
Running the Toolkit
Start the toolkit using:
./run.sh
Using the launcher ensures the virtual environment and dependencies are configured correctly before execution.
Main Menu
RECON
1. WHOIS Lookup
2. DNS Enumeration
3. Ping Sweep
SCANNING
4. Port Scanner
5. Log Analyzer
UTILITIES
6. Hash Generator
7. Phishing URL Checker
8. Generate Combined Report
ASSESSMENT
10. Automated Security Assessment
SYSTEM
9. Exit (Available from any menu)
Module Details
WHOIS Lookup
- Domain WHOIS lookup
- Registrar information
- Creation and expiration dates
- Domain status
- DNS nameservers
- JSON report generation
DNS Enumeration
- A record lookup
- AAAA record lookup
- MX record lookup
- NS record lookup
- TXT record lookup
- CNAME discovery
- DNS summary output
- JSON report export
Ping Sweep
- /24 subnet discovery
- Multithreaded ICMP scanning
- Live host detection
- Scan timing
- JSON reporting
Port Scanner
- Multithreaded TCP port scanning
- Custom port range support
- Service detection
- Basic banner grabbing
- Progress tracking
- Resolved target IP display
- JSON reporting
Log Analyzer
- Log file parsing
- Suspicious activity detection
- Error highlighting
- Security event inspection
- JSON export
Hash Generator
- MD5 hashing
- SHA1 hashing
- SHA256 hashing
- SHA512 hashing
- Text hashing
- File hashing
- Hash verification
- File integrity checks
- JSON reporting
Phishing URL Checker
- URL structure analysis
- Suspicious keyword detection
- IP-based URL detection
- URL length analysis
- HTTPS validation
- Domain extraction checks
Automated Security Assessment
The Automated Security Assessment module performs multiple security checks against a target and generates a consolidated report.
Assessment workflow:
- WHOIS Analysis
- DNS Enumeration
- Port Scanning
- Phishing URL Analysis
- Risk Classification
- Executive Summary Generation
- JSON Report Export
- PDF Report Export
The module automatically combines findings from multiple components into a single assessment report for easier review and documentation.
Combined Report Generator
- Aggregates module outputs into combined JSON
- Generates combined CSV reports
- Produces formatted PDF reports
- Adds forensic timestamps
- Includes PDF watermarking
- Allows direct report opening from toolkit
Screenshots
Main Menu
Port Scanner
Generated PDF Report
Output and Reports
Generated reports are automatically saved inside the reports/ directory.
Supported formats include:
- JSON
- CSV
Generated reports may include:
- Scan results
- DNS findings
- WHOIS information
- Security events
- Forensic summaries
- Timestamps
- Watermarked PDF exports
Disclaimer
This project is intended strictly for educational, academic, and authorized security testing purposes only.
Do not use this toolkit against systems, networks, or services without proper authorization.
The developer is not responsible for misuse or unauthorized activities performed using this toolkit.
Author
Veera Bhadhra Rao
Cyber Security Student | Python Developer | Cybersecurity Enthusiast | Open Source Contributor
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file cyber_recon_toolkit-1.0.1.tar.gz.
File metadata
- Download URL: cyber_recon_toolkit-1.0.1.tar.gz
- Upload date:
- Size: 20.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a398c8c5dce4c9490dc16a8867f14d45bc189822485448183cf6f0bc0917abd8
|
|
| MD5 |
15b7469d4891779946e8811201c2dffe
|
|
| BLAKE2b-256 |
faca20c49df3b76040d90cac994dddafa3567308b2003c184dbf4670367cfa6c
|
File details
Details for the file cyber_recon_toolkit-1.0.1-py3-none-any.whl.
File metadata
- Download URL: cyber_recon_toolkit-1.0.1-py3-none-any.whl
- Upload date:
- Size: 23.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d1f4149b81fee9e107e1b9a13fa2e985b4b6533d74776cd5de1cc4569f6a9c85
|
|
| MD5 |
d40fb633dcfdf78c0cff372cb9a8a70c
|
|
| BLAKE2b-256 |
d1aa26fdb13c4b9d292cc5086c93bb3ca5c1098565e2d69041dd59697e9dd07d
|