Metadata-Version: 2.4
Name: hb-recon
Version: 1.0.1
Summary: Automated reconnaissance tool with AI report generation. Subdomain enumeration, endpoint crawling, and vulnerability pattern detection.
Author-email: Hlaing Bwar <infohlaingbwar@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/infohlaingbwar/hb-recon
Project-URL: Repository, https://github.com/infohlaingbwar/hb-recon
Project-URL: Bug Tracker, https://github.com/infohlaingbwar/hb-recon/issues
Keywords: recon,reconnaissance,osint,bug-bounty,pentesting,subdomain,enumeration,security,ethical-hacking
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Security
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: MacOS
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == "dev"
Requires-Dist: black>=22.0; extra == "dev"
Dynamic: license-file

# HB-Recon

**Automated reconnaissance tool with AI-ready report generation.**

Perfect for bug bounty hunters, pentesters, and security researchers.

## Features

✅ **Subdomain Enumeration** — subfinder integration  
✅ **Live Host Detection** — httpx for alive checks  
✅ **Technology Stack Scan** — WhatWeb detection  
✅ **Endpoint Crawling** — Katana deep crawl  
✅ **Vulnerability Patterns** — gf (XSS, SQLi, IDOR detection)  
✅ **AI Report Generation** — Structured JSON output  

## Requirements

**External Tools (must be installed):**
- [subfinder](https://github.com/projectdiscovery/subfinder)
- [httpx](https://github.com/projectdiscovery/httpx)
- [katana](https://github.com/projectdiscovery/katana)
- [gf](https://github.com/tomnomnom/gf)
- [whatweb](https://github.com/urbanadventurer/WhatWeb)

**Install tools:**


## Install

Defaulting to user installation because normal site-packages is not writeable

## Usage



**Example:**


**Output Structure:**


## AI Report

The tool generates  with:
- Target info
- Discovered subdomains & endpoints
- Technology stack
- Risk-scored vulnerabilities
- Attack surface summary

Perfect for feeding into AI tools like ChatGPT, Claude for analysis.

## Example Workflow

Defaulting to user installation because normal site-packages is not writeable

## Security Notice

⚠️ **Only use on authorized targets.** Unauthorized scanning is illegal.

## License

MIT License - See [LICENSE](LICENSE)

## Author

**Hlaing Bwar**  
- GitHub: [@infohlaingbwar](https://github.com/infohlaingbwar)
- Website: [hlaingbwar.com](https://www.hlaingbwar.com)

---

**Made with ❤️ for the bug bounty community**
