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 2 modules (#753)

alexispradol833f828813ee
diff --git a/user_scanner/user_scan/adult/arsmate.py b/user_scanner/user_scan/adult/arsmate.py
new file mode 100644
index 0000000..4f1d14a
--- /dev/null
+++ b/user_scanner/user_scan/adult/arsmate.py
@@ -0,0 +1,59 @@
+from datetime import datetime, timezone
+
+from user_scanner.core.helpers import get_random_user_agent
+from user_scanner.core.orchestrator import generic_validate
+from user_scanner.core.result import Result
+
+
+def validate_arsmate(user: str) -> Result:
+ url = f"https://arsmate.com/api/creators/{user}"
+ show_url = f"https://arsmate.com/{user}"
+
+ headers = {
+ "User-Agent": get_random_user_agent(),
+ "Accept": "application/json",
+ }
+
+ def process(response):
+ if response.status_code == 200 or response.status_code == 404:
+ try:
+ data = response.json()
+ except Exception:
+ return Result.error("Unexpected response body, report it via GitHub issues")
+ if data.get("error") is True:
+ return Result.available()
+ creator = data.get("creator")
+ if not isinstance(creator, dict) or "username" not in creator:
+ return Result.error("Unexpected API response body, report it via GitHub issues")
+ extra = {}
+ media = {}
+ if name := creator.get("name"): extra["name"] = name
+ if username := creator.get("username"): extra["username"] = username
+ if bio := creator.get("about"): extra["bio"] = bio
+ if profession := creator.get("profession"): extra["profession"] = profession
+ if website := creator.get("website"): extra["links"] = website
+ extra["verified"] = bool(creator.get("isVerified"))
+ if birthdate := creator.get("birthdate"): extra["birth_date"] = birthdate
+ if country := creator.get("countryId"): extra["country"] = country
+ if created_at := creator.get("createdAt"):
+ extra["joined"] = datetime.fromtimestamp(
+ datetime.fromisoformat(created_at.replace("Z", "+00:00")).timestamp(),
+ timezone.utc
+ ).strftime("%Y-%m-%d")
+ stats = creator.get("stats") or {}
+ if subscribers := stats.get("subscribers"): extra["subscribers"] = str(subscribers)
+ if posts := stats.get("posts"): extra["posts"] = str(posts)
+ if photos := stats.get("photos"): extra["photos"] = str(photos)
+ if videos := stats.get("videos"): extra["videos"] = str(videos)
+ if likes := stats.get("likes"): extra["likes"] = str(likes)
+ if social := creator.get("social"):
+ links = [v for v in social.values() if isinstance(v, str) and v]
+ if links:
+ extra["social"] = " ".join(links)
+ if avatar := creator.get("avatar"): media["avatar"] = avatar
+ if cover := creator.get("cover"): media["banner"] = cover
+ return Result.taken(extra=extra, media=media)
+
+ return Result.error(f"Unexpected status code: {response.status_code}")
+
+ return generic_validate(url, process, show_url=show_url, headers=headers)
diff --git a/user_scanner/user_scan/music/genius.py b/user_scanner/user_scan/music/genius.py
new file mode 100644
index 0000000..4db1ab2
--- /dev/null
+++ b/user_scanner/user_scan/music/genius.py
@@ -0,0 +1,48 @@
+import re
+
+from user_scanner.core.helpers import get_random_user_agent
+from user_scanner.core.orchestrator import generic_validate
+from user_scanner.core.result import Result
+
+
+def validate_genius(user: str) -> Result:
+ url = f"https://genius.com/{user.lower()}"
+ show_url = f"https://genius.com/{user}"
+
+ headers = {
+ "User-Agent": get_random_user_agent(),
+ "Accept": "text/html",
+ }
+
+ def process(response):
+ if response.status_code == 404:
+ return Result.available()
+ if response.status_code == 200:
+ text = response.text
+ og_url = f'property="og:url" content="https://genius.com/{user.lower()}"'
+ if og_url not in text or 'followers_count":' not in text:
+ return Result.error("Unexpected response body, report it via GitHub issues")
+
+ extra = {}
+ media = {}
+ if title := re.search(r'property="og:title" content="([^"]+)"', text):
+ extra["username"] = title.group(1)
+ if match := re.search(r'followers_count":(\d+)', text):
+ extra["followers"] = match.group(1)
+ if match := re.search(r'followed_users_count":(\d+)', text):
+ extra["following"] = match.group(1)
+ if match := re.search(r'"iq":(\d+)', text):
+ extra["iq"] = match.group(1)
+ if match := re.search(r'https://images\.genius\.com/avatars/medium/[0-9a-f]{32}', text):
+ media["avatar"] = match.group(0)
+ banner = None
+ for match in re.finditer(r'header_image_url":"(https://[^&]+)"', text):
+ if "default_banner" not in match.group(1):
+ banner = match.group(1)
+ if banner:
+ media["banner"] = banner
+ return Result.taken(extra=extra, media=media)
+
+ return Result.error(f"Unexpected status code: {response.status_code}")
+
+ return generic_validate(url, process, show_url=show_url, headers=headers)