Skip to content

πŸ•΅οΈβ€β™‚οΈ (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.

feat: add regional email provider domain enumeration (#655)

Kristo Isberg42e6cb4f4160
diff --git a/README.md b/README.md
index 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:
```bash
user-scanner -u johndoe # Single username scan
user-scanner -e [email protected] # Single email scan
+user-scanner -u johndoe --email-domains global # Try johndoe across provider domains
```
### 2. Cross-Scan & Pivot Intelligence
diff --git a/docs/FLAGS.md b/docs/FLAGS.md
index 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.py
index 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.fixture
def 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__.py
index 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 = usernames
except 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.all
if args.module and not args.all:
diff --git a/user_scanner/core/helpers.py b/user_scanner/core/helpers.py
index 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 False
return 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":