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
这是干什么用的?GHunt 是一个面向攻击用途的 Google 框架,专注于 OSINT,也就是围绕 Google 收集情报。作者表示,任何与 Google 相关的用途都有可能实现。
那它到底是命令行工具、Python 库,还是两者都是?两者都是:它自带一个带模块的命令行界面,同时也可以作为 Python 库导入使用。所有功能完全基于异步实现,结果可以导出为 JSON,还配有一个浏览器扩展来简化登录。
我怎么把它跑起来?先安装它,运行 'ghunt login' 并选择两种登录方式中的一种,然后通过 GHunt Companion 浏览器扩展完成身份验证——之后各模块就可以使用了。
在运行之前我需要先装好什么?只需要 Python 3.10 或更新版本。安装过程会在它自己的 venv 里管理依赖,所以不会和你其他 Python 项目冲突。
我可以拿它来做什么?作者把它限制在个人使用、刑事调查、渗透测试或开源项目范围内,并附有免责声明:该工具仅供教育用途。
这个许可证是常规的吗,还是附带了不少限制?它采用 AGPL 许可证,而且 README 强调你必须切实遵守——这不是那种可以随便对待的宽松许可证。
GHunt Companion 这个扩展是干什么用的?它用于完成登录流程:在你启动 'ghunt login' 之后,这个配套的浏览器扩展(在常见的扩展商店都能下载到)会接手身份验证,这样你就不用手动粘贴 cookie 了。
它到底能查些什么?README 列出了四个模块——email、gaia、drive 和 geolocate——每个模块都支持 --json 标志,可以直接把结果导出为 JSON。
我能在自己的 Python 代码里调用 GHunt 吗?可以,但要用 pip 而不是 pipx 来安装——pipx 的隔离 venv 会让你的项目无法导入它——然后直接 'import ghunt' 即可;作者在仓库里提供了文档和示例。
GHunt 现在还在积极开发吗?它已经到了第 2 版,最近新增了对 Python 3.13 的兼容;README 里还提到了一个与命令行版并行的 GHunt Online 在线版本。
What are similar projects?bbot, social-analyzer, phoneinfoga, theHarvester, maigret, OneForAll, spiderfoot, Photon
Which topics is it in?osint-framework, information-gathering, reconnaissance, osint, offensive-security, python-library, async, pentesting, google, agpl, security-tools, framework
Creator
mxrch
Size
0.5 MB
Stars
19.7K
Updated
CommitApr 10Releasev2.2.0Jun 06
Age
6y
Commits · 90 Days