{"id":16848187,"url":"https://github.com/achillean/shodan-perl","last_synced_at":"2025-06-18T17:34:00.312Z","repository":{"id":1065631,"uuid":"902732","full_name":"achillean/shodan-perl","owner":"achillean","description":"Perl library for SHODAN","archived":false,"fork":false,"pushed_at":"2013-10-10T21:27:00.000Z","size":116,"stargazers_count":17,"open_issues_count":0,"forks_count":6,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-06-09T22:04:11.918Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"http://www.shodanhq.com","language":"Perl","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/achillean.png","metadata":{"files":{"readme":"README","changelog":"Changes","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2010-09-11T00:59:32.000Z","updated_at":"2020-04-15T23:37:53.000Z","dependencies_parsed_at":"2022-07-06T04:33:01.123Z","dependency_job_id":null,"html_url":"https://github.com/achillean/shodan-perl","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/achillean/shodan-perl","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/achillean%2Fshodan-perl","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/achillean%2Fshodan-perl/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/achillean%2Fshodan-perl/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/achillean%2Fshodan-perl/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/achillean","download_url":"https://codeload.github.com/achillean/shodan-perl/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/achillean%2Fshodan-perl/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260598904,"owners_count":23034407,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-13T13:10:25.427Z","updated_at":"2025-06-18T17:33:55.298Z","avatar_url":"https://github.com/achillean.png","language":"Perl","funding_links":[],"categories":["Perl Search Automation Tools"],"sub_categories":[],"readme":"Shodan\n\nVisit the official Shodan API documentation at:\n\n[http://docs.shodanhq.com](http://docs.shodanhq.com)\n\nINSTALLATION\n\nTo install this module, run the following commands:\n\n\tperl Makefile.PL\n\tmake\n\tmake install\n\nSUPPORT AND DOCUMENTATION\n\nBefore you can use the API, you need to have an API key.\n\nGet your API key here: http://www.shodanhq.com/api_doc\n\nSetup the SHODAN WebAPI:\n\n\tuse Shodan::WebAPI;\n\t\n\t$api = new Shodan::WebAPI(MY_API_KEY);\n\nPrint a list of cisco-ios devices:\n\n\t$result = $api-\u003esearch(\"cisco-ios\");\n\tforeach $host ( @{$result-\u003e{'matches'}} ) {\n\t\tprint $host{'ip'} . \"\\n\";\n\t}\n\nGet all the information SHODAN has on the IP 217.140.75.46:\n\n\t$host = $api-\u003ehost('217.140.75.46');\n\tprint $host['ip'];\n\nSearch the ExploitDB archive:\n\t$results = $api-\u003eexploitdb_search('PHP', { author =\u003e 'nuffsaid' });\n\tprint 'Total results: ' . $results-{'total'};\n\tmy @matches = @{$result-\u003e{'matches'}};\n\tfor ( my $i = 0; $i \u003c $#matches; $i++ ) {\n\t\tprint \"$matches[$i]{id}\\n\";\n\t}\n\nDownload an exploit from ExploitDB:\n\t# $exploit = $matches[0];\n\t$file = $api-\u003eexploitdb_download( $exploit{id} );\n\tprint \"Filename: $file{'filename'}\\n\";\n\nMake sure to check whether the API results contain the 'error' key, and if so handle the\nerror appropriately:\n\t\n\tif ( $result-\u003e{'error'} ) {\n\t\tprint \"Error: \" . $result-\u003e{'error'} . \"\\n\";\n\t\t# Do other error-handling\n\t}\n\n\nLICENSE AND COPYRIGHT\n\nCopyright (c) 2010 John Matherly \u003cjmath@surtri.com\u003e\n\nPermission is hereby granted, free of charge, to any person\nobtaining a copy of this software and associated documentation\nfiles (the \"Software\"), to deal in the Software without\nrestriction, including without limitation the rights to use,\ncopy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the\nSoftware is furnished to do so, subject to the following\nconditions:\n\nThe above copyright notice and this permission notice shall be\nincluded in all copies or substantial portions of the Software.\n\nExcept as contained in this notice, the name(s) of the above\ncopyright holders shall not be used in advertising or otherwise\nto promote the sale, use or other dealings in this Software\nwithout prior written authorization.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND,\nEXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES\nOF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND\nNONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT\nHOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,\nWHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\nFROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR\nOTHER DEALINGS IN THE SOFTWARE.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fachillean%2Fshodan-perl","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fachillean%2Fshodan-perl","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fachillean%2Fshodan-perl/lists"}