{"id":13459198,"url":"https://github.com/mxrch/GHunt","last_synced_at":"2025-03-24T16:31:24.899Z","repository":{"id":37240285,"uuid":"300592907","full_name":"mxrch/GHunt","owner":"mxrch","description":"🕵️‍♂️ Offensive Google framework.","archived":false,"fork":false,"pushed_at":"2025-02-05T15:33:39.000Z","size":497,"stargazers_count":16277,"open_issues_count":64,"forks_count":1372,"subscribers_count":526,"default_branch":"master","last_synced_at":"2025-03-18T01:33:16.850Z","etag":null,"topics":["google","hideandsec","osint"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mxrch.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"mxrch"}},"created_at":"2020-10-02T11:26:03.000Z","updated_at":"2025-03-18T00:34:47.000Z","dependencies_parsed_at":"2023-02-11T06:05:18.995Z","dependency_job_id":"f386b5e3-dc26-420a-aa3f-b5ae8d701918","html_url":"https://github.com/mxrch/GHunt","commit_stats":{"total_commits":260,"total_committers":32,"mean_commits":8.125,"dds":0.6115384615384616,"last_synced_commit":"66d640535d9c248f6e6d33ddb52e943e64a3733a"},"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mxrch%2FGHunt","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mxrch%2FGHunt/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mxrch%2FGHunt/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mxrch%2FGHunt/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mxrch","download_url":"https://codeload.github.com/mxrch/GHunt/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245308595,"owners_count":20594274,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["google","hideandsec","osint"],"created_at":"2024-07-31T09:01:09.977Z","updated_at":"2025-03-24T16:31:24.885Z","avatar_url":"https://github.com/mxrch.png","language":"Python","funding_links":["https://github.com/sponsors/mxrch"],"categories":["Python","1. [↑](#-content) OSINT","Uncategorized","Python (1887)","[↑](#-table-of-contents) E-mail Search / E-mail Check","GOOGLE","[↑](#-Table-of-Contents) E-mail Search / E-mail Check","[](#table-of-contents) Table of contents","Repos","osint","[↑](#-table-of-contents) Email Search / Email Check","Tools by Category","OSINT Automation","google","Table of Contents","🔧 Utilities \u0026 Miscellaneous"],"sub_categories":["Uncategorized","[↑](#-table-of-contents) Telegram","[↑](#-Table-of-Contents) Telegram","[](#google)Google","[↑](#-table-of-contents) GitHub","📧 Email Investigation","🕵️ OSINT"],"readme":"![](assets/long_banner.png)\n\n\u003cbr\u003e\n\n#### 🌐 GHunt Online version : https://osint.industries\n#### 🐍 Now Python 3.13 compatible !\n\n\u003cbr\u003e\n\n![Python minimum version](https://img.shields.io/badge/Python-3.10%2B-brightgreen)\n\n# 😊 Description\n\nGHunt (v2) is an offensive Google framework, designed to evolve efficiently.\\\nIt's currently focused on OSINT, but any use related with Google is possible.\n\nFeatures :\n- CLI usage and modules\n- Python library usage\n- Fully async\n- JSON export\n- Browser extension to ease login\n\n# ✔️ Requirements\n- Python \u003e= 3.10\n\n# ⚙️ Installation\n\n```bash\n$ pip3 install pipx\n$ pipx ensurepath\n$ pipx install ghunt\n```\nIt will automatically use venvs to avoid dependency conflicts with other projects.\n\n# 💃 Usage\n\n## Login\n\nFirst, launch the listener by doing `ghunt login` and choose between 1 of the 2 first methods :\n```bash\n$ ghunt login\n\n[1] (Companion) Put GHunt on listening mode (currently not compatible with docker)\n[2] (Companion) Paste base64-encoded cookies\n[3] Enter manually all cookies\n\nChoice =\u003e\n```\n\nThen, use GHunt Companion to complete the login.\n\nThe extension is available on the following stores :\\\n\\\n[![Firefox](https://files.catbox.moe/5g2ld5.png)](https://addons.mozilla.org/en-US/firefox/addon/ghunt-companion/)\u0026nbsp;\u0026nbsp;\u0026nbsp;[![Chrome](https://storage.googleapis.com/web-dev-uploads/image/WlD8wC6g8khYWPJUsQceQkhXSlv1/UV4C4ybeBTsZt43U4xis.png)](https://chrome.google.com/webstore/detail/ghunt-companion/dpdcofblfbmmnikcbmmiakkclocadjab)\n\n## Modules\n\nThen, profit :\n```bash\nUsage: ghunt [-h] {login,email,gaia,drive,geolocate} ...\n\nPositional Arguments:\n  {login,email,gaia,drive,geolocate}\n    login               Authenticate GHunt to Google.\n    email               Get information on an email address.\n    gaia                Get information on a Gaia ID.\n    drive               Get information on a Drive file or folder.\n    geolocate           Geolocate a BSSID.\n    spiderdal           Find assets using Digital Assets Links.\n\nOptions:\n  -h, --help            show this help message and exit\n```\n\n📄 You can also use --json with email, gaia, drive and geolocate modules to export in JSON ! Example :\n\n```bash\n$ ghunt email \u003cemail_address\u003e --json user_data.json\n```\n\n**Have fun 🥰💞**\n\n# 🧑‍💻 Developers\n\n📕 I started writing some docs [here](https://github.com/mxrch/GHunt/wiki) and examples [here](https://github.com/mxrch/GHunt/tree/master/examples), feel free to contribute !\n\nTo use GHunt as a lib, you can't use pipx because it uses a venv.\\\nSo you should install GHunt with pip :\n```bash\n$ pip3 install ghunt\n```\n\nAnd now, you should be able to `import ghunt` in your projects !\\\nYou can right now play with the [examples](https://github.com/mxrch/GHunt/tree/master/examples).\n\n# 📮 Details\n\n## Obvious disclaimer\n\nThis tool is for educational purposes only, I am not responsible for its use.\n\n## Less obvious disclaimer\n\nThis project is under [AGPL Licence](https://choosealicense.com/licenses/agpl-3.0/), and you have to respect it.\\\n**Use it only in personal, criminal investigations, pentesting, or open-source projects.**\n\n## Thanks\n\n- [novitae](https://github.com/novitae) for being my Python colleague\n- All the people on [Malfrats Industries](https://discord.gg/sg2YcrC6x9) and elsewhere for the beta test !\n- The HideAndSec team 💗 (blog : https://hideandsec.sh)\n- [Med Amine Jouini](https://dribbble.com/jouiniamine) for his beautiful rework of the Google logo, which I was inspired by *a lot*.\n\n## Sponsors\n\nThanks to these awesome people for supporting me !\n\n\u003c!-- sponsors --\u003e\u003ca href=\"https://github.com/BlWasp\"\u003e\u003cimg src=\"https://github.com/BlWasp.png\" width=\"50px\" alt=\"BlWasp\" /\u003e\u003c/a\u003e\u0026nbsp;\u0026nbsp;\u003ca href=\"https://github.com/gingeleski\"\u003e\u003cimg src=\"https://github.com/gingeleski.png\" width=\"50px\" alt=\"gingeleski\" /\u003e\u003c/a\u003e\u0026nbsp;\u0026nbsp;\u003c!-- sponsors --\u003e\n\n\\\nYou like my work ?\\\n[Sponsor me](https://github.com/sponsors/mxrch) on GitHub ! 🤗\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmxrch%2FGHunt","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmxrch%2FGHunt","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmxrch%2FGHunt/lists"}