Skip to main content

A simple Python script to compute the Shodan hash for a website's favicon

Project description

Shodafinder

made-with-python GitHub last commit GitHub Downloads (all assets, all releases) GitHub License

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

carbon

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

  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

  1. Run the script:

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

  3. 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 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 Pull Request with 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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

shodafinder-1.0.0.tar.gz (15.5 kB view details)

Uploaded Source

Built Distribution

shodafinder-1.0.0-py3-none-any.whl (15.9 kB view details)

Uploaded Python 3

File details

Details for the file shodafinder-1.0.0.tar.gz.

File metadata

  • Download URL: shodafinder-1.0.0.tar.gz
  • Upload date:
  • Size: 15.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.4

File hashes

Hashes for shodafinder-1.0.0.tar.gz
Algorithm Hash digest
SHA256 8fd478da9a588148b36c8362e229fa92c655ac4837c48f7bcda207b107695c51
MD5 71224026cdddd7cf7c09574fa483a35f
BLAKE2b-256 1bcf37de9384619b9acdfe5e0de1f0dcc1a97e139004364552a3640b6f0e1f70

See more details on using hashes here.

File details

Details for the file shodafinder-1.0.0-py3-none-any.whl.

File metadata

  • Download URL: shodafinder-1.0.0-py3-none-any.whl
  • Upload date:
  • Size: 15.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.4

File hashes

Hashes for shodafinder-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 86d6095e663d5a2261fccc0066240ee9edda6594fb2a2efde47efc075947f239
MD5 98069af419c940f503cf3ca216262245
BLAKE2b-256 f66e35d869ce341e16aad5e0001eafa9a0f061acc392cb50f693343376209e11

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page