{"id":27836,"library":"ghunt","title":"GHunt","description":"An offensive Google framework that provides modules to gather information from Google services. Current version 2.3.4, requires Python >=3.10. Released actively, with major refactors in v2.0.0 (async, CLI, library usage) and v2.1.0 (replaced cookies with OAuth token).","status":"active","version":"2.3.4","language":"python","source_language":"en","source_url":"https://github.com/mxrch/GHunt","tags":["google","osint","offensive security","async"],"install":[{"cmd":"pipx install ghunt","lang":"bash","label":"Recommended via pipx"},{"cmd":"pip install ghunt","lang":"bash","label":"Alternative via pip"}],"dependencies":[],"imports":[{"wrong":"from ghunt.core import GHuntLib","symbol":"GHuntLib","correct":"from ghunt import GHuntLib"}],"quickstart":{"code":"import asyncio\nfrom ghunt.auth import Auth\nfrom ghunt.core import GHuntLib\n\nasync def main():\n    auth = Auth()\n    await auth.load()  # loads existing credentials or starts OAuth flow\n    ghunt = GHuntLib(auth)\n    result = await ghunt.search(\"example@gmail.com\")\n    print(result)\n\nasyncio.run(main())","lang":"python","description":"Asynchronous example of using GHunt as a library. Requires authentication via OAuth (run `ghunt auth` first)."},"warnings":[{"fix":"Run `ghunt auth` to generate OAuth token. Remove any cookie files.","message":"v2.1.0 removed cookie-based authentication entirely. OAuth token is now required.","severity":"breaking","affected_versions":"<2.1.0"},{"fix":"Rewrite code to use async/await and the new library API. See GitHub README for migration.","message":"v2.0.0 refactored the entire library - async, new CLI, new API. All v1 scripts are incompatible.","severity":"breaking","affected_versions":"<2.0.0"},{"fix":"Check token expiry with `ghunt auth check` or reauthenticate before running modules.","message":"OAuth token (Android token) expires after a certain period. You must re-run `ghunt auth` periodically.","severity":"gotcha","affected_versions":">=2.1.0"},{"fix":"Use a personal Google account (not G Suite/Workspace with restrictions).","message":"Not all Google accounts work; GHunt requires an account with Google's 'multilogin' OAuth flow enabled (typically Android-style tokens).","severity":"gotcha","affected_versions":">=2.1.0"}],"env_vars":null,"search_vec":"'2.3.4':17 '3.10':20 'activ':22 'async':28,43 'cli':29 'cooki':35 'current':15 'framework':5 'gather':10 'ghunt':1 'googl':4,13,39 'inform':11 'librari':30 'major':24 'modul':8 'oauth':37 'offens':3,41 'osint':40 'provid':7 'python':19 'refactor':25 'releas':21 'replac':34 'requir':18 'secur':42 'servic':14 'token':38 'usag':31 'v2.0.0':27 'v2.1.0':33 'version':16","created_at":"2026-05-09T05:52:20.223880+00:00","updated_at":"2026-05-09T05:52:20.223880+00:00","problems":{"verify_error":"Traceback (most recent call last):\n  File \"<string>\", line 1, in <module>\nImportError: cannot import name 'GHuntLib' from 'ghunt' (/tmp/tmpon57emu1/venv/lib/python3.12/site-packages/ghunt/__init__.py)"},"ecosystem":"pypi","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":"ghunt","cli_version":"","type":"library","homepage":null,"github":"https://github.com/mxrch/GHunt","docs":null,"changelog":null,"pypi":"https://pypi.org/project/ghunt/","npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["gcp"],"base_url":null,"auth_type":null,"provenance":{"verified_status":"import_fail","verified_at":"2026-07-03","last_verified":"2026-07-03","next_check":"2026-07-10","install_tag":null}}