Google Search Consolen yhdistäminen Claude Codeen MCP:n avulla

Miksi yhdistää Search Console koodausavustajaan?

Claude Code on hyödyllinen, kun SEO-työ koskee itse verkkosivustoa. Voit tarkistaa sivupohjia, korjata uudelleenohjauksia, muuttaa sivujen otsikoita, testata buildin ja käydä läpi sivustokartan samassa kehitysympäristössä. Lähdekoodi ei kuitenkaan kerro, mikä sivu menetti viime viikolla 300 Google-napsautusta.

Ilman Search Console -pääsyä avustaja voi katsoa sivua ja tehdä järkeviä ehdotuksia. Se ei kuitenkaan erota tärkeää ongelmaa asiasta, jota kukaan ei hae. Ero on tärkeä, kun aikaa on rajallisesti.

MCP-yhteys tuo puuttuvan todisteiden lähteen. Voit pyytää Claude Codea tunnistamaan Search Consolesta ongelmista kärsivät URL-osoitteet, vertaamaan niitä paikallisiin sivupohjiin ja valmistelemaan koodimuutoksia todellisen selvityksen pohjalta.

Tämä opas käsittelee Claude Coden pääteohjattua työnkulkua, ei tavallista Clauden verkkoliitintä. Jos työskentelet pääasiassa selaimessa, käytä Clauden Search Console -käyttöönotto-opasta.

Mitä tarvitset ennen komennon ajamista

Tarvitset toimivan Claude Code -asennuksen päätteessä, Google-tilin, jolla on pääsy haluttuun Search Console -resurssiin, sekä MCP-palvelimen, joka saa kyseisen resurssin datan. Palvelin voi olla itse ylläpidetty tai etäpalvelin.

Alla olevat vaiheet käyttävät GSC Magic -palvelun pilvipäätepistettä. GSC Magic -dokumentaation mukaan se hyväksyy Streamable HTTP -siirron ja tukee OAuth-pohjaista kirjautumista tai käyttöoikeustunnusta. Tilisi on oltava luotu ja palvelun tavoitettavissa; pätevän URL-osoitteen syöttäminen ei automaattisesti tarkoita, että todennus on onnistunut.

Varmista ensin, että Claude Code itse toimii. Avaa se tavallisessa projektissa ja tarkista, että voit kirjoittaa kehotteita. Koko tuotantosivustoa ei tarvitse kloonata pelkästään vain luku -yhteyden testaamiseksi Search Consoleen.

Päätä ennen yhdistämistä, onko työ tarkoitettu yhdelle sivustolle vai useammalle. Väärän Search Console -resurssin valitsee helposti, kun Google-tilillä on pääsy asiakassivustoihin, testiverkkotunnuksiin ja vanhoihin URL-etuliiteresursseihin.

Vaihe 1: lisää etä-MCP-päätepiste

Avaa pääte ja aja seuraava komento:

claude mcp add --transport http --scope user gsc-magic https://mcp.gscmagic.com/mcp

Tässä komennon osien merkitys. claude mcp add rekisteröi palvelimen Claude Codeen. http-siirto kertoo, että kyseessä on etä-MCP-palvelu eikä paikallinen ohjelma. --scope user tekee liittimestä käytettävissä käyttäjätason konfiguraatiossasi. Lyhyt nimi gsc-magic on vain tunniste, jonka näet työkalulistassasi.

URL on GSC Magic -palvelulle dokumentoitu etäpäätepiste. Se ei ole Search Console -resurssisi URL, sivustosi sivustokartta eikä Googlen API-päätepiste.

Miksi käyttäjätason scope? Jos teet SEO-työtä useissa paikallisissa projekteissa, käyttäjätason yhteys on kätevä. Jaetussa repositoriossa tai arkaluonteisessa asiakasympäristössä tarkista Claude Coden konfiguraatiotasojen säännöt ja tiimisi käytäntö, ennen kuin lisäät ulkoisia integraatioita.

Yleiset MCP-komennot ja siirto-ohjeet löytyvät Anthropicin Claude Code -dokumentaatiosta. Tarkista se, jos jokin komentorivin valitsin muuttuu uudemmassa versiossa.

Vaihe 2: todenna Claude Codessa

Käynnistä Claude Code ja kirjoita:

/mcp

Valitse gsc-magic-palvelin. Jos asiakasohjelma tarjoaa Authenticate-toiminnon, seuraa sitä ja suorita selainpohjainen kirjautuminen. Käytä Google-tiliä, jolla on oikeat Search Console -resurssin käyttöoikeudet.

Älä lähetä Google-salasanaasi, OAuth-valtuutuskoodia tai käyttöoikeustunnusta tavallisena chat-viestinä. Todennus on erillinen vaihe, jonka asiakasohjelma ja palvelin hoitavat. Jos selain aukeaa mutta valtuutus ei koskaan valmistu, palaa MCP-valikkoon ja tarkista yhteyden tila ennen uutta yritystä.

Joissakin ympäristöissä selainpohjainen OAuth ei onnistu. Silloin GSC Magic -palvelu dokumentoi henkilökohtaiset käyttöoikeustunnukset hallintapaneelin kohdassa Connect → Access tokens. Tunnuspohjainen yhteys käyttää otsikkoa, esimerkiksi:

claude mcp add --transport http --scope user gsc-magic https://mcp.gscmagic.com/mcp \
  --header "Authorization: Bearer gsm_YOUR_TOKEN"

Tämä on malli, ei toimiva tunnus. Korvaa paikkamerkki suojatulla paikallisella konfiguraatiotyönkululla äläkä vie sitä Gitiin. Jos tarvitset vain analytiikka- ja indeksointiraportteja, luo vain luku -tunnus. Alustan dokumentaatio kertoo tunnusten vanhenemisesta, peruutuksesta ja oikeuksista.

Vaihe 3: todista, että yhteys toimii

Älä aloita pyynnöllä ”auditoi koko sivustoni ja korjaa kaikki”. Pyydä yksi vastaus, jonka voit tarkistaa.

Listaa Google Search Console -resurssit, joihin tällä yhteydellä on pääsy. Liitä mukaan tarkat resurssitunnisteet ja käyttöoikeustasot, jos ne ovat saatavilla. Älä analysoi mitään resurssia, ennen kuin valitsen sen.

Tämä testaa useita asioita kerralla: asiakasohjelma löytää palvelimen työkalut, palvelin pystyy todentamaan Googleen ja Google-tilisi näkee vähintään yhden resurssin.

Valitse tarkka tarvitsemasi resurssitunniste. Muodossa sc-domain:example.com oleva resurssi voi sisältää aliverkkotunnukset. URL-etuliiteresurssi, kuten https://www.example.com/, kattaa suppeamman URL-joukon. Huomaamatta jäänyt ristiriita voi saada liikennevertailun näyttämään vääristyneeltä, vaikka työkalu toimisi täydellisesti.

Jos lista on tyhjä, tarkista ensin Google-tilisi ja resurssin käyttöoikeudet. Älä oleta, että palvelin on rikki.

Vaihe 4: aja ensimmäinen hyödyllinen SEO-vertailu

Hyvä ensimmäinen tehtävä on rajattu, mitattavissa ja helppo toistaa:

Vertaa valitun Search Console -resurssin viimeistä 28 täyttä raportointipäivää sitä edeltäviin 28 päivään. Näytä tarkat aikavälit, napsautukset, näyttökerrat ja CTR yhteensä, ja listaa sitten kymmenen sivua, joiden napsautukset laskivat absoluuttisesti eniten. Käytä Search Console -dataa, älä arvioita. Merkitse mahdolliset selitykset hypoteeseiksi.

Voit tarkistaa saman raportin Search Consolen Suorituskyky-näkymästä. Jos kokonaisluvut poikkeavat, tarkista yhdistämisvalinnat, aikavyöhykkeet, hakutyypit ja se, onko data lopullista. Google laskee napsautukset ja näyttökerrat omien raportointimääritelmiensä mukaan, ei GA4:n istuntosääntöjen mukaan.

Pyydä seuraavaksi Claude Codea tarkentamaan yhteen sivuun:

Vertaa suurimman menetyksen URL-osoitteen kymmentä suosituinta kyselyä jaksojen välillä. Ryhmittele olennaiset muutokset laitteen ja maan mukaan. Kerro, mitkä havainnot oikeuttavat sivupohjan tutkimisen ja mitkä eivät.

Tässä koodausavustajasta tulee hyödyllinen. Jos sivu menetti näkyvyyttä mobiilissa, voit tarkistaa mobiilinavigoinnin, responsiivisen asettelun ja renderöinnin. Jos sivu menetti näyttökertoja kapealla kyselyjoukolla, voit tutkia sivun sisältöä ja sisäisiä linkkejä. Älä kuitenkaan anna mallin pitää korrelaatiota todisteena.

Vaihe 5: yhdistä data oikeaan sivustokoodiin

Oletetaan, että Search Console paljastaa tärkeän tuote-URL:n, jonka napsautussuhde laskee. Pyydä Claude Codea löytämään reitti tai sivupohja, joka vastaa sivun HTML-otsikosta, kuvauksesta ja otsikoista.

Järkevä järjestys on tämä:

1. Etsi sivu tai sivupohja projektistasi.
2. Tarkista nykyinen otsikko, kanoninen URL, otsikkorakenne ja pääsisältö.
3. Lue kyselyt, jotka toivat sivulle näyttökertoja.
4. Ehdota rajattua parannusta, joka vastaa sivun todellista sisältöä.
5. Näytä diff ennen muutosten tekemistä.
6. Aja tavallinen build ja testit.
7. Kirjaa julkaisupäivä ylös, jotta voit vertailla myöhemmin.

Kaikki matalan CTR:n sivut eivät tarvitse uutta otsikkoa. Sivu voi sijoittua laajoille informatiivisille kyselyille, joissa napsautushalukkuus on pieni, tai sen keskimääräinen sijainti on voinut muuttua. Käytä matalan CTR:n analyysiopasta, ennen kuin kirjoitat metatietoja uusiksi yhden luvun perusteella.

Älä koskaan käske Claude Codea poistamaan tai uudelleenohjaamaan sivuja pelkästään siksi, että kaksi URL-osoitetta jakaa kyselyn. Se voi aiheuttaa enemmän vahinkoa kuin alkuperäinen ongelma.

Näin rakennat toistettavan viikkotyönkulun

Voit tallentaa analyysikehotteen muistiinpanoihisi tai projektisi sisäiseen ohjekirjaan. Claude Coden ei tarvitse muistaa edellistä keskustelua, jos kehote määrittää raportin parametrit.

Pyydä joka kerta samat täydet 7 tai 28 päivän jaksot ja mainitse valittu resurssi. Pyydä avustajaa palauttamaan taulukko, jossa on URL, napsautukset kummallakin jaksolla, absoluuttinen muutos, suhteellinen muutos ja suurin kyselytason vaikuttaja. Pidä ensimmäinen versio vain luku -tilaisena.

Pyydä raportin jälkeen toimenpidesuunnitelma, joka rajoittuu kolmeen kohtaan. Hyvässä toimenpiteessä on havaittu signaali, yksi ehdotettu tarkistus, vastuuhenkilö ja tapa mitata tulos.

Esimerkiksi: ”Dokumentaatiosivu menetti 120 napsautusta, enimmäkseen asennukseen liittyvillä kyselyillä tietokoneella. Tarkista, vastaako sivu nyt integraation ohjeiden nykyistä versiota; päivitä vain, jos sisältö on vanhentunut.” Se on paljon toiminnallisempi kuin ”Paranna sisällön laatua.”

Jos ajastat skriptejä tai agentteja, hallitse toistuvia kutsuja ja noudata Search Console API:n kiintiöitä. Viikoittainen raportointi ei saisi vaatia satoja päällekkäisiä pyyntöjä.

Yleisten ongelmien vianetsintä

Jos avustaja ilmoittaa työkaluvirheestä, lue varsinainen virheilmoitus, ennen kuin kokeilet toista kehotetta. Kyselyn muotoilun muuttaminen ei korjaa peruutettua tunnusta tai sivustoa, johon tililläsi ei ole pääsyä.

Googlen Search Analytics API -viite dokumentoi päivämäärärajat, dimensiot, rajoitukset ja yhdistämisen. Näiden rajojen ymmärtäminen estää yllättävän monta virheellistä SEO-diagnoosia.

Oikeudet ja turvallisuus, kun koodi ja hakudata kohtaavat

Search Console -datan yhdistäminen koodausavustajaan on tehokasta, koska avustajalla voi olla myös pääsy tiedostojärjestelmään. Juuri siksi selvitys ja toteutus kannattaa erottaa toisistaan.

Pidä raportointityökalut mahdollisuuksien mukaan vain luku -tilassa. Pyydä ehdotetut koodin diffit ja tarkista ne, ennen kuin avustaja kirjoittaa tai julkaisee mitään. Käytä tavallista Git-työnkulkuasi ja tarkistuksiasi. Jos työskentelet asiakasresurssien kanssa, älä yhdistä toisiinsa liittymättömien asiakkaiden dataa samaan raporttiin.

GSC Magic -palvelu dokumentoi vain luku -tunnukset ja erilliset kirjoitustilan hallintaelementit. Sen Google Search Console -työkaluihin kuuluu analytiikan ja indeksoidun URL-osoitteen tilan lukeminen, kun taas hallinnolliset toimet, kuten sivustokartan lähettäminen, vaativat vahvemman oikeuden. Tämä erottelu on tärkeämpi kuin se, kuinka monta työkalua liitin listaa.

Muista, että Googlen URL Inspection API ei pyydä indeksointia. Sen indeksoidun version tulokset eroavat julkaistun URL-osoitteen reaaliaikaisesta testistä. Erillisellä Google Indexing API:lla on rajatut tuetut sisältötyypit, eikä sitä pidä käyttää oikotienä tavallisille sivuille.

Usein kysytyt kysymykset

Pääseekö Claude Code Google Search Consoleen suoraan ilman MCP:tä?

Ei oletuksena. Tarvitset toisen valtuutetun reitin, kuten oman API-skriptin tai tuodun viennin. MCP on yksi vakiintunut tapa tarjota nämä kutsut työkaluina, joita Claude Code voi käyttää.

Onko tämä sama käyttöönotto kuin Claudessa verkossa?

Ei. Claude Code käyttää komentorivillä hallittavaa MCP-konfiguraatiota. Clauden verkkosovelluksessa on oma liitinkäyttöliittymänsä. Datalähde voi olla sama, mutta yhdistämisvaiheet eroavat.

Voiko Claude Code korjata tekniset SEO-ongelmat automaattisesti?

Se voi auttaa muokkaamaan tiedostoja, joihin sillä on oikeus, mutta Search Console -todiste ei todista jokaisen ehdotetun muutoksen olevan oikea. Tarkista diffit, testaa buildit ja vaadi julkaisuun ihmisen hyväksyntä.

Tietääkö agentti Google-konversioni?

Vain, jos valtuutat sopivan analytiikkalähteen. Search Console raportoi hakunapsautukset ja näyttökerrat; istuntoihin ja avaintapahtumiin tarvitaan GA4.

Mitä tehtävää kannattaa kokeilla ensin?

Aloita kahden täyden 28 päivän jakson vertailulla ja kymmenellä sivulla, joiden napsautusmenetys on suurin. Voit varmistaa luvut ennen kuin ryhdyt koodimuutoksiin.

Käytännön johtopäätös

Claude Code toimii parhaiten siltana mitatun hakukäyttäytymisen ja sivuston välillä, jota voit oikeasti parantaa. Käytä liitintä ongelman tunnistamiseen, koodikantaa sen tutkimiseen ja tavallista tarkistusprosessiasi muutosten turvalliseen tekemiseen.

Jos haluat tarkat tällä hetkellä dokumentoidut työkalut, tunnusvaihtoehdot ja yhteysasetukset, pidä GSC Magic -dokumentaatio auki asiakasohjelmaa määrittäessäsi. Jatkoanalyysin ideoita löydät 25 kehotteesta SEO-agenteille.