Skip to content
This repository has been archived by the owner on Sep 17, 2024. It is now read-only.

Latest commit

 

History

History
161 lines (109 loc) · 3.85 KB

README.md

File metadata and controls

161 lines (109 loc) · 3.85 KB

forthebadge made-with-python

SubHuntr99

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

Table of Contents

📝 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


sub

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:

Please make sure to update tests as appropriate.

License

MIT

Feedback

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