n0toose / ruminative

A simple reconnaissance tool utilizing Shodan. Repository moved to Codeberg.

RUMINATIVE

A simple reconnaissance tool utilizing Shodan.

Getting started

• Add your Shodan token in the secret.py file.
• Alternatively, add your Shodan token in an environment variable with the key SHODAN_KEY. The tool prioritizes the SHODAN_KEY environment variable over the secret.py file.
• Alternatively, enter your Shodan token in the terminal as an argument. Or, just don't do anything and the script is going to ask you whether you want to add a token.
• Shodan will return results that match your external IP address.

Adding an environment variable will skip all prompts that require user input.

Prerequisites

• Python 3
• Shodan's Python library.
• Access to Shodan, as well as the API key corresponding to your account.
• Unfiltered internet access within the target network.

Authors

• Panos V. - Initial work. - AlwaysLivid

Acknowledgements

This tool was inspired by the following open-source projects:

• Shodan Mattermost by PaulSec

License

This project is licensed under the GNU License - see the LICENSE.md file for details