shodafinder 1.0.3

Shodafinder is a simple Python script to compute the Shodan hash for a website's favicon.

Features

• Validates and processes a URL to fetch the favicon.
• Computes a hash of the favicon using mmh3.
• Provides search links for Shodan and ZoomEye based on the favicon hash.

Requirements

• Python 3.x
• requests library
• mmh3 library
• base64 library
• favicon library

Installation

Install from PyPI

You can install Shodafinder directly from PyPI using pip:

pip install shodafinder

Manual Installation

1. Clone this repository:

   git clone https://github.com/logm1lo/Shodafinder.git
   

2. Navigate to the project directory:

   cd Shodafinder
   

3. Install the required libraries:

   pip install -r requirements.txt
   

Usage

After installing, you can run Shodafinder from the command line:

shodafinder

Or manually run the Python script:

python get_favicon_hash.py

1. Enter a URL when prompted. Ensure the URL includes a schema (e.g., http:// or https://).

2. The script will fetch the favicon, compute its hash, and display results with links to search in Shodan and ZoomEye.

Example

# Prompt for user input
Enter URL to get the mmh3-HASH: https://example.com

# Output the computed hash of the favicon
Hash: 1234567890

# Provide Shodan search query link
Use this on Shodan for searching, http.favicon.hash:1234567890
    # Direct link to search in Shodan with the computed hash
    or press here: https://www.shodan.io/search?query=http.favicon.hash%3A1234567890

# Provide ZoomEye search query link
Use this on ZoomEye for searching, iconhash:"1234567890"
    # Direct link to search in ZoomEye with the computed hash
    or press here: https://www.zoomeye.org/searchResult?q=iconhash%3A%20%221234567890%22

How to Contribute

1. Clone the repo and create a new branch:

   git checkout https://github.com/logm1lo/Shodafinder -b name_for_new_branch
   

2. Make changes and test.

3. Submit a Pull Request with a comprehensive description of changes.

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

Please make sure to update tests as appropriate.

License

This project is licensed under the GPL License - see the LICENSE file for details.

Acknowledgments

• Shodan and ZoomEye for providing search engines to explore favicon hashes.