{"id":20625341,"url":"https://github.com/nemmusu/shodan-output-parser","last_synced_at":"2026-05-29T08:03:15.716Z","repository":{"id":242335728,"uuid":"809293445","full_name":"nemmusu/shodan-output-parser","owner":"nemmusu","description":"The wrapper extracts and simplifies the output of Shodan, keeping only essential information.","archived":false,"fork":false,"pushed_at":"2024-06-02T10:53:09.000Z","size":147,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-14T15:51:00.796Z","etag":null,"topics":["osint","output","parser","passive-vulnerability-scanner","pentesting","prettify","python","redteaming","scanner","shodan"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nemmusu.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-06-02T09:29:07.000Z","updated_at":"2024-11-23T23:01:50.000Z","dependencies_parsed_at":"2024-06-02T10:45:59.360Z","dependency_job_id":"765e8040-8ad2-4434-be02-9e1f341ae695","html_url":"https://github.com/nemmusu/shodan-output-parser","commit_stats":null,"previous_names":["nemmusu/shodan-output-parser"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/nemmusu/shodan-output-parser","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nemmusu%2Fshodan-output-parser","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nemmusu%2Fshodan-output-parser/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nemmusu%2Fshodan-output-parser/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nemmusu%2Fshodan-output-parser/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nemmusu","download_url":"https://codeload.github.com/nemmusu/shodan-output-parser/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nemmusu%2Fshodan-output-parser/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33642318,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-29T02:00:06.066Z","response_time":107,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["osint","output","parser","passive-vulnerability-scanner","pentesting","prettify","python","redteaming","scanner","shodan"],"created_at":"2024-11-16T13:09:19.994Z","updated_at":"2026-05-29T08:03:15.702Z","avatar_url":"https://github.com/nemmusu.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Shodan Wrapper and Results Filter\n\nThis repository contains a script to download search results from Shodan and filter specific fields from the results. The script extracts and simplifies the output, keeping only essential information. Additionally, it allows you to save the results in a JSON file and print detailed entries. The full JSON result from Shodan is always downloaded and saved locally in a GZIP compressed format.\n\n## Requirements\n- Shodan API key\n- Python 3.x\n- Shodan CLI\n\n## Installation\n\n1. Install the Shodan CLI if you haven't already:\n\n    ```sh\n    pip install shodan\n    ```\n\n2. Clone this repository:\n\n    ```sh\n    git clone https://github.com/nemmusu/shodan-output-parser.git\n    cd shodan-output-parser\n    ```\n\n## Usage\n\n### Downloading and Filtering Shodan Results\n\nThe main script `shodan_wrapper.py` wraps the Shodan download command and filters the results based on specified fields.\n\n#### Command Line Arguments\n\n- `filename`: Name of the file to save the search results (file .json.gz)\n- `search_query`: Search query (e.g., \"org: organization\", \"ip: 8.8.8.8\" or \"ip: 8.8.0.0-8.8.255.255, \"hostname: example.com\")\n- `--limit`: Maximum number of results to download (optional)\n- `-j, --json`: Save the results in a JSON file (optional)\n- `-v, --verbose`: Print detailed extracted entries (optional)\n\n### Example\n\n```sh\npython shodan_wrapper.py results \"org: yourorganization\" --limit 100 -j -v\n```\n\n## Screenshots\n\n### Help:\n\n![help](https://github.com/nemmusu/shodan-output-parser/blob/main/doc/img/help.png)\n\n### JSON output:\n\n![json](https://github.com/nemmusu/shodan-output-parser/blob/main/doc/img/json_file.png)\n\n### Log file:\n\n![log](https://github.com/nemmusu/shodan-output-parser/blob/main/doc/img/log_file.png)\n\n### Verbose:\n\n![verbose](https://github.com/nemmusu/shodan-output-parser/blob/main/doc/img/verbose.png)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnemmusu%2Fshodan-output-parser","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnemmusu%2Fshodan-output-parser","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnemmusu%2Fshodan-output-parser/lists"}