sociopath

README

sociopath

Go library and CLI for fetching social media profiles across 65+ platforms.

Install

go install github.com/codeGROOVE-dev/sociopath/cmd/sociopath@latest

Usage

sociopath https://github.com/torvalds         # Fetch profile
sociopath -r https://linktr.ee/johndoe        # Follow social links recursively
sociopath --guess torvalds                    # Discover profiles by username
sociopath --email user@example.com            # Look up by email (Gravatar, etc.)

Options

Flag	Description
-r	Follow social links recursively (max depth: 3)
--guess	Discover related profiles on other platforms
--email	Look up profiles by email address
--browser	Extract cookies from browser for authenticated platforms
--no-cache	Disable HTTP caching (default: 75-day TTL)
-v, --debug	Enable verbose logging

Platforms

Developer: GitHub, GitLab, Codeberg, Sourcehut, Gitee, StackOverflow, HackerNews, Lobsters, Dev.to, Hashnode, Qiita, Zenn, Velog, CSDN, Juejin, V2EX, Crates.io, DockerHub, HexPM, npm, PyPI, RubyGems, LeetCode, Exercism, Kaggle, CodePen, FreeCodeCamp, Replit, HackerOne, Bugcrowd, TryHackMe, ORCID, HuggingFace, Keybase, Sessionize, SlideShare

Social: Twitter/X*, LinkedIn*, Instagram*, TikTok*, Mastodon, BlueSky, Reddit, VKontakte, Weibo, Micro.blog, Telegram

Content: YouTube, Twitch, Bilibili, Medium, Substack, Habr

Other: Linktree, Gravatar, Google, Steam, Strava, Goodreads, Douban, Dribbble, Holopin, IntenseDebate, Disqus, ArsTechnica, Mail.ru

* Requires --browser flag for authentication

Output

JSON to stdout:

{
  "Platform": "github",
  "URL": "https://github.com/torvalds",
  "Username": "torvalds",
  "Name": "Linus Torvalds"
}

Guessed profiles include confidence scores and match reasons.

Library

import "github.com/codeGROOVE-dev/sociopath/pkg/sociopath"

profiles, _ := sociopath.FetchRecursiveWithGuess(ctx, url, sociopath.WithBrowserCookies())
for _, p := range profiles {
    fmt.Printf("%s (%.0f%% confidence)\n", p.URL, p.Confidence*100)
}