🕵️♂️ (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: Clubhouse username module (#588)
Kristo Isberg745fff0dd060
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.mdindex 9b87ee2..87675b6 100644--- a/CONTRIBUTING.md+++ b/CONTRIBUTING.md@@ -136,6 +136,7 @@ def validate_<sitename>(user: str) -> Result:2. **Deep Data Extraction:** If the user is found, attempt to extract rich metadata (fullname, location, bio, stats) and return it via `Result.taken(extra={"fullname": "John Doe", ...})`. **If extracting profile pictures, banners, or other images, you MUST pass their URLs in the `media` dictionary** (e.g., `Result.taken(media={"avatar": "https://..."})`), not in `extra`.3. **Strict Error Handling:** NEVER use `raise Exception()`. All unhandled states or unexpected status codes must return `Result.error(f"Unexpected status code {resp.status_code}")`.4. **Use Orchestrator Helpers:** Use `generic_validate` to standardize `httpx` logic, but write robust `process` callbacks.+5. **Use Next.js Helpers:** When a site is based on Next.js, use the matching helper from `user_scanner.core.nextjs`: `parse_next_pages_data` for Pages Router `__NEXT_DATA__`, `iter_next_app_flight_chunks` for App Router Flight data, or `parse_next_pages_redirect` for Pages Router JSON redirects. Do not duplicate this parsing in a module.---diff --git a/user_scanner/user_scan/social/clubhouse.py b/user_scanner/user_scan/social/clubhouse.pynew file mode 100644index 0000000..9e5ed41--- /dev/null+++ b/user_scanner/user_scan/social/clubhouse.py@@ -0,0 +1,50 @@+from urllib.parse import quote++from user_scanner.core.nextjs import parse_next_pages_data+from user_scanner.core.orchestrator import generic_validate+from user_scanner.core.result import Result+++def validate_clubhouse(user: str) -> Result:+ encoded = quote(user, safe="")+ url = f"https://www.clubhouse.com/@{encoded}"++ def process(response):+ if response.status_code == 404 and response.text.strip() == "404":+ return Result.available()++ if response.status_code != 200:+ return Result.error(f"Unexpected response status: {response.status_code}")++ data = parse_next_pages_data(response.text)+ if data is None:+ return Result.error("Missing or invalid Clubhouse profile data")++ try:+ page_props = data["props"]["pageProps"]+ profile = page_props["routeProps"]["user"]+ except (KeyError, TypeError):+ return Result.error("Invalid Clubhouse profile data")++ username = profile.get("username")+ if not isinstance(username, str) or username.casefold() != user.casefold():+ return Result.error("Profile response did not match the requested username")++ route = page_props["routeProps"]+ extra = {+ key: value+ for key, value in {+ "fullname": profile.get("full_name"),+ "bio": profile.get("bio"),+ "twitter": profile.get("twitter_username"),+ "instagram": profile.get("instagram_username"),+ "followers": route.get("num_followers"),+ "following": route.get("num_following"),+ "friends": route.get("friend_count"),+ }.items()+ if value not in (None, "")+ }+ avatar = profile.get("photo_url")+ return Result.taken(extra=extra, media={"avatar": avatar} if avatar else {})++ return generic_validate(url, process, show_url=url, follow_redirects=True)