Prompt Question Finder

Discover what questions people ask about a topic by querying Google Autocomplete with question modifiers.

Usage

Run the script from the skill directory:

python3 scripts/find_questions.py "travel itinerary"

Options

--modifiers what how why should — override default modifiers (default: what how why should can does is when where which will are do)
--delay 0.5 — seconds between requests (use 0.5–1.0 when running many topics in batch)
--json — output as JSON for programmatic use
--volume — fetch avg monthly search volume via DataForSEO (reads creds from macOS Keychain: dataforseo-login / dataforseo-password, or env vars DATAFORSEO_LOGIN / DATAFORSEO_PASSWORD)
--location 2840 — DataForSEO location code (default: 2840 = US)
--lang en — language code for volume lookup (default: en)

Examples

# Default modifiers (what, how, why)
python3 scripts/find_questions.py "protein powder"

# Custom modifiers
python3 scripts/find_questions.py "travel itinerary" --modifiers what how why should when

# JSON output
python3 scripts/find_questions.py "travel itinerary" --json

Rate Limits

Google Autocomplete is an unofficial endpoint. Single-topic runs (10 requests) are safe. When running multiple topics in batch or parallel, always use --delay 0.5 or higher to avoid temporary IP blocks.

How It Works

For each modifier, the script queries https://suggestqueries.google.com/complete/search with "{modifier} {topic}" and returns the autocomplete suggestions. No API key required.