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
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
Node.js ^22.18.0 / >=24.11.0+npm- Użyj konta Google z dostępem do analizowanej usługi Search Console.
- Utwórz klienta OAuth w Google Cloud, włącz wymagane interfejsy API i zarejestruj dokładny lokalny URI przekierowania.
- 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
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.
get_capabilitiesWypisuje dostępne funkcje i stan uwierzytelnienia.
list_sitesWypisuje usługi Search Console dostępne dla połączonego konta.
query_search_analyticsOdpytuje kliknięcia, wyświetlenia, CTR i pozycję w dowolnym zakresie dat.
inspect_urlPobiera bieżące raporty sprawdzania adresu URL i szczegóły indeksowania.
list_sitemapsWypisuje przesłane mapy witryny wraz ze stanem skanowania i ostrzeżeniami.
add_siteDodaje usługę Search Console do połączonego konta.
delete_siteUsuwa usługę Search Console z konta.
submit_sitemapPrzesyła mapę witryny dla usługi Search Console.
delete_sitemapUsuwa przesłaną mapę witryny z usługi.
get_sitemapPobiera szczegółowy stan jednej przesłanej mapy witryny.
identify_quick_winsZnajduje zapytania o dużej liczbie wyświetleń zajmujące pozycje od 8 do 20.
detect_cannibalizationZnajduje zapytania, w których o widoczność konkuruje kilka stron.
detect_content_decayWskazuje strony z największym spadkiem kliknięć z wyszukiwarki.
request_indexingZgł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.
list_indexed_pagesWypisuje strony, które uzyskały wyświetlenia w Search Console.
compare_performancePorównuje kliknięcia, wyświetlenia, CTR i pozycję między okresami.
weekly_digestTworzy 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.
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 deployZostaw 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.