{"id":13449349,"url":"https://github.com/sham00n/buster","last_synced_at":"2025-03-22T22:32:42.957Z","repository":{"id":39705894,"uuid":"190042776","full_name":"sham00n/buster","owner":"sham00n","description":"An advanced tool for email reconnaissance","archived":false,"fork":false,"pushed_at":"2020-03-26T16:41:38.000Z","size":760,"stargazers_count":909,"open_issues_count":31,"forks_count":169,"subscribers_count":27,"default_branch":"master","last_synced_at":"2024-08-01T06:21:29.623Z","etag":null,"topics":["cybersecurity","emails","infosec","inteligence","osint","penetration-testing","recon","social-accounts"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sham00n.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-06-03T16:31:38.000Z","updated_at":"2024-07-28T13:13:25.000Z","dependencies_parsed_at":"2022-08-04T03:15:09.773Z","dependency_job_id":null,"html_url":"https://github.com/sham00n/buster","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/sham00n%2Fbuster","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sham00n%2Fbuster/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sham00n%2Fbuster/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sham00n%2Fbuster/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sham00n","download_url":"https://codeload.github.com/sham00n/buster/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":221840630,"owners_count":16889834,"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":["cybersecurity","emails","infosec","inteligence","osint","penetration-testing","recon","social-accounts"],"created_at":"2024-07-31T06:00:36.146Z","updated_at":"2024-10-28T14:30:43.038Z","avatar_url":"https://github.com/sham00n.png","language":"Python","funding_links":[],"categories":["Python","📧 Email Search","EMAIL","\u003ca id=\"170048b7d8668c50681c0ab1e92c679a\"\u003e\u003c/a\u003e工具","📧 Email \u0026 Breach Data"],"sub_categories":["\u003ca id=\"05ab1b75266fddafc7195f5b395e4d99\"\u003e\u003c/a\u003e未分类-OSINT"],"readme":"## Description\n\nBuster is an advanced OSINT tool used to:\n* Get social accounts of an email using multiple sources(gravatar,about.me,myspace,skype,github,linkedin,previous breaches)\n* Get links to where the email was found using google,twitter,darksearch and paste sites\n* Get breaches of an email\n* Get domains registered with an email (reverse whois)\n* Generate possible emails and usernames of a person\n* Find the email of a social media account\n* Find emails from a username\n* Find the work email of a person\n\nA tutorial on how to use Buster can be found [here](https://null-byte.wonderhowto.com/forum/perform-email-reconnaissance-with-buster-0202180/)\n\n![](buster-demo.gif)\n-----\n\n## Installation\n\n\nclone the repository:\n\n```bash\n$ git clone git://github.com/sham00n/buster\n```\n\nOnce you have a copy of the source, you can install it with:\n\n```bash\n$ cd buster/\n$ python3 setup.py install\n$ buster -h\n```\n-----\n\n\n## API keys\n\nThis project uses hunter.io to get information from company emails,the first couple \"company email\" searches dont require a key,if you have an interest in company emails i recommend that you sign up for an account on hunter.io.\n\nOnce you get an API key, add it to the file \"api-keys.yaml\" and rerun the command:\n\n\n```bash\n$ python setup.py install\n```\n\n-----\n\n## Usage\n\n```\nusage: buster [-h] [-e EMAIL] [-f FIRST] [-m MIDDLE] [-l LAST] [-b BIRTHDATE]\n              [-a ADDINFO [ADDINFO ...]] [-u USERNAME] [-c COMPANY]\n              [-p PROVIDERS [PROVIDERS ...]] [-o OUTPUT] [-v] [--list LIST]\n\nBuster is an OSINT tool used to generate and verify emails and return\ninformation associated with them\n\noptional arguments:\n  -h, --help            show this help message and exit\n  -e EMAIL, --email EMAIL\n                        email adress or email pattern\n  -f FIRST, --first FIRST\n                        first name\n  -m MIDDLE, --middle MIDDLE\n                        middle name\n  -l LAST, --last LAST  last name\n  -b BIRTHDATE, --birthdate BIRTHDATE\n                        birthdate in ddmmyyyy format,type * if you dont\n                        know(ex:****1967,3104****)\n  -a ADDINFO [ADDINFO ...], --addinfo ADDINFO [ADDINFO ...]\n                        additional info to help guessing the\n                        email(ex:king,345981)\n  -u USERNAME, --username USERNAME\n                        checks 100+ email providers for the availability of\n                        username@provider.com\n  -c COMPANY, --company COMPANY\n                        company domain\n  -p PROVIDERS [PROVIDERS ...], --providers PROVIDERS [PROVIDERS ...]\n                        email provider domains\n  -o OUTPUT, --output OUTPUT\n                        output to a file\n  -v, --validate        check which emails are valid and returns information\n                        of each one\n  --list LIST           file containing list of emails\n\n```\n\n-----\n\n## Usage examples\n\n###### Get info of a single email(exists or not,social media where email was used,data breaches,pastes and links to where it was found)\n\n```bash\n$ buster -e target@example.com\n```\n\n###### Query for list of emails`\n```bash\n$ buster --list emails.txt\n```\n\n###### Generate emails that matches the pattern and checks if they exist or not(use the -a argument if you have more info to add(ex: -a nickname fav_color phone #)\n```bash\n$ buster -e j********9@g****.com -f john -l doe -b ****1989\n```\n\n###### Generate usernames (use with -o option and input the file to recon-ng's profiler module)\n```bash\n$ buster -f john -m james -l doe -b 13071989 \n```\n\n###### Generate emails (use -v if you want to validate and get info of each email)\n\n```bash\n$ buster -f john -m james -l doe -b 13071989 -p gmail.com yahoo.com\n```\n\n###### Generate 100+ emails in the format username@provider.com and returns the valid ones(use -p if you dont want all 100+)\n\n```bash\n$ buster -u johndoe\n```\n\n###### Generate a company email and returns info associated with it\n\n```bash\n$ buster -f john -l doe -c company.com\n```\n\n-----\n\n## Tips\n* You get 200 email validations/day,use them wisely!\n* When using the -a option,avoid using small words(ex:j,3,66),the shorter the words are the bigger the email list is and therefore more validations are needed\n* when adding an email pattern make sure the service providing the pattern displays it with the right size(facebook,twitter,instagram do...others might not)\n* I dont recommend using with Tor as haveibeenpwnd.com,hunter.io and google wont function properly\n\n\n\n-----\n\n## Thanks\n\n* [emailrep.io](https://emailrep.io/) for being developer friendly\n* khast3x,developer of [h8mail](https://github.com/khast3x/h8mail) which was used as a reference for this README file\n* The OSINT community for being awesome!\n\n-----\n\n## Notes\n* My Code is ugly,i know...if you know how to do things better let me know!\n* If you have any suggestions or improvements email me at sham00n at protonmail dot com\n\n\n___\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsham00n%2Fbuster","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsham00n%2Fbuster","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsham00n%2Fbuster/lists"}