A Discord bot to interact with the Shodan API, allowing users to fetch information about devices, services, and vulnerabilities.
-
Clone the repository:
git clone https://github.com/rocketgod-git/shodanbot.git cd shodanbot
-
Windows Users: Run the
run.bat
file to set up the virtual environment and install necessary dependencies.Linux Users: Make
run.sh
executable withchmod +x run.sh
and then run it with./run.sh
.
Before running the bot, you need to set up the config.json
file:
TOKEN
: Your Discord bot token.SHODAN_API_KEY
: Your Shodan API key.
Example:
{
"TOKEN": "YOUR_DISCORD_BOT_TOKEN",
"SHODAN_API_KEY": "YOUR_SHODAN_API_KEY"
}
Invite the bot to your server and use the available commands to interact with Shodan. Here's a detailed list of the available commands:
/hostinfo <IP>
: Get information about a host./protocols
: List supported protocols./search <query>
: Search Shodan./searchcity <city>
: Search Shodan by city./searchorg <organization>
: Search Shodan by organization./searchport <port>
: Search Shodan by port./searchcountry <country>
: Search Shodan by country./exploitsearch <term>
: Search for known vulnerabilities using a term./listtags
: List popular tags on Shodan./searchnetblock <netblock>
: Search devices in a specific netblock./searchproduct <product>
: Search devices associated with a specific product./searchssl <SSL hash>
: Search for domains associated with a specific SSL certificate hash./searchisp <ISP>
: Search devices associated with a specific ISP./searchgeo <latitude> <longitude> <radius>
: Search devices around specific GPS coordinates.
For more advanced usage or to get more information about a particular command, use the bot's help command or refer to the bot's command descriptions in Discord.
Pull requests are welcome! For major changes, please open an issue first to discuss what you would like to change.