---
title: Google'i SEO API-d
description: Search Console, PageSpeed Insights ja CrUX andmed SEO jaoks.
category: Marketing
sublabel: SEO
author: AgriciDaniel
tags: 
license: MIT
source: https://github.com/AgriciDaniel/claude-seo
---

# Google'i SEO API-d

Otsejuurdepääs Google'i enda SEO-andmetele. Ületab lõhe roomamispõhise
analüüsi (olemasolevad claude-seo oskused) ja Google'i reaalajas väliandmete vahel: tegelikud
Chrome'i kasutajamõõdikud, tegelik indekseerimisolek, otsingutulemuslikkus ja orgaaniline liiklus.

Kõik API-d on tasuta. Seadistamiseks on vaja Google Cloudi projekti API-võtme ja/või
teenusekontoga — samm-sammuliste juhiste saamiseks käivita `/seo google setup`.

## Eeltingimused

Enne mis tahes käsu täitmist kontrolli volitusi:
```bash
"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run google_auth.py --check --json
```

Konfiguratsioonifail: `~/.config/claude-seo/google-api.json`
```json
{
  "service_account_path": "/path/to/service_account.json",
  "api_key": "<GOOGLE_API_KEY>",
  "default_property": "sc-domain:example.com",
  "ga4_property_id": "properties/123456789"
}
```

Kui see puudub, loe `references/auth-setup.md` ja juhata kasutaja seadistamisest läbi.

### Volituste tasemed

| Tase | Tuvastamine | Saadaolevad käsud |
|------|-----------|-------------------|
| **0** (API-võti) | `api_key` olemas | `pagespeed`, `crux`, `crux-history`, `youtube`, `nlp` |
| **1** (OAuth/SA) | + OAuthi token või teenusekonto | Tase 0 + `gsc`, `inspect`, `sitemaps`, `index` |
| **2** (Täielik) | + `ga4_property_id` seadistatud | Tase 1 + `ga4`, `ga4-pages` |
| **3** (Ads) | + `ads_developer_token` + `ads_customer_id` | Tase 2 + `keywords`, `volume` |

Teata alati tuvastatud tase enne käskude käivitamist.

## Kiirviide

| Käsk | Mida see teeb | Tase |
|---------|-------------|------|
| `/seo google setup` | Kontrolli/seadista API volitused | -- |
| `/seo google pagespeed <url>` | PSI Lighthouse + CrUX-i väliandmed | 0 |
| `/seo google crux <url>` | Ainult CrUX-i väliandmed (p75 mõõdikud) | 0 |
| `/seo google crux-history <url>` | 25-nädalane CWV trendianalüüs | 0 |
| `/seo google gsc <property>` | Search Console: klikid, näitamised, CTR, positsioon | 1 |
| `/seo google inspect <url>` | URL Inspection: indekseerimisolek, kanooniline URL, roomamisteave | 1 |
| `/seo google inspect-batch <file>` | URL Inspectioni hulgikontroll failist | 1 |
| `/seo google sitemaps <property>` | GSC saidikaartide olek | 1 |
| `/seo google index <url>` | Esita URL Indexing API-le | 1 |
| `/seo google index-batch <file>` | Esita korraga kuni 200 URL-i | 1 |
| `/seo google ga4 [property-id]` | GA4 orgaanilise liikluse aruanne | 2 |
| `/seo google ga4-pages [property-id]` | Populaarseimad orgaanilised maandumislehed | 2 |
| `/seo google youtube <query>` | YouTube'i videootsing (vaatamised, meeldimised, kestus) | 0 |
| `/seo google youtube-video <id>` | YouTube'i video üksikasjad + populaarseimad kommentaarid | 0 |
| `/seo google nlp <url-or-text>` | NLP olemite eraldamine + meelsus + klassifitseerimine | 0 |
| `/seo google entities <url-or-text>` | Ainult olemite analüüs (E-E-A-T jaoks) | 0 |
| `/seo google keywords <seed>` | Märksõnaideed Google Ads Keyword Planneri põhjal | 3 |
| `/seo google volume <keywords>` | Otsingumahu päring Keyword Plannerist | 3 |
| `/seo google entity <query>` | Knowledge Graphi olemi kontroll | 0 |
| `/seo google safety <url>` | Web Riski URL-i turvalisuse kontroll | 0 |
| `/seo google quotas` | Näita kõigi API-de päringupiiranguid | -- |

---

## PageSpeed + CrUX

### `/seo google pagespeed <url>`

Kombineeritud Lighthouse'i laboriandmed + CrUX-i väliandmed.

**Skript:** `"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run pagespeed_check.py <url> --json`
**Viide:** `references/pagespeed-crux-api.md`
**Vaikimisi:** nii mobiili- kui ka lauaarvutistrateegia, kõik Lighthouse'i kategooriad.

Väljund ühendab laborihinded (hetkeline Lighthouse) väliandmetega (28 päeva
Chrome'i kasutajamõõdikud). CrUX proovib esmalt URL-i taset ja langeb tagasi päritolu (origin) tasemele.

### `/seo google crux <url>`

Ainult CrUX-i väliandmed (Lighthouse'i ei käivitata). Kiirem.

**Skript:** `"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run pagespeed_check.py <url> --crux-only --json`

### `/seo google crux-history <url>`

25-nädalased CrUX History trendid. Näitab, kas CWV mõõdikud paranevad, püsivad stabiilsena või halvenevad.

**Skript:** `"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run crux_history.py <url> --json`
**Viide:** `references/pagespeed-crux-api.md`

Väljund sisaldab iga mõõdiku trendi suunda, protsentuaalset muutust ja iganädalasi p75 väärtusi.

---

## Search Console

### `/seo google gsc <property>`

Search Analytics: klikid, näitamised, CTR ja positsioon viimase 28 päeva kohta.

**Skript:** `"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run gsc_query.py --property <property> --json`
**Viide:** `references/search-console-api.md`
**Vaikimisi:** 28 päeva, dimensions=query,page, type=web, limit=1000.

Sisaldab kiirete võitude tuvastamist: päringud positsioonil 4–10 suure näitamiste arvuga.
Plokk `totals` pärineb eraldi dimensioonideta koondpäringust, sest
päringutaseme read võivad anonümiseeritud väikese mahuga liikluse välja jätta. Käsitle kogusummasid
kogu saiti hõlmavatena ainult siis, kui `totals_complete` on true. `--limit` piirab tagastatavate
dimensioonaridade koguarvu, mitte iga lehekülgedeks jaotatud päringu suurust.

> **Tehisaru pinnad GSC-s (2026):**
> - **Generatiivse tehisaru tulemuslikkuse aruanne** (käivitatud 2026-06-03), eraldi vaade **AI Overviewsi + AI Mode'i** nähtavusele. **Ainult näitamised** (ei klikke/CTR-i/positsiooni/päringut); dimensioonid Pages/Countries/Devices/Dates (Vaikse ookeani aeg); 1000 rea piirang; uusimad andmed on esialgsed; eraldi on olemas ka Discoveri generatiivse tehisaru aruanne. Võetakse kasutusele järk-järgult osale atribuutidest.
> - **AI Mode on juba arvestatud standardsetesse Performance'i kogusummadesse** (otsingutüüp Web): klikid (välislinkide klikid AI Mode'is) ja näitamised loetakse tavaaruandesse, nii et kogusummadest **ei saa** „klassikalist“ ja „tehisaru“ liiklust puhtalt eraldada. Kasuta ainult näitamistel põhineva tehisaru nähtavuse jaoks generatiivse tehisaru aruannet.
> - **Andmete usaldusväärsuse hoiatus:** GSC logimisviga muutis **näitamised, CTR-i ja keskmise positsiooni ajavahemikul 2025-05-13 kuni 2026-04-27 ebausaldusväärseks** (klikke see ei mõjutanud; parandati ainult edaspidiseks, **tagantjärele täitmist pole**). Käsitle seda ajavahemikku hõlmavaid näitamiste/CTR-i/positsiooni trende ettevaatlikult; oota pärast parandust näilist näitamiste langust.

> **Platvormiatribuudid (2026):** Search Console võib kuvada kinnitatud TikToki,
> Instagrami, X-i ja YouTube'i kontosid eraldi atribuutidena. Kinnita iga
> konto eraldi, kui seda pole juba lisatud nõutud Search-profiili kaudu.
> Kasuta neid atribuute ainult Google'i otsingu tulemuslikkuse jaoks, mitte
> platvormi enda analüütika asendajana. Allikas:
> developers.google.com/search/docs/monitor-debug/analyze-social-video-content

### `/seo google inspect <url>`

URL Inspection: tegelik indekseerimisolek Google'ilt.

**Skript:** `"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run gsc_inspect.py <url> --json`

Tagastab: otsuse (PASS/FAIL), katvuse oleku, robots.txt oleku, indekseerimisoleku,
lehe toomise oleku, kanoonilise URL-i valiku, mobiilikasutatavuse, rikkalikud tulemused.

### `/seo google inspect-batch <file>`

Hulgikontroll failist (üks URL rea kohta). Piirang 2000 päevas saidi kohta.

**Skript:** `"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run gsc_inspect.py --batch <file> --json`

### `/seo google sitemaps <property>`

Loetle esitatud saidikaardid koos oleku, vigade ja hoiatustega. Saidikaardi sisu aruanne
näitab ainult esitatud arve; URL Inspection API on tõeallikas selle kohta, kas
konkreetsed URL-id on indekseeritud.

**Skript:** `"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run gsc_query.py sitemaps --property <property> --json`

---

## Indexing API

### `/seo google index <url>`

Teavita Google'it URL-i uuendusest.

**Skript:** `"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run indexing_notify.py <url> --json`
**Viide:** `references/indexing-api.md`

Indexing API on ametlikult mõeldud JobPostingu ja BroadcastEvent/VideoObjecti lehtede jaoks.
Teavita kasutajat alati sellest piirangust. Päevane kvoot: 200 avaldamispäringut.

### `/seo google index-batch <file>`

Esita URL-id failist korraga. Jälgib kvoodi kasutust.

**Skript:** `"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run indexing_notify.py --batch <file> --json`

---

## GA4 liiklus

### `/seo google ga4 [property-id]`

Orgaanilise liikluse aruanne: päevased seansid, kasutajad, lehevaatamised, põrkemäär, kaasatus.

**Skript:** `"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run ga4_report.py --property <id> --json`
**Viide:** `references/ga4-data-api.md`
**Vaikimisi:** 28 päeva, filtreeritud kanalirühmale Organic Search.

> **GA4 kanal „AI Assistants“ (kasutusel ~2026-05-13):** GA4 lisas omaette vaikekanalirühma *AI Assistants*. Tuvastatud tehisaruassistendi suunatud seansid saavad `medium=ai-assistant`. Google'i tuvastatud allikad on **ChatGPT, Gemini, Claude, Deepseek, Copilot, Grok** ja kanal **ei hõlma** Google AI Overviewsi / AI Mode'i. **Vajadusel kontrolli Perplexityt eraldi**; toetamata allikad võivad jääda kanalisse Referral ja enamik tehisaru seansse saabub suunajata ning langeb kanalisse **Direct**, nii et see kanal alahindab tehisaru liiklust. Ainult edaspidiseks, tagantjärele täitmist pole.

### `/seo google ga4-pages [property-id]`

Populaarseimad orgaanilised maandumislehed, järjestatud seansside järgi.

**Skript:** `"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run ga4_report.py --property <id> --report top-pages --json`

---

## YouTube (video-SEO)

Mõned kolmandate osapoolte uuringud näitavad YouTube'i mainimiste ja tehisaru nähtavuse vahel korrelatsiooni 0,737. Käsitle seda metoodikast sõltuva signaalina. Tasuta, vaja on ainult API-võtit.

### `/seo google youtube <query>`

Otsi YouTube'ist videoid. Tagastab pealkirja, kanali, vaatamised, meeldimised, kestuse.

**Skript:** `"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run youtube_search.py search "<query>" --json`
**Viide:** `references/youtube-api.md`
**Kvoot:** 100 ühikut otsingu kohta (10 000 ühikut päevas tasuta).

### `/seo google youtube-video <video_id>`

Üksikasjalik videoteave + sildid + 10 populaarseimat kommentaari.

**Skript:** `"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run youtube_search.py video <video_id> --json`
**Kvoot:** 2 ühikut (video üksikasjad + kommentaarid).

---

## NLP sisuanalüüs

Google NLP olemite/meelsuse väljund sisemisteks sisukvaliteedi kontrollideks. Ära käsitle seda Google'i E-E-A-T hindena.

### `/seo google nlp <url-or-text>`

Täielik NLP-analüüs: olemid, meelsus, sisu klassifitseerimine.

**Skript:** `"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run nlp_analyze.py --url <url> --json` või `--text "..."`
**Viide:** `references/nlp-api.md`
**Tasuta tase:** 5000 ühikut kuus. GCP projektis peab arveldus olema lubatud.

### `/seo google entities <url-or-text>`

Ainult olemite eraldamine (kiirem, väiksem kvoodikulu).

**Skript:** `"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run nlp_analyze.py --url <url> --features entities --json`

---

## Märksõnauuring (Google Ads)

Kuldstandardi tasemel märksõnade mahuandmed. Vaja on Google Adsi kontot.

### `/seo google keywords <seed>`

Genereeri lähtemõistete põhjal märksõnaideid.

**Skript:** `"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run keyword_planner.py ideas "<seed>" --json`
**Viide:** `references/keyword-planner-api.md`
**Nõuab:** konfiguratsioonis Adsi arendajatokenit + kliendi ID-d (tase 3).

### `/seo google volume <keywords>`

Konkreetsete märksõnade otsingumaht (komadega eraldatud).

**Skript:** `"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run keyword_planner.py volume "<kw1>,<kw2>" --json`

---

## Täiendav

### `/seo google entity <query>`

Knowledge Graphi olemi kontroll. Kinnitab brändi olemasolu.

**Viide:** `references/supplementary-apis.md`
Kasutab API-võtmega Knowledge Graph Search API-t.

### `/seo google safety <url>`

Web Risk API kontroll pahavara/sotsiaalse manipuleerimise märgistuste suhtes.

**Viide:** `references/supplementary-apis.md`

### `/seo google quotas`

Kuva päringupiirangute tabel. Loe `references/rate-limits-quotas.md`.

---

## Aruanded

Paku pärast iga analüüsikäsku PDF/HTML-aruande koostamist.

### `/seo google report <type>`

Koosta professionaalne PDF-aruanne graafikute ja analüütikaga.

**Skript:** `"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run google_report.py --type <type> --data <json> --domain <domain> --format pdf`

| Tüüp | Sisend | Väljund |
|------|-------|--------|
| `cwv-audit` | PSI + CrUX + CrUX History andmed | Core Web Vitalsi audit näidikute, ajajoonte ja jaotustega |
| `gsc-performance` | GSC päringuandmed | Search Console'i aruanne päringutabelite ja kiirete võitudega |
| `indexation` | Hulgikontrolli andmed | Indekseerimisolek koos katvuse rõngasdiagrammiga |
| `full` | Kõik andmed koos | Põhjalik Google'i SEO-aruanne (kõik jaotised) |

**Töövoog:**
1. Käivita andmekogumise käsud (pagespeed, gsc, inspect-batch jne)
2. Salvesta JSON-väljund faili: `"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run pagespeed_check.py <url> --json > data.json`
3. Koosta aruanne: `"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run google_report.py --type cwv-audit --data data.json --domain <domain>`

**Kokkulepe:** pärast analüüsi lõpetamist soovita: „Kas koostan aruande? Kasuta `/seo google report <type>`“

---

## Päringupiirangud

| API | Minutis | Päevas | Autentimine |
|-----|-----------|---------|------|
| PSI v5 | 240 QPM | 25 000 QPD | API-võti |
| CrUX + History | 150 QPM (jagatud) | Piiramatu | API-võti |
| GSC Search Analytics | 1200 QPM/sait | 30M QPD | Teenusekonto |
| GSC URL Inspection | 600 QPM | 2000 QPD/sait | Teenusekonto |
| Indexing API | 380 RPM | 200 avaldamist päevas | Teenusekonto |
| GA4 Data API | 10 samaaegset | ~25K tokenit päevas | Teenusekonto |

## Oskustevaheline integratsioon

- **seo-audit**: käivitab reaalajas CWV ja indekseerimisandmete jaoks agendi `seo-google` (tingimuslikult)
- **seo-technical**: kasutab tegelike CWV väliandmete jaoks pagespeed_check.py-d
- **seo-performance**: CrUX-i väliandmed täiendavad Lighthouse'i laboriandmeid
- **seo-sitemap**: GSC saidikaardi olek näitab esitatud arve, vigu ja hoiatusi; indekseerimise tõe jaoks kasuta URL Inspectionit
- **seo-content**: GSC päringuandmed suunavad märksõnade sihtimist
- **seo-geo**: kasuta GSC generatiivse tehisaru tulemuslikkuse aruandeid ning AI Overviewsi/AI Mode'i/Discoveri generatiivse tehisaru kaasamise/välistamise juhtelemente, kus need on saadaval

## Väljundi vorming

- CWV mõõdikud: foorihinnang (Good / Needs Improvement / Poor)
- Tulemuslikkuse aruanded: sorditavate veergudega tabelid
- Lisa alati märge andmete värskuse kohta
- Salvesta aruanded nimega `GOOGLE-API-REPORT-{domain}.md`
- Markdowni/LLM-i mallid kaustas `assets/templates/`: `cwv-audit-report.md`, `gsc-performance-report.md`, `indexation-status-report.md`; eraldiseisvad `google_report.py` PDF-torustikust

## Tehnilised märkused

- INP asendas FID-i 12. märtsil 2024. Ära kunagi viita FID-ile.
- CrUX-i CLS-väärtused on kodeeritud stringidena (nt "0.05"). Skriptid tegelevad parsimisega.
- CrUX 404 = ebapiisav liiklus, mitte autentimisviga.
- Search Analyticsi andmetel on 2–3-päevane viivitus.
- `round_trip_time` asendas CrUX-is `effectiveConnectionType` (veebruar 2025).
- Custom Search JSON API on uutele klientidele suletud (2025).

## Vigade käsitlemine

| Olukord | Tegevus |
|----------|--------|
| Volitusi pole seadistatud | Käivita `/seo google setup`. Loetle 0. taseme käsud, mis töötavad ainult API-võtmega. |
| Teenusekontol puudub GSC juurdepääs | Teata veast. Juhenda: lisa `client_email` asukohas GSC > Settings > Users > Add. |
| CrUX-i andmed pole saadaval (404) | Teata ebapiisavast Chrome'i liiklusest. Soovita varuvariandina PSI laboriandmeid. |
| GA4 atribuuti ei leitud | Teata veast. Näita, kuidas leida atribuudi ID asukohas GA4 Admin > Property Details. |
| Indexing API kvoot ületatud | Teata piirangust 200 päevas. Soovita prioriseerida kõige olulisemad URL-id. |
| Päringupiirang (429) | Oota ja proovi uuesti eksponentsiaalse ooteajaga. Teata, milline API piirangu ületas. |