К основному содержанию
скилл CX Codex

geo-query-finder — скилл для Claude Code

Скилл geo-query-finder для Claude Code прогоняет длиннохвостовые запросы через ChatGPT с веб-поиском и показывает, в каких ответах упоминается бренд. Проверяет его GEO-видимость.

MIT 222 установок ★ 750 обновлён 2026-10-21

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add OpenClaudia/openclaudia-skills --skill geo-query-finder -a claude-code
Открыть на GitHub

Что делает geo-query-finder

Скилл берёт бренд и прогоняет через него 15–20 сгенерированных запросов через модель gpt-4o-search-preview с включённым веб-поиском. Сначала проверяет DataForSEO — если там уже есть проиндексированные упоминания домена, берёт готовые запросы с объёмом поиска и пропускает генерацию. Если данных меньше 20, использует их как основу для новых вариаций.

Для работы нужны ключи OPENAI_API_KEY и пара DATAFORSEO_LOGIN / DATAFORSEO_PASSWORD. Каждый запрос через OpenAI стоит около $0.01, один прогон — $0.15–0.20. Без ключей скилл не запустится.

В отчёте — таблица: где бренд упомянут, на какой позиции, какой контекст, и где его нет, а ChatGPT советует конкурентов. Из этого видно, под какие запросы стоит писать контент, а какие не стоят усилий. Тестирует именно ChatGPT — Gemini и Copilot могут отвечать иначе.

Какие задачи решает

  • проверить, в каких запросах ChatGPT упоминает бренд
  • найти готовые запросы с объёмом поиска через DataForSEO
  • сгенерировать длиннохвостовые запросы по категориям
  • увидеть, кого ChatGPT советует вместо бренда
  • разделить запросы на контентные пробелы и бесперспективные

Примеры запросов агенту

  • Проверь, какие запросы в ChatGPT упоминают "Acme Corp"
  • Прогони geo-query-finder для "Acme Corp" с индустрией smart TV OS
  • Найди запросы с упоминанием "Acme Corp" и отчёт по позициям

Как установить geo-query-finder

1Через Skills CLI (Vercel)

npx skills add OpenClaudia/openclaudia-skills --skill geo-query-finder -a claude-code

2Вручную: положить файлы

~/.claude/skills/geo-query-finder/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/geo-query-finder/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о geo-query-finder

Как установить geo-query-finder в Claude Code?

Выполните npx skills add OpenClaudia/openclaudia-skills --skill geo-query-finder -a claude-code. Скилл появится в ~/.claude/skills/geo-query-finder/SKILL.md.

Что делает geo-query-finder?

Тестирует длиннохвостовые запросы через ChatGPT с веб-поиском и показывает, в каких ответах упоминается заданный бренд. Сначала берёт готовые данные из DataForSEO, при их нехватке генерирует запросы и проверяет каждый через OpenAI Search API.

Что нужно для работы скилла?

Ключи OPENAI_API_KEY и DATAFORSEO_LOGIN / DATAFORSEO_PASSWORD в переменных окружения. Каждый прогон из 15–20 запросов стоит примерно $0.15–0.20.

Исходный текст

SKILL.md · MIT
---
name: geo-query-finder
description: >
  Find which ChatGPT search queries mention a given brand. Tests long-tail
  queries against ChatGPT's web-search-enabled model and reports which ones
  surface the brand. Use when the user asks to "find queries for [brand]",
  "check GEO visibility", "which queries mention [brand]", "geo query finder",
  "find AI mentions", or "test ChatGPT queries for [brand]".
---

# GEO Query Finder

Find which ChatGPT search queries mention a given brand. Tests long-tail queries against ChatGPT's web-search-enabled model and reports which ones surface the brand.

## Trigger

Use when the user asks to "find queries for [brand]", "check GEO visibility", "which queries mention [brand]", "geo query finder", "find AI mentions", or "test ChatGPT queries for [brand]".

## Usage

```
/geo-query-finder <brand_name> [--industry <industry>] [--features <feature1,feature2,...>] [--queries <custom_query1;custom_query2;...>]
```

**Examples:**
- `/geo-query-finder "Acme Corp"` — auto-researches the brand and generates queries
- `/geo-query-finder "Acme Corp" --industry "smart TV OS" --features "white-label,voice-control,OEM licensing"`
- `/geo-query-finder "Acme Corp" --queries "best regulatory AI;eCTD validation tool;pharma compliance software"`

## How It Works

### Step 0: Pull pre-indexed LLM mentions (DataForSEO) — do this FIRST

Before generating speculative queries, check if DataForSEO already has indexed mentions for the brand's domain. If it does, you get ground-truth queries with search volume in one call instead of burning OpenAI dollars guessing.

Auth via `DATAFORSEO_LOGIN` / `DATAFORSEO_PASSWORD` environment variables.

```bash
AUTH=$(printf '%s' "$DATAFORSEO_LOGIN:$DATAFORSEO_PASSWORD" | base64)
# Google AI Overview citations
curl -s -X POST "https://api.dataforseo.com/v3/ai_optimization/llm_mentions/search/live" \
  -H "Authorization: Basic $AUTH" -H "Content-Type: application/json" \
  -d '[{"target":[{"domain":"<DOMAIN>","search_filter":"include","include_subdomains":true}],"platform":"google","limit":700}]'
# ChatGPT citations (substitute "platform":"chat_gpt")
```

**Critical flags:**
- `"include_subdomains": true` — without it, apex domains return 0 results (www.X treated as a different domain).
- Omit `location_code` to get global results; add `"location_code": 2840` only to scope to US.
- `platform` options: `"google"` (AI Overview), `"chat_gpt"`. Perplexity is NOT supported via this dataset.

**Extract from each `items[]`:**
- `question` — the real search query where the brand was cited
- `ai_search_volume` — monthly AI search volume (use to prioritize)
- `sources[]` — entries with `domain` matching the brand have the exact cited URL
- `location_code`, `language_code`, `model_name` — for geo/locale breakdown
- `answer` — the LLM answer text (for context)

**Decision rule:**
- If ≥20 queries returned → skip Steps 1–4 entirely; report these as ground-truth mentions and focus Step 5 on gap analysis (sort by volume, find URL-section winners like `/guides/` vs `/tools/`).
- If <20 queries → use them as seed input for Step 2 (generate variations of the query themes DataForSEO already confirmed), then run Steps 3–4 only on the gaps.
- If 0 queries → the domain has no AI citations; proceed with the original Steps 1–5 (speculative testing) as fallback.

### Step 1: Research the Brand
If no `--industry` or `--features` provided, use web search to understand:
- What the brand does / what industry it's in
- Key differentiators vs competitors
- Unique features that competitors DON'T have

### Step 2: Generate Long-Tail Queries
Generate 15-20 long-tail queries across these categories:
1. **Feature-specific** (unique capabilities only this brand has)
2. **B2B/decision-maker** (queries from buyers, not consumers)
3. **Problem-solving** ("how to X without Y")
4. **Comparison/alternative** ("alternative to [dominant player]")
5. **Use-case specific** (niche scenarios where the brand excels)

Avoid generic queries where dominant players will always win.

### Step 3: Query ChatGPT via OpenAI Search API

Use OpenAI's `gpt-4o-search-preview` model with web search enabled:

```bash
OPENAI_API_KEY from environment variable
```

```python
import json, os, urllib.request, ssl

OPENAI_API_KEY = os.environ["OPENAI_API_KEY"]

data = json.dumps({
    "model": "gpt-4o-search-preview",
    "web_search_options": {"search_context_size": "medium"},
    "messages": [{"role": "user", "content": "<query>"}],
    "max_tokens": 1000
}).encode()

req = urllib.request.Request(
    "https://api.openai.com/v1/chat/completions",
    data=data,
    headers={
        "Authorization": f"Bearer {OPENAI_API_KEY}",
        "Content-Type": "application/json"
    }
)

resp = urllib.request.urlopen(req, context=ssl.create_default_context(), timeout=45)
result = json.loads(resp.read())
answer = result["choices"][0]["message"]["content"]
```

### Step 4: Check Mentions

For each query, check if the brand name (or known aliases) appears in ChatGPT's response:
- Check case-insensitive match
- Check variations (with/without spaces, dots, hyphens)
- If mentioned, extract the surrounding context (200 chars around the mention)
- Note the position (is it #1 recommended? listed among many? mentioned in passing?)

### Step 5: Report Results

Output a summary table:

```
## GEO Query Finder Results: [Brand Name]

### Mentioned (X/N queries)
| Query | Position | Context |
|-------|----------|---------|
| ... | #1 | "Brand is the leading..." |

### Not Mentioned (Y/N queries)
| Query | What ChatGPT Recommended Instead |
|-------|----------------------------------|
| ... | Competitor A, Competitor B |

### Recommendations
- Queries where brand is ALREADY mentioned: create more authoritative content to maintain/improve position
- Queries where brand is NOT mentioned but SHOULD be: these are content gaps — create targeted pages
- Queries to AVOID: too generic, dominated by big players, not worth the effort
```

## Rate Limiting

- Run queries sequentially with 1-2 second delays to avoid rate limits
- Each query costs ~$0.01 via OpenAI API
- Default: 15-20 queries per run (~$0.15-0.20 per run)

## Notes

- Results reflect ChatGPT with web search enabled (grounded in real-time web results)
- Results may vary slightly between runs due to search freshness
- This tests ChatGPT specifically — Gemini and Copilot may give different results
- For ongoing monitoring, consider scheduling periodic runs to track visibility changes over time

© OpenClaudia · MIT · OpenClaudia/openclaudia-skills

Похожие скиллы

Все скиллы по теме «SEO и GEO» →
ai-search James Dickerson (@boringmarketer) Скилл ai-search для Claude Code проверяет, упоминают ли AI-ответы бизнес и ссылаются ли на его сайт. Запускается для аудита видимости, поиска причин рекомендаций конкурентов и мониторинга изменений. CX Codex +1 ★ 778звёзд репо seo-geo-claude-skills reason-machines Скилл seo-geo-claude-skills для Claude Code объединяет 20 скиллов для SEO и подготовки контента под генеративные поисковики, включая проверки CORE-EEAT и CITE. CX Codex +1 1 000установок geo-compare zubair-trabzada Скилл geo-compare сравнивает два GEO-аудита — базовый и текущий — и собирает отчёт о прогрессе для клиента. Нужен на ежемесячной сверке. CX Codex +1 933установок geo-proposal zubair-trabzada Скилл geo-proposal для Claude Code и Codex. Собирает клиентское предложение по GEO из данных аудита: резюме, находки, три тарифа с ценами и сроками. CX Codex +1 925установок seo-geo ReScienceLab Скилл seo-geo проверяет техническое SEO, подбирает ключевые слова и готовит разметку JSON-LD, чтобы страницы цитировали поисковики и ИИ-ответы. CX Codex +1 57 400установок geo-content-optimizer aaron-he-zhu Скилл geo-content-optimizer переписывает текст под цитирование в ChatGPT, Perplexity, AI Overviews, Gemini и Claude. Оценивает контент по чек-листу GEO и выдаёт готовый фрагмент с оценкой до и после. CX Codex +1 1 900установок

Из того же набора73

Весь набор →
brand-dev Тянет название, описание, отрасль и логотипы компании через API brand.dev и складывает картинки в проект. CX Codex +1 337установок ahrefs-python Скилл ahrefs-python настраивает агента на работу с библиотекой Ahrefs API на Python. Пригодится при сборе бэклинков, ключевых слов, Domain Rating и запуске аудитов. CX Codex +1 329установок podcast-edit Скилл podcast-edit автоматизирует монтаж подкастов: находит границы выпуска, удаляет слова-паразиты и длинные паузы через Whisper, а затем выравнивает звук фильтрами FFmpeg. CX Codex +1 291установок similarweb-traffic Скилл similarweb-traffic собирает оценки трафика домена из SimilarWeb: визиты за месяц, каналы, страны и ключевые слова без платного API-ключа. CX Codex +1 227установок github-stars Скилл github-stars показывает прирост звёзд репозитория в виде ASCII-графиков по дням и часам в любом часовом поясе. Нужен, чтобы отследить запуск, всплеск на Product Hunt или рост проекта в реальном времени. CX Codex +1 197установок organize-skills Скилл organize-skills для Claude Code проверяет библиотеку скиллов, переименовывает их в зависимости от продукта или бэкенда и чинит связанные ссылки. Приводит имена и связи в нескольких хабах в порядок. CX Codex +1 139установок ai-citations-report Скилл ai-citations-report для Claude Code строит GEO-отчёт по домену с запросами, в которых сайт цитируют Google AI Overview и ChatGPT. Проверяет AI-видимость и пробелы в контенте. CX Codex +1 136установок geo-analysis Скилл geo-analysis для Claude Code запускает GEO/SEO-анализ домена через API Enception и скачивает PDF-отчёт о видимости бренда в ИИ, рынке и конкурентах. Используется для клиентских аудитов. CX Codex +1 135установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой