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: Clubhouse username module (#588)

Kristo Isberg745fff0dd060
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 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.py
new file mode 100644
index 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)