Conectează Search Console la orice client MCP

Endpoint-ul

Serverul se află la /mcp pe domeniul aplicației și vorbește Streamable HTTP la versiunea de protocol 2025-06-18. Clienții trimit JSON-RPC prin POST, transmit o cerere initialize, apoi tools/list. Nu e nimic de instalat și niciun proxy local pe traseu.

• Authorization: Bearer cu o cheie de forma apk_live_ plus 32 de caractere hexazecimale
• Cheile sunt afișate o singură dată la creare și stocate doar ca hash SHA-256
• Fiecare apel actualizează timestamp-ul ultimei utilizări și contorul de cereri al cheii

Instrumentele

Grupate după ce fac, cu nume clare, ca un model să aleagă instrumentul potrivit. O cheie doar pentru citire nu ajunge niciodată la un instrument care scrie sau consumă credite de cercetare.

• Descoperire: list_properties, search_analytics
• Performanță: top_queries, top_pages, top_countries, compare_periods
• Diagnostic: content_decay, cannibalization, ctr_benchmark, page_poaching, rank_changes, new_lost_rankings
• Indexare: url_inspection, sitemaps
• Cronologie: annotations și create_annotation pe o cheie de scriere
• Analitice: ga4_overview, ga4_breakdown, ga4_key_events
• Cercetare: cuvinte-cheie, SERP-uri, backlinkuri, urmărirea pozițiilor și audituri de site, care consumă credite de cercetare
• Content engine: content_list_tasks, content_claim, content_get_brief, content_submit, content_publish și instrumentele pentru copertă, pentru a scrie din coadă

Datele sunt opționale

Omite intervalul pentru orice unealtă și serverul folosește ultimele 28 de zile stabilizate, ținând cont de întârzierea de raportare din Search Console, cu fereastra de comparație implicită setată la perioada anterioară de aceeași lungime. Clientul nu trebuie niciodată să știe data de azi pentru a pune o întrebare sensibilă.

Domenii și limite de rată

O cheie este doar-citire sau citire și scriere. O cheie doar-citire nu poate accesa deloc o unealtă de scriere, iar fiecare modificare pe o cheie de scriere este înregistrată în jurnalul de audit.

• 60 de cereri pe minut per cheie, 1.000 pe oră per cont
• Depășirea limitei returnează HTTP 429 cu Retry-After în secunde
• Revocă o singură cheie fără a afecta restul contului

REST, dacă preferi

Instrumentele Search Console și GA4 sunt expuse și ca rute GET și POST sub /v1, cu un document OpenAPI 3.1 generat la /v1/openapi.json, care servește și ca specificație de function calling. Aceleași chei, aceleași permisiuni, aceleași limite.