Skip to content

repletech/shodan-python

This branch is 49 commits behind achillean/shodan-python:master.

Folders and files

NameName
Last commit message
Last commit date
Jan 31, 2020
Nov 2, 2020
Feb 11, 2019
Dec 17, 2018
Apr 23, 2014
Apr 6, 2020
Jun 1, 2018
Aug 1, 2018
Sep 8, 2020
Oct 5, 2019
Oct 11, 2020
Jun 23, 2020

Repository files navigation

shodan: The official Python library and CLI for Shodan

Shodan is a search engine for Internet-connected devices. Google lets you search for websites, Shodan lets you search for devices. This library provides developers easy access to all of the data stored in Shodan in order to automate tasks and integrate into existing tools.

Features

https://cli.shodan.io/img/shodan-cli-preview.png

Quick Start

from shodan import Shodan

api = Shodan('MY API KEY')

# Lookup an IP
ipinfo = api.host('8.8.8.8')
print(ipinfo)

# Search for websites that have been "hacked"
for banner in api.search_cursor('http.title:"hacked by"'):
    print(banner)

# Get the total number of industrial control systems services on the Internet
ics_services = api.count('tag:ics')
print('Industrial Control Systems: {}'.format(ics_services['total']))

Grab your API key from https://account.shodan.io

Installation

To install the Shodan library, simply:

$ pip install shodan

Or if you don't have pip installed (which you should seriously install):

$ easy_install shodan

Documentation

Documentation is available at https://shodan.readthedocs.org/ and https://help.shodan.io

About

The official Python library for Shodan

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 100.0%