Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/RocketGod-git/shodanbot
Discord bot for the Shodan API - OSINT tool
https://github.com/RocketGod-git/shodanbot
Last synced: about 6 hours ago
JSON representation
Discord bot for the Shodan API - OSINT tool
- Host: GitHub
- URL: https://github.com/RocketGod-git/shodanbot
- Owner: RocketGod-git
- License: gpl-3.0
- Created: 2023-08-29T20:29:51.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-03-08T15:56:35.000Z (8 months ago)
- Last Synced: 2024-03-08T16:54:10.719Z (8 months ago)
- Language: Python
- Size: 74.2 KB
- Stars: 52
- Watchers: 4
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
- License: LICENSE
Awesome Lists containing this project
- awesome-ip-search-engines - Discord ShodanBot
README
# ShodanBot
A Discord bot to interact with the Shodan API, allowing users to fetch information about devices, services, and vulnerabilities.
## Table of Contents
- [Installation](#installation)
- [Configuration](#configuration)
- [Usage](#usage)
- [Contributing](#contributing)
- [License](#license)
## Installation
1. Clone the repository:
```bash
git clone https://github.com/rocketgod-git/shodanbot.git
cd shodanbot
```
2. **Windows Users**: Run the `run.bat` file to set up the virtual environment and install necessary dependencies.
**Linux Users**: Make `run.sh` executable with `chmod +x run.sh` and then run it with `./run.sh`.
## Configuration
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:
```json
{
"TOKEN": "YOUR_DISCORD_BOT_TOKEN",
"SHODAN_API_KEY": "YOUR_SHODAN_API_KEY"
}
```
## Usage
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 `: Get information about a host.
- `/protocols`: List supported protocols.
- `/search `: Search Shodan.
- `/searchcity `: Search Shodan by city.
- `/searchorg `: Search Shodan by organization.
- `/searchport `: Search Shodan by port.
- `/searchcountry `: Search Shodan by country.
- `/exploitsearch `: Search for known vulnerabilities using a term.
- `/listtags`: List popular tags on Shodan.
- `/searchnetblock `: Search devices in a specific netblock.
- `/searchproduct `: Search devices associated with a specific product.
- `/searchssl `: Search for domains associated with a specific SSL certificate hash.
- `/searchisp `: Search devices associated with a specific ISP.
- `/searchgeo `: 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.
## Contributing
Pull requests are welcome! For major changes, please open an issue first to discuss what you would like to change.
## License
[LICENSE](LICENSE)
