# Aeo Citation Gap Finder

> >

- **Type:** Skill
- **Install:** `agentstack add skill-psyduckler-aeo-skills-aeo-citation-gap-finder`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [psyduckler](https://agentstack.voostack.com/s/psyduckler)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [psyduckler](https://github.com/psyduckler)
- **Source:** https://github.com/psyduckler/aeo-skills/tree/main/aeo-citation-gap-finder

## Install

```sh
agentstack add skill-psyduckler-aeo-skills-aeo-citation-gap-finder
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# AEO Citation Gap Finder

> **Source:** [github.com/psyduckler/aeo-skills](https://github.com/psyduckler/aeo-skills/tree/main/aeo-citation-gap-finder)
> **Part of:** [AEO Skills Suite](https://github.com/psyduckler/aeo-skills)

Compare what different AI models cite for the same prompts. Find gaps in your cross-platform AI visibility.

## Why This Matters

Different AI models cite different sources for the same query. Google's AI Overviews (Gemini 3 Flash) use Google Search grounding. ChatGPT uses Bing. Perplexity uses its own search stack. A page that dominates Google AI citations may be invisible in ChatGPT, and vice versa.

This skill identifies those gaps so you can optimize content for cross-platform AI visibility.

## How It Works

1. **Google AI citations** — Runs the prompt 20 times through Gemini 3 Flash with `google_search` grounding. This simulates real AI Overviews and gives reliable citation frequency data.
2. **Web search citations** — Searches the same prompt via Brave Search API (or web_search tool). The top organic results approximate what ChatGPT (Bing-powered) and Perplexity would cite, since they all draw from similar web indexes.
3. **Gap analysis** — Compares the two source sets:
   - **Google-only:** Cited by Gemini but not in top web results → Google's AI has unique source preferences
   - **Web-only:** In top web results but not cited by Gemini → traditional SEO winners that AI overlooks
   - **Both:** Cited everywhere → strong cross-platform authority
4. **Domain tracking** — If you specify a domain, shows exactly where it appears vs where it's missing.

## Requirements

- **Gemini API key** (free) — set as `GEMINI_API_KEY` env var
- **Brave Search API key** (optional) — set as `BRAVE_API_KEY` env var. If not set, web search comparison is skipped.
- Python 3.9+
- No pip dependencies (stdlib only)

## Usage

```bash
# Full gap analysis with domain tracking
GEMINI_API_KEY="$GEMINI_API_KEY" \
BRAVE_API_KEY="$BRAVE_API_KEY" python3 scripts/find_gaps.py "best SEO tools for content optimization" --domain acme.com

# Without Brave (Gemini-only analysis)
GEMINI_API_KEY="$GEMINI_API_KEY" python3 scripts/find_gaps.py "best SEO tools for content optimization" --domain acme.com

# JSON output
GEMINI_API_KEY="$GEMINI_API_KEY" \
BRAVE_API_KEY="$BRAVE_API_KEY" python3 scripts/find_gaps.py "best SEO tools for content optimization" --domain acme.com --output json
```

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

## Options

| Option | Default | Description |
|--------|---------|-------------|
| `prompt` | (required) | The query to analyze |
| `--domain` | (required) | Domain to track across citation sources |
| `--runs` | 20 | Number of Gemini grounding runs |
| `--model` | `gemini-3-flash-preview` | Gemini model to use |
| `--output` | `text` | Output format: `text` or `json` |

## Output

### Text Output

```
Citation Gap Analysis: "best SEO tools for content optimization"
Domain: acme.com
================================================================

GOOGLE AI CITATIONS (Gemini 3 Flash, 20 runs):
  85% — acme.com
  70% — surferseo.com
  55% — semrush.com
  40% — ahrefs.com

WEB SEARCH RESULTS (Brave, top 20):
  #1 — g2.com/categories/seo-content-optimization
  #2 — surferseo.com/blog/best-seo-tools
  #3 — acme.com
  ...

GAP ANALYSIS:
  Google AI Only (not in web top 20):
    - contentharmony.com (cited 25% in AI)
    - frase.io (cited 20% in AI)

  Web Only (not cited by Google AI):
    - g2.com (web rank #1, 0% AI citation)
    - backlinko.com (web rank #5, 0% AI citation)

  Both (cross-platform authority):
    - acme.com (85% AI citation, web rank #3)
    - surferseo.com (70% AI citation, web rank #2)

DOMAIN REPORT: acme.com
  Google AI: ✅ Cited in 85% of runs
  Web Search: ✅ Appears in top 20
  Status: STRONG — cross-platform visibility
  
RECOMMENDATIONS:
  → Your domain has strong Google AI visibility (85%). Maintain current content.
  → Consider targeting web-only sources' topics to strengthen Bing/ChatGPT presence.
```

## Tips

- Run against your top 5-10 target prompts to find patterns across queries
- "Google AI Only" sources reveal what Gemini specifically values — study their content structure
- "Web Only" sources that rank well but aren't AI-cited often lack extractable, direct answers
- Pair with `aeo-content-free` to fix content gaps identified by this analysis
- Pair with `aeo-ai-overview-simulator` for deeper single-prompt analysis

## Notes

- Gemini API key in macOS Keychain under `google-api-key`
- Brave Search API key in macOS Keychain under `brave-search`
- If Brave API key is not available, the tool runs Gemini-only analysis (no web comparison)
- Retries with exponential backoff for API failures

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [psyduckler](https://github.com/psyduckler)
- **Source:** [psyduckler/aeo-skills](https://github.com/psyduckler/aeo-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-psyduckler-aeo-skills-aeo-citation-gap-finder
- Seller: https://agentstack.voostack.com/s/psyduckler
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.