GHunt (v2) is an offensive Google OSINT framework used for gathering intel from Google services. Fast, async, modular — and now super easy to set up with this tested setup guide.

• Python >= 3.10
• Works perfectly on Kali Linux (tested)

Kali normally has Python preinstalled. Still, ensure compatibility:

sudo apt install python-is-python3 -y
sudo apt install python3-pip -y

pip3 install pipx
pipx ensurepath

If you see "externally-managed-environment" error, ignore — pipx still installs.

pipx install ghunt --force

After installation, confirm:

ghunt --version

Run:

ghunt login

You’ll see menu options:

[1] (Companion) Put GHunt on listening mode
[2] (Companion) Paste base64 encoded cookies
[3] Enter oauth token manually
[4] Enter master token manually

GHunt will say:

GHunt is listening on port 60067...

Install from:

• Firefox
• Chrome
• Edge
• Opera

Then extension automatically sends cookies.

You will see:

[+] Received cookies!
[+] Got OAuth2 token
[+] Master token generated and saved

All credentials saved here:

~/.malfrats/ghunt/creds.m

Your GHunt is now fully authenticated.

ghunt email <email_here>

Shows:

• DP / cover pic status
• Active Google services
• Calendar events
• Maps contribution
• PlayGames info
• Gaia ID
• Much more…

Use for Google URLs:

ghunt spider <google_link>

Works on:

• Maps profiles
• Photos share links
• People cards
• YouTube channels
• MyMaps

ghunt drive <file_or_folder_id>

ghunt geolocate <bssid>

ghunt email <email> --json output.json

ghunt email [email protected]

Output included:

• Default profile pics
• Gaia ID
• Activated services (Maps, Photos, Meet)
• Public Google Calendar
• 81 events dumped
• Maps profile link

https://www.google.com/maps/contrib/<gaia_id>/reviews

Everything worked perfectly.

Docs: https://github.com/mxrch/GHunt/wiki

If you want to use GHunt as a library:

pip3 install ghunt

Then:

import ghunt

• Educational purposes only.
• Respect the AGPL license.
• Use responsibly.

Nitin (@nitinscodehub) Cybersecurity & OSINT Enthusiast GitHub: https://github.com/nitinscodehub