mirror of
https://github.com/anotherhadi/gravatar-recon.git
synced 2026-10-05 19:28:25 +02:00
101 lines
2.6 KiB
Markdown
101 lines
2.6 KiB
Markdown
# Gravatar-Recon 👤
|
|
|
|
<p>
|
|
<a href="https://github.com/anotherhadi/gravatar-recon/releases"><img src="https://img.shields.io/github/release/anotherhadi/gravatar-recon.svg" alt="Latest Release"></a>
|
|
<a href="https://pkg.go.dev/github.com/anotherhadi/gravatar-recon?tab=doc"><img src="https://godoc.org/github.com/anotherhadi/gravatar-recon?status.svg" alt="GoDoc"></a>
|
|
<a href="https://goreportcard.com/report/github.com/anotherhadi/gravatar-recon"><img src="https://goreportcard.com/badge/github.com/anotherhadi/gravatar-recon" alt="GoReportCard"></a>
|
|
</p>
|
|
|
|
- [🧾 Project Overview](#-project-overview)
|
|
- [🚀 Features](#-features)
|
|
- [⚠️ Disclaimer](#%EF%B8%8F-disclaimer)
|
|
- [📦 Installation](#-installation)
|
|
- [🧪 Usage](#-usage)
|
|
- [💡 Examples](#-examples)
|
|
- [🤝 Contributing](#-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
|
|
|
|
```bash
|
|
go install github.com/anotherhadi/gravatar-recon@latest
|
|
```
|
|
|
|
### With Nix/NixOS
|
|
|
|
<details>
|
|
<summary>Click to expand</summary>
|
|
|
|
**From anywhere (using the repo URL):**
|
|
|
|
```bash
|
|
nix run github:anotherhadi/gravatar-recon -- [--flags value] target_email
|
|
```
|
|
|
|
**Permanent Installation:**
|
|
|
|
```bash
|
|
# 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}
|
|
];
|
|
```
|
|
|
|
</details>
|
|
|
|
## 🧪 Usage
|
|
|
|
```bash
|
|
gravatar-recon [--flags value] [email protected]
|
|
```
|
|
|
|
### Flags
|
|
|
|
```txt
|
|
-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
|
|
|
|
```bash
|
|
gravatar-recon [email protected]
|
|
gravatar-recon [email protected] --json output.json
|
|
```
|
|
|
|
## 🤝 Contributing
|
|
|
|
Contributions are welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for details.
|