What is this?
GHunt is an offensive Google framework geared toward OSINT — collecting intelligence around Google — and its authors note that any Google-related use is possible.
GHunt is an offensive Google framework geared toward OSINT — collecting intelligence around Google — and its authors note that any Google-related use is possible.So is it a CLI tool, a Python library, or both?Both: it ships a CLI with modules and doubles as an importable Python library. Everything is fully async, results can be exported to JSON, and a browser extension eases the login.
Both: it ships a CLI with modules and doubles as an importable Python library. Everything is fully async, results can be exported to JSON, and a browser extension eases the login.How do I get it running?Install it, run 'ghunt login' and pick one of the two login methods, then complete authentication with the GHunt Companion browser extension — after that the modules are ready to use.
Install it, run 'ghunt login' and pick one of the two login methods, then complete authentication with the GHunt Companion browser extension — after that the modules are ready to use.What do I need to have installed before it will run?Just Python 3.10 or newer. The installation manages dependencies inside its own venv, so it won't clash with your other Python projects.
Just Python 3.10 or newer. The installation manages dependencies inside its own venv, so it won't clash with your other Python projects.What am I allowed to use it for?The author limits it to personal use, criminal investigations, pentesting, or open-source projects, with the disclaimer that the tool is for educational purposes only.
The author limits it to personal use, criminal investigations, pentesting, or open-source projects, with the disclaimer that the tool is for educational purposes only.Is the licence standard, or does it come with strings attached?It's AGPL, and the README insists you actually respect it — this is not a casual permissive licence.
It's AGPL, and the README insists you actually respect it — this is not a casual permissive licence.What is the GHunt Companion extension for?It completes the login flow: after you start 'ghunt login', the companion browser extension — available from the usual stores — hands over the authentication so you don't have to paste cookies manually.
It completes the login flow: after you start 'ghunt login', the companion browser extension — available from the usual stores — hands over the authentication so you don't have to paste cookies manually.What can it actually look into?The README names four modules — email, gaia, drive and geolocate — and each of them supports the --json flag so you can export results straight to JSON.
The README names four modules — email, gaia, drive and geolocate — and each of them supports the --json flag so you can export results straight to JSON.Can I use GHunt from my own Python code?Yes, but install it with pip rather than pipx — pipx's isolated venv would make the import unreachable from your project — then just 'import ghunt'; the author keeps docs and examples in the repo.
Yes, but install it with pip rather than pipx — pipx's isolated venv would make the import unreachable from your project — then just 'import ghunt'; the author keeps docs and examples in the repo.Is GHunt still actively developed?It's on version 2 and recently gained Python 3.13 compatibility; the README also mentions a GHunt Online version alongside the CLI.
It's on version 2 and recently gained Python 3.13 compatibility; the README also mentions a GHunt Online version alongside the CLI.What are similar projects?bbot, social-analyzer, phoneinfoga, theHarvester, maigret, OneForAll, spiderfoot, Photon
bbot, social-analyzer, phoneinfoga, theHarvester, maigret, OneForAll, spiderfoot, PhotonWhich topics is it in?osint-framework, information-gathering, reconnaissance, osint, offensive-security, python-library, async, pentesting, google, agpl, security-tools, framework
osint-framework, information-gathering, reconnaissance, osint, offensive-security, python-library, async, pentesting, google, agpl, security-tools, framework