SubHuntr99

Hunting Sub-Domain(s) by scraping subdomainfinder.c99.nl.

Table of Contents

• SubHuntr99
  • Table of Contents
    • 📝 Description
    • 🔧 Technologies & Tools
  • 📚 Requirements
  • Installation
    • Usage
      • Help Menu
    • Docker
    • Repo Info
  • Contributing
  • Todo
  • Contributors
  • License
  • Feedback

📝 Description

SubHuntr99 is a python script that scrapes the subdomainfinder.c99.nl website to find sub-domains of a domain. I/O is done using the requests and BeautifulSoup libraries. Also, it is possible to use a custom user-agent.

🔧 Technologies & Tools

📚 Requirements

• Python 3.9+
• pip3

Installation

Use the package manager pip to install the requirements. if not installed, install it using the following command.

sudo apt-get install python3-pip

It is advised to install the python requirements in a virtual environment, for that install the venv package.

python3 -m pip install venv
cd SubHuntr99
python3 -m venv env
source env/bin/activate

After that run the following commands:

python3 -m pip install -r requirements.txt

Usage

1) python3 main.py
2) python3 main.py -d example.com
3) python3 main.py -d example.com -u "Mozilla/5.0 (X11; Linux x86_64; rv:78.0) Gecko/20100101 Firefox/78.0"

Help Menu

                        
   _____       __    __  __            __       ____  ____ 
  / ___/__  __/ /_  / / / /_  ______  / /______/ __ \/ __ \
  \__ \/ / / / __ \/ /_/ / / / / __ \/ __/ ___/ /_/ / /_/ /
 ___/ / /_/ / /_/ / __  / /_/ / / / / /_/ /   \__, /\__, / 
/____/\__,_/_.___/_/ /_/\__,_/_/ /_/\__/_/   /____//____/ 
    

    Sub Domian Finder --> subdomainfinder.c99.nl
        
        Author:     Sc4rfurry
        version:    0.2
        github:     https://github.com/sc4rfurry
    
================================================================================

usage: main.py [-h] [-d DOMAIN] [-u USERAGENT]

SubHuntr99

options:
  -h, --help    show this help message and exit
  -d DOMAIN     Domain
  -u USERAGENT  User-Agent

Docker

# Build the docker image
docker build -t subhuntr99 .

# Run the docker image
docker run -it subhuntr99

# Run the docker image with a argument
docker run -it subhuntr99 -d example.com

Repo Info

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Todo

• Clean Up the Code.
• Optimize the workflow.
• More bugs to fix. :\XD

Contributors

Special thanks to the following people who have contributed to this project:

• @cosad3s

Please make sure to update tests as appropriate.

License

MIT

Feedback

If you have any feedback, please reach out to us at [email protected]