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
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 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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a8a2e828fe648115de27e1d9fd16faf686fc51801b59072ef3ea4764f37f2133
|
|
| MD5 |
fca5c497c9cc7c143cfe90208f4bf1b9
|
|
| BLAKE2b-256 |
b644d5e24872deee0e538b7c7f413e8b6aa86b312cb29dbcf8f214b0fe6586c5
|
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
cb978e32504f7a504068ab3134d829338aa5ad9be6ea45e7486e23de2020bb94
|
|
| MD5 |
5b027348339a5fb719d4c74cb9a39b13
|
|
| BLAKE2b-256 |
886f8613d105e7d1426a46b4eb8ca4bee7deb150f993ebdf02b4205d3c643515
|