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(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.py
new file mode 100644
index 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.py
new file mode 100644
index 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.py
new file mode 100644
index 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)