😊 Description

GHunt (v2) is an offensive Google framework, designed to evolve efficiently.\ It's currently focused on OSINT, but any use related with Google is possible.

Features :

CLI usage and modules
Python library usage
Fully async
JSON export
Browser extension to ease login

✔️ Requirements

Python >= 3.10

⚙️ Installation

$ pip3 install pipx
$ pipx ensurepath
$ pipx install ghunt

It will automatically use venvs to avoid dependency conflicts with other projects.

💃 Usage

Login

First, launch the listener by doing ghunt login and choose between 1 of the 2 first methods :

$ ghunt login
[1] (Companion) Put GHunt on listening mode (currently not compatible with docker) [2] (Companion) Paste base64-encoded cookies [3] Enter manually all cookies
Choice =>

Then, use GHunt Companion to complete the login.

The extension is available on the following stores :\ \

Modules

Then, profit :

Usage: ghunt [-h] {login,email,gaia,drive,geolocate} ... Positional Arguments: {login,email,gaia,drive,geolocate} login Authenticate GHunt to Google. email Get information on an email address. gaia Get information on a Gaia ID. drive Get information on a Drive file or folder. geolocate Geolocate a BSSID. spiderdal Find assets using Digital Assets Links.

Options: -h, --help show this help message and exit

📄 You can also use --json with email, gaia, drive and geolocate modules to export in JSON ! Example :

$ ghunt email <emailaddress> --json userdata.json

Have fun 🥰💞

🧑‍💻 Developers

📕 I started writing some docs here and examples here, feel free to contribute !

To use GHunt as a lib, you can't use pipx because it uses a venv.\ So you should install GHunt with pip :

$ pip3 install ghunt

And now, you should be able to import ghunt in your projects !\ You can right now play with the examples.

📮 Details

Obvious disclaimer

This tool is for educational purposes only, I am not responsible for its use.

Less obvious disclaimer

This project is under AGPL Licence, and you have to respect it.\ Use it only in personal, criminal investigations, pentesting, or open-source projects.

Thanks

novitae for being my Python colleague
All the people on Malfrats Industries and elsewhere for the beta test !
The HideAndSec team 💗 (blog : https://hideandsec.sh)
Med Amine Jouini for his beautiful rework of the Google logo, which I was inspired by a lot.