π΅οΈββοΈ (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 3 modules kik gtainside and mobilegta (#712)
alvaromaltrain8665a70641b6
diff --git a/user_scanner/user_scan/gaming/gtainside.py b/user_scanner/user_scan/gaming/gtainside.pynew file mode 100644index 0000000..f9dcbd2--- /dev/null+++ b/user_scanner/user_scan/gaming/gtainside.py@@ -0,0 +1,91 @@+import re+from urllib.parse import quote++from user_scanner.core.orchestrator import generic_validate+from user_scanner.core.result import Result++_TITLE_RE = re.compile(r"<title>([^<]*)</title>")+_NAME_RE = re.compile(r'<h2 class="marginbottom5">([^<]+)</h2>')+_AVATAR_RE = re.compile(r'src="(/img/avatars/[^"]+)"')+_ACTIVITY_RE = re.compile(r"Last activity:\s*([^<]+?)\s*</span>")+_AGE_RE = re.compile(r"Age:\s*(\d+)")+_COUNTRY_RE = re.compile(r'Country:\s*<img src="/gfx/flags/[^"]+" alt="([^"]+)"')+_MODS_RE = re.compile(r"</i>\s*([\d.,]+)\s*Mods</a>")+_DOWNLOADS_RE = re.compile(r"</i>\s*([\d.,]+)\s*Downloads")+_COMMENTS_RE = re.compile(r"</i>\s*([\d.,]+)\s*Comments")+++def _count(raw: str) -> int | str:+ value = raw.replace(".", "").replace(",", "")+ return int(value) if value.isdigit() else raw+++def validate_gtainside(user: str) -> Result:+ """+ Check account existence on GTAinside.com via its public profile page.++ Existing profiles return 200 with a "<name>'s profile | GTAinside.com"+ title; missing profiles return a dedicated 404 page whose title is+ "Page not found - 404". Both markers are verified explicitly so a WAF or+ challenge page can never be mistaken for a verdict.++ Sidebar stats (age, country, mods, downloads, comments) are extracted+ when present; valid profiles exist without any of them (e.g. users who+ never filled in their details or never uploaded mods).+ """+ url = f"https://www.gtainside.com/profile/{quote(user, safe='')}"+ show_url = url++ def process(response):+ text = response.text+ title_match = _TITLE_RE.search(text)+ title = title_match.group(1) if title_match else ""++ # Available state: the dedicated 404 page, identified by its own+ # title and error block β not just the bare status code.+ if response.status_code == 404 and title == "Page not found - 404":+ return Result.available(url=show_url)++ if response.status_code != 200:+ return Result.error(f"Unexpected response status: {response.status_code}")++ # Taken state: profile pages carry a title ending in "'s profile |+ # GTAinside.com", which the 404/challenge pages never produce.+ if not title.endswith("'s profile | GTAinside.com"):+ return Result.error("Missing GTAinside profile markers")++ name_match = _NAME_RE.search(text)+ extra = {}+ if name_match:+ extra["fullname"] = name_match.group(1).strip()+ activity_match = _ACTIVITY_RE.search(text)+ if activity_match:+ extra["last_activity"] = " ".join(activity_match.group(1).split())++ # Sidebar stats β all optional: some valid profiles (e.g. users who+ # never filled in their details) omit age/country, and accounts+ # without uploads show "No mods uploaded yet." instead of counts.+ age_match = _AGE_RE.search(text)+ if age_match:+ extra["age"] = int(age_match.group(1))+ country_match = _COUNTRY_RE.search(text)+ if country_match:+ extra["country"] = country_match.group(1)+ mods_match = _MODS_RE.search(text)+ if mods_match:+ extra["mods"] = _count(mods_match.group(1))+ downloads_match = _DOWNLOADS_RE.search(text)+ if downloads_match:+ extra["downloads"] = _count(downloads_match.group(1))+ comments_match = _COMMENTS_RE.search(text)+ if comments_match:+ extra["comments"] = _count(comments_match.group(1))++ avatar_match = _AVATAR_RE.search(text)+ media = {}+ if avatar_match:+ media["avatar"] = "https://www.gtainside.com" + avatar_match.group(1)++ return Result.taken(extra=extra, media=media)++ return generic_validate(url, process, show_url=show_url, follow_redirects=True)diff --git a/user_scanner/user_scan/gaming/mobilegta.py b/user_scanner/user_scan/gaming/mobilegta.pynew file mode 100644index 0000000..232f7c6--- /dev/null+++ b/user_scanner/user_scan/gaming/mobilegta.py@@ -0,0 +1,109 @@+import re+from urllib.parse import quote++from user_scanner.core.orchestrator import generic_validate+from user_scanner.core.result import Result++_NAME_RE = re.compile(r'<h1 class="userpage_user">([^<]+)</h1>')+_AVATAR_RE = re.compile(r'userpage_avatar"[^>]*><img src="([^"]+)"')+_RELEASED_RE = re.compile(r"Released:\s*(\d+)\s*mods")+_TOTAL_DOWNLOADS_RE = re.compile(r"Total:</strong>\s*([\d.,]+)\s*downloads")+_VIEWS_RE = re.compile(r"<strong>Userpage:</strong><br>\s*(\d+)\s*Views")+_LAST_ONLINE_RE = re.compile(r"<strong>Last online:</strong><br>\s*([^<]+)")+_RANK_POINTS_RE = re.compile(r"I have\s+(\d+)\s+<a href=\"/en/faq.php#9\">rank points</a>")+_RANK_NAME_RE = re.compile(r"and I'm called:\s*<h2>\"?([^<\"]+)")+_COUNTRY_RE = re.compile(r'Country:\s*<img src="/gfx/flags/[^"]+">\s*([^<]+)</span>')+_AGE_RE = re.compile(r"Age:\s*(\d+)")+_CF_EMAIL_RE = re.compile(r'href="/cdn-cgi/l/email-protection#([a-f0-9]+)"')+++def _count(raw: str) -> int | str:+ value = raw.replace(".", "").replace(",", "")+ return int(value) if value.isdigit() else raw+++def _cf_decode(hex_bytes: str) -> str:+ """Undo Cloudflare's email-protection XOR obfuscation."""+ data = bytes.fromhex(hex_bytes)+ key = data[0]+ return "".join(chr(byte ^ key) for byte in data[1:])+++def validate_mobilegta(user: str) -> Result:+ """+ Check account existence on MobileGTA.net via its public userpage.++ The site answers HTTP 200 for every /user/ URL: missing profiles carry an+ error box with "<h1>404 Not Found</h1>" and no userpage markup, while+ real profiles always render an <h1 class="userpage_user"> name plus a+ "My Stats" box. Both markers are checked explicitly β a 200 alone proves+ nothing here.++ Stats (mods released, total downloads, page views, last online, rank)+ live in the "My Stats" box and are extracted when present. Country and+ age sit in profile "block" spans, and the public contact email is a+ Cloudflare-protected link that gets decoded back to plain text β all+ three only appear when the user filled them in.+ """+ url = f"https://www.mobilegta.net/en/user/{quote(user, safe='')}"+ show_url = url++ def process(response):+ if response.status_code != 200:+ return Result.error(f"Unexpected response status: {response.status_code}")++ text = response.text++ # Available state: the embedded 404 page, identified by its own+ # error block β it never contains userpage markup.+ if "<h1>404 Not Found</h1>" in text:+ return Result.available(url=show_url)++ # Taken state: the profile heading is unique to existing users.+ name_match = _NAME_RE.search(text)+ if not name_match:+ return Result.error("Missing MobileGTA userpage markers")++ extra = {"fullname": name_match.group(1).strip()}++ released_match = _RELEASED_RE.search(text)+ if released_match:+ extra["mods"] = int(released_match.group(1))+ downloads_match = _TOTAL_DOWNLOADS_RE.search(text)+ if downloads_match:+ extra["downloads"] = _count(downloads_match.group(1))+ views_match = _VIEWS_RE.search(text)+ if views_match:+ extra["views"] = int(views_match.group(1))+ country_match = _COUNTRY_RE.search(text)+ if country_match:+ extra["country"] = country_match.group(1).strip()+ age_match = _AGE_RE.search(text)+ if age_match:+ extra["age"] = int(age_match.group(1))+ email_match = _CF_EMAIL_RE.search(text)+ if email_match:+ # Only users who made their address public get this link; it is+ # XOR-obfuscated by Cloudflare, never stored in plain text.+ extra["email"] = _cf_decode(email_match.group(1))+ last_online_match = _LAST_ONLINE_RE.search(text)+ if last_online_match:+ last_online = " ".join(last_online_match.group(1).split())+ if last_online and last_online != "N/A":+ extra["last_online"] = last_online+ points_match = _RANK_POINTS_RE.search(text)+ if points_match:+ extra["rank_points"] = int(points_match.group(1))+ rank_name_match = _RANK_NAME_RE.search(text)+ if rank_name_match:+ extra["rank"] = rank_name_match.group(1).strip()++ avatar_match = _AVATAR_RE.search(text)+ media = {}+ # Accounts without an uploaded picture get the shared no_avatar.jpg.+ if avatar_match and not avatar_match.group(1).endswith("no_avatar.jpg"):+ media["avatar"] = "https://www.mobilegta.net" + avatar_match.group(1)++ return Result.taken(extra=extra, media=media)++ return generic_validate(url, process, show_url=show_url, follow_redirects=True)diff --git a/user_scanner/user_scan/social/kik.py b/user_scanner/user_scan/social/kik.pynew file mode 100644index 0000000..eb82b2e--- /dev/null+++ b/user_scanner/user_scan/social/kik.py@@ -0,0 +1,48 @@+import re+from urllib.parse import quote++from user_scanner.core.orchestrator import generic_validate+from user_scanner.core.result import Result++_DISPLAY_NAME_RE = re.compile(r'<h1 class="display-name">([^<]*)</h1>')+_AVATAR_RE = re.compile(r'<meta property="og:image"\s+content="([^"]*)"')+++def validate_kik(user: str) -> Result:+ """+ Check account existence on Kik via its kik.me share page.++ Kik returns HTTP 200 for both existing and non-existing usernames, so the+ verdict relies on page markers: a real profile has a non-empty og:image+ pointing at profilepics.cf.kik.com, while a missing profile ships an empty+ og:image and a blank display name.+ """+ url = f"https://kik.me/{quote(user, safe='')}"+ show_url = url++ def process(response):+ if response.status_code != 200:+ return Result.error(f"Unexpected response status: {response.status_code}")++ text = response.text++ avatar_match = _AVATAR_RE.search(text)+ avatar = avatar_match.group(1) if avatar_match else None+ name_match = _DISPLAY_NAME_RE.search(text)+ fullname = name_match.group(1).strip() if name_match else None++ # Taken state: Kik serves the profile picture CDN URL only for+ # accounts that actually exist.+ if (avatar and "profilepics.cf.kik.com" in avatar) or fullname:+ extra = {"fullname": fullname} if fullname else {}+ media = {"avatar": avatar} if avatar else {}+ return Result.taken(extra=extra, media=media)++ # Available state: both the avatar slot and the display name are+ # blank β verified against a nonexistent handle.+ if not avatar and not fullname:+ return Result.available(url=show_url)++ return Result.error("Ambiguous kik.me page: profile markers disagree")++ return generic_validate(url, process, show_url=show_url)