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:

"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run google_auth.py --check --json

Konfiguratsioonifail: ~/.config/claude-seo/google-api.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üümitud 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.