An offensive Google framework.
Project description
🌐 GHunt Online version : https://osint.industries
😊 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.
Sponsors
Thanks to these awesome people for supporting me !
You like my work ?
Sponsor me on GitHub ! 🤗
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
Built Distribution
File details
Details for the file ghunt-2.1.6-py3-none-any.whl
.
File metadata
- Download URL: ghunt-2.1.6-py3-none-any.whl
- Upload date:
- Size: 85.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.0.0 CPython/3.11.7
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 39bf4c5c80d4858c4a7c9d66315a1eb86b64c440500da9e2d4226b89e6fe8843 |
|
MD5 | f09d97a8175ad87acdabc010d3b4059f |
|
BLAKE2b-256 | f94766c8f4e9979c91ae6f5c1e923cf9e68981850494117d9e1e9420714e707f |