mxrch /GHunt

🕵️‍♂️ Offensive Google framework.

★ 19,851⑂ 1,752👁 560⑃ 114● 444▤ 3
PythonNOASSERTIONCreated 2020-10-02
下载:v2.2.0v2.2.0 ↓2.2.02024-06-06
+2
日增长
19,851
stars
1,752
forks
560
watchers
114
prs
444
issues
3
releases

README

!



 🌐 GHunt Online version : https://osint.industries
 🐍 Now Python 3.13 compatible !



!Python minimum version

 😊 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

bash
$ 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 :
bash
$ 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 :
bash
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 :

bash
$ ghunt email  --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 :
bash
$ 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.

 Sponsors

Thanks to these awesome people for supporting me !

    

\
You like my work ?\
Sponsor me on GitHub ! 🤗

Top issues

Discussions

Latest release

v2.2.0 v2.2.0 2024-06-06
New module !
📍🗺️ Releasing the geolocate module, that lets you geolocate a BSSID.
No API key required !

 Update

pipx upgrade ghunt 🥰

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON