Blogi Google: Google API andmed blogi jõudluse jaoks

Otsejuurdepääs Google'i SEO API-dele blogi jõudluse analüüsiks. Pakub tõelisi Chrome'i kasutajamõõdikuid, indekseerimisstaatust, otsingujõudlust, olemianalüüsi, YouTube'i videote leidmist, märksõnade mahte ja PDF/HTML jõudlusaruandeid.

Enamikul integratsioonidel pole dokumenteeritud kvootide piires kasutustasu. Cloud Natural Language nõuab arveldust ja võib pärast tasuta kuutaset tekitada kulusid. Google Ads nõuab sobivat kontot ja arendaja märki. Ära kunagi luba arveldust ega tee tasulist päringut ilma kasutaja selgesõnalise heakskiiduta.

Eeltingimused

Kontrolli alati volitusi enne mis tahes käsu käivitamist:

python3 skills/blog-google/scripts/run.py google_auth --check --json

Konfiguratsioonifail: ~/.config/claude-seo/google-api.json (jagatud claude-seo-ga)

{
  "api_key": "YOUR_GOOGLE_API_KEY",
  "oauth_client_path": "/path/to/client_secret.json",
  "default_property": "sc-domain:example.com",
  "ga4_property_id": "properties/123456789",
  "ads_developer_token": "...",
  "ads_customer_id": "123-456-7890",
  "ads_login_customer_id": "123-456-7890"
}

Kui puudub, loe references/auth-setup.md ja juhata kasutaja seadistusest 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)	+ OAuth märk või teenusekonto	Tase 0 + `gsc`, `inspect`, `index`
2 (täielik)	+ `ga4_property_id` seadistatud	Tase 1 + `ga4`
3 (Ads)	+ `ads_developer_token` + `ads_customer_id`	Tase 2 + `keywords`

Teavita alati tuvastatud tasemest enne käskude käivitamist.

Kiirülevaade

Käsk	Mida see teeb	Tase
`/blog google setup`	Kontrolli/seadista API volitused	:
`/blog google pagespeed <url>`	PSI Lighthouse + CrUX väliandmed	0
`/blog google crux <url>`	Ainult CrUX väliandmed (p75 mõõdikud)	0
`/blog google crux-history <url>`	25-nädalane CWV trendianalüüs	0
`/blog google youtube <query>`	YouTube'i videootsing (vaatamised, meeldimised, kestus)	0
`/blog google nlp <url-or-text>`	NLP olemiväljavõte + sentiment	0
`/blog google gsc <property>`	Search Console: klikid, näitamised, CTR, positsioon	1
`/blog google inspect <url>`	URL Inspection: indeksolek, kanooniline	1
`/blog google index <url>`	Esita URL Indexing API-le	1
`/blog google ga4 [property-id]`	GA4 orgaanilise liikluse aruanne	2
`/blog google keywords <seed>`	Märksõnaideed Google Ads Keyword Plannerist	3
`/blog google report <type>`	PDF/HTML jõudlusaruanne	:
`/blog google quotas`	Näita kõigi API-de päringupiiranguid	:

PageSpeed + CrUX

`/blog google pagespeed <url>`

Kombineeritud Lighthouse laboriandmed + CrUX väliandmed avaldatud blogipostituse jaoks.

Skript: python3 skills/blog-google/scripts/run.py pagespeed_check <url> --json Viide: references/api-reference.md

Väljund ühendab laboriskoorid (ajahetke Lighthouse) väliandmetega (28-päevased Chrome'i kasutajamõõdikud). CrUX proovib esmalt URL-i taset, taandub päritolutasemele.

`/blog google crux <url>`

Ainult CrUX väliandmed (Lighthouse'i käitust ei toimu). Kiirem.

Skript: python3 skills/blog-google/scripts/run.py pagespeed_check <url> --crux-only --json

`/blog google crux-history <url>`

25-nädalane CrUX History trendid. Näitab, kas CWV mõõdikud paranevad, on stabiilsed või halvenevad.

Skript: python3 skills/blog-google/scripts/run.py crux_history <url> --json

Search Console

`/blog google gsc <property>`

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

Skript: python3 skills/blog-google/scripts/run.py gsc_query --property <property> --json Vaikimisi: 28 päeva, dimensions=query,page, type=web, limit=1000.

Sisaldab kiirvõidu tuvastamist: päringud positsioonil 4-10 suurte näitamistega.

Search Console'i spetsiaalsed genereeriva-AI aruanded on järkjärguline, alamhulga kasutuselevõtt Search Console'i kasutajaliideses. Neil on eraldi Search ja Discover vaated; Search-vaade katab AI Overviews ja AI Mode. Ära luba klikke, päringuid ega API-hankimist nendest spetsiaalsetest vaadetest. Kuni Google dokumenteerib API, raporteeri see võimekus kui SKIPPED või kättesaamatu ja suuna kasutaja kasutajaliidesse.

Google'i 29. juuli Search Centrali teade ütleb, et Search Console'i platvormi property'd Instagrami, TikToki, X-i ja YouTube'i jaoks on globaalselt saadaval. Praegune abikeskus ütleb endiselt järkjärguline kasutuselevõtt. Raporteeri see Google'i-allika konfliktina, kontrolli saadavust kasutaja kontol ja ära väida, et /blog google gsc hangib need platvormiaruanded läbi praeguse API.

`/blog google inspect <url>`

URL Inspection: tegelik indekseerimisstaatus Google'ilt.

Skript: python3 skills/blog-google/scripts/run.py gsc_inspect <url> --json

Tagastab: verdikt (PASS/FAIL), katvuse olek, robots.txt olek, indekseerimise olek, lehe hankimise olek, kanoonilise valik, mobiilikasutatavus, rikastatud tulemused.

Pärast kanoniseerimise parandust võib Google URL-i duplikaatklastris kuni kaks nädalat hoida. Kui rakendus on nüüd õige ja parandus on selles aknas, raporteeri PENDING_REEVALUATION, mitte kohene ebaõnnestumine. Search Console'i Request Indexing funktsioon on kvoodiga piiratud; reserveeri see oluliste URL-ide jaoks.

Partiikontrolliks: python3 skills/blog-google/scripts/run.py gsc_inspect --batch <file> --json

Indexing API

`/blog google index <url>`

Teavita Google'it URL-i uuendusest läbi Indexing API.

Skript: python3 skills/blog-google/scripts/run.py indexing_notify <url> --json Viide: references/api-reference.md

Indexing API on ametlikult JobPosting ja BroadcastEvent/VideoObject lehtede jaoks. Teavita kasutajat alati sellest piirangust. Päevane kvoot: 200 avaldamispäringut. Ära esita seda üldotstarbelise asendusena URL Inspectioni Request Indexing funktsioonile.

Partiina: python3 skills/blog-google/scripts/run.py indexing_notify --batch <file> --json

GA4 liiklus

`/blog google ga4 [property-id]`

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

Skript: python3 skills/blog-google/scripts/run.py ga4_report --property <id> --json Vaikimisi: 28 päeva, filtreeritud Organic Search kanalirühmale.

Peamiste maandumislehtede jaoks: python3 skills/blog-google/scripts/run.py ga4_report --property <id> --report top-pages --json

YouTube (videote leidmine)

YouTube'i uuring võib lisada kasulikku, asjakohast meediat ja levituskonteksti. Igasugune kolmanda osapoole nähtavuse korrelatsioon on vaatluslik, mitte Google'i edetabeli ega viitamise nõue. Tasuta, ainult API-võti. Kasutavad blog-write ja blog-rewrite video manustamiseks.

`/blog google youtube <query>`

Otsi YouTube'ist blogiteemale asjakohaseid videoid.

Skript: python3 skills/blog-google/scripts/run.py youtube_search search "<query>" --json Kvoot: 100 ühikut otsingu kohta (10 000 ühikut/päev tasuta).

Tagastab: pealkiri, kanal, vaatamised, meeldimised, kestus, kirjeldus, sildid.

Video üksikasjade + kommentaaride jaoks: python3 skills/blog-google/scripts/run.py youtube_search video <video_id> --json

NLP sisuanalüüs

Google'i olemi- ja sentimentianalüüs saab toetada teema- ja toimetuseülevaatust. See ei avalda edetabelisüsteemi skoore ja E-E-A-T ei ole numbriline Google'i edetabeli tegur.

`/blog google nlp <url-or-text>`

Täielik NLP analüüs: olemid, sentiment, sisuklassifikatsioon.

Skript: python3 skills/blog-google/scripts/run.py nlp_analyze --url <url> --json Tasuta tase: 5000 ühikut/kuus. Nõuab GCP projektil lubatud arveldust.

Ainult olemiväljavõtte jaoks: python3 skills/blog-google/scripts/run.py nlp_analyze --url <url> --features entities --json

Märksõnauuring (Google Ads)

Kuldstandardi märksõnamahu andmed. Nõuab Google Ads kontot (tase 3).

`/blog google keywords <seed>`

Genereeri märksõnaideed seemnetest blogiteema uurimiseks.

Skript: python3 skills/blog-google/scripts/run.py keyword_planner ideas "<seed>" --json

Mahu otsingu jaoks: python3 skills/blog-google/scripts/run.py keyword_planner volume "<kw1>,<kw2>" --json

Aruanded

`/blog google report <type>`

Genereeri PDF/HTML aruanne graafikute ja tabelitega.

Skript: python3 skills/blog-google/scripts/run.py google_report --type <type> --data <json> --domain <domain> --format pdf

Tüüp	Sisend	Väljund
`cwv-audit`	PSI + CrUX + CrUX History andmed	Core Web Vitals audit mõõdikute ja ajajoontega
`gsc-performance`	GSC päringuandmed	Search Console aruanne päringutabelitega
`indexation`	Partiikontrolli andmed	Indekseerimisstaatus katvuse sõõrikdiagrammiga
`full`	Kõik andmed koos	Põhjalik Google SEO aruanne

Märkus: PDF-i genereerimine nõuab süsteemiteeke: sudo apt install libpango1.0-dev libcairo2-dev. Taandub HTML-ile, kui WeasyPrint pole saadaval või PDF-i renderdus ebaõnnestub.

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äev	Teenusekonto
GA4 Data API	10 samaaegset (50 360 jaoks)	200K Core Tokens/päev (2M 360 jaoks)	Teenusekonto
YouTube Data	:	10 000 ühikut/päev	API-võti
NLP API	:	5000 ühikut/kuus	API-võti (arveldus)

Loe references/rate-limits-quotas.md üksikasjaliku kvoodihalduse jaoks.

Blogi töövoo integratsioon

See oskus on nii kasutaja-kutsutav (/blog google pagespeed) kui ka teiste blogi alamoskuste poolt sisemiselt kutsutav:

blog-seo-check: käivitab PSI + CrUX avaldatud postituse URL-il reaalajas CWV andmete jaoks
blog-rewrite: NLP olemianalüüs E-E-A-T olemilünkade tuvastamiseks
blog-geo: GSC jõudlusandmed tegelike otsinguilmumise ülevaadete jaoks
blog-audit: partii CWV + indekseerimiskontrollid kõigi avaldatud blogi-URL-ide lõikes
blog-write / blog-rewrite: YouTube'i otsing video manustamiseks

Taandub sujuvalt, kui volitused pole seadistatud.

Aruandemallid

Kasuta kaasasolevaid malle, kui töövoog nõuab püsivat inimloetavat aruannet. Hoia kättesaamatud kontoandmed märgituna SKIPPED; ära kunagi täida tühja jaotist hinnanguliste mõõdikutega.

assets/templates/cwv-audit-report.md PageSpeedi ja CrUX tõendite jaoks.
assets/templates/gsc-performance-report.md Search Analyticsi ekspordi jaoks.
assets/templates/indexation-status-report.md URL Inspectioni tõendite jaoks.

Tehnilised märkused

INP asendas FID 12. märtsil 2024. Ära kunagi viita FID-ile.
CLS väärtused CrUX-ist on sõnena kodeeritud (nt "0.05"). Skriptid tegelevad parsimisega.
CrUX 404 = ebapiisav Chrome'i liiklus, mitte autentimisviga.
Search Analyticsi andmetel on 2-3 päeva viivitus.
Indexing API on ametlikult ainult JobPosting/BroadcastEvent lehtede jaoks.
Enamikul integratsioonidel pole kvoodi piires kasutustasu. Cloud Natural Language nõuab arveldust ja võib tekitada kulusid; Google Ads nõuab konto ja arendaja-märgi juurdepääsu.
Loe references/search-currentness.md enne nimelise uuenduse, kanoonilise muudatuse, Discover-nähtavuse, Google'i genereeriva-AI aruandluse, platvormi property'de, Preferred Sources, AMP või roomaja baidipiirangu probleemi diagnoosimist.
Nimelise uuenduse kuupäevad ei tõenda, mis põhjustas üksiku saidi muutuse. Oota pärast kasutuselevõttu üks täisnädal enne andmete võrdlemist ja eralda Web, Image, Video ja News jõudlus.
Googlebot töötleb toetatud failidest ainult esimest 2 MB ja PDF-idest esimest 64 MB. Hoia kriitilised metaandmed ja põhisisu enne lõikepunkti.

Vigade käsitlemine

Stsenaarium	Tegevus
Volitusi pole seadistatud	Käivita `/blog google setup`. Loetle tase 0 käsud (ainult API-võti).
Teenusekontol puudub GSC juurdepääs	Lisa `client_email` GSC > Settings > Users > Add.
CrUX andmed kättesaamatud (404)	Ebapiisav Chrome'i liiklus. Kasuta tagavaraks PSI laboriandmeid.
GA4 property't ei leitud	Leia property ID GA4 Admin > Property Details.
Indexing API kvoot ületatud	200/päev piirang. Prioriseeri kõige olulisemad URL-id.
Päringupiirang (429)	Oota ja proovi uuesti eksponentsiaalse tagasilangusega.

Google'i andmed blogile