{"id":22794285,"url":"https://github.com/sc4rfurry/shodna","last_synced_at":"2025-03-30T17:42:54.353Z","repository":{"id":257522333,"uuid":"734798948","full_name":"sc4rfurry/ShoDNA","owner":"sc4rfurry","description":"Yet another Shodan with CLI + WebUI Tool with some Dorks related to SHodan.","archived":false,"fork":false,"pushed_at":"2024-09-17T04:08:34.000Z","size":403,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-02-05T19:50:07.528Z","etag":null,"topics":["python","shodan","shodan-cli","shodan-webui","tool"],"latest_commit_sha":null,"homepage":"https://sc4rfurry.github.io/","language":"HTML","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/sc4rfurry.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":"2023-12-22T16:45:44.000Z","updated_at":"2024-10-24T10:23:38.000Z","dependencies_parsed_at":"2024-09-17T07:16:17.267Z","dependency_job_id":"19df3c1e-ece3-446a-9617-1515b24b7233","html_url":"https://github.com/sc4rfurry/ShoDNA","commit_stats":null,"previous_names":["sc4rfurry/shodna"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sc4rfurry%2FShoDNA","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sc4rfurry%2FShoDNA/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sc4rfurry%2FShoDNA/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sc4rfurry%2FShoDNA/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sc4rfurry","download_url":"https://codeload.github.com/sc4rfurry/ShoDNA/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246357627,"owners_count":20764359,"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":["python","shodan","shodan-cli","shodan-webui","tool"],"created_at":"2024-12-12T04:07:56.950Z","updated_at":"2025-03-30T17:42:54.333Z","avatar_url":"https://github.com/sc4rfurry.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![forthebadge made-with-python](https://ForTheBadge.com/images/badges/made-with-python.svg)](https://www.python.org/)\n\n\n\n##\n# ShoDNA (◣_◢)ノ-=≡≡卍\nYet Another Shodan CLI Scanner with addition of DORKs related to shodan.\n\n## Table of Contents\n- [ShoDNA (◣_◢)ノ-=≡≡卍]\n    - [Technologies \u0026 Tools](#technologies--tools)\n    - [Requirements](#requirements)\n    - [Features](#features)\n    - [Installation](#installation)\n    - [Config](#config)\n    - [Usage](#usage)\n        - [Options](#options)\n        - [Example](#example)\n    - [Todo](#todo)\n    - [Contributing](#contributing)\n    - [License](#license)\n\n#\n\n### 🔧 Technologies \u0026 Tools\n\n![](https://img.shields.io/badge/OS-Linux-informational?style=flat-square\u0026logo=ubuntu\u0026logoColor=white\u0026color=5194f0\u0026bgcolor=110d17)\n![](https://img.shields.io/badge/Editor-VS_Code-informational?style=flat-square\u0026logo=visual-studio\u0026logoColor=white\u0026color=5194f0)\n![](https://img.shields.io/badge/Language-python-informational?style=flat-square\u0026logo=python\u0026logoColor=white\u0026color=5194f0\u0026bgcolor=110d17)\n![](https://img.shields.io/badge/Python_Version-3.10-informational?style=flat-square\u0026logo=python\u0026logoColor=white\u0026color=5194f0\u0026bgcolor=110d17)\n\n##\n\n### 📚 Requirements\n\u003e - Python 3.9+\n\u003e - pip3\n\n### Features\n- Quick and easy to use\n- Search the Custom Quries\n- Pre-Included **`Dorks`**\n- Setch `Shodan's API` Information.\n\n\u003e `Note:` Please keep in mind that the tool is still in development and more features will be added in the future.\n\n\n## Installation\n\nUse the package manager [pip](https://pip.pypa.io/en/stable/) to install the requirements.\nif not installed, install it using the following command.\n```bash\nsudo apt-get install python3-pip\n```\n\n\u003e It is advised to install the python requirements in a virtual environment, for that install the venv package.\n\n```bash\n    python3 -m pip install venv\n    python3 -m venv env\n    source env/bin/activate\n```\n\nAfter that run the following commands:\n```bash\n    python3 -m pip install -r requirements.txt\n```\n#\n\n## Config\n\u003e `ShoDNA` by default uses **Shodan's API** and need the API key, for that make sure you have a `.env` file in the program folder with the API key as follow:\n```bash\nSHODAN_API_KEY=abc123ShodanKeyHere\n```\n#\n\n## Usage\n\n```bash\npython3 main.py -q [Query]\n```\n\n#### Options\n\n```bash\n        -q              Shodan Query\n        -pl             Page Liimit (Defaulr: 1)\n        -cn             Specify the Country (US,JP,FR)\n        -iq             Fetch More Information about each Host (Hostname, Ports etc)\n        -lq             Show the Pre-Included SHodan Dorks (Scada, Medical etc)\n        -ai             Fetch API Information (API key Required)\n        -idb            Fetch the results using the OpenAPI by Shodan\n        -h              Print the help menu\n```\n\n##\n\n# (◣_◢) WebUI - ShoDNA\n\nTo run the Web Server you have to install the requirements for the Web Server too.\n\n```bash\ncd shodna/web\npython3 -m pip install -r requirements.txt\n```\n\nFor `Development` run the server as following:\n\n```bash\npython3 app.py\n```\n\nAs for the `Production` Server do the following:\n\n```bash\ncd shodna/web\npython3 -m pip install -r requirements.txt\ngunicorn -c config.py app:app;\n```\n+ `gunicorn` should be installed.\n\n##\n\n## Json Viewer\n- For now history is json form, so for Chrome user's Kindly install the following extention\n\n```console\n\u003e https://chrome.google.com/webstore/detail/json-viewer-pro/eifflpmocdbdmepbjaopkkhbfmdgijcc\n```\n\n#### Example\n```bash\n1) python3 main.py -q 'apache' -pl 2 -cn 'US' -iq\n2) python3 main.py -lq\n2) python3 main.py -ai\n3) python3 main.py -idb 1.1.1.1\n4) python3 main.py -h\n```\n\n\n### Todo\n- [ ] More things to add\n- [ ] Overall Optimizations\n- [X] WebUI (Completed)\n- [X] Bug Fixes (I tried :/)\n\n#\n\n## Contributing\nPull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.\n\n## License\n[MIT](https://choosealicense.com/licenses/mit/)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsc4rfurry%2Fshodna","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsc4rfurry%2Fshodna","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsc4rfurry%2Fshodna/lists"}