Search Console összekapcsolása bármely MCP klienssel

A végpont

A szerver az app domainen a /mcp alatt érhető el, és Streamable HTTP protokollt beszél, 2025-06-18-as protokollverzióban. A kliensek JSON-RPC-t POST-olnak, elküldenek egy initialize kérést, majd egy tools/list-et. Nincs mit telepíteni, és nincs helyi proxy az útvonalban.

• Authorization: Bearer, apk_live_ formátumú kulccsal, plusz 32 hex karakter
• A kulcsok létrehozáskor csak egyszer jelennek meg, és tárolásuk kizárólag SHA-256 hash formájában történik
• Minden hívás frissíti a kulcs utolsó használatának időbélyegét és a kéréseinek számlálóját

Az eszközök

Funkció szerint csoportosítva, egyértelmű nevekkel, hogy a modell a megfelelőt válassza. Az írásvédett kulcs sosem ér el olyan eszközt, amely ír vagy kutatási krediteket költ.

• Discovery: list_properties, search_analytics
• Performance: top_queries, top_pages, top_countries, compare_periods
• Diagnosis: content_decay, cannibalization, ctr_benchmark, page_poaching, rank_changes, new_lost_rankings
• Indexing: url_inspection, sitemaps
• Timeline: annotations, és create_annotation írásra jogosult kulccsal
• Analytics: ga4_overview, ga4_breakdown, ga4_key_events
• Kutatás: kulcsszavak, SERP-ek, backlinkek, rangsorkövetés és oldalauditok, amelyek kutatási krediteket költenek
• Tartalommotor: content_list_tasks, content_claim, content_get_brief, content_submit, content_publish és a borítóeszközök, a sorból való íráshoz

A dátumok opcionálisak

Ha bármelyik eszköznél kihagyod az időszakot, a szerver az utolsó 28 lezárt napot használja, figyelembe véve a Search Console jelentési késleltetését, és az összehasonlítási időszak alapértelmezetten az azonos hosszúságú előző időszak. A kliensnek soha nem kell ismernie a mai dátumot ahhoz, hogy értelmes kérdést tegyen fel.

Scope-ok és rate limitek

Egy kulcs vagy csak olvasási, vagy olvasási és írási jogú. A csak olvasási jogú kulcs egyáltalán nem érheti el az írási eszközöket, és az írásra jogosult kulccsal végzett minden módosítás audit-naplózásra kerül.

• 60 kérés percenként kulcsonként, 1000 óránként fiókonként
• Limit túllépése esetén HTTP 429 érkezik, Retry-After értékkel másodpercben
• Egyetlen kulcs visszavonása a fiók többi részének érintése nélkül

REST, ha azt szereted jobban

A Search Console és GA4 eszközök GET és POST útvonalakként is elérhetők a /v1 alatt, egy generált OpenAPI 3.1 dokumentummal a /v1/openapi.json címen, amely függvényhívási specifikációként is szolgál. Ugyanazok a kulcsok, ugyanazok a jogosultságok, ugyanazok a korlátok.