🎯 bounthunt — Bug Bounty Recon & Orchestration

Scope-aware recon orchestration for bug bounty programs.

🚀 Demo

$ bounthunt monitor scope.yaml

🔄 Starting monitoring loop...
[INFO] Checking scope.yaml...
[INFO] Scan completed. 12 new hosts discovered.
[INFO] 2 new endpoints found on example.com
[INFO] 1 new vulnerability found via nuclei
[SUCCESS] Sending notification to Telegram...

$ bounthunt report --format html

📊 Generating diff report...
✅ Report saved to reports/diff_2026_07_12.html

❓ Why bounthunt?

✨ Features

• Scope Guard — YAML allow/deny list prevents accidental out-of-scope scanning
• Diff Monitoring — Tracks new hosts, ports, findings, endpoints across scan runs
• SQLite Persistence — Every scan stored with timestamps, queryable and auditable
• Professional Reports — HTML/Markdown via Jinja2 with diff sections
• Smart Notifications — Telegram and Discord webhook alerts on changes
• Dockerized Workflow — Multi-stage Docker build, docker compose up -d for 24/7 scans

🛠️ Tech Stack

• Language: Python 3.11+
• CLI: Typer
• Terminal output: Rich
• HTTP client: HTTPX
• DB & Storage: SQLite
• Templates: Jinja2
• Config: PyYAML
• Orchestration: subfinder · dnsx · httpx · naabu · nuclei · katana
• Reports: HTML/Markdown via Jinja2 with diff sections
• Notifications: Telegram / Discord webhooks
• Deployment: Docker

🏗️ Architecture

graph TD
    S[Scope YAML] --> G{Scope Guard}
    G -->|allow| SF[subfinder]
    SF --> DX[dnsx]
    DX --> HX[httpx]
    HX --> NB[naabu]
    NB --> NC[nuclei]
    NC --> KT[katana]
    KT --> SC[secrets]
    SC --> DB[(SQLite)]
    DB --> DIFF[Diff Engine]
    DIFF --> RPT[Report]
    DIFF --> NOT[Notifications]
    NOT --> TG[Telegram]
    NOT --> DC[Discord]
    G -->|deny| X[❌ Blocked]

⚡ Quick Start

Prerequisites

• Python 3.11+
• Docker (recommended) or Go tools installed locally

Using Docker (Recommended)

docker compose build
docker compose run --rm bounthunt scan /data/scope.yaml --all
docker compose up -d

Using Source

git clone https://github.com/bess1lie/bounthunt.git
cd bounthunt
pip install .
bounthunt init scope.yaml
bounthunt scan scope.yaml --all

🗺️ Roadmap

🤝 Contributing

Contributions welcome! See CONTRIBUTING.md.

📄 License

MIT — see LICENSE.

🔍 apihunter · 🚀 gqlhunter · 🌍 bess1lie.github.io