😊 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} ...

positional arguments:
  {login,email,gaia,drive}
    login   (--clean)         Authenticate GHunt to Google.
    email   (--json)          Get information on an email address.
    gaia    (--json)          Get information on a Gaia ID.
    drive   (--json)          Get information on a Drive file or folder.

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

📄 You can also use --json with email, gaia and drive 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.

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.

Project Name	Stars	Repos Using This	Packages Using This	Most Recent Commit	Total Releases	Latest Release	Open Issues	License	Language
Ghunt	13,666			3 days ago			16	other	Python
🕵️‍♂️ Offensive Google framework.
Degoogle	6,749			25 days ago			58	cc-by-4.0
A huge list of alternatives to Google products. Privacy tips, tricks, and links.
Udork	613			a year ago			1		Shell
uDork is a script written in Bash Scripting that uses advanced Google search techniques to obtain sensitive information in files or directories, find IoT devices, detect versions of web applications, and so on.
Geektime Dl	484		2	7 months ago	11	January 29, 2021	42	mit	Go
👾 Geektime-dl 是使用Go构建的快速、简单的极客时间下载器，支持专栏下载为PDF文档。
Nginx Google Oauth	405			3 years ago			15	mit	Lua
Lua module to add Google OAuth to nginx
Contain Google	386			3 months ago			47	mpl-2.0	JavaScript
[Looking for maintainer] - Google Container isolates your Google activity from the rest of your web activity in order to prevent Google from tracking you outside of the Google website via third party cookies.
Google Authenticator	285	4		2 months ago	23	July 02, 2018	4	mit	Ruby
Ruby gem to implement Google's MFA authenticator
Google Group Crawler	213			a year ago			6		Shell
[Deprecated] Get (almost) original messages from google group archives. Your data is yours.
Pixic	119			2 months ago			3	mit	Python
Pixiv插画批量下载，提供关注画师插画、收藏作品下载（单/多/动图）及API - pixiv爬虫
Galocalstorage	116	4		5 years ago		February 22, 2021	19		JavaScript
A google analytics version that works with localstorage instead of cookies for webviews usage (deprecated)

Ghunt