gravatar_recon

README

Gravatar-Recon 👤

• 🧾 Project Overview
• 🚀 Features
• ⚠️ Disclaimer
• 📦 Installation
• 🧪 Usage
• 💡 Examples
• 🤝 Contributing

🧾 Project Overview

Retrieve and aggregate public OSINT data from Gravatar. Given an email address, the tool queries the Gravatar API and extracts useful information such as profile metadata, avatar, social accounts, and contact info.

🚀 Features

• Export results to JSON
• Fetch avatar directly
• Extract profile metadata:
  • Display name, bio, location, job, company
  • Public emails
  • Phone numbers
  • Contact forms, calendars
• Enumerate linked accounts (Twitter, GitHub, Mastodon, etc.)
• Parse profile background colors and styles

⚠️ Disclaimer

This tool is intended for educational purposes only. Use responsibly and ensure you have permission to access the data you are querying.

📦 Installation

With Go

go install github.com/anotherhadi/gravatar-recon@latest

With Nix/NixOS

Click to expand

From anywhere (using the repo URL):

nix run github:anotherhadi/gravatar-recon -- [--flags value] target_email

Permanent Installation:

# add the flake to your flake.nix
{
  inputs = {
    gravatar-recon.url = "github:anotherhadi/gravatar-recon";
  };
}

# then add it to your packages
environment.systemPackages = with pkgs; [ # or home.packages
  inputs.gravatar-recon.defaultPackage.${pkgs.system}
];

🧪 Usage

gravatar-recon [--flags value] target_email@example.com

Flags

-j, --json string     Write results to specified JSON file
-s, --silent          Suppress all non-essential output
-a, --print-avatar    Show the avatar in the output

💡 Examples

gravatar-recon myemail@gmail.com
gravatar-recon myemail@gmail.com --json output.json

🤝 Contributing

Contributions are welcome! See CONTRIBUTING.md for details.

Documentation

Index

• func GetGravatarProfiles(email string) (*[]GravatarProfile, error)
• type GravatarProfile

Functions

func GetGravatarProfiles

func GetGravatarProfiles(email string) (*[]GravatarProfile, error)

Types

type GravatarProfile

type GravatarProfile struct {
	Hash          string `json:"hash"`
	ProfileURL    string `json:"profileUrl"`
	PreferredUser string `json:"preferredUsername"`
	ThumbnailURL  string `json:"thumbnailUrl"`

	Photos []struct {
		Value string `json:"value"`
		Type  string `json:"type"`
	} `json:"photos"`

	DisplayName     string `json:"displayName"`
	Pronunciation   string `json:"pronunciation"`
	Pronouns        string `json:"pronouns"`
	AboutMe         string `json:"aboutMe"`
	CurrentLocation string `json:"currentLocation"`
	JobTitle        string `json:"job_title"`
	Company         string `json:"company"`

	PhoneNumbers []struct {
		Type  string `json:"type"`
		Value string `json:"value"`
	} `json:"phoneNumbers"`

	ContactInfo []struct {
		Type  string `json:"type"`
		Value string `json:"value"`
	} `json:"contactInfo"`

	Emails []struct {
		Primary string `json:"primary"`
		Value   string `json:"value"`
	} `json:"emails"`

	Accounts []struct {
		Domain    string `json:"domain"`
		Display   string `json:"display"`
		URL       string `json:"url"`
		IconURL   string `json:"iconUrl"`
		IsHidden  bool   `json:"is_hidden"`
		Username  string `json:"username"`
		Verified  bool   `json:"verified"`
		Name      string `json:"name"`
		Shortname string `json:"shortname"`
	} `json:"accounts"`

	ProfileBackground struct {
		Color        string  `json:"color"`
		Opacity      float64 `json:"opacity"`
		Size         int     `json:"size"`
		PrimaryColor string  `json:"primary_color"`
		SurfaceColor string  `json:"surface_color"`
	} `json:"profileBackground"`
}