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.

chore: retire Motherless modules to abandoned/ (site is offline) (#525)

BrunoLMaac3cce8cabf
diff --git a/AGENTS.md b/AGENTS.md
index 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 not
add unit tests for individual scan modules** β€” modules are verified by
live-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 PR
Local CI gates must pass:
diff --git a/user_scanner/email_scan/adult/motherless.py b/abandoned/email_scan/adult/motherless.py
similarity index 100%
rename from user_scanner/email_scan/adult/motherless.py
rename to abandoned/email_scan/adult/motherless.py
diff --git a/user_scanner/user_scan/adult/motherless.py b/abandoned/user_scan/adult/motherless.py
similarity index 100%
rename from user_scanner/user_scan/adult/motherless.py
rename to abandoned/user_scan/adult/motherless.py