{"id":21228440,"url":"https://github.com/bitfede/subomain-examiner","last_synced_at":"2025-10-24T23:02:37.680Z","repository":{"id":127166230,"uuid":"199095003","full_name":"bitfede/subomain-examiner","owner":"bitfede","description":"Gets a list of subdomains, port scans them and reports them back by open port and service name","archived":false,"fork":false,"pushed_at":"2019-07-27T23:15:18.000Z","size":12,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-01-21T17:49:26.660Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bitfede.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","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":"2019-07-27T00:12:24.000Z","updated_at":"2019-07-27T23:15:20.000Z","dependencies_parsed_at":null,"dependency_job_id":"d5c4e281-8c9e-4b03-b22e-8db83cfcbaf5","html_url":"https://github.com/bitfede/subomain-examiner","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bitfede%2Fsubomain-examiner","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bitfede%2Fsubomain-examiner/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bitfede%2Fsubomain-examiner/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bitfede%2Fsubomain-examiner/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bitfede","download_url":"https://codeload.github.com/bitfede/subomain-examiner/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243672373,"owners_count":20328762,"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-11-20T23:19:00.604Z","updated_at":"2025-10-24T23:02:37.674Z","avatar_url":"https://github.com/bitfede.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Subdomain Examiner\n\n## What is it?\n\nA simple recon tool that allows you to scan a whole list of subdomains and identify which of these servers have open services.\n\nRequires superuser permission to run because it uses the nmap SYN scan. Make sure you review and acknowledge the code before running it on your system.\n\n## How do I install it?\n\n1. `git clone` this repo\n2. make sure python3-nmap is installed. Install it with `sudo apt install python3-nmap`\n3. create a symlink with `ln -s /path/to/subdomain-examiner/subdomain-examiner/app.py ~/bin/subdomain-examiner` (make sure `~/bin` or whatever you want to use exists)\n4. make sure `~/bin` or whatever you are using is in `$PATH` if not add it yourself\n5. test successful installation with `subdomain-examiner -h`\n\n## How do I use it?\n\nCommand usage:\n```\nsudo subdomain-examiner -i subdomains.txt\n```\n\nThe argument `subdomains.txt` has one subdomain per line:\n```\nsubdomain1.example.com\nsubdomain2.example.com\nsubdomain3.example.com\nsubdomain4.example.com\n```\n\nThe examiner will start port scanning them one by one and create different text files depending which subdomains have which port open. All these report files are saved in a directory named with the present timestamp.\n\n## DISCLAIMER\n\nDo NOT use this software for malicious purposes, I am not responsible for whatever damage you cause.\n\nMake sure you have explicit permission from the subdomains owner before testing them.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbitfede%2Fsubomain-examiner","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbitfede%2Fsubomain-examiner","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbitfede%2Fsubomain-examiner/lists"}