🕵️♂️ (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(user_scan): add BoardGameGeek username module (#701)
Kristo Isberg10d138bbb090
diff --git a/user_scanner/user_scan/gaming/boardgamegeek.py b/user_scanner/user_scan/gaming/boardgamegeek.pynew file mode 100644index 0000000..ae40db4--- /dev/null+++ b/user_scanner/user_scan/gaming/boardgamegeek.py@@ -0,0 +1,100 @@+from urllib.parse import quote, urljoin++import httpx++from user_scanner.core.orchestrator import generic_validate, make_request+from user_scanner.core.result import Result+++def validate_boardgamegeek(user: str) -> Result:+ """Use Geekdo's shared user lookup; profile HTML is only an app shell."""+ url = "https://api.geekdo.com/api/user"+ show_url = f"https://boardgamegeek.com/profile/{quote(user, safe='')}"++ def process(response) -> Result:+ if response.status_code != 200:+ return Result.error(f"Unexpected status code: {response.status_code}")++ data = response.json()++ if not isinstance(data, list):+ return Result.error("Unexpected BoardGameGeek user response")+ if not data:+ return Result.available()+ if len(data) != 1 or not isinstance(data[0], dict):+ return Result.error("Unexpected BoardGameGeek user records")++ account = data[0]+ username = account.get("username")+ userid = account.get("userid")+ if (+ account.get("type") != "user"+ or not isinstance(username, str)+ or username.casefold() != user.casefold()+ or type(userid) is not int+ or userid <= 0+ ):+ return Result.error("Unable to verify BoardGameGeek user identity")++ extra: dict[str, str | int | list[str]] = {"user_id": userid}+ years = account.get("supportYears")+ if isinstance(years, list):+ extra["supporter_years"] = years+ for source, target in (+ ("firstname", "firstname"),+ ("lastname", "lastname"),+ ("city", "city"),+ ("state", "state"),+ ("country", "country"),+ ("regdate", "joined"),+ ):+ value = account.get(source)+ if isinstance(value, str) and value != "Unspecified":+ extra[target] = value.strip()++ credits = account.get("creditBadges")+ if isinstance(credits, dict):+ labels = []+ links = []+ for credit in credits.get("boardgame") or []:+ if not isinstance(credit, dict):+ continue+ if isinstance(label := credit.get("label"), str):+ labels.append(label)+ if isinstance(href := credit.get("href"), str) and href:+ links.append(urljoin("https://boardgamegeek.com", href))+ extra["credits"] = list(dict.fromkeys(labels))+ extra["credit_links"] = list(dict.fromkeys(links))++ media = {}+ avatar = account.get("avatar")+ if isinstance(avatar, dict) and isinstance(avatar.get("urls"), dict):+ urls = avatar["urls"]+ image = urls.get("xl") or urls.get("default@2x") or urls.get("default")+ if isinstance(image, str) and image.startswith("https://"):+ media["avatar"] = image++ result = Result.taken(extra=extra, media=media)+ try:+ enrichment = make_request(f"{url}/{userid}/profile")+ if enrichment.status_code == 200:+ data = enrichment.json()+ result.update(+ extra={+ target: value.strip()+ for source, target in (+ ("body", "bio"),+ ("shortDescription", "description"),+ ("lastLogin", "last_seen"),+ ("editdate", "profile_updated"),+ )+ if isinstance(value := data.get(source), str)+ }+ )+ except (httpx.HTTPError, ValueError, AttributeError):+ # Optional enrichment errors must not overwrite the confirmed account.+ pass++ return result++ return generic_validate(url, process, params={"username": user}, show_url=show_url)