shodan: Официальная Python-библиотека и CLI для Shodan

.. image — https://img.shields.io/pypi/v/shodan.svg :target: https://pypi.org/project/shodan/

.. image — https://img.shields.io/github/contributors/achillean/shodan-python.svg :target: https://github.com/achillean/shodan-python/graphs/contributors

Shodan — это поисковая система для устройств, подключенных к Интернету. Google позволяет искать веб-сайты, а Shodan позволяет искать устройства. Эта библиотека предоставляет разработчикам удобный доступ ко всем данным, хранимым в Shodan, для автоматизации задач и интеграции в существующие инструменты.

Возможности

• Поиск в Shodan
• Быстрый/массовый поиск по IP <https://help.shodan.io/developer-fundamentals/looking-up-ip-info>_
• Поддержка API потоковой передачи для получения данных Shodan в реальном времени («огненный шланг»)
• Сетевые оповещения (приватный «огненный шланг») <https://help.shodan.io/guides/how-to-monitor-network>_
• Управление уведомлениями по электронной почте <https://asciinema.org/a/7WvyDtNxn0YeNU70ozsxvXDmL>_
• Полная реализация API поиска эксплойтов
• Массовая загрузка данных
• Доступ к базе данных DNS Shodan для просмотра информации о доменах
• Интерфейс командной строки <https://cli.shodan.io>_

.. image — https://cli.shodan.io/img/shodan-cli-preview.png :target: https://asciinema.org/~Shodan :width: 400px :align: center

Быстрый старт

.. code-block — python

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']))

Получите свой API-ключ на https://account.shodan.io

Установка

Для установки библиотеки Shodan выполните следующее:

.. code-block — bash

$ pip install shodan

Или, если у вас не установлен pip (настоятельно рекомендуем его установить):

.. code-block — bash

$ easy_install shodan

Документация

Документация доступна по адресам https://shodan.readthedocs.org/ и https://help.shodan.io