Metadata-Version: 2.1
Name: shodan
Version: 1.25.0
Summary: Python library and command-line utility for Shodan (https://developer.shodan.io)
Home-page: http://github.com/achillean/shodan-python/tree/master
Author: John Matherly
Author-email: jmath@shodan.io
License: UNKNOWN
Description: shodan: The official Python library and CLI for 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 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
        --------
        
        - Search Shodan
        - `Fast/ bulk IP lookups <https://help.shodan.io/developer-fundamentals/looking-up-ip-info>`_
        - Streaming API support for real-time consumption of Shodan firehose
        - `Network alerts (aka private firehose) <https://help.shodan.io/guides/how-to-monitor-network>`_
        - `Manage Email Notifications <https://asciinema.org/a/7WvyDtNxn0YeNU70ozsxvXDmL>`_
        - Exploit search API fully implemented
        - Bulk data downloads
        - Access the Shodan DNS DB to view domain information
        - `Command-line interface <https://cli.shodan.io>`_
        
        .. image:: https://cli.shodan.io/img/shodan-cli-preview.png
            :target: https://asciinema.org/~Shodan
            :width: 400px
            :align: center
        
        
        Quick Start
        -----------
        
        .. 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']))
        
        Grab your API key from https://account.shodan.io
        
        Installation
        ------------
        
        To install the Shodan library, simply:
        
        .. code-block:: bash
        
            $ pip install shodan
        
        Or if you don't have pip installed (which you should seriously install):
        
        .. code-block:: bash
        
            $ easy_install shodan
        
        
        Documentation
        -------------
        
        Documentation is available at https://shodan.readthedocs.org/ and https://help.shodan.io
        
Keywords: security,network
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Description-Content-Type: text/x-rst
