π΅οΈββοΈ (2-in-1) Email & Username OSINT suite featuring native MCP support for deep data extraction just from a single Email/Username. Analyzes 2720+ actively maintained scan vectors (210+ email / 2510+ username) for security research, investigations, and digital footprinting.
Python cybersecuritycybersecurity-toolsemail-osintethical-hackingethical-hacking-toolsidentificationinfosecosintosint-emailosint-toolosint-toolsosint-usernamepentestingpythonredteam-toolsredteamingthreat-intelligence
feat: add regional email provider domain enumeration (#655)
Kristo Isberg42e6cb4f4160
diff --git a/README.md b/README.mdindex c0d0ce9..8992c19 100644--- a/README.md+++ b/README.md@@ -128,6 +128,7 @@ Scan a single username or email address across all available platform modules:```bashuser-scanner -u johndoe # Single username scanuser-scanner -e [email protected] # Single email scan+user-scanner -u johndoe --email-domains global # Try johndoe across provider domains```### 2. Cross-Scan & Pivot Intelligencediff --git a/docs/FLAGS.md b/docs/FLAGS.mdindex a94897c..4342367 100644--- a/docs/FLAGS.md+++ b/docs/FLAGS.md@@ -17,6 +17,8 @@| `-c, --category CATEGORY` | Scan all platforms in a specific category (comma-separated for multiple); also narrows `--cross-scan` || `-lu, --list-user` | List all available modules for username scanning || `-le, --list-email` | List all available modules for email scanning |+| `--list-email-domains` | List available email provider domain scopes |+| `--email-domains SCOPES` | With username input, generate emails from named provider scopes such as `global,canada`, `usa`, or `all` and scan email modules || `-v, --verbose` | Enable verbose output to show urls of the websites || `--all` | Show all results including Not Found/Not Registered/Error/Skipped || `-m, --module MODULE` | Scan a specific module (comma-separated for multiple); also narrows `--cross-scan` |diff --git a/tests/test_helpers.py b/tests/test_helpers.pyindex 2f75527..cd55f2c 100644--- a/tests/test_helpers.py+++ b/tests/test_helpers.py@@ -21,6 +21,32 @@ def test_get_site_name():assert helpers.get_site_name(module("user_scanner.chess_com")) == "Chess.com"+def test_parse_email_domain_scopes_dedupes_in_order(monkeypatch):+ monkeypatch.setitem(helpers.EMAIL_DOMAIN_SCOPES, "test", ("gmail.com", "example.com"))++ domains = helpers.parse_email_domain_scopes("global,test")++ global_domains = helpers.EMAIL_DOMAIN_SCOPES["global"]+ assert domains[: len(global_domains)] == global_domains+ assert domains.count("gmail.com") == 1+ assert domains[-1] == "example.com"+++def test_parse_email_domain_scopes_all():+ assert helpers.parse_email_domain_scopes("all") == tuple(+ dict.fromkeys(+ domain+ for domains in helpers.EMAIL_DOMAIN_SCOPES.values()+ for domain in domains+ )+ )+++def test_parse_email_domain_scopes_rejects_unknown():+ with pytest.raises(ValueError, match="Unknown email domain scope 'mars'"):+ helpers.parse_email_domain_scopes("global,mars")++@pytest.fixturedef run_main(monkeypatch):def _run(args):@@ -187,6 +213,16 @@ def test_bulk_usernames_skip_comments_blank_lines(tmp_path, run_main, capsys):assert exit_code == 0+def test_username_email_domains_use_email_modules(run_main, capsys):+ exit_code = run_main(["-u", "alice", "--email-domains", "usa", "-m", "github"])+ out = capsys.readouterr().out++ assert "Checking email: [email protected]" in out+ assert "Checking email: [email protected]" in out+ assert "Checking email: [email protected]" in out+ assert exit_code == 0++def test_username_file_unreadable(tmp_path, run_main):username_file = tmp_path / "test_usernames.txt"username_file.write_text("user")diff --git a/user_scanner/__main__.py b/user_scanner/__main__.pyindex a14d277..9c99d74 100644--- a/user_scanner/__main__.py+++ b/user_scanner/__main__.py@@ -34,6 +34,8 @@ from user_scanner.core.helpers import (load_modules,set_proxy_manager,find_category,+ EMAIL_DOMAIN_SCOPES,+ parse_email_domain_scopes,)from user_scanner.core.orchestrator import (run_user_category,@@ -108,6 +110,17 @@ def main():help="List all available modules for email scanning",)+ parser.add_argument(+ "--list-email-domains",+ action="store_true",+ help="List available email provider domain scopes",+ )++ parser.add_argument(+ "--email-domains",+ help="Generate emails from username input using named provider scopes (comma-separated)",+ )+parser.add_argument("-v","--verbose",@@ -261,6 +274,13 @@ def main():print(f"user-scanner current version -> {G}{version}{X}")sys.exit(0)+ if args.list_email_domains:+ print(f"\n{Fore.CYAN}Email domain scopes:{Style.RESET_ALL}")+ print(" - all: every scope below")+ for scope, domains in sorted(EMAIL_DOMAIN_SCOPES.items()):+ print(f" - {scope}: {', '.join(domains)}")+ return+if args.list_user or args.list_email:categories = load_categories(args.list_email, args.no_nsfw)sorted_cats = sorted(categories.items(), key=lambda x: x[0].lower())@@ -339,6 +359,21 @@ def main():print(f" - {name}{loud}")return+ if args.email_domains and (args.email or args.email_file):+ print(f"{R}[β] Error: --email-domains can only be used with username input.{X}")+ sys.exit(1)++ email_domains = ()+ if args.email_domains:+ try:+ email_domains = parse_email_domain_scopes(args.email_domains)+ except ValueError as e:+ print(f"{R}[β] Error: {e}{X}")+ sys.exit(1)+ if not email_domains:+ print(f"{R}[β] Error: --email-domains requires at least one scope.{X}")+ sys.exit(1)+if not (args.username or args.email or args.username_file or args.email_file):parser.print_help()return@@ -444,7 +479,7 @@ def main():print(f"{C}[+] Loaded {len(usernames)} {'username' if len(usernames) == 1 else 'usernames'} from {args.username_file}{X}")- is_email = False+ is_email = bool(email_domains)targets_found = usernamesexcept FileNotFoundError:print(f"{R}[β] Error: File not found: {args.username_file}{X}")@@ -453,8 +488,8 @@ def main():print(f"{R}[β] Error reading username file: {e}{X}")sys.exit(1)else:- is_email = args.email is not None- if is_email and not is_valid_email(args.email):+ is_email = args.email is not None or bool(email_domains)+ if args.email and not is_valid_email(args.email):print(R + "[β] Error: Invalid email format." + X)sys.exit(1)@@ -465,19 +500,38 @@ def main():targets = []for target_name in targets_found:- temp_targets = list(islice(expand_patterns_random(target_name), args.stop))+ username_targets = list(islice(expand_patterns_random(target_name), args.stop))+ temp_targets = username_targets+ if email_domains:+ temp_targets = [+ f"{username}@{domain}"+ for username in username_targets+ for domain in email_domains+ ]targets.extend(temp_targets)- if len(temp_targets) > 1:+ if len(username_targets) > 1:total = count_patterns(target_name)- if total > len(temp_targets):+ if total > len(username_targets):print(- C + f"[+] Scanning {len(temp_targets)} of {total} permutations" + Style.RESET_ALL+ C + f"[+] Scanning {len(username_targets)} of {total} permutations" + Style.RESET_ALL)else:print(- C + f"[+] Scanning {len(temp_targets)} permutations" + Style.RESET_ALL+ C + f"[+] Scanning {len(username_targets)} permutations" + Style.RESET_ALL)+ if email_domains:+ valid_targets = []+ for target in targets:+ if is_valid_email(target):+ valid_targets.append(target)+ else:+ print(f"{Y}[!] Skipping invalid generated email: {target}{X}")+ targets = valid_targets+ if not targets:+ print(f"{R}[β] Error: No valid generated emails found.{X}")+ sys.exit(1)+results = []show_all = args.allif args.module and not args.all:diff --git a/user_scanner/core/helpers.py b/user_scanner/core/helpers.pyindex a199701..e81b873 100644--- a/user_scanner/core/helpers.py+++ b/user_scanner/core/helpers.py@@ -71,6 +71,364 @@ LOUD_MODULES: Dict[str, List[str]] = {],}+EMAIL_DOMAIN_SCOPES: Dict[str, tuple[str, ...]] = {+ "global": (+ "gmail.com",+ "googlemail.com",+ "outlook.com",+ "hotmail.com",+ "live.com",+ "msn.com",+ "yahoo.com",+ "ymail.com",+ "rocketmail.com",+ "icloud.com",+ "me.com",+ "mac.com",+ "proton.me",+ "protonmail.com",+ "pm.me",+ "aol.com",+ "mail.com",+ "gmx.com",+ "fastmail.com",+ "zoho.com",+ "zohomail.com",+ "tuta.com",+ "tutanota.com",+ "tutamail.com",+ "tuta.io",+ "keemail.me",+ "hey.com",+ "hushmail.com",+ "mailfence.com",+ "startmail.com",+ "mailbox.org",+ "posteo.de",+ ),+ "usa": (+ "comcast.net",+ "verizon.net",+ "att.net",+ "sbcglobal.net",+ "bellsouth.net",+ "charter.net",+ "spectrum.net",+ "cox.net",+ "earthlink.net",+ "juno.com",+ "netzero.net",+ "usa.com",+ ),+ "canada": (+ "shaw.ca",+ "rogers.com",+ "sympatico.ca",+ "bell.net",+ "videotron.ca",+ "telus.net",+ "cogeco.ca",+ ),+ "uk": (+ "btinternet.com",+ "btopenworld.com",+ "talktalk.net",+ "virginmedia.com",+ "sky.com",+ "blueyonder.co.uk",+ "ntlworld.com",+ "tiscali.co.uk",+ "live.co.uk",+ "hotmail.co.uk",+ "yahoo.co.uk",+ ),+ "ireland": (+ "eircom.net",+ "eir.ie",+ "hotmail.ie",+ "yahoo.ie",+ ),+ "germany": (+ "web.de",+ "gmx.de",+ "gmx.net",+ "t-online.de",+ "freenet.de",+ "mail.de",+ "arcor.de",+ "online.de",+ ),+ "austria": (+ "gmx.at",+ "aon.at",+ "chello.at",+ "inode.at",+ "utanet.at",+ ),+ "switzerland": (+ "bluewin.ch",+ "hispeed.ch",+ "gmx.ch",+ "sunrise.ch",+ "swissonline.ch",+ ),+ "france": (+ "orange.fr",+ "wanadoo.fr",+ "free.fr",+ "sfr.fr",+ "neuf.fr",+ "laposte.net",+ "bbox.fr",+ "numericable.fr",+ "club-internet.fr",+ ),+ "belgium": (+ "skynet.be",+ "proximus.be",+ "telenet.be",+ "scarlet.be",+ "voo.be",+ ),+ "netherlands": (+ "ziggo.nl",+ "kpnmail.nl",+ "planet.nl",+ "xs4all.nl",+ "hetnet.nl",+ "chello.nl",+ "upcmail.nl",+ "live.nl",+ ),+ "italy": (+ "libero.it",+ "virgilio.it",+ "alice.it",+ "tin.it",+ "tiscali.it",+ "email.it",+ "poste.it",+ "fastwebnet.it",+ ),+ "spain": (+ "telefonica.net",+ "movistar.es",+ "terra.es",+ "orange.es",+ "ono.com",+ "hotmail.es",+ "yahoo.es",+ ),+ "portugal": (+ "sapo.pt",+ "iol.pt",+ "netcabo.pt",+ "clix.pt",+ "mail.telepac.pt",+ ),+ "poland": (+ "wp.pl",+ "onet.pl",+ "op.pl",+ "interia.pl",+ "poczta.fm",+ "o2.pl",+ "tlen.pl",+ "gazeta.pl",+ ),+ "czechia": (+ "seznam.cz",+ "email.cz",+ "post.cz",+ "centrum.cz",+ "volny.cz",+ "atlas.cz",+ ),+ "slovakia": (+ "azet.sk",+ "centrum.sk",+ "post.sk",+ "zoznam.sk",+ ),+ "hungary": (+ "freemail.hu",+ "citromail.hu",+ "indamail.hu",+ "vipmail.hu",+ ),+ "romania": (+ "yahoo.ro",+ "email.ro",+ "home.ro",+ "rdslink.ro",+ ),+ "greece": (+ "otenet.gr",+ "forthnet.gr",+ "hol.gr",+ "in.gr",+ ),+ "turkey": (+ "mynet.com",+ "superonline.com",+ "ttmail.com",+ "windowslive.com",+ ),+ "nordics": (+ "telia.com",+ "live.se",+ "hotmail.se",+ "spray.se",+ "bredband.net",+ "mail.dk",+ "post.tele.dk",+ "stofanet.dk",+ "online.no",+ "start.no",+ "luukku.com",+ "kolumbus.fi",+ "suomi24.fi",+ ),+ "russia": (+ "mail.ru",+ "yandex.ru",+ "ya.ru",+ "rambler.ru",+ "bk.ru",+ "list.ru",+ "inbox.ru",+ ),+ "estonia": (+ "mail.ee",+ "hot.ee",+ "online.ee",+ ),+ "latvia": (+ "inbox.lv",+ "apollo.lv",+ "tvnet.lv",+ ),+ "lithuania": (+ "inbox.lt",+ "mail.lt",+ "takas.lt",+ "one.lt",+ ),+ "ukraine": (+ "ukr.net",+ "i.ua",+ "meta.ua",+ "bigmir.net",+ ),+ "belarus": (+ "tut.by",+ "mail.by",+ ),+ "china": (+ "qq.com",+ "foxmail.com",+ "163.com",+ "126.com",+ "yeah.net",+ "sina.com",+ "sina.cn",+ "sohu.com",+ "aliyun.com",+ "139.com",+ "189.cn",+ "21cn.com",+ ),+ "japan": (+ "yahoo.co.jp",+ "docomo.ne.jp",+ "ezweb.ne.jp",+ "au.com",+ "softbank.ne.jp",+ "i.softbank.jp",+ "rakuten.jp",+ "nifty.com",+ "biglobe.ne.jp",+ "ocn.ne.jp",+ "goo.jp",+ "excite.co.jp",+ ),+ "korea": (+ "naver.com",+ "daum.net",+ "hanmail.net",+ "nate.com",+ "kakao.com",+ ),+ "india": (+ "rediffmail.com",+ "indiatimes.com",+ "sify.com",+ "yahoo.co.in",+ "hotmail.co.in",+ "airtelmail.in",+ ),+ "australia": (+ "bigpond.com",+ "bigpond.net.au",+ "optusnet.com.au",+ "iinet.net.au",+ "internode.on.net",+ "tpg.com.au",+ "westnet.com.au",+ ),+ "new_zealand": (+ "xtra.co.nz",+ "vodafone.co.nz",+ "ihug.co.nz",+ "slingshot.co.nz",+ ),+ "brazil": (+ "uol.com.br",+ "bol.com.br",+ "terra.com.br",+ "ig.com.br",+ "globo.com",+ "r7.com",+ ),+ "mexico": (+ "prodigy.net.mx",+ "hotmail.com.mx",+ "yahoo.com.mx",+ ),+ "argentina": (+ "arnet.com.ar",+ "fibertel.com.ar",+ "speedy.com.ar",+ "ciudad.com.ar",+ "yahoo.com.ar",+ ),+ "chile": (+ "vtr.net",+ "entelchile.net",+ "terra.cl",+ "hotmail.cl",+ "yahoo.cl",+ ),+ "colombia": (+ "une.net.co",+ "etb.net.co",+ "hotmail.com.co",+ "yahoo.com.co",+ ),+ "south_africa": (+ "webmail.co.za",+ "mweb.co.za",+ "vodamail.co.za",+ "telkomsa.net",+ ),+ "israel": (+ "walla.co.il",+ "bezeqint.net",+ "netvision.net.il",+ "012.net.il",+ ),+}+CONFIG_PATH = Path(__file__).parent.parent / "config.json"@@ -99,6 +457,30 @@ def is_valid_email(email: str) -> bool:if len(local) > 64 or len(domain) > 253:return Falsereturn bool(EMAIL_RE.fullmatch(email))+++def parse_email_domain_scopes(value: str) -> tuple[str, ...]:+ requested = tuple(scope.strip().lower() for scope in value.split(",") if scope.strip())+ unknown = [+ scope for scope in requested if scope != "all" and scope not in EMAIL_DOMAIN_SCOPES+ ]+ if unknown:+ valid = ", ".join(("all", *sorted(EMAIL_DOMAIN_SCOPES)))+ raise ValueError(+ f"Unknown email domain scope '{unknown[0]}'. Valid scopes: {valid}"+ )+ seen: set[str] = set()+ domains = []+ for scope in requested:+ scopes = EMAIL_DOMAIN_SCOPES if scope == "all" else (scope,)+ for scope_name in scopes:+ for domain in EMAIL_DOMAIN_SCOPES[scope_name]:+ if domain not in seen:+ seen.add(domain)+ domains.append(domain)+ return tuple(domains)++def get_site_name(module) -> str:name = module.__name__.split(".")[-1].capitalize().replace("_", ".")if name == "X":