Here is the markdown description:

GHunt Online version : https://osint.industries

Now Python 3.13 compatible !

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-encrypted cookies
[3] Enter manually all cookies
Choice =>

Then, use GHunt Companion to complete the login.

Modules

Then, profit :

Usage: ghunt [-h] {login, email, gaia, drive, geolocate} ...
Positional Arguments:
    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 <email_address> --json user_data.json

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 !

> Visit GHunt Website <