# GHunt: An Offensive Google Framework for OSINT and Data Collection

This repository profile is provided by osrepos.com, an open source repository discovery platform.

Source: osrepos.com
Repository profile: https://osrepos.com/repo/mxrch-ghunt
Generated for open source discovery and AI-assisted research.

GHunt is a powerful Python-based offensive Google framework primarily focused on Open-Source Intelligence (OSINT), designed for efficient evolution. It offers robust CLI usage, Python library integration, and fully asynchronous operations, making it a versatile tool for gathering information related to Google services. With features like JSON export and a companion browser extension for streamlined login, GHunt simplifies the process of digital data collection.

GitHub: https://github.com/mxrch/GHunt
OSRepos URL: https://osrepos.com/repo/mxrch-ghunt

## Summary

GHunt is a powerful Python-based offensive Google framework primarily focused on Open-Source Intelligence (OSINT), designed for efficient evolution. It offers robust CLI usage, Python library integration, and fully asynchronous operations, making it a versatile tool for gathering information related to Google services. With features like JSON export and a companion browser extension for streamlined login, GHunt simplifies the process of digital data collection.

## Topics

- google
- osint
- python
- security
- framework
- cli
- reconnaissance
- hideandsec

## Repository Information

Last analyzed by OSRepos: Sat May 16 2026 00:23:15 GMT+0100 (Western European Summer Time)
Detail views: 4
GitHub clicks: 11

## Safety Notice

OSRepos shares public repositories for knowledge and discovery only. Review source code, dependencies, licenses, and security implications before running or installing anything.

## Content

## Introduction

GHunt (v2) is an advanced offensive Google framework, meticulously designed to evolve efficiently within the realm of digital reconnaissance. While its primary focus is on Open-Source Intelligence (OSINT), its flexible architecture allows for various other applications related to Google services. This powerful tool provides a comprehensive suite of features, including command-line interface (CLI) usage with modular capabilities, integration as a Python library for custom projects, and fully asynchronous operations for enhanced performance. It also supports JSON export for easy data handling and includes a browser extension to simplify the login process.

GHunt requires Python version 3.10 or higher to run effectively.

## Installation

To install GHunt, it is recommended to use `pipx`, which automatically manages virtual environments to prevent dependency conflicts with other projects. Follow these steps:

bash
$ pip3 install pipx
$ pipx ensurepath
$ pipx install ghunt


For developers who wish to use GHunt as a library within their Python projects, `pipx` is not suitable due to its use of virtual environments. In this case, you should install GHunt directly with `pip`:

bash
$ pip3 install ghunt


This will allow you to `import ghunt` in your projects and leverage its functionalities programmatically.

## Examples

### Login

Before utilizing GHunt's modules, you need to authenticate it with Google. Launch the listener and choose one of the first two 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 the GHunt Companion browser extension to complete the login. The extension is available for:

*   [Firefox](https://addons.mozilla.org/en-US/firefox/addon/ghunt-companion/){:target="_blank"}
*   [Chrome](https://chrome.google.com/webstore/detail/ghunt-companion/dpdcofblfbmmnikcbmmiakkclocadjab){:target="_blank"}

### Modules

Once logged in, you can explore GHunt's various modules:

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 export the output of modules like `email`, `gaia`, `drive`, and `geolocate` to JSON using the `--json` flag. For example:

bash
$ ghunt email <email_address> --json user_data.json


## Why Use GHunt

GHunt stands out as an invaluable tool for anyone involved in OSINT or digital investigations due to several key advantages:

*   **Powerful OSINT Capabilities**: It provides a dedicated framework for gathering information from Google, a vast source of public data.
*   **Flexibility**: Whether you prefer command-line operations or integrating functionalities into your Python projects, GHunt offers both options.
*   **Modern Architecture**: Being fully asynchronous and compatible with Python 3.10+, it ensures efficient and up-to-date performance.
*   **Ease of Use**: The companion browser extension significantly simplifies the often complex Google login process.
*   **Structured Data Output**: The ability to export data in JSON format makes it easy to parse, store, and integrate collected information into other tools or databases.

## Links

*   **GitHub Repository**: [https://github.com/mxrch/GHunt](https://github.com/mxrch/GHunt){:target="_blank"}
*   **GHunt Online Version**: [https://osint.industries](https://osint.industries){:target="_blank"}
*   **Firefox Companion Extension**: [https://addons.mozilla.org/en-US/firefox/addon/ghunt-companion/](https://addons.mozilla.org/en-US/firefox/addon/ghunt-companion/){:target="_blank"}
*   **Chrome Companion Extension**: [https://chrome.google.com/webstore/detail/ghunt-companion/dpdcofblfbmmnikcbmmiakkclocadjab](https://chrome.google.com/webstore/detail/ghunt-companion/dpdcofblfbmmnikcbmmiakkclocadjab){:target="_blank"}
*   **Documentation (Wiki)**: [https://github.com/mxrch/GHunt/wiki](https://github.com/mxrch/GHunt/wiki){:target="_blank"}
*   **Examples**: [https://github.com/mxrch/GHunt/tree/master/examples](https://github.com/mxrch/GHunt/tree/master/examples){:target="_blank"}