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] [email protected]

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 [email protected]
gravatar-recon [email protected] --json output.json

🤝 Contributing

Contributions are welcome! See CONTRIBUTING.md for details.