GHunt README

The project's README from github.com/mxrch/GHunt. As one markdown file: README.md.


🌐 GHunt Online version : https://osint.industries

🐍 Now Python 3.13 compatible !


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 :

✔️ Requirements

⚙️ 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,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 use --json with email, gaia, drive and geolocate 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  gingeleski  


You like my work ?
Sponsor me on GitHub ! 🤗

GHunt (mxrch/GHunt)

Searching Database…

19.7K ·GitHub
Что это такое?GHunt — это фреймворк для атак на Google, заточенный под OSINT, то есть сбор разведывательной информации вокруг Google. Авторы отмечают, что можно работать с чем угодно, что связано с Google.
Так это CLI-утилита, Python-библиотека или и то и другое?И то и другое: в комплекте идёт CLI с модулями, и при этом GHunt можно импортировать как Python-библиотеку. Всё полностью асинхронно, результаты можно выгружать в JSON, а для входа есть браузерное расширение.
Как его запустить?Установите его, запустите 'ghunt login', выберите один из двух способов входа и завершите аутентификацию через браузерное расширение GHunt Companion — после этого модули готовы к работе.
Что должно быть установлено, чтобы он заработал?Нужен только Python 3.10 или новее. Установка сама раскладывает зависимости в отдельный venv, так что с другими вашими Python-проектами конфликтов не будет.
Для чего его можно использовать?Автор разрешает только личное использование, уголовные расследования, пентесты и open-source проекты, с оговоркой, что инструмент создан исключительно в образовательных целях.
Лицензия стандартная или с подвохом?Это AGPL, и README прямо настаивает, что её нужно соблюдать — это не какая-нибудь разрешительная лицензия на все руки.
Зачем нужно расширение GHunt Companion?Оно довершает процесс входа: после запуска 'ghunt login' расширение GHunt Companion — его можно скачать из обычных магазинов расширений — передаёт данные аутентификации, так что вручную вставлять куки не приходится.
Что он вообще может смотреть?В README перечислены четыре модуля — email, gaia, drive и geolocate — и у каждого поддерживается флаг --json, чтобы выгружать результаты прямо в JSON.
Могу ли я использовать GHunt из своего Python-кода?Да, но устанавливайте через pip, а не pipx — изолированный venv у pipx сделает импорт недоступным из вашего проекта, — а дальше просто 'import ghunt'; документацию и примеры автор держит в репозитории.
GHunt ещё развивается?Проект вышел на вторую версию и недавно получил совместимость с Python 3.13; в README также упоминается версия GHunt Online наряду с CLI.
Creator
mxrch
Size
0.5 MB
Stars
19.7K
Age
6y
Commits · 90 Days