This module uses the Shodan API to search Shodan. Accounts are free and an API key is required to use this module. Output from the module is displayed to the screen and can be saved to a file or the MSF database. NOTE: SHODAN filters (i.e. port, hostname, os, geo, city) can be used in queries, but there are limitations when used with a free API key. Please see the Shodan site for more information. Shodan website: https://www.shodan.io/ API: https://developer.shodan.io/api Filters: https://www.shodan.io/search/filters Facets: https://www.shodan.io/search/facet (from the scrollbox)
To display the available options, load the module within the Metasploit console and run the commands 'show options' or 'show advanced':
msf > use auxiliary/gather/shodan_search
msf auxiliary(shodan_search) > show actions
...actions...
msf auxiliary(shodan_search) > set ACTION < action-name >
msf auxiliary(shodan_search) > show options
...show and set options...
msf auxiliary(shodan_search) > run
Time is precious, so I don’t want to do something manually that I can automate. Leveraging the Metasploit Framework when automating any task keeps us from having to re-create the wheel as we can use the existing libraries and focus our efforts where it matters.
– Jim O’Gorman | President, Offensive Security