Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/NullArray/Shogun
Shodan.io Command Line Interface
https://github.com/NullArray/Shogun
cli command-line command-line-interface command-line-tool intelligence-gathering interactive interface osint shodan
Last synced: about 1 month ago
JSON representation
Shodan.io Command Line Interface
- Host: GitHub
- URL: https://github.com/NullArray/Shogun
- Owner: NullArray
- License: gpl-3.0
- Created: 2017-03-27T15:15:18.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2021-07-10T23:32:22.000Z (over 3 years ago)
- Last Synced: 2024-11-15T10:10:36.806Z (about 1 month ago)
- Topics: cli, command-line, command-line-interface, command-line-tool, intelligence-gathering, interactive, interface, osint, shodan
- Language: Python
- Size: 22.5 KB
- Stars: 44
- Watchers: 6
- Forks: 27
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-ip-search-engines - Shogun
README
# Shogun
Shodan.io Command Line Interface
Shogun is a custom CLI for the Shodan.io search engine. The interface is designed to resemble a "shell" to the Shodan database. This way we can simply input commands to have the program perform various operations. As such Shogun aims to be a comprehensive assistant in the process of gathering open source intelligence.
Features include the ability to resolve domains, check if a host IP has any ports with certain services running and attempts to enumerate these services. It can also provide a summary of all the information Shodan has on platforms such as 'IIS' or Apache etc and includes a feature to log all information gathered in this manner and more.
## Usage
Cloning the repo.
```
git clone https://github.com/NullArray/Shogun.git
cd Shogun
python shogun.py
```
The commands for Shogun are as follows.
```
Help - Print usage information
Resolve - Query DNS to retrieve a domain's associated IP address
Ports - Retrieve ports/services associated with provided host IP
Platform- Retrieve IPs associated with platform. I.E. 'Routers' returns a list of IPs that are classified as part of such
Summary - Provide a summary of information on provided search item. I.E. 'IIS' will provide top results for 'IIS'
Logging - Enable or disable search result logging(Disabled by default)
Api - Display API key info and/or change API key
Quit/Q - Exit Shogun
```
## Dependencies
Besides the Shodan module Shogun makes use of Blessings as well for formatting purposes. Should you find you do not have these installed please use `pip` to get them like so.
```
pip install shodan
pip install blessings
```
Or feel free to use the requirements file i have made for this program.
`pip install -r requirements.txt`