π΅οΈββοΈ (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(cli): centralize terminal tips and add proxy guidance for blocked sites (#710)
Kaifb85d470b48f7
diff --git a/user_scanner/__main__.py b/user_scanner/__main__.pyindex 60b6f26..3c3b6b0 100644--- a/user_scanner/__main__.py+++ b/user_scanner/__main__.py@@ -10,6 +10,7 @@ from itertools import islicefrom dataclasses import replacefrom user_scanner.cli.banner import print_banner+from user_scanner.cli.tips import print_loud_skip_tip, print_proxy_tipfrom user_scanner.core import formatterfrom user_scanner.core.cross_scan import (DEFAULT_DEPTH,@@ -794,10 +795,9 @@ def main():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}")- if total_skipped > 0:- print(f" {C}Skipped:{X} {total_skipped}")- print(f" {Y}Reason for skip: Module(s) notify{X} (but only if target exists there) {Y}the target with password reset email(s){X}")- print(f" {Y}Use {G}--allow-loud{X}{Y} to include those module(s) to be scanned{X}")+ print_loud_skip_tip(total_skipped)++ print_proxy_tip(results, has_proxy=bool(args.proxy_file))if __name__ == "__main__":main()diff --git a/user_scanner/cli/tips.py b/user_scanner/cli/tips.pynew file mode 100644index 0000000..9e26bcf--- /dev/null+++ b/user_scanner/cli/tips.py@@ -0,0 +1,83 @@+"""CLI tips, intelligence service recommendations, and operational hints."""++from typing import Sequence++from colorama import Fore, Style++from user_scanner.core.result import Result, Status++_BLOCKED_KEYWORDS = (+ "403",+ "429",+ "waf",+ "cloudflare",+ "timed out",+ "timeout",+ "curl: (28)",+ "connection closed",+ "rate limit",+)++PROXY_SPONSOR_URL = "https://proxy-seller.com/?partner=A711D0DB08424F5A"+PROXY_PROMO_CODE = "KAIF15"+++def print_proxy_tip(results: Sequence[Result], has_proxy: bool = False) -> None:+ """Surface regional / WAF blocks and recommend proxy routing if not already configured."""+ if has_proxy:+ return++ blocked_count = sum(+ 1+ for r in results+ if r.status == Status.ERROR+ and any(kw in str(r.reason or "").lower() for kw in _BLOCKED_KEYWORDS)+ )++ if blocked_count > 0:+ Y = Fore.YELLOW+ G = Fore.GREEN+ C = Fore.CYAN+ B = Style.BRIGHT+ RESET = Style.RESET_ALL++ print(+ f"\n{Y}{B}[!] {blocked_count} site(s) were unreachable{RESET} due to regional blocks or rate limits {Y}(403/timeout){RESET}."+ f"\n {C}{B}Tip:{RESET} Route scans with {G}{B}-P/--proxy-file{RESET} to get verdicts from blocked sites."+ f"\n {B}Tested provider:{RESET} {C}{PROXY_SPONSOR_URL}{RESET} (use code {G}{B}{PROXY_PROMO_CODE}{RESET} for {G}{B}15% off{RESET})"+ )+++def print_hudson_remediation_tip() -> None:+ """Print security guidance when infostealer compromises are detected."""+ Y = Fore.YELLOW+ B = Style.BRIGHT+ C = Fore.CYAN+ RESET = Style.RESET_ALL++ print(+ f"\n{Y}{B}[!] Security Notice:{RESET} All credentials saved on infected computers are at risk."+ )+ print(+ f" {C}{B}Remediation tools:{RESET} Visit {C}https://www.hudsonrock.com/free-tools{RESET} for identity monitoring."+ )+++def print_loud_skip_tip(skipped_count: int) -> None:+ """Explain why loud modules were skipped and how to enable them."""+ if skipped_count <= 0:+ return++ C = Fore.CYAN+ Y = Fore.YELLOW+ G = Fore.GREEN+ B = Style.BRIGHT+ RESET = Style.RESET_ALL++ print(f" {C}Skipped:{RESET} {skipped_count}")+ print(+ f" {Y}Reason for skip: Module(s) may notify the target with password reset emails.{RESET}"+ )+ print(+ f" {Y}Use {G}{B}--allow-loud{RESET}{Y} to include those module(s) in the scan.{RESET}"+ )diff --git a/user_scanner/core/hudson.py b/user_scanner/core/hudson.pyindex 6660999..a2f1363 100644--- a/user_scanner/core/hudson.py+++ b/user_scanner/core/hudson.py@@ -1,6 +1,7 @@import httpximport jsonfrom colorama import Fore, Style+from user_scanner.cli.tips import print_hudson_remediation_tipfrom user_scanner.core.helpers import load_config, _get_config_path# Color configs@@ -93,8 +94,7 @@ def run_hudson_scan(target: str, is_email: bool = False):if top_logins:print(f" - Sample Logins Found: {', '.join(top_logins[:3])}...")- print(f"\n{Y}[!] Recommendation: All credentials saved on infected computers are at risk.{X}")- print(f"{Y}[!] Visit https://www.hudsonrock.com/free-tools for more info.{X}")+ print_hudson_remediation_tip()elif response.status_code == 404:print(f"{G}[β] No data found for this {param} in Hudson Rock database.{X}")