---
title: GEO päringute leidja
description: Leiab, millised ChatGPT otsingupäringud brändi mainivad.
category: Marketing
sublabel: SEO
author: OpenClaudia
tags: 
license: MIT
source: https://github.com/OpenClaudia/openclaudia-skills
---

# GEO päringute leidja

Leia, millised ChatGPT otsingupäringud mainivad antud brändi. Testib long-tail päringuid ChatGPT veebiotsinguga mudeli vastu ja raporteerib, millised neist brändi esile toovad.

## Päästik

Kasuta, kui kasutaja palub „leia päringuid [brändi] jaoks“, „kontrolli GEO nähtavust“, „millised päringud mainivad [brändi]“, „geo query finder“, „leia AI mainimisi“ või „testi ChatGPT päringuid [brändi] jaoks“.

## Kasutamine

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

**Näited:**
- `/geo-query-finder "Acme Corp"` — uurib brändi automaatselt ja genereerib päringuid
- `/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"`

## Kuidas see töötab

### Samm 0: Too eelindekseeritud LLM-mainimised (DataForSEO) — tee see ESIMESENA

Enne spekulatiivsete päringute genereerimist kontrolli, kas DataForSEO-l on juba indekseeritud mainimisi brändi domeeni jaoks. Kui on, saad ühe kutsega ground-truth päringud otsingumahuga, selle asemel et OpenAI dollareid ära põletada arvates.

Auth keskkonnamuutujate `DATAFORSEO_LOGIN` / `DATAFORSEO_PASSWORD` kaudu.

```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")
```

**Kriitilised lipud:**
- `"include_subdomains": true` — ilma selleta tagastavad tippdomeenid 0 tulemust (www.X käsitletakse erineva domeenina).
- Jäta `location_code` välja globaalsete tulemuste jaoks; lisa `"location_code": 2840` ainult USA-sse piiramiseks.
- `platform` valikud: `"google"` (AI Overview), `"chat_gpt"`. Perplexity EI OLE selle andmestiku kaudu toetatud.

**Eralda igast `items[]`-st:**
- `question` — päris otsingupäring, kus brändi tsiteeriti
- `ai_search_volume` — igakuine AI otsingumaht (kasuta prioriseerimiseks)
- `sources[]` — kirjed, mille `domain` ühtib brändiga, omavad täpset tsiteeritud URL-i
- `location_code`, `language_code`, `model_name` — geo/lokaali jaotuseks
- `answer` — LLM-i vastuse tekst (kontekstiks)

**Otsuse reegel:**
- Kui ≥20 päringut tagastati → jäta sammud 1–4 täielikult vahele; raporteeri need ground-truth mainimistena ja keskendu sammule 5 lõheanalüüsile (sorteeri mahu järgi, leia URL-sektsiooni võitjad nagu `/guides/` vs `/tools/`).
- Kui <20 päringut → kasuta neid seemnena sammule 2 (genereeri variatsioone päringuteemadest, mida DataForSEO juba kinnitas), seejärel jooksuta samme 3–4 ainult lõhedele.
- Kui 0 päringut → domeenil pole AI-tsitaate; jätka algsete sammudega 1–5 (spekulatiivne testimine) varuvariandina.

### Samm 1: Uuri brändi
Kui `--industry` või `--features` pole antud, kasuta veebiotsingut, et mõista:
- Mida bränd teeb / millises tööstuses see on
- Peamised eristajad vs konkurendid
- Unikaalsed funktsioonid, mida konkurentidel POLE

### Samm 2: Genereeri long-tail päringuid
Genereeri 15–20 long-tail päringut nendes kategooriates:
1. **Funktsioonispetsiifilised** (unikaalsed võimekused, mis on ainult sellel brändil)
2. **B2B/otsustaja** (päringud ostjatelt, mitte tarbijatelt)
3. **Probleemilahendus** („kuidas X ilma Y-ta“)
4. **Võrdlus/alternatiiv** („alternatiiv [domineerivale mängijale]“)
5. **Kasutusjuht-spetsiifilised** (nišistsenaariumid, kus bränd paistab silma)

Väldi üldisi päringuid, kus domineerivad mängijad alati võidavad.

### Samm 3: Päring ChatGPT-le OpenAI Search API kaudu

Kasuta OpenAI `gpt-4o-search-preview` mudelit veebiotsinguga lubatuna:

```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"]
```

### Samm 4: Kontrolli mainimisi

Iga päringu jaoks kontrolli, kas brändi nimi (või teadaolevad aliased) ilmub ChatGPT vastuses:
- Kontrolli tõstutundetut ühtimist
- Kontrolli variatsioone (tühikutega/ilma, punktidega, sidekriipsudega)
- Kui mainitud, eralda ümbritsev kontekst (200 tähemärki mainimise ümber)
- Märgi positsioon (kas see on #1 soovitus? loetletud paljude seas? mainitud möödaminnes?)

### Samm 5: Raporteeri tulemused

Väljasta kokkuvõttetabel:

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

## Kiirusepiirangud

- Jooksuta päringuid järjestikku 1–2-sekundiliste viivitustega, et vältida kiirusepiiranguid
- Iga päring maksab ~$0,01 OpenAI API kaudu
- Vaikimisi: 15–20 päringut jooksu kohta (~$0,15–0,20 jooksu kohta)

## Märkused

- Tulemused peegeldavad ChatGPT-d veebiotsinguga (ankurdatud reaalajas veebitulemustesse)
- Tulemused võivad jookside vahel veidi erineda otsingu värskuse tõttu
- See testib spetsiifiliselt ChatGPT-d — Gemini ja Copilot võivad anda erinevaid tulemusi
- Jätkuvaks jälgimiseks kaalu perioodiliste jookside ajastamist, et jälgida nähtavuse muutusi aja jooksul