GitHub: https://github.com/mxrch/GHunt
Last Commit: June 6th, 2024
😊 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.
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 <email_address> --json user_data.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.
