Przejdź do treści głównej
Google Search Console · MCP
Google Search Console · MCP

GSC MCP dla Google Search Console.

mcp-gsc łączy Google Search Console z Claude, ChatGPT, Cursor i innymi klientami MCP przez Google OAuth.

Zalecany tryb
Read-only
Uwierzytelnianie
Google OAuth
Sposoby uruchomienia
npm / Worker
Licencja
MIT
GSC MCP dla Google Search Console | DigestSEO
mcp-gsc łączy Google Search Console z Claude, ChatGPT, Cursor i innymi klientami MCP przez Google OAuth.

npm · Google Search Console MCP

Zainstaluj GSC MCP lokalnie przez npm

npm uruchamia serwer Streamable HTTP na Twoim komputerze. Najpierw skonfiguruj Google OAuth i dane dostępowe; to nie jest instalacja jednym kliknięciem.

1. Przygotuj dostęp do Google

  1. Node.js ^22.18.0 / >=24.11.0 + npm
  2. Użyj konta Google z dostępem do analizowanej usługi Search Console.
  3. Utwórz klienta OAuth w Google Cloud, włącz wymagane interfejsy API i zarejestruj dokładny lokalny URI przekierowania.
  4. Ustaw te trzy zmienne środowiskowe zgodnie z instrukcją dla tej wersji. TOKEN_ENCRYPTION_KEY musi zawierać poprawny base64 z dokładnie 32 losowych bajtów.
    GOOGLE_CLIENT_IDGOOGLE_CLIENT_SECRETTOKEN_ENCRYPTION_KEY

Zarejestruj ten dokładny URI w Google Cloud. Host, port i ścieżka muszą być identyczne; localhost i 127.0.0.1 to różne hosty.

http://127.0.0.1:8080/google/callback

localhost ≠ 127.0.0.1

SETUP.md · npm v0.4.38

2. Uruchom serwer lokalny

Po ustawieniu danych w terminalu uruchom pakiet npm. Do analizy wybierz właściwe dla powłoki ustawienie tylko do odczytu.

Domyślny tryb to readwrite. Do analiz ustaw readonly przed autoryzacją Google; narzędzia modyfikujące nie zostaną udostępnione.

Polecenia Bash / zsh

export GSC_ACCESS_MODE=readonly
npx -y @digestseo/mcp-gsc

PowerShell

$env:GSC_ACCESS_MODE = 'readonly'
npx -y @digestseo/mcp-gsc

Lokalny punkt końcowy · Streamable HTTP

http://127.0.0.1:8080/mcp

3. Połącz klienta MCP

Pozostaw uruchomiony proces i połącz klienta na tym samym komputerze przez lokalny punkt Streamable HTTP, a nie stdio.

Claude Code

claude mcp add --transport http gsc http://127.0.0.1:8080/mcp

Podłącz Codex CLI / IDE

codex mcp add gsc --url http://127.0.0.1:8080/mcp

Cursor

W Cursor dodaj serwer MCP Streamable HTTP o nazwie gsc z tym adresem (lokalny Cursor).

http://127.0.0.1:8080/mcp

ChatGPT / Claude.ai

ChatGPT i Claude w chmurze nie widzą 127.0.0.1 na Twoim komputerze. Użyj własnego Workera HTTPS lub obsługiwanego bezpiecznego tunelu MCP, jeśli pozwala na to konto.

Potrzebujesz dostępu zdalnego?

Potrzebujesz dostępu zdalnego?

Własne wdrożenie na Cloudflare Workers pozostaje dostępne. Wymaga Cloudflare i Google OAuth. Przykład poniżej używa Bash; pełne kroki opisuje SETUP.md.

Informacje

Czym jest mcp-gsc?

mcp-gsc to serwer Model Context Protocol do samodzielnego hostowania, który łączy twojego klienta AI bezpośrednio z oficjalnym API Google Search Console.

Pakiet npm działa lokalnie przez HTTP loopback; alternatywą jest własny Cloudflare Worker z adresem HTTPS do dostępu zdalnego. Obie opcje używają Google OAuth.

Lokalny program przechowuje zaszyfrowany stan sesji domyślnie w ~/.mcp-gsc/state; Worker używa pamięci na Twoim koncie Cloudflare. Nie jest to usługa hostowana przez DigestSEO.

Nie. Tutaj analizujesz własne dane skuteczności stron w wyszukiwaniu multimodalnym, a nie przesyłasz fotografię do wyszukiwarki. Analizator ruchu z Google Lens i wyszukiwania multimodalnego.

Porównuj widoczność autoryzowanych kont w wyszukiwarce Google, nie polubienia ani odsłony w aplikacjach. Porównaj wyniki treści społecznościowych w Google.

Narzędzia

Możliwości udostępniane przez serwer

Wyspecjalizowane narzędzia obejmują analitykę, sprawdzanie adresów URL, mapy witryny, indeksowanie, diagnostykę SEO i tygodniowe podsumowanie skuteczności.

Lista obejmuje opcjonalne narzędzia zapisu. GSC_ACCESS_MODE=readonly udostępnia wyłącznie narzędzia bez zmian; Google ogranicza Indexing API do określonych treści.

01get_capabilities

Wypisuje dostępne funkcje i stan uwierzytelnienia.

02list_sites

Wypisuje usługi Search Console dostępne dla połączonego konta.

03query_search_analytics

Odpytuje kliknięcia, wyświetlenia, CTR i pozycję w dowolnym zakresie dat.

04inspect_url

Pobiera bieżące raporty sprawdzania adresu URL i szczegóły indeksowania.

05list_sitemaps

Wypisuje przesłane mapy witryny wraz ze stanem skanowania i ostrzeżeniami.

06add_site

Dodaje usługę Search Console do połączonego konta.

07delete_site

Usuwa usługę Search Console z konta.

08submit_sitemap

Przesyła mapę witryny dla usługi Search Console.

09delete_sitemap

Usuwa przesłaną mapę witryny z usługi.

10get_sitemap

Pobiera szczegółowy stan jednej przesłanej mapy witryny.

11identify_quick_wins

Znajduje zapytania o dużej liczbie wyświetleń zajmujące pozycje od 8 do 20.

12detect_cannibalization

Znajduje zapytania, w których o widoczność konkuruje kilka stron.

13detect_content_decay

Wskazuje strony z największym spadkiem kliknięć z wyszukiwarki.

14request_indexing

Zgłasza indeksowanie przez Indexing API Google. Obecnie Google ogranicza to API do stron z danymi strukturalnymi JobPosting oraz transmisji na żywo z BroadcastEvent wewnątrz VideoObject. Nie służy do zgłaszania zwykłych stron.

15list_indexed_pages

Wypisuje strony, które uzyskały wyświetlenia w Search Console.

16compare_performance

Porównuje kliknięcia, wyświetlenia, CTR i pozycję między okresami.

17weekly_digest

Tworzy tygodniowy raport SEO napisany prostym językiem.

Wdrożenie

Potrzebujesz dostępu zdalnego?

Własne wdrożenie na Cloudflare Workers pozostaje dostępne. Wymaga Cloudflare i Google OAuth. Przykład poniżej używa Bash; pełne kroki opisuje SETUP.md.

~/digestseo · deploy
git clone https://github.com/AKzar1el/mcp-gsc.git
cd mcp-gsc && npm install
npx wrangler login
cp wrangler.example.jsonc wrangler.jsonc
npx wrangler deploy

Zostaw gwiazdkę w repozytorium i korzystaj z Search Console w Claude.

Otwarte oprogramowanie do samodzielnego hostowania. Skonfiguruj Google OAuth według instrukcji lub wdroż własnego Workera.