gitdork 1.0.0

Google, Shodan, and GitHub dork generator for pentesters and bug bounty hunters

🎯 gitdork

Google, Shodan, and GitHub dork generator. Feed it a repo URL or domain — get ready-to-use dork queries targeting exposed secrets, sensitive files, open directories, and misconfigs. Built for pentesters and bug bounty hunters.

---

Features

• 🔍 Google dorks — site:, filetype:, intitle:, inurl: across 8 categories
• 🌐 Shodan dorks — hostname:, port:, ssl:, product: for infra recon
• 🐙 GitHub code search — org:, filename:, extension: for secret hunting
• 🧠 Tech stack detection — fetch GitHub metadata to generate tech-specific dorks
• 🗂️ Category filtering — focus on secrets, misconfigs, login panels, or any combo
• ⚙️ Engine filtering — run just Google, just Shodan, or all three
• 📊 Multiple output formats — terminal (Rich), JSON, Markdown
• 🔗 Clickable URLs — every dork includes a direct search link

---

Installation

pip install gitdork

Or from source:

git clone https://github.com/ExploitCraft/gitdork
cd gitdork
pip install -e .

---

Quick Start

# Generate dorks for a domain
gitdork generate example.com

# Generate dorks for a GitHub org/repo
gitdork generate ExploitCraft/ReconNinja

# Google dorks only
gitdork generate example.com --engine google

# Secrets and misconfigs only
gitdork generate example.com --category secrets,misconfigs

# Enrich with GitHub API (detects tech stack for extra dorks)
gitdork generate ExploitCraft/ReconNinja --enrich

# Export to JSON
gitdork generate example.com --format json --output dorks.json

# Export to Markdown (great for reports)
gitdork generate example.com --format markdown --output dorks.md

# Group output by category instead of engine
gitdork generate example.com --group-by category

---

Example Output

╭─ gitdork — Google, Shodan & GitHub dork generator ─╮

Target: example.com

── GOOGLE ──────────────────────────────────────────────

 #   CATEGORY            DESCRIPTION                       QUERY
 1   Secrets & Creds     API keys in GitHub                site:github.com "example.com" "api_key"
 2   Sensitive Files     .env files exposed                site:example.com filetype:env
 3   Sensitive Files     Log files exposed                 site:example.com filetype:log
 4   Exposed Dirs        Open directory listings           site:example.com intitle:"index of /"
 5   Misconfigurations   phpMyAdmin exposed                site:example.com inurl:phpMyAdmin
...

── SHODAN ───────────────────────────────────────────────

 #   CATEGORY            DESCRIPTION                       QUERY
 1   Subdomains          All hosts under this domain       hostname:"example.com"
 2   Misconfigs          SSH exposed                       hostname:"example.com" port:22
 3   Misconfigs          Redis exposed (often no auth)     hostname:"example.com" port:6379
...

╭─ Summary ──────────────────────╮
  Total dorks   97
  Google        42
  Shodan        31
  GitHub        24
╰────────────────────────────────╯

---

Categories

ID	Description
secrets	API keys, tokens, passwords, private keys
sensitive_files	.env, .sql, .log, .bak, config files
exposed_dirs	Open directory listings
misconfigs	phpMyAdmin, Jenkins, Grafana, Docker API, debug mode
login_panels	Admin panels, login pages
error_pages	Stack traces, PHP errors, SQL errors
subdomains	Subdomain enumeration, infra discovery
code_leaks	TODO credentials, internal-only code

# View all categories
gitdork list-categories

# View all engines
gitdork list-engines

---

CLI Reference

Usage: gitdork [OPTIONS] COMMAND [ARGS]...

Commands:
  generate         Generate dorks for a target
  list-categories  List all available categories
  list-engines     List all supported engines

Options for generate:
  TARGET              Domain, GitHub org/repo, or URL
  --engine, -e        google,shodan,github (default: all)
  --category, -c      Comma-separated category filter
  --format            terminal | json | markdown (default: terminal)
  --output, -o        Write to file
  --group-by          engine | category (default: engine)
  --enrich            Fetch GitHub metadata for tech-stack dorks
  --token             GitHub token for enrichment (or GITHUB_TOKEN env)

---

Tech Stack Detection

With --enrich, gitdork queries the GitHub API to detect the repo's language, topics, and description — then generates additional targeted dorks:

Tech	Extra dorks
django	DEBUG mode, SECRET_KEY, ALLOWED_HOSTS
wordpress	wp-config.php, upload PHP shells
laravel	.env APP_KEY
aws	aws_access_key_id in code
kubernetes	API server, Shodan product query
terraform	tfvars with secrets

# Use your GitHub token for higher API rate limits
export GITHUB_TOKEN=ghp_...
gitdork generate ExploitCraft/ReconNinja --enrich

---

Part of the HackerInc/ExploitCraft Ecosystem

Tool	Description
envleaks	Codebase & git history secret scanner
gitdork	Google/Shodan dork generator (this repo)
wifi-passview	Cross-platform WiFi credential dumper
ReconNinja	ReconNinja v6 — 21-phase recon framework
VaultHound	Secret & credential scanner

---

Disclaimer

gitdork generates search queries only — it does not perform any active scanning or exploitation. Use responsibly, only against targets you own or have explicit written permission to test.

---

License

MIT © ExploitCraft