Liigu sisu juurde

Kerge vaade: lehed avanevad kiiresti ja ilma 3D-graafikata. Näitame kerget vaadet, sest 3D-graafika oleks selles seadmes aeglane. Sisu on sama.

Lülita 3D sisse

Valmistan graafikat ette. Esimesel külastusel võib see veidi aega võtta.

Henry Lõiv

Veebidisain ja arendus

JuhendSEO ja AI-otsing 11 min lugemist

Google Search Console MCP: tasuta ühendus Claude’i ja Codexiga

Ühenda Search Console Claude’i või Codexiga macOS-is ja Windowsis. Tasuta kohalik MCP, lugemisõigus, praktilised SEO-päringud ja levinud vigade lahendused.

Google Search Console’i saab kohaliku MCP-serveri kaudu Claude’i või Codexiga ühendada ja küsida vestluses oma veebisaidi Google’i otsingutulemuste kohta. Selleks ei ole vaja tasulist vahendusteenust. Search Console’i API on tasuta, kuid sellele kehtivad kasutuskvoodid; AI-abilise tavapärane pakett või API kasutustasu jääb eraldi. Google’i API hinnastus

Ühendasin 4. novembril 2026 oma kohalikku seadistusse nii Search Console’i kui ka Google Analyticsi. See juhend kirjeldab Search Console’i ühendamist macOS-is ja Windowsi PowerShellis ning sisaldab Claude Desktopi, Claude Code’i ja Codexi seadeid. Lisa ühendus ainult sellesse klienti, mida kasutad.

Siin kasutatakse AminForou kogukonnaprojekti mcp-gsc, mida avaldatakse paketina mcp-search-console. See on Google’i ametlikust Analyticsi MCP-serverist eraldi projekt. Juhendis on paketiversiooniks fikseeritud 0.4.1 ning kasutatakse Pythonit 3.13.

Kontrollitud 4. novembril 2026: algses macOS-i ühenduses töötasid autentimine, tokeni värskendamine, andmevarade leidmine ja päris Search Console’i aruanne. Windowsi käske ja allolevat täiendatud käivitajat kontrolliti dokumentatsiooni ning lähtekoodi põhjal; Windowsis ei ole kogu töövoogu läbi käivitatud. Mõlemad juhised lõpevad tegeliku andmepäringuga.

Mida sellelt tegelikult küsida saab?

Ühenduse mõte on tuua sinu otsinguandmed vestlusse enne, kui palud AI-l soovitusi anda.

KüsimusMilliseid andmeid esmalt küsida?
Milliste lehtede otsinguliiklus väheneb?Kahe võrreldava perioodi klikid ja näitamised ning seejärel päringute ja positsioonide muutused.
Millised pealkirjad võiks üle vaadata?Palju näitamisi saanud lehed, nende CTR, päringud, keskmised positsioonid ja seadmete jaotus.
Mida Google selle URL-i kohta teab?URL Inspectioni tulemus koos salvestatud indekseerimisoleku ja viimase roomamise infoga, kui need on olemas.

GSC näitab tulemusi Google’i otsingus. Kui tahad uurida mõõdetud külastajate tegevust pärast saabumist—seansse, kaasatust või salvestatud võtmesündmusi—kasuta kõrval Google Analyticsi MCP-d. Ühendus ei ava konkurentide privaatseid andmeid.

URL Inspection tagastab Google’i indeksisse salvestatud info. See ei kontrolli reaalajas lehe indekseeritavust ega sunni Google’it lehte indekseerima. URL Inspectioni API

Enne alustamist

Vaja on ligipääsu Search Console’i andmevarale ehk veebisaidi kirjele, õigust luua või kasutada Google Cloudi projekti ning paigaldatud MCP-toega AI-klienti. Cloudi projekt annab API kasutamiseks vajalikud mandaadid; see ei anna iseenesest ligipääsu veebisaidi Search Console’i andmetele.

Kasuta macOS-is Terminali ja Windowsis PowerShelli. Windowsi näited on mõeldud otse Windowsis töötava Pythoni ja AI-klientide jaoks. WSL-il on oma paigaldused ja failiteed, seega hoia see seadistus ühes keskkonnas. Paigalda valitud klient selle ametliku juhendi järgi: Claude Code, Claude Desktop või Codex.

1. Paigalda Python, pipx ja server

Järgi oma operatsioonisüsteemi juhiseid. Kui tegid juba Analyticsi ühenduse, saad kasutada olemasolevat Pythonit ja pipx-i; MCP-serverid paigaldatakse siiski eraldi keskkondadesse.

macOS

Kui Homebrew on olemas, käivita:

brew install python@3.13 pipx
pipx ensurepath

Ava uus Terminali aken ja paigalda fikseeritud serveriversioon:

pipx install --python "$(brew --prefix python@3.13)/bin/python3.13" mcp-search-console==0.4.1

Windows PowerShell

Paigalda Python 3.13 WinGetiga:

winget install --exact --id Python.Python.3.13

Sulge ja ava PowerShell uuesti. Seejärel paigalda pipx ja lisa selle käivitusfailide kaustad PATH-i:

py -3.13 --version
py -3.13 -m pip install --user pipx
py -3.13 -m pipx ensurepath

Sulge ja ava PowerShell veel kord, enne kui kasutad käsku pipx otse:

pipx --version
pipx install --python (py -3.13 -c 'import sys; print(sys.executable)') 'mcp-search-console==0.4.1'

py -3.13 valib konkreetse Pythoni versiooni, et pakett ei satuks kogemata teise keskkonda. Kui WinGet puudub, kasuta ametlikku Python 3.13 Windowsi installerit ning jäta pip ja Pythoni käivitaja paigalduse valikutesse. Seejärel jätka pipx-i käskudest. Python Windowsis · WinGeti pakett · pipx-i paigaldamine

2. Luba API ja laadi alla OAuthi kliendi fail

Google Cloud Console’is:

  1. Loo või vali projekt. Võid kasutada Analyticsi jaoks loodud projekti, kuid iga API tuleb eraldi lubada.
  2. Ava APIs & Services → Library, otsi Google Search Console API ja luba see valitud projektis.
  3. Ava Google Auth Platform. Kui rakendus pole veel seadistatud, vali Get started ning sisesta rakenduse nimi, toe e-posti aadress ja kontaktandmed.
  4. Vali sobiv sihtrühm. Isikliku Google’i konto puhul vali External. Kui rakendus jääb olekusse Testing, lisa kasutatav Google’i konto jaotises Audience → Test users.
  5. Ava Data Access → Add or remove scopes ja lisa https://www.googleapis.com/auth/webmasters.readonly.
  6. Ava Clients → Create client, vali Desktop app ja loo klient. Laadi alla selle JSON-fail, kui seda pakutakse. Säilita originaalfail; ära koosta seda väärtusi käsureale kopeerides uuesti.

Neid vaateid selgitavad Google’i Auth Platformi tutvustus, OAuthi kliendi juhend ja õiguste seadistamise juhend.

Anna rakendusele luba selle Google’i kontoga, millel on ligipääs sinu Search Console’i andmevarale. Välise rakenduse Testing-olekus kehtib selle õigusega värskendustoken seitse päeva. Testing sobib esmaseks proovimiseks, kuid võib nõuda korduvat autoriseerimist. Rakenduse avaldamisolek ja Google’i verifitseerimisnõuded on eraldi asjad. Google OAuthi aegumisreeglid

Minu algses seadistuses õnnestus Google’isse sisse logida, kuid andmevarade loetlemine andis vea 403 accessNotConfigured: Search Console’i API oli projektis lubamata. Autentimine ja API aktiveerimine on eri sammud.

Loo selle ühenduse jaoks eraldi kaust.

macOS:

mkdir -p "$HOME/.config/mcp-gsc"
chmod 700 "$HOME/.config/mcp-gsc"

Windows PowerShell:

$GscConfigDir = Join-Path $env:USERPROFILE '.config\mcp-gsc'
New-Item -ItemType Directory -Force -Path $GscConfigDir | Out-Null
Write-Output $GscConfigDir

Salvesta allalaaditud fail sellesse kausta nimega oauth_client.json. macOS-is piira failile ligipääsu:

chmod 600 "$HOME/.config/mcp-gsc/oauth_client.json"

Hoia mandaadid ja tokenid oma kasutajaprofiilis, väljaspool koodihoidlat või jagatud kausta. Unixi chmod-režiimid ei seadista Windowsi ligipääsuõigusi.

3. Lisa ainult lugemiseks mõeldud käivitaja

Algne server küsib laiemat õigust webmasters ning pakub ka andmevarade ja saidikaartide muutmise tööriistu. Aruannete jaoks sobib Google’i kitsam õigus webmasters.readonly. Allolev kohandatud käivitaja valib selle ning eemaldab viis muutmist võimaldavat tööriista. See on konkreetsele paketiversioonile tehtud kohandus, mitte serveri ametlik GSC_SCOPE seadistus. Google’i õiguste kirjeldus · Serveri lähtekood

Salvesta järgnev nimega read_only_server.py samasse kausta, kus on oauth_client.json. Kasuta lihttekstiredaktorit ja UTF-8 kodeeringut. Veendu, et failinime lõppu ei lisanduks .py.txt.

Võid ka sama käivitaja alla laadida ja sellesse kausta salvestada.

import os
import sys
from importlib.metadata import version
from pathlib import Path

if os.name == "posix":
    os.umask(0o077)

root = Path.home() / ".config" / "mcp-gsc"
root.mkdir(mode=0o700, parents=True, exist_ok=True)
if os.name == "posix":
    root.chmod(0o700)

os.environ["GSC_CONFIG_DIR"] = str(root)
os.environ["GSC_OAUTH_CLIENT_SECRETS_FILE"] = str(
    root / "oauth_client.json"
)
os.environ["GSC_ALLOW_DESTRUCTIVE"] = "false"
os.environ["GSC_DATA_STATE"] = "final"
os.environ["MCP_TRANSPORT"] = "stdio"

if version("mcp-search-console") != "0.4.1":
    raise RuntimeError("This launcher requires mcp-search-console==0.4.1")

import gsc_server

gsc_server.SCOPES = [
    "https://www.googleapis.com/auth/webmasters.readonly"
]
# This guide uses the explicitly configured OAuth account only.
gsc_server.get_gsc_service = gsc_server.get_gsc_service_oauth

for name in (
    "add_site", "delete_site", "submit_sitemap",
    "delete_sitemap", "manage_sitemaps",
):
    gsc_server.mcp.remove_tool(name)

# Upstream's static help text may advertise the removed mutation tools.
if hasattr(gsc_server, "get_capabilities"):
    gsc_server.mcp.remove_tool("get_capabilities")

if __name__ == "__main__":
    if "--login" in sys.argv:
        gsc_server.get_gsc_service()
        print("Credentials loaded. Next, verify property access and a report.")
    else:
        gsc_server.main()

Käivitaja fikseerib ühendusviisiks kohaliku stdio ja kasutab otse OAuthi, et varasemad teenusekonto seaded ei valiks taustal teist kontot. Kui serveril on olemas staatilise abitekstiga tööriist get_capabilities, eemaldatakse ka see: selle tekst võib endiselt pakkuda siin eemaldatud muutmistööriistu. AI-klient saab tööriistade tegeliku loendi tavapärase MCP-ühenduse kaudu.

Paketiversiooni kontroll ja tööriistade eemaldamisel tekkivad vead on tahtlikud: kui oodatud liides muutub, peab käivitumine nähtava veaga peatuma. Enne paketi uuendamist vaata käivitaja üle. Aruanded kasutavad vaikimisi lõplikke andmeid; kõige värskemad näitajad võivad siia jõuda hiljem kui värskeid andmeid näitavasse veebiliidesesse.

Kas ühendus oli varem laiemate õigustega olemas?

Kitsama õiguse küsimine ei tühista varasemat luba ja server võib kasutada juba salvestatud tokenit. Enne kui pead olemasolevat ühendust ainult lugemiseks mõeldud ühenduseks:

  1. Sulge seda seadistust kasutavad AI-kliendid.
  2. Eemalda vastava rakenduse varasem luba oma Google’i konto ühenduste alt.
  3. Kustuta selle seadistuse salvestatud token alloleva käsuga.
  4. Tee sisselogimissamm uuesti ja kontrolli tegelikku ligipääsu andmetele.

macOS:

rm -f "$HOME/.config/mcp-gsc/token.json"

Windows PowerShell:

$GscToken = Join-Path $env:USERPROFILE '.config\mcp-gsc\token.json'
if (Test-Path -LiteralPath $GscToken) {
    Remove-Item -LiteralPath $GscToken
}

Loa tühistamine võib muuta kehtetuks sama kasutaja autoriseeringud ka selle Google Cloudi projekti teistele OAuthi klientidele. Kui kasutasid Analyticsiga sama projekti, võib olla vaja ka Analytics uuesti ühendada. Google’i tokeni tühistamise reeglid

4. Logi sisse ja leia Pythoni täpne failitee

Käivita fail selle paketi pipx-keskkonna Pythoniga. Käsud küsivad pipx-i asukohta ega eelda vaikimisi paigalduskausta. Virtuaalkeskkonda ei pea eraldi aktiveerima. pipx-i failiteed

macOS:

GSC_PYTHON="$(pipx environment --value PIPX_HOME)/venvs/mcp-search-console/bin/python"
GSC_LAUNCHER="$HOME/.config/mcp-gsc/read_only_server.py"
"$GSC_PYTHON" "$GSC_LAUNCHER" --login
printf '%s\n' "$GSC_PYTHON" "$GSC_LAUNCHER"

Windows PowerShell:

$GscPipxHome = (pipx environment --value PIPX_HOME).Trim()
$GscPython = Join-Path $GscPipxHome 'venvs\mcp-search-console\Scripts\python.exe'
$GscLauncher = Join-Path $env:USERPROFILE '.config\mcp-gsc\read_only_server.py'
& $GscPython $GscLauncher --login
Write-Output $GscPython
Write-Output $GscLauncher

Lõpeta Google’i sisselogimine brauseris ja kinnita lugemisõigus. Token salvestatakse käivitajaga samasse kausta faili token.json. Jäta väljastatud Pythoni ja käivitaja failiteed alles. Teade kinnitab mandaatide laadimist; järgmine andmepäring kontrollib, kas nendega saab sinu andmevara lugeda.

5. Ühenda valitud AI-⁠klient

Piisab ühest allolevast seadistusest. Hoia CLI-käskude jaoks sama terminaliaken lahti, et failiteede muutujad oleksid alles. Uues aknas määra kõigepealt uuesti 4. sammu muutujad.

Codex

macOS:

codex mcp add google-search-console -- "$GSC_PYTHON" "$GSC_LAUNCHER"

Windows PowerShell:

codex mcp add google-search-console -- $GscPython $GscLauncher

See lisab ühenduse Codexi kasutajapõhistesse seadetesse, nii et seda saab kasutada eri kohalikes projektides. Projektipõhised seaded ja organisatsiooni piirangud võivad saadavust siiski mõjutada. Codexi MCP seadistamine

Claude Code

macOS:

claude mcp add --scope user --transport stdio google-search-console -- "$GSC_PYTHON" "$GSC_LAUNCHER"

Windows PowerShell:

claude mcp add --scope user --transport stdio google-search-console -- $GscPython $GscLauncher

--scope user teeb ühenduse kättesaadavaks sinu kasutaja eri projektides. Claude Code’is näitab käsk /mcp serveri olekut. Claude Code’i MCP ulatused

Claude Desktop

Ava Claude Desktop vähemalt korra. Seejärel ava seadistusfail rakenduse arendajaseadetest või leia see siit:

SüsteemSeadistusfail
macOS~/Library/Application Support/Claude/claude_desktop_config.json
Windows%APPDATA%\Claude\claude_desktop_config.json

Lisa google-search-console kirje olemasolevasse mcpServers objekti. Säilita teised seaded ja serverid. Asenda näidisteed 4. sammus saadud täpsete failiteedega. Ära kasuta JSON-i väärtustes käsureamuutujaid nagu $HOME või %USERPROFILE%.

macOS-i näide:

{
  "mcpServers": {
    "google-search-console": {
      "command": "/ABSOLUTE/PATH/TO/PIPX_PYTHON",
      "args": [
        "/Users/YOUR_NAME/.config/mcp-gsc/read_only_server.py"
      ]
    }
  }
}

Windowsi näide: kasuta JSON-i failiteedes kaldkriipse / või kirjuta iga kurakaldkriips topelt: \\.

{
  "mcpServers": {
    "google-search-console": {
      "command": "C:/FULL/PATH/TO/pipx/venvs/mcp-search-console/Scripts/python.exe",
      "args": [
        "C:/Users/YOUR_NAME/.config/mcp-gsc/read_only_server.py"
      ]
    }
  }
}

Salvesta JSON UTF-8 kodeeringus. Pärast seadete muutmist sulge rakendus täielikult ja ava uuesti. CLI-klientides alusta uut seanssi. Claude Desktopi seadistusfailide asukohad

6. Kontrolli ühendust ja küsi seejärel midagi kasulikku

Alusta nii:

Kasuta Google Search Console’i MCP-serverit ja loetle andmevarad, millele mul on ligipääs. Näita igaühe täpset identifikaatorit ja minu õiguste taset.

Vali vastusest üks identifikaator. sc-domain:example.com ja https://example.com/ on erinevad andmevarad. Säilita Google’i tagastatud täpne kirjapilt, sealhulgas lõpus olev kaldkriips.

Kontrolli esmalt väikest aruannet:

Kasuta selle andmevara jaoks tööriista get_advanced_search_analytics parameetriga data_state="final" ja küsi kümme peamist otsingupäringut ühe täieliku 28-päevase perioodi kohta. Näita täpseid algus- ja lõppkuupäevi, klikke, näitamisi, CTR-i ja keskmist positsiooni. Märgi viimane kuupäev, mille kohta andmeid tagastati, ning andmete piirangud. Ära mõtle puuduvaid väärtusi välja.

Kasulikum jätkupäring:

Võrdle kaht järjestikust täielikku 28-päevast perioodi, kasutades lõplikke andmeid. Näita täpseid perioode ja leia lehed, mille klikid vähenesid. Vaata iga kandidaadi puhul päringute, näitamiste ja positsioonide muutusi. Erista andmetest nähtavat võimalike põhjuste oletustest ning paku iga lehe jaoks üks järgmine kontroll.

See tööriist toetab täpseid kuupäevi ja tulemuste lehekaupa küsimist. Google’i API tagastab eelkõige peamised read ega taga iga otsingupäringu tagastamist. Piiratud või filtreeritud ridade summat ei tohiks esitada kogu saidi tulemusena. Värsked andmed võivad veel täieneda. Search Analyticsi API kirjeldus

Levinud seadistusvead

Kui serveri olek on ühendatud, aga Claude Code tööriistu ei näita, kontrolli sellest MCP-tööriistade leidmise juhisest, mida server pakub, millised õigused rakenduvad ja kuidas toimub vajaduspõhine laadimine.

SümptomMida kontrollida?
403 accessNotConfiguredLuba Google Search Console API OAuthi kliendi projektis. Äsja tehtud muudatuse jõustumine võib veidi aega võtta.
Andmevarasid ei ilmu või saad õiguste veaKontrolli Google’i kontot, ligipääsu andmevarale ja selle täpset identifikaatorit.
Windows ei tunne käsku pipxKäivita py -3.13 -m pipx ensurepath ning sulge ja ava PowerShell uuesti.
py -3.13 ei tööta või ei leia PythonitKontrolli Pythoni ja selle käivitaja paigaldust. Vajadusel kasuta ametlikku Windowsi installerit.
Python ei leia moodulit gsc_serverKasuta 4. sammus leitud pipx-keskkonna Pythonit, mitte mõnda teist süsteemi Pythonit.
Käivitumisel tekib versiooni või tööriista eemaldamise vigaKontrolli paketti mcp-search-console==0.4.1 ja käivitaja täielikkust. Ära jäta kohustuslike muutmistööriistade eemaldamise vigu tähelepanuta.
Ühendus töötab ainult ühes hoidlasKontrolli Claude Code’i kasutajapõhist ulatust või Codexi kasutajaseadeid ning projekti võimalikke eriseadeid.
Login aegub seitsme päeva pärastKontrolli, kas väline OAuthi rakendus on endiselt Testing-olekus. Pärast sobiva seadistuse valimist anna luba uuesti. Vaata, miks võib Google’i OAuth-ühendus seitsme päeva järel katkeda.
MCP olek on roheline, aga aruanded ebaõnnestuvadProovi andmevarade loendit ja päris aruannet. Käivitunud protsess ei tõenda Google’i API kasutusõigust.

Kas kohalik MCP on täiesti privaatne või piiramatu?

Kohalik tähendab, et MCP-protsess töötab sinu arvutis. See teeb endiselt päringuid Google’i API-le ning pilvepõhisele AI-abilisele tagastatud aruandeandmeid töötleb selle teenuse pakkuja vastavalt sinu konto seadetele ja tingimustele. Google’i mandaadid peaksid jääma kohalikesse failidesse. Ära kleebi neid vestlusse ega lisa Giti.

API-l on ka kasutuspiirangud. URL Inspectioni praegune piirang on 2000 päringut päevas ühe andmevara kohta. Kontrolli seega vajalikke URL-e väikeste partiidena. Search Console’i API piirangud

Siinne stdio seadistus on mõeldud kohalikus arvutis töötavale kliendile. Selle lisamine ei tee ühendust iseenesest kättesaadavaks brauseris avatud ChatGPT või Claude’i vestlusele ega loo pidevalt töötavat pilveteenust.

Kas GSC ühendamine parandab positsioone?

Ühendus teeb olemasolevad andmed mugavamini kasutatavaks. Järgmine samm on endiselt sisuline või tehniline otsus: uurida languse põhjust, täiendada lehte, mis ei vasta päringule piisavalt hästi, või lahendada indekseerimisprobleem. Kasuta aruannet järgmise tegevuse valimiseks ning mõõda seejärel muutust.

Et näha ka mõõdetud tegevusi pärast veebisaidile saabumist, jätka Google Analyticsi MCP seadistusjuhendiga. See lühivastus selgitab, miks Search Console’i klikid ja GA4 sessioonid erinevad.

Kuidas aidata otsingust tulnud külastajal edasi liikuda?

Kasulik sisu vajab enda kõrvale selget veebilehte. Aitan parandada lehe struktuuri, kiirust ja teekonda artiklist teenuse, toote või päringuvormini.

Vaata, kuidas ehitan ja täiendan ettevõtete veebilehti⁠

Kirjutanud Henry Lõiv

Seotud juhendid

  1. Kuidas leida Search Console’i, GA4 ja AI abil veebilehe järgmised parandused Leia Search Console’i, GA4 ja AI abil veebilehe järgmised parandused. Väljamõeldud näide, tööleht ja päringud, millega kontrollida andmeid ning tulemust. JuhendSEO ja AI-otsing 3 min lugemist
  1. Parimad AI-agendid 2026: Grok Bot, Dots ja ligipääs Eestis Milline AI-agent sobib sinu tööks ja milliseid neist saab Eestis kasutada? Võrdlus koos kehtivate ligipääsutingimustega. Tehisintellekt 4 min lugemist
  2. AI-agent, vestlusrobot või automatiseerimine: mida sinu ettevõte vajab? Vestlusrobot on kasutajaliides; agent on üks viis selle taga olevat tööd korraldada. Kliendipäringu näide aitab valida ettevõttele sobiva lahenduse. Tehisintellekt 6 min lugemist
  3. Claude Code või Codex frontendi arenduses: praktiline võrdlus Dokumentatsioonil põhinev võrdlus, korratav frontendi harjutus ja tühi hindamisleht. Mõõdetud võitjat ei väideta. Tehisintellekt 6 min lugemist

Hei!

Ma armastan väga merd, jahte, päikeseloojanguid ja tähistaevast.

Läbi selle väikese 3D-maailma saan Sinuga jagada tükikest endast.

Aitäh, et selle pudeli avasid ja mu kirja lugesid.

Henry

Räägime sinu projektist

Kirjelda oma projekti

Räägi, mida soovid luua või paremaks teha. Valmis lähteülesannet pole vaja — täpsustame töömahu ja järgmised sammud koos.

01 Millega saan aidata?
02 Mitu lehte on vaja?
03 Milliseid lisasid veebileht vajab? Vali kõik sobivad
04 Millal peab töö valmis olema?
05 Projekti üksikasjad
06 Sinu kontaktandmed

Päring on vastu võetud

Aitäh!

Päring on vastu võetud. Vastan e-posti teel tavaliselt 2 tööpäeva jooksul.