Skip to main content

Cyber Recon Toolkit

Project description

Cyber Recon Toolkit

PyPI Python GitHub stars

๐Ÿ“ฆ 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

Main Menu


Port Scanner

Port Scanner


Generated PDF Report

PDF Report

PDF Report


Output and Reports

Generated reports are automatically saved inside the reports/ directory.

Supported formats include:

  • JSON
  • CSV
  • PDF

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


Download files

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

Source Distribution

cyber_recon_toolkit-1.0.1.tar.gz (20.5 kB view details)

Uploaded Source

Built Distribution

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

cyber_recon_toolkit-1.0.1-py3-none-any.whl (23.5 kB view details)

Uploaded Python 3

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

Hashes for cyber_recon_toolkit-1.0.1.tar.gz
Algorithm Hash digest
SHA256 a398c8c5dce4c9490dc16a8867f14d45bc189822485448183cf6f0bc0917abd8
MD5 15b7469d4891779946e8811201c2dffe
BLAKE2b-256 faca20c49df3b76040d90cac994dddafa3567308b2003c184dbf4670367cfa6c

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for cyber_recon_toolkit-1.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 d1f4149b81fee9e107e1b9a13fa2e985b4b6533d74776cd5de1cc4569f6a9c85
MD5 d40fb633dcfdf78c0cff372cb9a8a70c
BLAKE2b-256 d1aa26fdb13c4b9d292cc5086c93bb3ca5c1098565e2d69041dd59697e9dd07d

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