Så ansluter du Google Search Console till Claude Code med MCP

Varför koppla Search Console till en kodassistent?

Claude Code är användbart när SEO-arbetet gäller själva webbplatsen. Du kan granska mallar, rätta omdirigeringar, ändra sidtitlar, testa ett bygge och gå igenom en webbplatskarta i samma utvecklingsmiljö. Men din källkod kan inte tala om vilken sida som tappade 300 klick från Google förra veckan.

Utan åtkomst till Search Console kan en assistent titta på en sida och komma med rimliga förslag. Den kan inte skilja ett högt prioriterat problem från något som ingen söker efter. Skillnaden är viktig när tiden är knapp.

En MCP-anslutning ger dig en källa till belägg som annars saknas. Du kan be Claude Code ta fram de berörda URL:erna från Search Console, jämföra dem med mallarna lokalt och förbereda kodändringar som bygger på en faktisk utredning.

Den här guiden handlar om arbetsflödet i terminalen med Claude Code, inte om den vanliga connectorn på Claudes webbplats. Arbetar du mest i webbläsaren använder du i stället vår guide för att ansluta Claude till Search Console.

Det här behöver du innan du kör något kommando

Du behöver ha Claude Code installerat och fungerande i en terminal, ett Google-konto med åtkomst till den egendom i Search Console du vill arbeta med och en MCP-server som kan hämta egendomens data. Servern kan köras av dig själv eller finnas på distans.

Stegen nedan använder den hostade slutpunkten hos GSC Magic. Enligt dokumentationen för GSC Magic accepterar den transporten Streamable HTTP och stöder inloggning med OAuth eller en åtkomsttoken. Ditt konto måste vara upplagt och tjänsten tillgänglig. Att ange en giltig URL betyder inte automatiskt att autentiseringen har lyckats.

Börja med att bekräfta att Claude Code själv fungerar. Öppna det i ett vanligt projekt och kontrollera att du kan skriva prompter. Du behöver inte klona hela din produktionswebbplats bara för att testa en skrivskyddad anslutning till Search Console.

Bestäm också innan du ansluter om arbetet gäller en webbplats eller flera. Det är lätt att välja fel egendom i Search Console när ett Google-konto har åtkomst till kundwebbplatser, stagingdomäner och gamla egendomar med URL-prefix.

Steg 1: lägg till MCP-slutpunkten på distans

Öppna terminalen och kör följande kommando:

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

Så här fungerar delarna. claude mcp add registrerar en server i Claude Code. Transporten http visar att det rör sig om en MCP-tjänst på distans och inte en lokal körbar fil. --scope user gör att connectorn blir tillgänglig i din konfiguration på användarnivå. Det korta namnet gsc-magic är bara den identifierare du ser i din verktygslista.

URL:en är den slutpunkt på distans som dokumenteras för GSC Magic. Den är inte webbadressen till din egendom i Search Console, din webbplatskarta eller en slutpunkt i något Google-API.

Varför använda användarnivå? Om du gör SEO-arbete i flera lokala projekt är en anslutning på användarnivå bekväm. För ett delat repo eller en känslig kundmiljö bör du gå igenom reglerna för konfigurationsnivåer i Claude Code och ditt teams policy innan du lägger till externa integrationer.

Allmän vägledning om MCP-kommandot och transporterna finns i Anthropics dokumentation för Claude Code. Titta där om ett alternativ i CLI:t ändras i en nyare version.

Steg 2: autentisera i Claude Code

Starta Claude Code och skriv:

/mcp

Välj servern gsc-magic. Om klienten erbjuder åtgärden Authenticate följer du den och slutför inloggningen i webbläsaren. Använd det Google-konto som har rätt behörigheter till egendomen i Search Console.

Skicka aldrig ditt Google-lösenord, din OAuth-auktoriseringskod eller din åtkomsttoken som ett vanligt chattmeddelande. Autentiseringen är ett separat steg som klienten och servern sköter. Om webbläsaren öppnas men godkännandet aldrig slutförs går du tillbaka till MCP-menyn och kontrollerar anslutningens status innan du försöker igen.

Vissa miljöer kan inte slutföra OAuth i webbläsaren. I de fallen dokumenterar GSC Magic personliga åtkomsttoken under Connect → Access tokens i dashboarden. En anslutning med token använder en förfrågningsrubrik, till exempel:

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

Det här är en mall, inte en fungerande inloggningsuppgift. Byt ut platshållaren i ett säkert lokalt konfigurationsflöde och checka inte in den i Git. Behöver du bara rapporter om analys och indexering skapar du en skrivskyddad token. Plattformens dokumentation förklarar hur token löper ut, återkallas och vilka behörigheter de har.

Steg 3: bevisa att anslutningen fungerar

Börja inte med ”granska hela min webbplats och åtgärda allt”. Be om ett svar som du kan kontrollera.

Lista de egendomar i Google Search Console som den här anslutningen har åtkomst till. Ta med de exakta identifierarna för egendomarna och deras behörighetsnivåer om de finns. Analysera ingen egendom förrän jag har valt en.

Det testar flera saker samtidigt: klienten kan hitta serverns verktyg, servern kan autentisera mot Google och ditt Google-konto kan se minst en egendom.

Välj den exakta identifierare för egendomen som du behöver. En egendom som skrivs sc-domain:example.com kan omfatta underdomäner. En egendom med URL-prefix som https://www.example.com/ täcker en snävare uppsättning URL:er. Ett obemärkt misstag här kan få en trafikjämförelse att se fel ut även när verktyget fungerar helt som det ska.

Om listan är tom kontrollerar du först ditt Google-konto och behörigheterna till egendomen. Utgå inte från att servern är trasig.

Steg 4: kör en användbar första SEO-jämförelse

En bra första uppgift är avgränsad, mätbar och lätt att upprepa:

Jämför de senaste 28 hela rapportdagarna med de 28 dagarna före för den valda egendomen i Search Console. Visa exakta datumintervall, totalt antal klick, visningar och CTR och lista sedan de tio sidor som tappade flest klick i absoluta tal. Använd data från Search Console, inte uppskattningar. Märk möjliga förklaringar som hypoteser.

Du kan kontrollera rapporten i gränssnittet för prestanda i Search Console. Om summorna skiljer sig åt verifierar du val av aggregering, tidszoner, söktyper och om datan är slutgiltig. Google räknar klick och visningar enligt sina egna rapportdefinitioner, inte enligt reglerna för sessioner i GA4.

Be sedan Claude Code gå på djupet med en sida:

Jämför de tio främsta sökfrågorna mellan perioderna för den URL som tappade mest. Gruppera väsentliga förändringar per enhet och land. Tala om vilka observationer som motiverar att sidmallen undersöks och vilka som inte gör det.

Här blir en kodassistent användbar. Om sidan tappade synlighet på mobilen kan du granska mobilnavigeringen, den responsiva layouten och renderingen. Om sidan tappade visningar för en snäv grupp sökfrågor kan du titta på sidans innehåll och interna länkar. Men låt inte modellen behandla korrelation som bevis.

Steg 5: koppla datan till webbplatsens faktiska kod

Anta att Search Console pekar ut en viktig produkt-URL med sjunkande klickfrekvens. Be Claude Code hitta den route eller mall som ansvarar för sidans HTML-titel, beskrivning och rubriker.

En rimlig ordning ser ut så här:

1. Hitta sidan eller mallen i ditt projekt.
2. Granska den nuvarande titeln, canonical-URL:en, rubrikstrukturen och huvudinnehållet.
3. Läs de sökfrågor som gav visningar för sidan.
4. Föreslå en avgränsad förbättring som stämmer med sidans verkliga innehåll.
5. Visa en diff innan några ändringar görs.
6. Kör ditt vanliga bygge och dina tester.
7. Anteckna när ändringen driftsattes så att du kan jämföra senare.

Alla sidor med låg CTR behöver inte en ny titel. En sida kan ranka för breda informationssökningar med liten klickintention, eller så kan den genomsnittliga positionen ha ändrats. Använd guiden för analys av låg CTR innan du skriver om metadata utifrån ett enda tal.

Säg aldrig åt Claude Code att radera eller omdirigera sidor bara för att två URL:er delar en sökfråga. Det kan göra mer skada än det ursprungliga problemet.

Så bygger du ett repeterbart veckoarbetsflöde

Du kan spara analysprompten i dina anteckningar eller i projektets interna körbok. Claude Code behöver inte minnas den tidigare konversationen så länge prompten anger rapportens parametrar.

Be om samma hela fönster på 7 eller 28 dagar varje gång och ta med den valda egendomen. Låt assistenten returnera en tabell med URL, klick i varje period, absolut förändring, relativ förändring och den sökfråga som bidrar mest. Håll den första versionen skrivskyddad.

Be efter rapporten om en handlingsplan begränsad till tre punkter. En användbar åtgärd har en observerad signal, en föreslagen kontroll, en ansvarig och ett sätt att mäta resultatet.

Till exempel: ”Dokumentationssidan tappade 120 klick, mest på sökfrågor om installation på dator. Kontrollera om sidan fortfarande svarar mot den aktuella versionen av integrationsinstruktionerna och uppdatera bara om innehållet är föråldrat.” Det är mycket mer användbart än ”Förbättra innehållets kvalitet”.

Om du schemalägger skript eller agenter ska du styra upprepade anrop och respektera kvoterna i API:t för Search Console. En veckorapport ska inte behöva hundratals dubbla förfrågningar.

Felsökning av vanliga problem

Om assistenten rapporterar ett verktygsfel ska du läsa det faktiska felet innan du försöker med en annan prompt. Att formulera om frågan lagar inte en återkallad token eller en webbplats som ditt konto inte kommer åt.

Googles referens för Search Analytics API dokumenterar datumgränser, dimensioner, begränsningar och aggregering. Att förstå de gränserna förhindrar förvånansvärt många felaktiga SEO-diagnoser.

Behörigheter och säkerhet när kod och sökdata möts

Att koppla data från Search Console till en kodassistent är kraftfullt just för att assistenten också kan ha åtkomst till filsystemet. Det är precis därför du ska skilja på utredning och genomförande.

Behandla rapporteringsverktyg som skrivskyddade så långt det går. Be om föreslagna kodändringar som diffar och granska dem innan assistenten skriver eller driftsätter något. Använd ditt vanliga arbetsflöde i Git och dina vanliga kontroller. Om du arbetar med kunders egendomar bör du undvika att blanda olika kunders data i samma rapport.

GSC Magic dokumenterar skrivskyddade token och separata inställningar för skrivläge. Verktygen för Google Search Console omfattar att läsa analysdata och status för indexerade URL:er, medan administrativa åtgärder som att skicka in en webbplatskarta kräver starkare behörighet. Den uppdelningen är viktigare än hur många verktyg connectorn listar.

Kom ihåg att Googles API för URL-granskning inte begär indexering. Resultaten för den indexerade versionen skiljer sig från ett livetest av en URL. Det separata Google Indexing API har begränsade innehållstyper som stöds och ska inte användas som genväg för vanliga sidor.

Vanliga frågor

Kan Claude Code komma åt Google Search Console direkt, utan MCP?

Inte som standard. Du skulle behöva en annan godkänd väg, till exempel ett eget API-skript eller en importerad export. MCP är ett standardiserat sätt att göra de anropen tillgängliga som verktyg som Claude Code kan använda.

Är det här samma installation som Claude på webben?

Nej. Claude Code använder en MCP-konfiguration som hanteras via CLI. Claudes webbapp har sitt eget gränssnitt för connectors. Datakällan kan vara densamma, men stegen för att ansluta skiljer sig åt.

Kan Claude Code åtgärda tekniska SEO-problem automatiskt?

Den kan hjälpa till att redigera filer som den har behörighet att komma åt, men underlag från Search Console bevisar inte att varje föreslagen ändring är rätt. Granska diffar, testa byggen och kräv mänskligt godkännande för driftsättning.

Känner agenten till mina konverteringar i Google?

Bara om du godkänner en lämplig analyskälla. Search Console rapporterar klick och visningar i sökning, och för sessioner och nyckelhändelser behövs GA4.

Vilken uppgift bör jag testa först?

Börja med en jämförelse av två hela 28-dagarsperioder och de tio sidor som tappade flest klick. Du kan bekräfta de siffrorna innan du involverar några kodändringar.

Den praktiska slutsatsen

Claude Code används bäst som en brygga mellan uppmätt sökbeteende och den webbplats du faktiskt kan förbättra. Använd connectorn för att hitta ett problem, kodbasen för att utreda det och din vanliga granskningsprocess för att göra ändringar på ett säkert sätt.

Vill du se exakt vilka verktyg, vilka token och vilka anslutningsalternativ som för tillfället är dokumenterade, ha dokumentationen för GSC Magic öppen medan du konfigurerar din klient. För idéer till fortsatt analys kan du använda våra 25 prompter för SEO-agenter.