🦅 HandleHawk

August 10, 2025 · View on GitHub

HandleHawk is a cross-platform username reconnaissance tool for OSINT analysts, CyberSecurity professionnals, Red Teamers, and CTF enthusiasts. It scans multiple social platforms to gather publicly available user information by just a single username input.

"Find the signal in the noise."

Code style: black

HandleHawk Logo

📁 Repository Structure

HandleHawk/
│
├── API_KEY/
│   └── twitter_api_key.txt      # Optional Twitter API Key file
│
├── handlehawk.py                # Main script
├── requirements.txt             # Python dependencies
├── README.md                    # Tool documentation
├── platforms/                   # External platform modules added after tool creation
│   ├── __init__.py              # Makes platforms a package
│   └── paypal.py                # PayPal Module
│   └── hudsonrock.py            # Hudson Rock Module
├── Assets/                      # Assets folder
    └── HandleHawk_Logo.png      # HandleHawk logo
    └── HandleHawk_small.png     # HandleHawk logo (small)
    └── Report_Sample[1].html    # HandleHawk report sample
    └── Report_Sample[2].html    # HandleHawk report sample
    └── Report_Sample[3].html    # HandleHawk report sample 
    └── test1.png                # Testing platforms before launch
    └── test2.png                # Testing platforms before launch
    └── HandleHawk-cyberguy.pdf  # Clean PDF report from html
    └── Bluesky_Logo.png
    └── Hudsonrock_Logo.png
    └── Mastodon_Logo.png
    └── Nostr_Logo.png
    └── Paypal_Logo.png
    └── Reddit_Logo.png
    └── Snapchat_Logo.png
    └── Truth-Social_Logo.png
    └── X_Logo.png

✔ Currently Supported Platforms

PlatformLogoSupported
BlueSkyBlueSky✅
Hudson RockHudson Rock✅
MastodonMastodon✅
NostrNostr✅
PayPalPayPal✅
RedditReddit✅
SnapchatSnapchat✅
TruthSocialNostr✅
X (Twitter)X/Twitter✅ + API

🚀 Features

  • 🔍 Scans multiple platforms:
    • Bluesky
    • Mastodon
    • Nostr
    • PayPal
    • Reddit
    • Snapchat
    • TruthSocial
    • Twitter (via optional RapidAPI)
  • 🥷🏻 Infostealer information from a username with the Hudson Rock module
  • 🛡️ Resilient to Cloudflare thanks to cloudscraper
  • 📄 Generates a clean, dark-mode HTML report
  • 🧠 Smart spinner for each check (UX-friendly)
  • 🔐 Optional Twitter API key (kept local)

🧠 Advanced Nostr Support

  • ✅ Supports pagination through all available pages of Nostr search results (up to hundreds of results!)
  • 🔁 Converts hex-encoded pubkeys to Nostr npub format using Bech32 encoding
  • 🔗 Generates accurate profile links: https://nostrapp.link/npub...
  • 📅 Displays account creation date and time in human-readable format

This allows HandleHawk to return all Nostr profiles that match a username, with rich metadata and clickable profile URLs — not just the first few!

📦 Installation

git clone https://github.com/C3n7ral051nt4g3ncy/HandleHawk.git
cd HandleHawk
pip install -r requirements.txt

🔑 Twitter API Key (Optional)

To enable Twitter checks (via RapidAPI), do the following:

  • Create a free account on Rapid API
  • Choose the free Twitter API plan (1000 requests per month) by Alexander Vikhorev
  • Paste your API key into the file twitter_api_key.txt
  • If no key is found, HandleHawk will skip X/Twitter and continue without errors

⚙️ Usage

Run the tool from terminal:

python3 handlehawk.py

https://github.com/user-attachments/assets/5c44834b-52dc-46b7-8b52-fc1d25f659fc

🛣️ Roadmap

A list of upcoming features and improvements planned for HandleHawk:

✅ v1.0 (Completed)

  • Core recon engine with spinner animations
  • Cross-platform username scanning for:
    • Reddit
    • Mastodon
    • Bluesky
    • TruthSocial
    • Nostr
    • Snapchat
  • Twitter (X) scanning via optional RapidAPI key
  • HTML report generator with profile summaries & images which does more than other username enumeration tools
  • Optional API_KEY/ folder for key management
  • User-agent spoofing & anti-bot headers

✅ v1.1 (Completed)

  • PayPal module added (platforms/paypal.py)
  • Extract PayPal full name, currency, and avatar
  • Refactored architecture to support modular platform checks
  • Improved HTML report with PayPal-specific display logic
  • Clean integration of external paypal.py instead of monolithic block

✅ v1.2 (Completed)

  • Hudson Rock module added to pull stealerinfo from a username module added (platforms/hudsonrock.py)

🧠 Planned for v1.3

  • CSV report export
  • JSON output for automation
  • Support for more platforms:
    • Threads
    • Facebook
    • Telegram
    • LinkedIn
    • YouTube
    • GitHub

👨‍💻 Author

Developed by C3n7ral051nt4g3ncy

💡 Suggestions?

  • Open an issue or start a discussion! Contributions and feature ideas are welcome 🦅
  • If you use HandleHawk in your investigations, feel free to give a ⭐️ or suggest a feature!