{"id":20475158,"url":"https://github.com/atiilla/gitrecon","last_synced_at":"2025-09-03T13:34:45.455Z","repository":{"id":193580156,"uuid":"686661426","full_name":"atiilla/gitrecon","owner":"atiilla","description":"This tool uses the GitHub API to scan repositories owned by a user for email addresses and associated names. It provides options to scan specific repositories and exclude forked repositories. Additionally, you can provide a GitHub API token to increase the rate limit for API requests.","archived":false,"fork":false,"pushed_at":"2025-06-22T18:34:41.000Z","size":1257,"stargazers_count":43,"open_issues_count":0,"forks_count":11,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-09-03T06:40:08.290Z","etag":null,"topics":["osint","recon"],"latest_commit_sha":null,"homepage":"https://npmjs.com/package/gitrecon","language":"JavaScript","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/atiilla.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,"zenodo":null}},"created_at":"2023-09-03T14:37:55.000Z","updated_at":"2025-09-02T23:44:46.000Z","dependencies_parsed_at":null,"dependency_job_id":"edbaf2bd-02ab-4855-ac17-7f709f4df944","html_url":"https://github.com/atiilla/gitrecon","commit_stats":null,"previous_names":["atiilla/gitrecon"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/atiilla/gitrecon","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/atiilla%2Fgitrecon","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/atiilla%2Fgitrecon/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/atiilla%2Fgitrecon/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/atiilla%2Fgitrecon/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/atiilla","download_url":"https://codeload.github.com/atiilla/gitrecon/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/atiilla%2Fgitrecon/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273423542,"owners_count":25103143,"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","status":"online","status_checked_at":"2025-09-03T02:00:09.631Z","response_time":76,"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","recon"],"created_at":"2024-11-15T15:14:50.602Z","updated_at":"2025-09-03T13:34:45.446Z","avatar_url":"https://github.com/atiilla.png","language":"JavaScript","readme":"# GitHub \u0026 GitLab Repository Scanner\n\nA tool to scan GitHub and GitLab repositories for exposed email addresses and names.\n\n![screenshot](./demo.gif)\n\n## Introduction\n\nThis tool uses the GitHub and GitLab APIs to scan repositories owned by a user or organization for email addresses and associated names. It provides options to scan specific repositories and exclude forked repositories. Additionally, you can provide API tokens to increase the rate limit for API requests.\n\n### Installation\n\n```\nnpm install -g gitrecon\n```\n\n### Usage\nCommand Line Arguments:\n```\n  -u, --username \u003cusername\u003e         GitHub/GitLab username (Required)\n  -t, --token \u003ctoken\u003e               GitHub/GitLab API token (Optional)\n  -r, --repo \u003crepo\u003e                 Repository name (Optional)\n  -n, --no-forks                    Exclude forked repositories (Optional)\n  --site \u003csite\u003e                     Platform to scan (github or gitlab, default: github) (Optional)\n  --org \u003corg\u003e                       Scan GitHub organization (Optional)\n  --group \u003cgroup\u003e                   Scan GitLab group (Optional)\n  --email \u003cemail\u003e                   Find GitHub username by email (Optional)\n  --format \u003cformat\u003e                 Output format (json, html, or text, default: text) (Optional)\n  --output \u003cdir\u003e                    Output directory (Optional)\n  -h, --help                        Output usage information\n```\n\nExample usage:\nScan all public repositories of a GitHub user:\n```\ngitrecon -u \u003cusername\u003e -n\n```\n\nScan a specific repository of a user:\n```\ngitrecon -u \u003cusername\u003e -r \u003crepo\u003e\n```\n\nProvide a GitHub API token:\n```\ngitrecon -u \u003cusername\u003e -t \u003ctoken\u003e\n```\n\nScan a GitLab user:\n```\ngitrecon -u \u003cusername\u003e --site gitlab\n```\n\nScan a GitHub organization:\n```\ngitrecon --org \u003corganization_name\u003e\n```\n\nScan a GitLab group:\n```\ngitrecon --group \u003cgroup_name\u003e --site gitlab\n```\n\nFind a GitHub username by email:\n```\ngitrecon --email \u003cemail_address\u003e\n```\n\nSave output to HTML format:\n```\ngitrecon -u \u003cusername\u003e --format html --output ./reports\n```\n\n## Implementation Details\n\n### Constants\n`API_URL:` The base URL for GitHub API.\n\n`GITLAB_API_URL:` The base URL for GitLab API.\n\n`HEADER:` Default HTTP headers for API requests.\n\n`DELAY:` Delay between API requests (1000 milliseconds by default).\n\n### Functions\n`Repository(name, isFork):` Factory function to create Repository objects.\n\n`updateHeader(updateObj):` Function to update HTTP headers.\n\n`getRepositories(username):` Function to retrieve user's repositories.\n\n`getEmails(username, repoName):` Function to retrieve email addresses from a repository's commits.\n\n`apiCall(url):` Function to make API calls with a delay.\n\n`runGithubRecon(username, options):` Main function for GitHub reconnaissance.\n\n`runGitlabRecon(username, options):` Main function for GitLab reconnaissance.\n\n`runGithubOrganizationRecon(orgName, options):` Function to scan GitHub organizations.\n\n`runGitlabGroupRecon(groupName, options):` Function to scan GitLab groups.\n\n### Main Function\n* Parses command line arguments.\n* Determines which platform and scan type to use.\n* Fetches repositories to scan based on user input.\n* Scans repositories for email addresses and names.\n* Saves and displays the results in the requested format.\n\n### `Ethics and Disclaimer`\n```\nDISCLAIMER: This tool is intended for educational and ethical security research purposes only. \nBy using this tool, you agree to:\n1. Only scan repositories you own or have explicit permission to scan\n2. Respect GitHub/GitLab Terms of Service and API rate limits\n3. Use collected information responsibly and in compliance with applicable laws\n4. Not use this tool for illegal activities, harassment, or privacy violations\n\nThe author expressly disclaims all liability for any direct, indirect, consequential, incidental, or special damages arising out of or in any way connected with the use or misuse of this tool.\n```\n","funding_links":[],"categories":["[↑](#-table-of-contents) E-mail Search / E-mail Check","[↑](#-table-of-contents) Email Search / Email Check","JavaScript"],"sub_categories":["[↑](#-table-of-contents) Telegram","[↑](#-table-of-contents) GitHub"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fatiilla%2Fgitrecon","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fatiilla%2Fgitrecon","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fatiilla%2Fgitrecon/lists"}