Skip to content
forked from mxrch/GHunt

๐Ÿ•ต๏ธโ€โ™‚๏ธ Offensive Google framework.

License

Notifications You must be signed in to change notification settings

0x67757300/GHunt

ย 
ย 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation


๐ŸŒ GHunt Online version : https://osint.industries


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
  • HTTP API

โœ”๏ธ 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 :

Firefoxย ย ย Chrome

Modules

Then, profit :

usage: ghunt [-h] {login,email,gaia,drive,web} ...

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.
    web     (--api)           Launch web app.

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

Sponsors

Thanks to these awesome people for supporting me !

BlWaspย ย C3n7ral051nt4g3ncyย ย rayanlecatย ย im-hanzouย ย gingeleskiย ย ItsMalwareย ย 


You like my work ?
Sponsor me on GitHub ! ๐Ÿค—

About

๐Ÿ•ต๏ธโ€โ™‚๏ธ Offensive Google framework.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 99.1%
  • Other 0.9%