Skip to content

AEO Prompt Frequency Analyzer

Verified

Analyze what search queries Gemini uses when answering a prompt, by running it multiple times with Google Search grounding and reporting frequency distributi...

251 downloads
$ Add to .claude/skills/

About This Skill

# Prompt Frequency Analyzer

Run a prompt N times against Gemini with Google Search grounding enabled. Collect and report the frequency of search queries Gemini generates across all runs.

Usage

```bash GEMINI_API_KEY=$(security find-generic-password -s "nano-banana-pro" -w) \ python3 scripts/analyze.py "your prompt here" [--runs 10] [--model gemini-2.5-pro] [--concurrency 5] [--output text|json] ```

Run from the skill directory. Resolve `scripts/analyze.py` relative to this SKILL.md.

Options

  • `--runs N` — Number of times to run the prompt (default: 10)
  • `--model NAME` — Gemini model to use (default: gemini-2.5-pro)
  • `--concurrency N` — Max parallel API calls (default: 5; keep ≤5 to avoid rate limits)
  • `--output text|json` — Output format (default: text)

Output

  • Reports for each unique search query:
  • Frequency percentage (how many runs used that query)
  • Raw count
  • Top web sources referenced

Notes

  • Gemini API key must be in `GEMINI_API_KEY` env var (stored in macOS Keychain under `nano-banana-pro`)
  • Each run is independent — Gemini may use different search queries each time
  • Retries failed requests up to 3 times with exponential backoff
  • Use `--output json` for programmatic consumption

Use Cases

  • Run a prompt N times against Gemini to measure search query consistency
  • Analyze which search queries Gemini generates most frequently for a given prompt
  • Identify stable vs. variable search patterns in AI-grounded search behavior
  • Test prompt variations to see which generate more relevant grounded searches
  • Build frequency reports for AEO keyword research and content optimization

Pros & Cons

Pros

  • +Unique capability — measures the search queries AI models generate internally
  • +Configurable run count and model selection for thorough statistical analysis
  • +Uses Google Search grounding for real-world relevance of generated queries

Cons

  • -Requires a Gemini API key — limited to Google's AI platform only
  • -Multiple API calls per analysis can accumulate costs quickly at scale
  • -Results may vary significantly between runs due to model non-determinism

FAQ

What does AEO Prompt Frequency Analyzer do?
Analyze what search queries Gemini uses when answering a prompt, by running it multiple times with Google Search grounding and reporting frequency distributi...
What platforms support AEO Prompt Frequency Analyzer?
AEO Prompt Frequency Analyzer is available on Claude Code, OpenClaw.
What are the use cases for AEO Prompt Frequency Analyzer?
Run a prompt N times against Gemini to measure search query consistency. Analyze which search queries Gemini generates most frequently for a given prompt. Identify stable vs. variable search patterns in AI-grounded search behavior.

100+ free AI tools

Writing, PDF, image, and developer tools — all in your browser.

Next Step

Use the skill detail page to evaluate fit and install steps. For a direct browser workflow, move into a focused tool route instead of staying in broader support surfaces.