Sådan forbinder du Google Search Console med Claude Code via MCP

Forbind Claude Code med Google Search Console via en ekstern MCP-server, test godkendelsen, og kør rigtige SEO-tjek direkte fra din terminal.

TL;DR

Du kan give Claude Code adgang til dine data fra Google Search Console ved at tilføje en godkendt MCP-server. Med GSC Magic kører du claude mcp add --transport http --scope user gsc-magic https://mcp.gscmagic.com/mcp, åbner /mcp, godkender forbindelsen og beder Claude liste de tilgængelige ejendomme. Kør en lille skrivebeskyttet forespørgsel, før du stoler på en større SEO-audit.

Hvorfor forbinde Search Console med en kodeassistent?

Claude Code er nyttig, når SEO-arbejdet handler om selve webstedet. Du kan gennemgå skabeloner, rette omdirigeringer, ændre sidetitler, teste et build og kigge et sitemap igennem i det samme udviklingsmiljø. Men din kildekode kan ikke fortælle dig, hvilken side der mistede 300 Google-klik i sidste uge.

Uden adgang til Search Console kan en assistent se på en side og komme med fornuftige forslag. Den kan ikke skelne mellem et problem med høj prioritet og noget, ingen søger efter. Den forskel betyder meget, når tiden er knap.

En MCP-forbindelse tilfører en manglende kilde til belæg. Du kan bede Claude Code om at finde de berørte URL’er i Search Console, sammenligne dem med de lokale sideskabeloner og forberede kodeændringer, der bygger på en egentlig undersøgelse.

Denne guide handler om arbejdsgangen i Claude Codes terminal, ikke om den almindelige connector på Claudes websted. Arbejder du mest i en browser, så brug vores opsætningsguide til Claude og Search Console.

Det skal du have klar, før du kører en kommando

Du skal have Claude Code installeret og kørende i en terminal, en Google-konto med adgang til den ønskede Search Console-ejendom og en MCP-server, der kan hente ejendommens data. Serveren kan være selvhostet eller ekstern.

Trinnene nedenfor bruger GSC Magics hostede endpoint. Ifølge dokumentationen til GSC Magic understøtter det Streamable HTTP-transport og login via OAuth eller et adgangstoken. Din konto skal være oprettet, og tjenesten skal være tilgængelig; at du har indtastet en gyldig URL, betyder ikke automatisk, at godkendelsen er lykkedes.

Begynd med at bekræfte, at Claude Code selv kører. Åbn det i et almindeligt projekt, og kontrollér, at du kan skrive prompts. Du behøver ikke klone hele dit produktionswebsted blot for at teste en skrivebeskyttet forbindelse til Search Console.

Før du forbinder, så beslut, om arbejdet gælder ét websted eller flere. Det er let at vælge den forkerte Search Console-ejendom, når en Google-konto har adgang til kundewebsteder, staging-domæner og gamle ejendomme med URL-præfiks.

Trin 1: tilføj det eksterne MCP-endpoint

Åbn din terminal, og kør følgende kommando:

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

Sådan hænger delene sammen. claude mcp add registrerer en server i Claude Code. Transporten http angiver en ekstern MCP-tjeneste frem for en lokal kørbar fil. --scope user gør connectoren tilgængelig i din konfiguration på brugerniveau. Det korte navn gsc-magic er blot den identifikator, du ser på din værktøjsliste.

URL’en er det eksterne endpoint, som er dokumenteret for GSC Magic. Det er ikke URL’en på din Search Console-ejendom, dit websteds sitemap eller et endpoint hos Google.

Hvorfor bruge scope user? Hvis du laver SEO-arbejde på tværs af flere lokale projekter, er en forbindelse på brugerniveau praktisk. Til et delt repository eller et følsomt kundemiljø bør du læse reglerne for konfigurationsscopes i Claude Code og dit teams politik, før du tilføjer eksterne integrationer.

Den generelle MCP-kommando og vejledningen om transport finder du i Anthropics dokumentation til Claude Code. Slå op dér, hvis en CLI-indstilling ændrer sig i en nyere version.

Trin 2: godkend i Claude Code

Start Claude Code, og skriv:

/mcp

Vælg serveren gsc-magic. Hvis klienten tilbyder handlingen Authenticate, så følg den og gennemfør login i browseren. Brug den Google-konto, der har de rigtige tilladelser til Search Console-ejendommen.

Send ikke din Google-adgangskode, OAuth-autorisationskode eller dit adgangstoken som en almindelig chatbesked. Godkendelsen er et selvstændigt trin, som klienten og serveren håndterer. Hvis din browser åbner, men godkendelsen aldrig bliver gennemført, så gå tilbage til MCP-menuen og se forbindelsens status, før du prøver igen.

I nogle miljøer kan browserbaseret OAuth ikke gennemføres. Her dokumenterer GSC Magic personlige adgangstokens under Connect → Access tokens i sit dashboard. En forbindelse med token bruger en header, for eksempel:

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

Det er en skabelon, ikke en fungerende legitimation. Erstat pladsholderen via en sikker lokal konfiguration, og læg den ikke i Git. Hvis du kun har brug for rapporter om analytics og indeksering, så opret et skrivebeskyttet token. Platformens dokumentation forklarer udløb, tilbagekaldelse og tilladelser for tokens.

Trin 3: bevis, at forbindelsen virker

Begynd ikke med “gennemgå hele mit websted, og ret alt”. Bed om ét svar, du kan kontrollere.

List de Google Search Console-ejendomme, som denne forbindelse har adgang til. Medtag de præcise ejendomsidentifikatorer og tilladelsesniveauer, hvis de er tilgængelige. Analysér ikke en ejendom, før jeg har valgt den.

Det kontrollerer flere ting på én gang: klienten kan finde serverens værktøjer, serveren kan godkende mod Google, og din Google-konto kan se mindst én ejendom.

Vælg den præcise ejendomsidentifikator, du har brug for. En ejendom skrevet som sc-domain:example.com kan omfatte subdomæner. En ejendom med URL-præfiks som https://www.example.com/ dækker et snævrere udsnit af URL’er. En overset uoverensstemmelse kan få en trafiksammenligning til at se forkert ud, selv om værktøjet virker helt, som det skal.

Er listen tom, så tjek først din Google-konto og tilladelserne på ejendommen. Gå ikke ud fra, at serveren er i stykker.

Trin 4: kør en brugbar første SEO-sammenligning

En god første opgave er afgrænset, målbar og nem at gentage:

Sammenlign for den valgte Search Console-ejendom de seneste 28 fulde rapporteringsdage med de foregående 28 dage. Vis de præcise datointervaller, samlede klik, eksponeringer og CTR, og list derefter de ti sider med det største absolutte tab af klik. Brug data fra Search Console, ikke estimater. Mærk mulige forklaringer som hypoteser.

Du kan efterprøve rapporten i Performance-visningen i Search Console. Hvis totalerne afviger, så kontrollér valgene til aggregering, tidszoner, søgetyper og om dataene er endelige. Google tæller klik og eksponeringer efter sine egne rapporteringsdefinitioner, ikke efter GA4’s regler for sessioner.

Bed derefter Claude Code om at gå i dybden med én side:

Sammenlign for den URL, der har tabt flest klik, de ti bedste søgeforespørgsler mellem de to perioder. Gruppér væsentlige ændringer efter enhed og land. Fortæl mig, hvilke observationer der berettiger til at undersøge sidens skabelon, og hvilke der ikke gør.

Her bliver en kodeassistent nyttig. Hvis siden mistede synlighed på mobil, kan du gennemgå mobilnavigation, responsivt layout og rendering. Hvis siden mistede eksponeringer for en snæver gruppe søgeforespørgsler, kan du se på sidens indhold og interne links. Men lad ikke modellen behandle sammenfald som bevis.

Trin 5: knyt dataene til din faktiske webstedskode

Antag, at Search Console peger på en vigtig produkt-URL med faldende klikrate. Bed Claude Code finde den rute eller skabelon, der står for sidens HTML-titel, beskrivelse og overskrifter.

Et fornuftigt forløb ser sådan ud:

  1. Find siden eller skabelonen i dit projekt.
  2. Gennemgå den nuværende titel, canonical-URL, overskriftsstruktur og det primære indhold.
  3. Læs de søgeforespørgsler, der gav eksponeringer til siden.
  4. Foreslå en begrænset forbedring, der passer til sidens faktiske indhold.
  5. Vis en diff, før der ændres noget.
  6. Kør dit sædvanlige build og dine tests.
  7. Notér udrulningsdatoen, så du kan sammenligne senere.

Ikke alle sider med lav CTR har brug for en ny titel. En side kan rangere på brede informationssøgninger med lille klikintention, eller dens gennemsnitlige placering kan have ændret sig. Brug guiden til analyse af lav CTR, før du omskriver metadata ud fra ét enkelt tal.

Bed aldrig Claude Code om at slette eller omdirigere sider, blot fordi to URL’er deler en søgeforespørgsel. Det kan gøre mere skade end det oprindelige problem.

Sådan bygger du et gentageligt ugentligt workflow

Du kan gemme analyseprompten i dine noter eller i projektets interne runbook. Claude Code behøver ikke huske den forrige samtale, hvis prompten angiver rapportens parametre.

Bed om de samme fulde vinduer på 7 eller 28 dage hver gang, og angiv den valgte ejendom. Få assistenten til at returnere en tabel med URL, klik i hver periode, absolut ændring, relativ ændring og den søgeforespørgsel, der bidrager mest. Hold den første version skrivebeskyttet.

Efter rapporten kan du bede om en handlingsplan på højst tre punkter. Et brugbart punkt har et observeret signal, ét foreslået tjek, en ansvarlig og en måde at måle resultatet på.

For eksempel: “Dokumentationssiden mistede 120 klik, mest på søgeforespørgsler om opsætning på desktop. Tjek, om siden stadig svarer til den aktuelle version af integrationsvejledningen; opdatér kun, hvis indholdet er forældet.” Det er langt mere handlingsorienteret end “Forbedr indholdets kvalitet.”

Hvis du planlægger scripts eller agenter, så styr gentagne kald, og respektér kvoterne for Search Console API’et. En ugentlig rapport bør ikke kræve hundredvis af dublerede forespørgsler.

Fejlfinding af almindelige problemer

Det ser duSandsynligt næste tjek
Serveren er registreret, men dens værktøjer manglerÅbn /mcp igen; tjek transport og forbindelsesstatus
OAuth åbner den forkerte Google-kontoLog ud af den utilsigtede konto, og gennemgå den godkendte identitet
Værktøjerne virker, men ingen websteder visesKontrollér ejerskab eller delegeret adgang i Search Console
En forespørgsel returnerer ingen rækkerTjek datoer, søgetype, filtre, og om ejendommen havde data
En inspektionsforespørgsel fejlerTjek URL’ens tilhørsforhold, scopes, udbyderens kvote og værktøjets tilgængelighed
En rapport ser inkonsistent udSammenlign de præcise datovinduer og aggregering på side- kontra ejendomsniveau

Hvis assistenten melder en værktøjsfejl, så læs den faktiske fejlmeddelelse, før du prøver en anden prompt. At omformulere en forespørgsel løser hverken et tilbagekaldt token eller et websted, din konto ikke har adgang til.

Googles reference til Search Analytics API’et dokumenterer datogrænser, dimensioner, begrænsninger og aggregering. Når du kender dem, undgår du overraskende mange fejlagtige SEO-diagnoser.

Tilladelser og sikkerhed, når kode og søgedata mødes

Det er stærkt at forbinde Search Console-data med en kodeassistent, fordi assistenten måske også har adgang til filsystemet. Netop derfor bør du holde undersøgelse adskilt fra implementering.

Behandl rapporteringsværktøjer som skrivebeskyttede, når det er muligt. Bed om forslag til kodeændringer som diffs, og gennemgå dem, før assistenten skriver eller udruller noget. Brug dit sædvanlige Git-workflow og dine sædvanlige kontroller. Arbejder du med kunders ejendomme, så undgå at blande data fra urelaterede kunder i én rapport.

GSC Magic dokumenterer skrivebeskyttede tokens og separate kontroller for skrivetilstand. Værktøjerne til Google Search Console omfatter læsning af analytics og status for indekserede URL’er, mens administrative handlinger som at indsende et sitemap kræver en stærkere tilladelse. Den adskillelse er vigtigere end antallet af værktøjer, connectoren oplister.

Husk, at Googles URL Inspection API ikke anmoder om indeksering. Dens resultater om den indekserede version er noget andet end en live URL-test. Det separate Google Indexing API understøtter kun begrænsede indholdstyper og bør ikke bruges som genvej for almindelige sider.

Ofte stillede spørgsmål

Kan Claude Code tilgå Google Search Console direkte uden MCP?

Ikke som standard. Du skal bruge en anden godkendt vej, for eksempel et brugerdefineret API-script eller en importeret eksport. MCP er én standardmåde at gøre de kald tilgængelige som værktøjer, Claude Code kan bruge.

Er det den samme opsætning som Claude på nettet?

Nej. Claude Code bruger en MCP-konfiguration, der styres fra CLI’en. Claudes webapp har sin egen brugerflade til connectors. Datakilden kan være den samme, men forbindelsestrinnene er forskellige.

Kan Claude Code rette tekniske SEO-problemer automatisk?

Den kan hjælpe med at redigere de filer, den har tilladelse til at tilgå, men belæg fra Search Console beviser ikke, at hver foreslået ændring er rigtig. Gennemgå diffs, test builds, og kræv menneskelig godkendelse til udrulning.

Kender agenten mine konverteringer i Google?

Kun hvis du godkender en passende analysekilde. Search Console rapporterer klik og eksponeringer i søgning; til sessioner og nøglehændelser skal du bruge GA4.

Hvilken opgave skal jeg prøve først?

Start med en sammenligning af to fulde perioder på 28 dage og de ti sider med de største tab af klik. Du kan bekræfte tallene, før du rører ved nogen kodeændringer.

Det praktiske resultat

Claude Code bruges bedst som bro mellem målt søgeadfærd og det websted, du faktisk kan forbedre. Brug connectoren til at finde et problem, kodebasen til at undersøge det og din sædvanlige gennemgangsproces til at lave ændringer sikkert.

Vil du kende de værktøjer, tokenvalg og forbindelsesmuligheder, der er dokumenteret lige nu, så hold dokumentationen til GSC Magic åben, mens du sætter din klient op. Til idéer til videre analyse kan du bruge vores 25 prompts til SEO-agenter.

, Grundlægger af GSC Magic

Łukasz bygger GSC Magic, MCP-serveren, der giver AI-agenter adgang til Google Search Console, Bing Webmaster Tools og GA4. Han skriver om at bruge Search Console-data sammen med Claude, ChatGPT og kodeagenter og om de SEO-workflows, disse værktøjer gør mulige.

lukaszblania.comgithub.com/lumizone

Giv din agent dine søgedata.

GSC Magic forbinder Claude, ChatGPT og Cursor med Google Search Console, Bing og GA4. Gratis plan, 7 dages Pro-prøveperiode, intet kort.

Kom i gang gratis