Skip to main content

Modern modular reconnaissance framework for bug bounty hunters and security researchers.

Project description

➡️ مشاهده نسخه فارسی

HunterX

Modern Modular Reconnaissance Framework
Built for Bug Bounty Hunters • Pentesters • Security Researchers


HunterX

HunterX is a modern reconnaissance framework written entirely in Python.

It is designed for bug bounty hunters, penetration testers and security researchers who need a fast, modular and extensible reconnaissance toolkit.

Unlike traditional monolithic scanners, HunterX uses an independent plugin architecture, allowing every module to work individually or as part of a complete reconnaissance pipeline.


Features

  • Modular architecture
  • Plugin-based design
  • Fast HTTP engine
  • DNS reconnaissance
  • Subdomain enumeration
  • JavaScript analysis
  • Web crawler
  • Directory brute forcing
  • Security header analysis
  • Cookie analysis
  • CORS analysis
  • Technology fingerprinting
  • Workspace support
  • JSON reports
  • Markdown reports
  • Colored terminal UI
  • Progress bars
  • Rich logging
  • Extensible API

Installation

Using pip

pip install hunterx-reconhive

Using uv

uv tool install hunterx-reconhive

Usage

Basic scan

hunterx scan example.com

Run specific plugins

hunterx scan example.com --plugins dns,http,crawler

Custom HTTP headers

hunterx scan example.com -H "Authorization: Bearer TOKEN"

POST request

hunterx scan example.com -X POST

Directory scan

hunterx scan example.com --plugins directory

Crawler

hunterx scan example.com --plugins crawler

JavaScript analysis

hunterx scan example.com --plugins javascript

Generate JSON report

hunterx scan example.com -o report.json

Generate Markdown report

hunterx scan example.com -o report.md

Available Plugins

Plugin Description
dns DNS Reconnaissance
http HTTP Analysis
crawler Website Crawling
javascript JavaScript Analysis
directory Directory Enumeration
subdomain Subdomain Enumeration
tls TLS Scanner
ports Port Scanner

Example

hunterx scan google.com --plugins dns,http,crawler,javascript -o report.json

Project Structure

hunterx/
│
├── cli/
├── core/
├── modules/
├── plugins/
└── utils/

Architecture

CLI

↓

Core Engine

↓

Plugin Loader

↓

Plugins

↓

Modules

↓

Result Objects

↓

Workspace / Report

Current Modules

✅ DNS

✅ HTTP

✅ Cookies

✅ Security Headers

✅ CORS

✅ Fingerprinting

✅ Directory Scanner

✅ Web Crawler

✅ JavaScript Analyzer


Roadmap

  • TLS Scanner improvements

  • Port Scanner

  • WAF Detection

  • Screenshot Engine

  • Parameter Discovery

  • Archive.org integration

  • Wayback Machine

  • CDN Detection

  • ASN Lookup

  • CSP Analyzer

  • HTTP/2 & HTTP/3 analysis

  • HTTP Request Smuggling checks

  • GraphQL discovery

  • Swagger/OpenAPI detection

  • Secret Discovery

  • AWS bucket discovery

  • Passive Recon

  • Shodan integration

  • Censys integration

  • VirusTotal integration

  • HTML Report

  • Live Dashboard


Why HunterX?

HunterX focuses on

  • Clean architecture
  • High performance
  • Readable output
  • Easy plugin development
  • Modern Python practices
  • Lightweight dependencies

Contributing

Contributions are welcome.

Fork the repository

Create your feature branch

Submit a Pull Request


License

MIT License


Disclaimer

HunterX is intended for educational purposes and authorized security assessments only.

The author is not responsible for any misuse.

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

hunterx_reconhive-0.2.1.tar.gz (53.0 kB view details)

Uploaded Source

Built Distribution

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

hunterx_reconhive-0.2.1-py3-none-any.whl (76.9 kB view details)

Uploaded Python 3

File details

Details for the file hunterx_reconhive-0.2.1.tar.gz.

File metadata

  • Download URL: hunterx_reconhive-0.2.1.tar.gz
  • Upload date:
  • Size: 53.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.26 {"installer":{"name":"uv","version":"0.11.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for hunterx_reconhive-0.2.1.tar.gz
Algorithm Hash digest
SHA256 a8a2e828fe648115de27e1d9fd16faf686fc51801b59072ef3ea4764f37f2133
MD5 fca5c497c9cc7c143cfe90208f4bf1b9
BLAKE2b-256 b644d5e24872deee0e538b7c7f413e8b6aa86b312cb29dbcf8f214b0fe6586c5

See more details on using hashes here.

File details

Details for the file hunterx_reconhive-0.2.1-py3-none-any.whl.

File metadata

  • Download URL: hunterx_reconhive-0.2.1-py3-none-any.whl
  • Upload date:
  • Size: 76.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.26 {"installer":{"name":"uv","version":"0.11.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for hunterx_reconhive-0.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 cb978e32504f7a504068ab3134d829338aa5ad9be6ea45e7486e23de2020bb94
MD5 5b027348339a5fb719d4c74cb9a39b13
BLAKE2b-256 886f8613d105e7d1426a46b4eb8ca4bee7deb150f993ebdf02b4205d3c643515

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