Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/s4hm4d/shodanidb
Fetch data (open ports, CVEs, CPEs, ...) from shodan internetDB API
https://github.com/s4hm4d/shodanidb
Last synced: 21 days ago
JSON representation
Fetch data (open ports, CVEs, CPEs, ...) from shodan internetDB API
- Host: GitHub
- URL: https://github.com/s4hm4d/shodanidb
- Owner: s4hm4d
- Created: 2022-02-19T20:50:38.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2023-01-09T08:08:42.000Z (almost 2 years ago)
- Last Synced: 2024-08-05T17:29:43.682Z (4 months ago)
- Language: Go
- Size: 22.5 KB
- Stars: 91
- Watchers: 3
- Forks: 12
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-hacking-lists - s4hm4d/shodanidb - Fetch data (open ports, CVEs, CPEs, ...) from shodan internetDB API (Go)
- awesome-ip-search-engines - Shodanidb (Fetch data (open ports, CVEs, CPEs, ...) from shodan internetDB API)
README
# shodanIDB
A command-line tool to fetch data (open ports, CVEs, CPEs, ...) from [Shodan internetDB API](https://internetdb.shodan.io/). Free to use and no API key required.
## Installation
```
go install -v github.com/s4hm4d/shodanidb@latest
```
## Usage
```shell
echo | shodanidb [options]
Options:
-nc Hide CPEs
-nh Hide hostnames
-nt Hide tags
-nv Hide vulnerabilities
-nocolor Disable color in output
-json Save output to JSON format
-compare Compare new results with a JSON file
-url Show only IP and Port
-v Verbose mode
-c Concurrency (default 5)
-nmap Run Nmap Service Detection
-script Run Nmap Scripts
-aggregate Enable Aggregate
# Simple Usage:
echo 149.202.182.140 | shodanidb
# CIDR Input:
echo 149.202.182.140/24 | shodanidb
# Use Filters (Hide CPEs, Hostnames and Tags):
echo 149.202.182.140 | shodanidb -nc -nh -nt
# Show Only IP and Ports:
echo 149.202.182.140/24 | shodanidb -url
# Save Output to a JSON File:
cat ips.txt | shodanidb -json output.json
# Show New Results by Comparing With The Old JSON File:
cat ips.txt | shodanidb -compare output.json
```
### Compare
Before using this switch, you need save the output to a JSON file first:
```shell
echo 149.202.182.140 | shodanidb -json output.json
```
Then you can get the new resutls by comparing with the JSON file:
```shell
echo 149.202.182.140 | shodanidb -compare output.json
```
It can be used with the other switches:
```shell
echo 149.202.182.140 | shodanidb -nmap -compare output.json
echo 149.202.182.140 | shodanidb -url -compare output.json
echo 149.202.182.140 | shodanidb -url -nmap -compare output.json
echo 149.202.182.140 | shodanidb -url -nmap -script -compare output.json
echo 149.202.182.140 | shodanidb -url -nmap -script -compare output.json -aggregate
```
### Nmap
To run this switch you need to have nmap installed.
It uses the nmap service detection with this command for every IP address:
```shell
nmap -sV -Pn IP -p Ports
```
It can be used with the other switches:
```shell
echo 149.202.182.140 | shodanidb -nmap
echo 149.202.182.140 | shodanidb -url -nmap
echo 149.202.182.140 | shodanidb -nmap -compare output.json
```
Also it can be used with `-script` switch. It's equals to `-sC` in the nmap and run the nmap scripts.
```shell
echo 149.202.182.140 | shodanidb -nmap -script
```
### url
This switch show the results as the `ip:port` format.
```shell
echo 149.202.182.140 | shodanidb -url
echo 149.202.182.140 | shodanidb -url -compare output.json
```
## Credit
The original tool is [nrich](https://gitlab.com/shodan-public/nrich). I wanted to learn Go and write this tool with Go for practice.
Also the idea for `-url` switch was gotten from [sdlookup](https://github.com/j3ssie/sdlookup).