hook-s3c / shodan-viz

Shodan.io browser built with Vue.js (hook's 1337 edition)

shodan-viz

Modern web UI for Shodan.io, a search engine for internet-connected devices. Built with d3.js, Highcharts, and Vue.js.

• Installation
• Querying

Dependencies

• Ruby 2.2 or higher
• Bundler

Installation

1. $ git clone https://github.com/joshporter1/shodan-viz.git
2. $ cd shodan-viz && bundle install

• Optional: Use your own API key in config/initializers.yml

3. Run $ rackup
4. Navigate to http://localhost:9292 in a modern browser

Docker Install

For users who already have Docker set up, the proper files have been supplies to get a container up and running quickly. If you don't have Docker, check out Docker Toolbox.

1. $ git clone https://github.com/joshporter1/shodan-viz.git
2. $ cd shodan-viz && docker-compose up
3. Navigate to http://<docker-ip>

Querying

The Shodan API uses a fairly simple querying syntax, ranging from single-word queries to those including filters if your API key supports it.

Example queries:

• Server: SQ-WEBCAM
• elasticsearch
• netgear
• apache
• scada
• admin 1234
• "china telecom"
• "default password"

Example filtered queries:

• nginx city:"Baltimore"
• "china telecom" country:"CN"
• "admin 1234" os:"Linux"

Note: the included API key does not support filtering.