π΅οΈββοΈ (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
chore: retire Motherless modules to abandoned/ (site is offline) (#525)
BrunoLMaac3cce8cabf
diff --git a/AGENTS.md b/AGENTS.mdindex d4c26de..b4cf673 100644--- a/AGENTS.md+++ b/AGENTS.md@@ -26,6 +26,8 @@ profile metadata. See `README.md` for the full feature list and install steps.Asynchronous. Export `async def validate_<service>(email: str) -> Result`.- `user_scanner/core/` β engine, orchestrator, helpers, `Result`, formatters,exporters (JSON/CSV/PDF). Changes here affect every module; review carefully.+- `abandoned/<email_scan|user_scan>/<category>/<site>.py` β retired modules+ (dead sites, permanently broken detection). See "Retiring a module" below.- `tests/` β pytest suite. Add tests for new core behavior only. **Do notadd unit tests for individual scan modules** β modules are verified bylive-testing against real and nonexistent handles (see "Before opening a@@ -56,6 +58,14 @@ Read `CONTRIBUTING.md` first β it has full examples. The essentials:7. **Respect the global CLI flags** in any request-making code (timeout `-t`,concurrency `-C`, `--allow-loud`) β mirror the existing helpers.+## Retiring a module++Never delete a scan module. When a site shuts down or a module can no longer+work, **move** the file from `user_scanner/<email_scan|user_scan>/<category>/`+to `abandoned/<email_scan|user_scan>/<category>/` β same scan type, same+category, same file name, contents unchanged. This keeps the module out of+`load_modules()` while preserving it for revival if the site returns.+## Before opening a PRLocal CI gates must pass:diff --git a/user_scanner/email_scan/adult/motherless.py b/abandoned/email_scan/adult/motherless.pysimilarity index 100%rename from user_scanner/email_scan/adult/motherless.pyrename to abandoned/email_scan/adult/motherless.pydiff --git a/user_scanner/user_scan/adult/motherless.py b/abandoned/user_scan/adult/motherless.pysimilarity index 100%rename from user_scanner/user_scan/adult/motherless.pyrename to abandoned/user_scan/adult/motherless.py