WebFox is an automated web reconnaissance and vulnerability scanning framework designed for ethical hackers, penetration testers, and bug bounty hunters.
It performs domain scanning, data collection, and reporting, and also provides a GUI interface for ease of use.
- 🔍 Automated domain scanning
- 📊 Generates structured reports
- 📁 Saves results and snapshots automatically
- 🖥️ Command Line Interface (CLI)
- 🎨 Graphical User Interface (GUI) using Streamlit
- ⚡ Simple installation & execution
- 🐍 Built with Python
Before installation, make sure you have:
- Python 3.8 or above
- Linux / Kali / Ubuntu / Termux
- Internet connection
git,chmod,bash
git clone https://github.com/lucky-om/WebFox2️⃣ Navigate to the Project Directory
cd WebFox3️⃣ Give Execute Permissions
chmod +x *4️⃣ Run the Installer
./install.shThis script will automatically install all required dependencies.
🔹 Run Scan
python3 test.py example.com -scan🔹 Description
Replace example.com with your target domain
The tool will start scanning automatically
📂 Results & Reports
After the scan completes:
📁 Results are saved inside:
WebFox/report/
Inside the report folder, you will find:
📄 Scan results
📊 Collected data
📸 Domain snapshots
📁 Organized output files
Everything related to the scan is stored there.
🖥️ GUI Mode (Streamlit)
WebFox also provides a Graphical User Interface.
streamlit run gui.py🔹 GUI Features
Easy target input
One‑click scanning
Visual output
Beginner‑friendly interface
📸 Tool Screenshots
🔹 CLI Mode
🔹 GUI Mode
WebFox is developed strictly for educational and authorized security testing purposes.
❌ Do NOT scan domains without permission
❌ Illegal use is strictly prohibited
✅ Use only on assets you own or are authorized to test
The developer holds no responsibility for misuse of this tool.
🧠 Use Cases
Bug Bounty Reconnaissance
Attack Surface Mapping
Security Assessment
Learning Ethical Hacking
Automation Practice
🤝 Contributing
Contributions are welcome!
-
Fork the repository
-
Create a new branch
-
Commit your changes
-
Open a Pull Request
👤 Author
Lucky Krish Jayesh Aryan Kunal Shani GitHub: https://github.com/lucky-om
⭐ Support
If you like this project:
⭐ Star the repository
🐛 Report issues
💡 Suggest improvements
📜 License
This project is licensed under the MIT License.