aeo-prompt-question-finder

查找针对任何主题的基于问题的 Google 自动完成建议。在种子主题前添加问题修饰符（什么、如何、为什么）并返回真正的自动完成建议 - 对于 AEO 提示研究、内容构思以及理解人们对某个主题的询问非常有用。当用户想要发现人们搜索的问题、查找内容角度或对主题进行关键字/提示研究时使用。

# 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:

```bash
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

```bash
# 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.

---

## 中文说明

# Prompt Question Finder

通过向 Google 自动完成添加问题修饰符来发现人们对某个主题提出的问题。

## 用法

从技能目录运行脚本：

```bash
python3 scripts/find_questions.py "travel itinerary"
```

### 选项

- `--modifiers what how why should` — 覆盖默认修饰符（默认：what how why should can does is when where which will are do）
- `--delay 0.5` — 请求之间的间隔秒数（批量处理多个主题时使用 0.5–1.0）
- `--json` — 以 JSON 格式输出，供程序化使用
- `--volume` — 通过 DataForSEO 获取平均月搜索量（从 macOS 钥匙串读取凭据：`dataforseo-login` / `dataforseo-password`，或环境变量 `DATAFORSEO_LOGIN` / `DATAFORSEO_PASSWORD`）
- `--location 2840` — DataForSEO 位置代码（默认：2840 = 美国）
- `--lang en` — 搜索量查询的语言代码（默认：en）

### 示例

```bash
# 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
```

## 速率限制

Google 自动完成是一个非官方端点。单主题运行（10 个请求）是安全的。批量或并行运行多个主题时，请始终使用 `--delay 0.5` 或更高的值，以避免临时的 IP 封禁。

## 工作原理

对于每个修饰符，脚本会用 `"{modifier} {topic}"` 查询 `https://suggestqueries.google.com/complete/search` 并返回自动完成建议。无需 API 密钥。