Połącz Search Console z dowolnym klientem MCP

Endpoint

Serwer znajduje się pod /mcp na domenie aplikacji i komunikuje się przez Streamable HTTP w wersji protokołu 2025-06-18. Klienci wysyłają JSON-RPC metodą POST, wysyłają żądanie initialize, a następnie tools/list. Nie trzeba niczego instalować ani używać lokalnego proxy.

• Authorization: Bearer z kluczem w formacie apk_live_ plus 32 znaki szesnastkowe
• Klucze są pokazywane tylko raz przy tworzeniu i przechowywane wyłącznie jako skrót SHA-256
• Każde wywołanie aktualizuje znacznik czasu ostatniego użycia klucza i licznik żądań

Narzędzia

Pogrupowane według zastosowania, z wyraźnymi nazwami, by model wybrał właściwe. Klucz tylko do odczytu nigdy nie uzyska dostępu do narzędzia, które zapisuje lub zużywa kredyty badawcze.

• Odkrywanie: list_properties, search_analytics
• Wydajność: top_queries, top_pages, top_countries, compare_periods
• Diagnostyka: content_decay, cannibalization, ctr_benchmark, page_poaching, rank_changes, new_lost_rankings
• Indeksowanie: url_inspection, sitemaps
• Oś czasu: annotations oraz create_annotation przy kluczu z prawem zapisu
• Analityka: ga4_overview, ga4_breakdown, ga4_key_events
• Badania: słowa kluczowe, SERP-y, linki zwrotne, śledzenie pozycji i audyty witryn, które zużywają kredyty badawcze
• Silnik treści: content_list_tasks, content_claim, content_get_brief, content_submit, content_publish i narzędzia okładek, do pisania z kolejki

Daty są opcjonalne

Pomiń zakres w dowolnym narzędziu, a serwer użyje ostatnich 28 ustabilizowanych dni, uwzględniając opóźnienie raportowania Search Console, przy czym okno porównawcze domyślnie obejmuje poprzedni okres o tej samej długości. Klient nigdy nie musi znać dzisiejszej daty, by zadać sensowne pytanie.

Zakresy uprawnień i limity zapytań

Klucz jest tylko do odczytu albo do odczytu i zapisu. Klucz tylko do odczytu w ogóle nie ma dostępu do narzędzi zapisu, a każda modyfikacja przy kluczu z prawem zapisu jest rejestrowana w dzienniku audytu.

• 60 żądań na minutę na klucz, 1000 na godzinę na konto
• Przekroczenie limitu zwraca HTTP 429 z nagłówkiem Retry-After w sekundach
• Odwołaj pojedynczy klucz, nie naruszając reszty konta

REST, jeśli wolisz

Narzędzia Search Console i GA4 są też udostępnione jako trasy GET i POST pod /v1 wraz z wygenerowanym dokumentem OpenAPI 3.1 pod /v1/openapi.json, który służy też jako specyfikacja wywoływania funkcji. Te same klucze, zakresy i limity.