https://github.com/logm1lo/shodafinder
A simple Python script to compute the Shodan hash for a website's favicon
https://github.com/logm1lo/shodafinder
ip python shodan zoomeye
Last synced: 3 months ago
JSON representation
A simple Python script to compute the Shodan hash for a website's favicon
- Host: GitHub
- URL: https://github.com/logm1lo/shodafinder
- Owner: logm1lo
- License: gpl-3.0
- Created: 2024-08-08T03:16:54.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-10-17T07:50:08.000Z (12 months ago)
- Last Synced: 2024-11-19T13:52:45.572Z (11 months ago)
- Topics: ip, python, shodan, zoomeye
- Language: Python
- Homepage:
- Size: 22.5 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://www.python.org/)   
**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](https://pypi.org/project/shodafinder/) using `pip`:
```sh
pip install shodafinder
```
### Manual Installation
1. Clone this repository:
```sh
git clone https://github.com/logm1lo/Shodafinder.git
```
2. Navigate to the project directory:
```sh
cd Shodafinder
```
3. Install the required libraries:
```sh
pip install -r requirements.txt
```
## Usage
After installing, you can run `Shodafinder` from the command line:
```sh
shodafinder
```
Or manually run the Python script:
```sh
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:
```sh
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](LICENSE) file for details.
## Acknowledgments
- [Shodan](https://www.shodan.io/) and [ZoomEye](https://www.zoomeye.org/) for providing search engines to explore favicon hashes.