How mxrch/ghunt works
GHunt is an async Google OSINT framework, exposed as CLI commands and a Python library. The main workflow is to authenticate, investigate a target through a domain module, query Google APIs, parse responses, and present or optionally export findings. The graph preserves the documented email, Gaia ID, Drive, geolocation, and Digital Assets Links capabilities, plus shared API, credential, and knowledge layers. Connections for unsampled modules rely on the README or SOURCE INDEX references; uncertain runtime details are omitted.
Main entry points: cli.py CLI commands · apis.py API request runtime · email.py Email lookup · drive.py Drive lookup
Components 21
User interface
- CLI commands
ghunt/cli.py
Authentication
- Login flow
ghunt/modules/login.py - Credential auth
ghunt/helpers/auth.py - Credential model
ghunt/objects/base.py
Investigations
- Email lookup
ghunt/modules/email.py - Gaia lookup
ghunt/modules/gaia.py - Drive lookup
ghunt/modules/drive.py - BSSID geolocation
ghunt/modules/geolocate.py - Asset-link search
ghunt/modules/spiderdal.py - Maps enrichment
ghunt/helpers/gmaps.py
Google API access
- Drive API
ghunt/apis/drive.py - People API
ghunt/apis/peoplepa.py - Vision API
ghunt/apis/vision.py - Client auth config
ghunt/apis/clientauthconfig.py - Digital asset links
ghunt/apis/digitalassetslinks.py
Shared runtime
- API request runtime
ghunt/objects/apis.py - Drive parser
ghunt/parsers/drive.py - Reference knowledge
ghunt/helpers/knowledge.py - Async HTTP client
ghunt/lib/httpx.py
Other components
- Operator
- Google services
Connections 27
- Operator → CLI commands: runs commands
README.md - CLI commands → Login flow: dispatches login
ghunt/cli.py - CLI commands → Email lookup: dispatches lookup
ghunt/cli.py - CLI commands → Gaia lookup: dispatches lookup
ghunt/cli.py - CLI commands → Drive lookup: dispatches lookup
ghunt/cli.py - CLI commands → BSSID geolocation: dispatches lookup
ghunt/cli.py - CLI commands → Asset-link search: dispatches search
README.md - Login flow → Credential auth: loads authentication
ghunt/modules/login.py - Credential auth → Credential model: updates credentials
ghunt/helpers/auth.py - Email lookup → Credential auth: authenticates
ghunt/modules/email.py - Email lookup → People API: looks up people
ghunt/modules/email.py - Email lookup → Vision API: queries vision
ghunt/modules/email.py - Email lookup → Maps enrichment: enriches with Maps
ghunt/modules/email.py - Gaia lookup → People API: queries profiles
ghunt/modules/gaia.py - Gaia lookup → Maps enrichment: enriches with Maps
ghunt/modules/gaia.py - Drive lookup → Credential auth: authenticates
ghunt/modules/drive.py - Drive lookup → Drive API: fetches Drive data
ghunt/modules/drive.py - Drive lookup → Client auth config: looks up app brand
ghunt/modules/drive.py - Asset-link search → Digital asset links: queries asset links
ghunt/modules/spiderdal.py - Drive API → Drive parser: parses responses
ghunt/apis/drive.py - Drive API → Reference knowledge: uses Drive knowledge
ghunt/apis/drive.py - Drive API → API request runtime: uses API runtime
ghunt/apis/drive.py - People API → API request runtime: uses API runtime
ghunt/apis/peoplepa.py - Vision API → API request runtime: uses API runtime
ghunt/apis/vision.py - Client auth config → API request runtime: uses API runtime
ghunt/apis/clientauthconfig.py - API request runtime → Async HTTP client: sends requests
ghunt/objects/apis.py - API request runtime → Google services: calls Google APIs
ghunt/objects/apis.py