🕵️♂️ (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
from user_scanner.core.confidence import Confidence, build_anchors, rank_emails, score
from user_scanner.core.pivots import extract_email_pivots, select_email_pivots
from user_scanner.core.result import Result
def hit(site_name, username="johndoe", **extra):
return Result.taken(extra=extra).update(site_name=site_name, username=username)
def anchors_from(*confirmed, emails=("[email protected]",)):
return build_anchors(
confirmed=confirmed,
emails=emails,
urls=("https://github.com/johndoe", "https://stackoverflow.com/users/12345/johndoe"),
)
CONFIRMED = hit(
"Github",
name="Johnathan Doe",
website="https://johndoe.com",
links="https://johndoe.com, https://twitter.com/johndoe2",
)
def test_anchors_take_names_domains_and_emails_from_confirmed_hits():
anchors = anchors_from(CONFIRMED)
assert "johnathandoe" in anchors.names
assert "johndoe.com" in anchors.domains
assert "[email protected]" in anchors.emails
def test_anchors_ignore_platform_hosts():
anchors = anchors_from(CONFIRMED)
assert "twitter.com" not in anchors.domains
assert "github.com" not in anchors.domains
def test_anchors_ignore_a_name_that_only_repeats_the_handle():
anchors = anchors_from(hit("Github", name="JohnDoe"))
assert "johndoe" not in anchors.names
def test_another_accounts_handle_does_not_suppress_a_real_name():
anchors = anchors_from(
hit("Linkedin", name="Johnathan Doe"),
hit("Youtube", username="JohnathanDoe"),
)
assert "johnathandoe" in anchors.names
def test_a_named_site_is_confirmed():
rating = score(hit("Github"), anchors_from(CONFIRMED), confirmed=True)
assert rating is Confidence.CONFIRMED
def test_a_matching_name_is_likely():
rating = score(hit("Behance", name="Johnathan Doe"), anchors_from(CONFIRMED))
assert rating is Confidence.LIKELY
def test_a_personal_domain_in_the_bio_is_likely():
rating = score(hit("Bluesky", bio="Dev - https://johndoe.com/"), anchors_from(CONFIRMED))
assert rating is Confidence.LIKELY
def test_a_confirmed_profile_url_in_the_bio_is_likely():
rating = score(
hit("Instagram", bio="http://stackoverflow.com/users/12345/johndoe"),
anchors_from(CONFIRMED),
)
assert rating is Confidence.LIKELY
def test_linking_a_confirmed_account_is_likely():
anchors = anchors_from(hit("X (Twitter)", username="JohnDoe2"))
twitch = hit("Twitch", twitter="https://twitter.com/JohnDoe2")
assert score(twitch, anchors) is Confidence.LIKELY
def test_a_link_matches_a_confirmed_account_across_a_renamed_host():
anchors = anchors_from(hit("X (Twitter)", username="JohnDoe2"))
for url in ("https://x.com/johndoe2", "https://twitter.com/JohnDoe2/"):
assert score(hit("Linktree", showcased_links=url), anchors) is Confidence.LIKELY
def test_a_link_to_an_unconfirmed_account_is_not_corroboration():
anchors = anchors_from(hit("X (Twitter)", username="JohnDoe2"))
other = hit("Linktree", showcased_links="https://x.com/somebodyelse")
assert score(other, anchors) is Confidence.CANDIDATE
def test_the_scanned_email_in_the_bio_is_likely():
rating = score(hit("Hackernews", bio="Reach me at [email protected]"), anchors_from(CONFIRMED))
assert rating is Confidence.LIKELY
def test_a_different_persons_name_conflicts():
rating = score(hit("Chess.com", name="Other Person"), anchors_from(CONFIRMED))
assert rating is Confidence.CONFLICTING
def test_a_descriptor_field_conflicts_on_its_name_part_only():
rating = score(
hit("Somesite", i_am="Other Person, 44, male"), anchors_from(CONFIRMED)
)
assert rating is Confidence.CONFLICTING
def test_a_descriptor_carrying_no_surname_does_not_conflict():
rating = score(hit("Somesite", i_am="Someone, 44, male"), anchors_from(CONFIRMED))
assert rating is Confidence.CANDIDATE
def test_a_name_that_only_renders_the_handle_stays_a_candidate():
rating = score(hit("Picsart", name="john.d.oe"), anchors_from(CONFIRMED))
assert rating is Confidence.CANDIDATE
def test_a_hit_with_no_metadata_stays_a_candidate():
rating = score(hit("Roblox"), anchors_from(CONFIRMED))
assert rating is Confidence.CANDIDATE
def test_nothing_conflicts_when_there_is_no_confirmed_account_to_conflict_with():
rating = score(hit("Chess.com", name="Other Person"), anchors_from(emails=()))
assert rating is Confidence.CANDIDATE
def emails_from(*results, mode="all"):
return select_email_pivots(extract_email_pivots(results), mode)
def rate(*results, mode="all"):
pivots = emails_from(*results, mode=mode)
ranked = rank_emails(pivots, build_anchors(confirmed=results))
return {entry.email: entry.confidence for entry in ranked}
def test_two_sites_publishing_one_address_confirm_it():
"""Independent agreement is the strongest tie available without mailing it."""
ratings = rate(
hit("Github", email="[email protected]"),
hit("Gravatar", emails="[email protected]"),
)
assert ratings == {"[email protected]": Confidence.CONFIRMED}
def test_a_single_email_field_is_only_likely():
assert rate(hit("Github", email="[email protected]")) == {"[email protected]": Confidence.LIKELY}
def test_an_address_scraped_from_prose_is_a_candidate():
assert rate(hit("Reddit", bio="mail [email protected]")) == {
"[email protected]": Confidence.CANDIDATE
}
def test_an_address_on_a_linked_domain_is_likely():
ratings = rate(hit("Github", website="https://acme.dev", bio="[email protected], [email protected]"))
assert ratings["[email protected]"] is Confidence.LIKELY
assert ratings["[email protected]"] is Confidence.CANDIDATE
def test_an_address_does_not_vouch_for_itself():
"""build_anchors mines these same profiles for addresses and their domains,
so rating against either would promote every hit on its own appearance."""
ratings = rate(hit("Reddit", bio="[email protected]"))
assert ratings == {"[email protected]": Confidence.CANDIDATE}
def test_best_tied_addresses_come_first():
ranked = rank_emails(
emails_from(
hit("Reddit", bio="[email protected]"),
hit("Github", email="[email protected]"),
hit("Gravatar", emails="[email protected]"),
),
build_anchors(confirmed=()),
)
assert [e.email for e in ranked] == ["[email protected]", "[email protected]"]
def test_an_address_is_never_rated_conflicting():
"""An address carries no name to disagree with, so inventing a mismatch
from the local part would mislabel every shared mailbox."""
ratings = rate(
hit("Github", name="Johnathan Doe", email="[email protected]"),
hit("Reddit", name="Other Person", bio="[email protected]"),
)
assert Confidence.CONFLICTING not in ratings.values()