Skip to main content

An offensive Google framework.

Project description


🌐 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

✔️ 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} ...

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

Sponsors

Thanks to these awesome people for supporting me !

BlWasp  C3n7ral051nt4g3ncy  im-hanzou  gingeleski  ItsMalware  


You like my work ?
Sponsor me on GitHub ! 🤗

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

ghunt-2.1.6-py3-none-any.whl (85.2 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page