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üsimus | Milliseid 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
- Loo või vali projekt. Võid kasutada Analyticsi jaoks loodud projekti, kuid iga API tuleb eraldi lubada.
- Ava APIs & Services → Library, otsi Google Search Console API ja luba see valitud projektis.
- Ava Google Auth Platform. Kui rakendus pole veel seadistatud, vali Get started ning sisesta rakenduse nimi, toe e-posti aadress ja kontaktandmed.
- 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.
- Ava Data Access → Add or remove scopes ja lisa
https://www.googleapis.com/auth/webmasters.readonly. - 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:
- Sulge seda seadistust kasutavad AI-kliendid.
- Eemalda vastava rakenduse varasem luba oma Google’i konto ühenduste alt.
- Kustuta selle seadistuse salvestatud token alloleva käsuga.
- 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üsteem | Seadistusfail |
|---|---|
| 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ümptom | Mida kontrollida? |
|---|---|
403 accessNotConfigured | Luba 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 vea | Kontrolli Google’i kontot, ligipääsu andmevarale ja selle täpset identifikaatorit. |
Windows ei tunne käsku pipx | Käivita py -3.13 -m pipx ensurepath ning sulge ja ava PowerShell uuesti. |
py -3.13 ei tööta või ei leia Pythonit | Kontrolli Pythoni ja selle käivitaja paigaldust. Vajadusel kasuta ametlikku Windowsi installerit. |
Python ei leia moodulit gsc_server | Kasuta 4. sammus leitud pipx-keskkonna Pythonit, mitte mõnda teist süsteemi Pythonit. |
| Käivitumisel tekib versiooni või tööriista eemaldamise viga | Kontrolli 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 hoidlas | Kontrolli Claude Code’i kasutajapõhist ulatust või Codexi kasutajaseadeid ning projekti võimalikke eriseadeid. |
| Login aegub seitsme päeva pärast | Kontrolli, 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õnnestuvad | Proovi 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.