Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/shubhamrooter/ShodanSpider
ShodanSpider is an open-source tool for interacting with Shodan. It lets you search and extract data from Shodan without an API key, offering a simple command-line interface. Premium users can integrate their API key for more results. Ideal for penetration testers and cybersecurity researchers.
https://github.com/shubhamrooter/ShodanSpider
Last synced: 11 days ago
JSON representation
ShodanSpider is an open-source tool for interacting with Shodan. It lets you search and extract data from Shodan without an API key, offering a simple command-line interface. Premium users can integrate their API key for more results. Ideal for penetration testers and cybersecurity researchers.
- Host: GitHub
- URL: https://github.com/shubhamrooter/ShodanSpider
- Owner: shubhamrooter
- License: mit
- Created: 2024-11-22T10:28:40.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2024-12-13T06:43:49.000Z (21 days ago)
- Last Synced: 2024-12-13T07:28:20.368Z (21 days ago)
- Size: 16.6 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-ip-search-engines - ShodanSpider
README
# ShodanSpider v2
**ShodanSpider v2** is an advanced, powerful, and easy-to-use tool for interacting with Shodan's vast database of internet-connected devices. Ideal for cybersecurity researchers, penetration testers, and bug hunters, this tool allows users to search and analyze devices on the internet with enhanced capabilities. The tool can be used both with and without a Shodan API key for basic or premium results, making it versatile for all users.
## Features
- **Free and Open Source**: No API key required for basic use, with limited results. You can still perform Shodan searches for free but can upgrade to the full version using your Shodan API key for enhanced results.
- **Enhanced Search with API Key**: Input your Shodan API key for premium access and more detailed results, including advanced filtering and additional information.
- **Customizable Output**: Save search results to an output file and use them for later analysis. You can specify the file name to store results in a variety of formats.
- **Efficient and Fast**: Search Shodan for specific devices, vulnerabilities (CVE), and more, all while optimizing the search speed with timeouts and custom parameters.
- **Multiple Search Options**: Search for general queries, CVEs, and specific device types, making it perfect for bug hunting and vulnerability research.
## Installation
### Prerequisites
To run ShodanSpider, ensure that the following are installed:
- **bash** (for running the script)
- **curl** (for making HTTP requests)
- **jq** (for query encoding)
- **Optional**: A Shodan API key for enhanced results
### Steps to Install
1. Clone the repository:
```bash
git clone https://github.com/shubhamrooter/ShodanSpider.git
```
2. Navigate to the project directory:
```bash
cd ShodanSpider
```
3. Give execute permission to the script:
```bash
chmod +x shodanspider
```
4. Optionally, make the script executable globally (optional):
```bash
sudo cp shodanspider.sh /usr/local/bin/shodanspider
```
## Usage
Once installed, you can use **ShodanSpider v2** directly from the terminal with various options for flexible search and output control.
### Options
- `-q `: Perform a Shodan search with a specific query (e.g., `apache`, `ssl`, `cve-2021-34473`, etc.).
- `-cve `: Search for a specific CVE (e.g., `cve-2021-34473`).
- `-o `: Save the search results to a specified output file. If not provided, the results will be displayed on the terminal.
- `-h`: Display the help menu and available options.
### Example Commands
- **Search for 'apache' on Shodan without an API key**:
```bash
./shodanspider.sh -q "apache"
```
- **Search for a CVE (e.g., `cve-2021-34473`)**:
```bash
./shodanspider.sh -cve "cve-2021-34473"
```
- **Search for 'apache' and save results to a file**:
```bash
./shodanspider -q "apache" -o "results.txt"
```
- **Search for a specific CVE and save to a file**:
```bash
./shodanspider -cve "cve-2021-34473" -o "cve_results.txt"
```
## Contributing
Contributions are welcome! If you want to contribute to ShodanSpider's development, feel free to fork the repository, make your changes, and submit a pull request.
### How to Contribute
1. Fork the repository.
2. Create a new branch (`git checkout -b feature-branch`).
3. Make your changes.
4. Commit your changes (`git commit -am 'Add new feature'`).
5. Push to your fork (`git push origin feature-branch`).
6. Submit a pull request.
## License
This tool is open-source and available under the MIT License. See the [LICENSE](LICENSE) file for more information.
## Contact
For any questions or support, you can contact me at:
- **Email**: [email protected]
- **GitHub**: [ShubhamTiwari](https://github.com/shubhamrooter)
## Disclaimer
**ShodanSpider v2** is intended for educational, research, and ethical use only. Unauthorized scanning and accessing systems without proper consent may violate legal regulations. Use this tool responsibly and at your own risk.