{"id":20120501,"url":"https://github.com/lamcodeofpwnosec/subdomain-scanner","last_synced_at":"2025-04-13T06:40:57.851Z","repository":{"id":259489743,"uuid":"877223932","full_name":"lamcodeofpwnosec/subdomain-scanner","owner":"lamcodeofpwnosec","description":"This script is an automated subdomain scanner that uses public data from the crt.sh API to search for subdomains of a given domain. Equipped with parallel search, connectivity checking, and email notification features, this script helps pentesters or security administrators find and verify subdomains quickly and efficiently.","archived":false,"fork":false,"pushed_at":"2024-10-27T13:10:47.000Z","size":508,"stargazers_count":72,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-06T02:15:49.579Z","etag":null,"topics":["subdomain-enumeration","subdomain-finder","subdomain-scanner"],"latest_commit_sha":null,"homepage":"","language":"Shell","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/lamcodeofpwnosec.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","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},"funding":{"github":"lamcodeofpwnosec","patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"lfx_crowdfunding":null,"polar":null,"buy_me_a_coffee":null,"thanks_dev":null,"custom":null}},"created_at":"2024-10-23T09:51:53.000Z","updated_at":"2024-12-02T09:02:16.000Z","dependencies_parsed_at":"2024-10-26T00:02:38.074Z","dependency_job_id":"181fddcc-607d-4187-ab95-58e5363ed64a","html_url":"https://github.com/lamcodeofpwnosec/subdomain-scanner","commit_stats":null,"previous_names":["lamcodeofpwnosec/subdomain-scanner"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lamcodeofpwnosec%2Fsubdomain-scanner","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lamcodeofpwnosec%2Fsubdomain-scanner/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lamcodeofpwnosec%2Fsubdomain-scanner/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lamcodeofpwnosec%2Fsubdomain-scanner/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lamcodeofpwnosec","download_url":"https://codeload.github.com/lamcodeofpwnosec/subdomain-scanner/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248675434,"owners_count":21143763,"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":["subdomain-enumeration","subdomain-finder","subdomain-scanner"],"created_at":"2024-11-13T19:20:46.655Z","updated_at":"2025-04-13T06:40:57.829Z","avatar_url":"https://github.com/lamcodeofpwnosec.png","language":"Shell","funding_links":["https://github.com/sponsors/lamcodeofpwnosec"],"categories":[],"sub_categories":[],"readme":"# Subdomain Scanner using Bash and the crt.sh API\n\nThis script is an automated subdomain scanner that uses public data from the crt.sh API to search for subdomains of a given domain. Equipped with parallel search, connectivity checking, and email notification features, this script helps pentesters or security administrators find and verify subdomains quickly and efficiently.\n\n## Key Features:\n * Unique subdomain search using crt.sh API.\n * Connectivity check in parallel with ping.\n * Automatic output to file and statistics of results.\n * Retry handling and error logging.\n * Email notification (optional) for scan results.\n * Automatic subdomain search via crt.sh API.\n * Filtering unique subdomains to avoid duplication.\n * Output to a neatly formattedfile.\n * Automatic logging to keep a log of each execution.\n * Connectivity check (ping) to make sure the subdomain is active or not.\n * Warning notification if the domain or subdomain is not found.\n * Argument parsing to allow the use of arguments from the command line.\n\n\n## Explanation of New Features:\n 1. Parallel Execution:We use parallel to run the ping command simultaneously for up to 10 subdomains at a time. This improves performance if there are many subdomains to scan.\n 1. Retry Handling:The --retry 3 option on the curl command ensures the request is repeated up to 3 times in case of failure.\n 1. Execution Time Statistics:The script records the start time and end time to provide information on how long the scanning process took.\n 1. Email Delivery (Optional):Users can add an email address as the second argument to receive the scan results via email. If the address is not provided, this feature is skipped.\n 1. Dependency Handling:The script checks for the presence of all required tools: curl, jq, xargs, parallel, and mail. If one is not found, the script stops and gives an error message.\n\n## Installation Steps\nClone Repository from GitHubFirst, make sure you have Git on your system. If not, install Git:\n```\nsudo apt update \u0026\u0026 sudo apt install git -y\n```\nClone project repository from GitHub:\n```\ngit clone https://github.com/lamcodeofpwnosec/subdomain-scanner.git\ncd subdomain-scanner\n```\nMake sure Dependencies are Installed\nThis script requires several tools: `curl`, `jq`, `parallel`, and `mail`. Install all these tools using the following command:\n```\nsudo apt update\nsudo apt install curl jq parallel mailutils -y\n```\nGrant Execution Permission to Scripts\nChange the access rights so that the script can be executed:\n```\nchmod +x subdomain_scanner.sh\n```\n## Usage of features\nRun without Email Notification\nTo run the script without sending the results via email:\n```\n./subdomain_scanner.sh contoh.com\n```\nRun with Email Notification\nRun by sending the scan results to email (for example: `email@example.com`):\n```\n./subdomain_scanner.sh contoh.com email@example.com\n```\nHelp Options\nIf you want to see how to use:\n```\n./subdomain_scanner.sh\n```\n\n## Explanation of Generated Output Files\nSubdomain List file\nContains a list of unique subdomains found from crt.sh:\n```\n$ cat contoh.com_subdomains.txt\n\nwww.contoh.com\nmail.contoh.com\napi.contoh.com\n```\nConnectivity Result File\nContains subdomains that are on or off after being checked with ping:\n```\n$ connectivity_result.txt\n\n[LIVE] www.contoh.com\n[DEAD] api.contoh.com\n[LIVE] mail.contoh.com\n```\nTerminal Statistics\nOnce the scan is complete, you will see a summary like this:\n```\n=====================================\n     Advanced Subdomain Scanner\n=====================================\n[+] Memulai pencarian subdomain untuk: contoh.com\n[+] Ditemukan 5 subdomain untuk contoh.com.\n[+] Memeriksa konektivitas subdomain secara paralel...\n[+] 3 subdomain aktif dan 2 subdomain tidak aktif.\n[+] Pemindaian selesai dalam waktu 8 detik.\n```\n[![asciicast](https://asciinema.org/a/683023.svg)](https://asciinema.org/a/683023)\n\n## Conclusion\n**With these steps, you can easily:**\n * Install dependencies and run scripts.\n * Perform an automated subdomain scan.\n * Save results into a file and check connectivity status.\n * Send reports via `email` for more effective monitoring.\n\nThis script is perfect for testers and administrators to enumerate subdomains efficiently. 🚀\n\n\u0026copy; [PT. Pwn0Sec DIGITAL TECHNOLOGIES LTD.](https://www.pwn0sec.com/) \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flamcodeofpwnosec%2Fsubdomain-scanner","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flamcodeofpwnosec%2Fsubdomain-scanner","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flamcodeofpwnosec%2Fsubdomain-scanner/lists"}