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: default to found-only results and introduce --all flag

Kaif8d51086d5acc
diff --git a/README.md b/README.md
index 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.
```bash
user-scanner -v -e [email protected] -c dev
```
diff --git a/docs/FLAGS.md b/docs/FLAGS.md
index 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.py
index 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().out
assert "bob" in out # Needs to be improved
diff --git a/user_scanner/__main__.py b/user_scanner/__main__.py
index 742c09d..86975df 100644
--- a/user_scanner/__main__.py
+++ b/user_scanner/__main__.py
@@ -51,6 +51,12 @@ MAX_PERMUTATIONS_LIMIT = 100
def 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.py
index 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[R
for 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.py
index 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 = False
no_nsfw: bool = False
- only_found: bool = False
+ show_all: bool = False
verbose: bool = False
timeout: Optional[float] = None
diff --git a/user_scanner/core/orchestrator.py b/user_scanner/core/orchestrator.py
index 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 coro
actual_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[Resul
if 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.py
index 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 self
print(self.get_console_output(configs))
return self