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.2.tar.gz (16.3 kB view details)

Uploaded Source

Built Distribution

shodafinder-1.0.2-py3-none-any.whl (16.7 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: shodafinder-1.0.2.tar.gz
  • Upload date:
  • Size: 16.3 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.2.tar.gz
Algorithm Hash digest
SHA256 77fdfa7b9a837dd0043ddb9c5d4918dd88eb72ccbc12e0ef6f3c92017cac7e3e
MD5 ebfdba655cbe77c6b9a2f3e735e9a131
BLAKE2b-256 beb48f4f66be0383b1e52f3988aca5188cce36a1639a71ac3332f4089c53a70f

See more details on using hashes here.

File details

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

File metadata

  • Download URL: shodafinder-1.0.2-py3-none-any.whl
  • Upload date:
  • Size: 16.7 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.2-py3-none-any.whl
Algorithm Hash digest
SHA256 9989f489510e64c1af0f0a9ab600a3a9cf2bb767045e0599674845a24c6c9e95
MD5 c4a27f8e8e2cc74c6dc3934f86128313
BLAKE2b-256 dab45a7244f31943fd420d5c1a605a97295b515c7309188a74151d5ecfb641d5

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