π΅οΈββοΈ (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: default to found-only results and introduce --all flag
Kaif8d51086d5acc
diff --git a/README.md b/README.mdindex 67a4838..e892b40 100644--- a/README.md+++ b/README.md@@ -110,7 +110,9 @@ user-scanner -u johndoe # single username scanning```### Verbose mode-Use `-v` flag to show the url of the sites being checked+Use `-v` flag to show the url of the sites being checked.+Use `--all` flag to show all sites (including those where the target was not found, skipped, or errored).+Note: By default, the scanner only displays sites where the target is found/registered.```bashuser-scanner -v -e [email protected] -c dev```diff --git a/docs/FLAGS.md b/docs/FLAGS.mdindex 9c59f3a..2422f7c 100644--- a/docs/FLAGS.md+++ b/docs/FLAGS.md@@ -6,7 +6,6 @@| `-e, --email EMAIL` | Scan a single email across platforms || `-uf, --username-file FILE` | Scan multiple usernames from file (one per line) || `-ef, --email-file FILE` | Scan multiple emails from file (one per line) |-| `--only-found` | Only show sites where the username/email was found || `--allow-loud` | Enable scanning sites that may send emails/notifications || `--no-nsfw` | Disable NSFW site scanning || `--hudson, --hudson-scan` | Check for infostealer intelligence using Hudson Rock's API |@@ -14,6 +13,7 @@| `-lu, --list-user` | List all available modules for username scanning || `-le, --list-email` | List all available modules for email scanning || `-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) || `-p, --permute PERMUTE` | Generate username permutations using a pattern/suffix || `-P, --proxy-file FILE` | Use proxies from file (one per line) |diff --git a/tests/test_orchestrator.py b/tests/test_orchestrator.pyindex 919c05d..d958876 100644--- a/tests/test_orchestrator.py+++ b/tests/test_orchestrator.py@@ -26,7 +26,7 @@ def test_run_module_single_prints_json_and_csv(capsys):setattr(module, "validate_testsite", validate_testsite)- orchestrator.run_user_module(module, "bob", ScanConfig())+ orchestrator.run_user_module(module, "bob", ScanConfig(show_all=True))out = capsys.readouterr().outassert "bob" in out # Needs to be improveddiff --git a/user_scanner/__main__.py b/user_scanner/__main__.pyindex 742c09d..86975df 100644--- a/user_scanner/__main__.py+++ b/user_scanner/__main__.py@@ -51,6 +51,12 @@ MAX_PERMUTATIONS_LIMIT = 100def main():+ if "--only-found" in sys.argv:+ print(f"{Fore.YELLOW}[!] The '--only-found' flag is deprecated and has been removed.{Style.RESET_ALL}")+ print(f"{Fore.YELLOW}[!] Showing only found modules is now the DEFAULT behavior.{Style.RESET_ALL}")+ print(f"{Fore.YELLOW}[!] To show all results, use the '--all' flag.{Style.RESET_ALL}")+ sys.exit(1)+parser = argparse.ArgumentParser(prog="user-scanner",description="Scan usernames or emails across multiple platforms.",@@ -93,6 +99,12 @@ def main():help="Enable verbose output to show urls of the websites",)+ parser.add_argument(+ "--all",+ action="store_true",+ help="Show all results including Not Found/Not Registered/Error/Skipped.",+ )+parser.add_argument("-s","--stop",@@ -142,12 +154,6 @@ def main():help="Validate proxies before scanning (tests against gstatic.com/generate_204)",)- parser.add_argument(- "--only-found",- action="store_true",- help="Only show sites where the username/email was found",- )-parser.add_argument("--allow-loud",action="store_true",@@ -339,7 +345,7 @@ def main():config = ScanConfig(allow_loud=args.allow_loud,- only_found=args.only_found,+ show_all=args.all,no_nsfw=args.no_nsfw,verbose=args.verbose,timeout=args.timeout,@@ -515,7 +521,7 @@ def main():total_found = len([r for r in results if r.is_found()])total_skipped = len([r for r in results if r.status == Status.SKIPPED])- if args.only_found and total_found == 0:+ if not config.show_all and total_found == 0:print(f"\n{R}[β] No results found for the given target(s).{X}")else:print(f"\n{C}[i] Scan complete.\n Total hits:{X} {total_found}")diff --git a/user_scanner/core/email_orchestrator.py b/user_scanner/core/email_orchestrator.pyindex 68e7d2f..4750eb8 100644--- a/user_scanner/core/email_orchestrator.py+++ b/user_scanner/core/email_orchestrator.py@@ -96,8 +96,8 @@ async def _async_worker(result.update(**params)- # Logic to print header dynamically for --only-found streaming- if configs.only_found and result.status == Status.TAKEN:+ # Logic to print header dynamically for --show-all streaming+ if not configs.show_all and result.status == Status.TAKEN:if printed_cats is not None and actual_cat not in printed_cats:print(f"\n{Fore.MAGENTA}== {actual_cat.upper()} SITES =={Style.RESET_ALL}"@@ -149,7 +149,7 @@ async def _run_email_category_batch_async(modules = load_modules(category_path)printed_cats = set()- if not configs.only_found:+ if configs.show_all:print(f"\n{Fore.MAGENTA}== {cat_name.upper()} SITES =={Style.RESET_ALL}")printed_cats.add(cat_name)@@ -174,7 +174,7 @@ async def _run_email_full_batch_async(email: str, configs: ScanConfig) -> List[Rfor cat_name, cat_path in categories.items():modules = load_modules(cat_path)- if not configs.only_found:+ if configs.show_all:print(f"\n{Fore.MAGENTA}== {cat_name.upper()} SITES =={Style.RESET_ALL}")printed_cats.add(cat_name)diff --git a/user_scanner/core/helpers.py b/user_scanner/core/helpers.pyindex 7224ff9..9f4dfda 100644--- a/user_scanner/core/helpers.py+++ b/user_scanner/core/helpers.py@@ -60,7 +60,7 @@ CONFIG_PATH = Path(__file__).parent.parent / "config.json"class ScanConfig:allow_loud: bool = Falseno_nsfw: bool = False- only_found: bool = False+ show_all: bool = Falseverbose: bool = Falsetimeout: Optional[float] = Nonediff --git a/user_scanner/core/orchestrator.py b/user_scanner/core/orchestrator.pyindex ea7a1f9..db61edc 100644--- a/user_scanner/core/orchestrator.py+++ b/user_scanner/core/orchestrator.py@@ -92,7 +92,8 @@ async def _run_batch(result = await coroactual_cat = result.category or "Unknown"- if configs.only_found and result.is_found():+ # Handle specific logic where skipping needs to happen early+ if not configs.show_all and result.is_found():if printed_cats is not None and actual_cat not in printed_cats:print(f"\n{Fore.MAGENTA}== {actual_cat.upper()} SITES =={Style.RESET_ALL}")printed_cats.add(actual_cat)@@ -116,7 +117,7 @@ def run_user_category(modules = load_modules(category_path)printed_cats = set()- if not configs.only_found:+ if configs.show_all:print(f"\n{Fore.MAGENTA}== {category_name.upper()} SITES =={Style.RESET_ALL}")printed_cats.add(category_name)@@ -156,14 +157,14 @@ async def _run_user_full_async(username: str, configs: ScanConfig) -> List[Resulif not tasks:continue- if not configs.only_found:+ if configs.show_all:print(f"\n{Fore.MAGENTA}== {display_name.upper()} SITES =={Style.RESET_ALL}")printed_cats.add(display_name)for coro in asyncio.as_completed(tasks):result = await coro- if configs.only_found and result.is_found():+ if not configs.show_all and result.is_found():if display_name not in printed_cats:print(f"\n{Fore.MAGENTA}== {display_name.upper()} SITES =={Style.RESET_ALL}")printed_cats.add(display_name)diff --git a/user_scanner/core/result.py b/user_scanner/core/result.pyindex b787a69..846d562 100644--- a/user_scanner/core/result.py+++ b/user_scanner/core/result.py@@ -282,9 +282,9 @@ class Result:def show(self, configs: ScanConfig):"""Prints the console output and returns itself for chaining.- If only_found is True, only results with Status.TAKEN are printed."""+ If show_all is False, only results with Status.TAKEN are printed."""# Updated show() to accept and pass the show_url flag- if configs.only_found and self.status != Status.TAKEN:+ if not configs.show_all and self.status != Status.TAKEN:return selfprint(self.get_console_output(configs))return self