https://github.com/sc4rfurry/shodna
Yet another Shodan with CLI + WebUI Tool with some Dorks related to SHodan.
https://github.com/sc4rfurry/shodna
python shodan shodan-cli shodan-webui tool
Last synced: about 1 year ago
JSON representation
Yet another Shodan with CLI + WebUI Tool with some Dorks related to SHodan.
- Host: GitHub
- URL: https://github.com/sc4rfurry/shodna
- Owner: sc4rfurry
- Created: 2023-12-22T16:45:44.000Z (over 2 years ago)
- Default Branch: master
- Last Pushed: 2024-09-17T04:08:34.000Z (almost 2 years ago)
- Last Synced: 2025-02-05T19:50:07.528Z (over 1 year ago)
- Topics: python, shodan, shodan-cli, shodan-webui, tool
- Language: HTML
- Homepage: https://sc4rfurry.github.io/
- Size: 394 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
[](https://www.python.org/)
##
# ShoDNA (◣_◢)ノ-=≡≡卍
Yet Another Shodan CLI Scanner with addition of DORKs related to shodan.
## Table of Contents
- [ShoDNA (◣_◢)ノ-=≡≡卍]
- [Technologies & Tools](#technologies--tools)
- [Requirements](#requirements)
- [Features](#features)
- [Installation](#installation)
- [Config](#config)
- [Usage](#usage)
- [Options](#options)
- [Example](#example)
- [Todo](#todo)
- [Contributing](#contributing)
- [License](#license)
#
### 🔧 Technologies & Tools
##
### 📚 Requirements
> - Python 3.9+
> - pip3
### Features
- Quick and easy to use
- Search the Custom Quries
- Pre-Included **`Dorks`**
- Setch `Shodan's API` Information.
> `Note:` Please keep in mind that the tool is still in development and more features will be added in the future.
## Installation
Use the package manager [pip](https://pip.pypa.io/en/stable/) to install the requirements.
if not installed, install it using the following command.
```bash
sudo apt-get install python3-pip
```
> It is advised to install the python requirements in a virtual environment, for that install the venv package.
```bash
python3 -m pip install venv
python3 -m venv env
source env/bin/activate
```
After that run the following commands:
```bash
python3 -m pip install -r requirements.txt
```
#
## Config
> `ShoDNA` by default uses **Shodan's API** and need the API key, for that make sure you have a `.env` file in the program folder with the API key as follow:
```bash
SHODAN_API_KEY=abc123ShodanKeyHere
```
#
## Usage
```bash
python3 main.py -q [Query]
```
#### Options
```bash
-q Shodan Query
-pl Page Liimit (Defaulr: 1)
-cn Specify the Country (US,JP,FR)
-iq Fetch More Information about each Host (Hostname, Ports etc)
-lq Show the Pre-Included SHodan Dorks (Scada, Medical etc)
-ai Fetch API Information (API key Required)
-idb Fetch the results using the OpenAPI by Shodan
-h Print the help menu
```
##
# (◣_◢) WebUI - ShoDNA
To run the Web Server you have to install the requirements for the Web Server too.
```bash
cd shodna/web
python3 -m pip install -r requirements.txt
```
For `Development` run the server as following:
```bash
python3 app.py
```
As for the `Production` Server do the following:
```bash
cd shodna/web
python3 -m pip install -r requirements.txt
gunicorn -c config.py app:app;
```
+ `gunicorn` should be installed.
##
## Json Viewer
- For now history is json form, so for Chrome user's Kindly install the following extention
```console
> https://chrome.google.com/webstore/detail/json-viewer-pro/eifflpmocdbdmepbjaopkkhbfmdgijcc
```
#### Example
```bash
1) python3 main.py -q 'apache' -pl 2 -cn 'US' -iq
2) python3 main.py -lq
2) python3 main.py -ai
3) python3 main.py -idb 1.1.1.1
4) python3 main.py -h
```
### Todo
- [ ] More things to add
- [ ] Overall Optimizations
- [X] WebUI (Completed)
- [X] Bug Fixes (I tried :/)
#
## Contributing
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
## License
[MIT](https://choosealicense.com/licenses/mit/)