hb-recon README

项目的 README,来自 github.com/mrhlaingbwardev/hb-recon。合并为一个 markdown 文件:README.md。

HB-Recon

Python License Stars

Automated reconnaissance workflow with AI-ready report generation.

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


⚠️ Important Notice

HB-Recon is a workflow automation tool — it orchestrates external security tools and generates structured reports.

What it does:

What it does NOT do:


Features

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


Prerequisites

System Requirements

Required External Tools

You MUST install these tools before using hb-recon:

Tool Purpose Installation
subfinder Subdomain enumeration go install -v github.com/projectdiscovery/subfinder/v2/cmd/subfinder@latest
httpx HTTP probe go install -v github.com/projectdiscovery/httpx/cmd/httpx@latest
katana Web crawler go install -v github.com/projectdiscovery/katana/cmd/katana@latest
gf Pattern matcher go install github.com/tomnomnom/gf@latest
whatweb Tech detection sudo apt install whatweb (Debian/Ubuntu)

Quick Install (All Tools)

# Install Go tools
go install -v github.com/projectdiscovery/subfinder/v2/cmd/subfinder@latest
go install -v github.com/projectdiscovery/httpx/cmd/httpx@latest
go install -v github.com/projectdiscovery/katana/cmd/katana@latest
go install github.com/tomnomnom/gf@latest

# Install WhatWeb
sudo apt install whatweb

# Verify installations
subfinder -version
httpx -version
katana -version
gf -h
whatweb --version

Installation

docker build -t hb-recon .
docker run -it hb-recon -h

Option 2: From Source (Linux/WSL)

git clone https://github.com/mrhlaingbwardev/hb-recon.git
cd hb-recon
pip install -e .

Usage

Interactive Mode

python -m hb_recon

Example:

=======================================================
  Auto Recon -> AI Ready
=======================================================

[>] Domain: example.com

[+] Subfinder + Httpx
[v] Done (5.2s)

[*] WhatWeb + Katana (parallel)...
[+] Katana (crawl)
[v] Done (12.4s)

[+] gf (XSS/SQLi/IDOR patterns)
[v] Done (1.8s)

[√] Total: 19.4s

Output Structure

recon_example.com/
├── subdomains.txt      # All discovered subdomains
├── alive.txt           # Live hosts (200, 301, 403)
├── urls.txt            # Crawled endpoints (depth 3)
├── xss.txt             # XSS-prone endpoints
├── sqli.txt            # SQLi-prone endpoints
├── idor.txt            # IDOR-prone endpoints
├── tech_stack.txt      # Technology detection
└── ai_report.json      # AI-ready structured report

AI Report Format

The tool generates ai_report.json with structured data perfect for AI analysis:

{
  "target": "example.com",
  "timestamp": "2026-06-20T13:45:00",
  "summary": {
    "subdomains": 15,
    "alive_hosts": 8,
    "endpoints": 324,
    "technologies": 12,
    "high_risk": 3,
    "medium_risk": 7,
    "low_risk": 15
  },
  "endpoints": [
    {
      "url": "https://admin.example.com/api/users?id=123",
      "category": "idor",
      "risk": "high",
      "params": ["id"]
    }
  ],
  "tech_stack": {
    "server": "nginx/1.18.0",
    "frameworks": ["React", "Node.js"],
    "cms": "WordPress 6.2"
  }
}

Use with AI:

# After scan
cat recon_example.com/ai_report.json | pbcopy
# Paste into ChatGPT/Claude: "Analyze this recon data for vulnerabilities"

Workflow Logic

Input: Domain
    ↓
1. Subdomain Enumeration (subfinder)
    → hackertarget, waybackarchive sources
    ↓
2. Live Detection (httpx)
    → Filter 200, 301, 403 status codes
    ↓
3. Parallel Execution:
    ├─→ Tech Stack (WhatWeb)
    └─→ Endpoint Crawl (Katana depth=3)
    ↓
4. Pattern Detection (gf)
    ├─→ XSS patterns
    ├─→ SQLi patterns
    └─→ IDOR patterns
    ↓
5. AI Report Generation
    → Risk scoring
    → Category grouping
    → JSON export

Example Workflow

# 1. Install hb-recon (from source)
git clone https://github.com/mrhlaingbwardev/hb-recon.git
cd hb-recon
pip install -e .

# 2. Run scan
python -m hb_recon
# Enter: bugcrowd.com

# 3. Wait 30-60 seconds

# 4. Check results
cd recon_bugcrowd.com
cat ai_report.json

# 5. Analyze with AI
# Copy ai_report.json content to ChatGPT/Claude

Security Notice

⚠️ Only use on authorized targets.

This tool is for:

Unauthorized scanning is illegal and violates:

You are responsible for your actions.


Troubleshooting

"Command not found" errors

Problem: Tool binaries not in PATH

Solution:

# Add Go bin to PATH (add to ~/.bashrc or ~/.zshrc)
export PATH="$HOME/go/bin:$PATH"

# Reload shell
source ~/.bashrc

"Platform Error" on Windows

Problem: hb-recon requires Linux/WSL

Solution:

# Use WSL (Windows Subsystem for Linux)
wsl -d kali-linux
pip install hb-recon
python -m hb_recon

Network timeouts

Problem: Slow/unstable connection

Solution:

# Increase timeout in cli.py
# Default: timeout=300 (5 minutes)

Contributing

Contributions welcome! Please:

  1. Fork the repository
  2. Create a feature branch
  3. Submit a pull request

License

MIT License - See LICENSE


Author

Hlaing Bwar


Made with ❤️ for the bug bounty community

Disclaimer: This tool is for educational and authorized testing only. Misuse may result in legal consequences.

hb-recon (mrhlaingbwardev/hb-recon)

正在搜索数据库…

这是什么?一个用于安全侦察的工作流工具:它把多个外部侦察工具串联起来,并将其输出转换为结构化的 JSON 报告,便于分析。
它自己运行扫描,还是调用其他工具?它是调用其他工具。它负责编排外部安全工具,本身没有内置扫描引擎,也不会替你安装这些工具。
我该怎么把它跑起来?先安装外部工具(subfinder、httpx、katana、gf、whatweb),然后在 Linux 或 WSL 中从源码设置 hb-recon,或者使用 Docker 方案。
开始之前我需要准备什么?Python 3.8+ 和 Go 1.19+,因为大多数被串联的工具都通过 'go install' 安装。whatweb 在 Debian 和 Ubuntu 上通过 apt 安装。
有什么需要注意的?你需要手动安装好几个外部工具;如果某个工具的二进制文件不在 PATH 中,运行就会失败。作者也要求你只扫描已获得授权测试的目标。
它是给漏洞赏金猎人用的吗?是的。README 面向漏洞赏金猎人、渗透测试人员和安全研究人员,并提醒漏洞赏金项目必须有明确定义的范围。
它能在 Windows 上用吗?不能直接用。它需要 Linux 或 WSL,README 建议 Windows 用户使用 Docker 方案。
它串联了哪些工具?Subfinder 用于查找子域名,httpx 检查哪些主机在线,WhatWeb 识别技术栈,Katana 爬取端点,爬取深度为 3,gf 则用于匹配 XSS、SQLi 和 IDOR 的模式。
“Command not found”报错是怎么回事?当工具的二进制文件不在 PATH 中时就会出现这个错误。README 把它列为第一个排错案例,所以请检查已安装的工具能否从你的 shell 中调用。
大小
<0.1 MB
星标
320
更新
提交Aug 18
时长
3个月
提交 · 90 天