Search Console verilerinizi asistanınıza taşıyın.
mcp-gsc, Google Search Console’u Google OAuth ile Claude, ChatGPT, Cursor ve diğer MCP istemcilerine bağlar.
- Önerilen mod
- Read-only
- Kimlik doğrulama
- Google OAuth
- Çalıştırma seçenekleri
- npm / Worker
- Lisans
- MIT
npm · Google Search Console MCP
GSC MCP'yi npm ile yerel olarak kurun
npm bilgisayarınızda bir Streamable HTTP sunucusu başlatır. Önce Google OAuth ve kimlik bilgileri yapılandırılmalıdır; tek tıklamayla bağlantı değildir.
1. Google erişimini hazırlayın
Node.js ^22.18.0 / >=24.11.0+npm- Analiz edeceğiniz Search Console mülküne erişimi olan bir Google hesabı kullanın.
- Google Cloud'da bir OAuth istemcisi oluşturun, gerekli API'leri etkinleştirin ve tam yerel yönlendirme URI'sini kaydedin.
- Bu üç ortam değişkenini sürümle eşleşen kılavuza göre ayarlayın. TOKEN_ENCRYPTION_KEY tam 32 rastgele baytın geçerli base64 kodlaması olmalıdır.
GOOGLE_CLIENT_IDGOOGLE_CLIENT_SECRETTOKEN_ENCRYPTION_KEY
Bu URI'yi Google Cloud'a aynen kaydedin. Ana bilgisayar, bağlantı noktası ve yol eşleşmelidir; localhost ile 127.0.0.1 farklıdır.
http://127.0.0.1:8080/google/callback localhost ≠ 127.0.0.1
2. Yerel sunucuyu başlatın
Terminalde kimlik bilgilerini yapılandırdıktan sonra npm paketini çalıştırın. Yalnızca analiz için kabuğunuza uygun salt okunur ayarı kullanın.
Başlatıcının varsayılanı readwrite'tır. Analiz için Google yetkilendirmesinden önce readonly seçin; yazma araçları kaydedilmez.
Bash / zsh komutları
export GSC_ACCESS_MODE=readonly
npx -y @digestseo/mcp-gsc PowerShell
$env:GSC_ACCESS_MODE = 'readonly'
npx -y @digestseo/mcp-gsc Yerel uç nokta · Streamable HTTP
http://127.0.0.1:8080/mcp 3. MCP istemcinizi bağlayın
Başlatıcı açık kalsın; aynı bilgisayardaki istemciyi yerel Streamable HTTP uç noktasına bağlayın. stdio değildir.
Claude Code
claude mcp add --transport http gsc http://127.0.0.1:8080/mcp Codex CLI / IDE bağla
codex mcp add gsc --url http://127.0.0.1:8080/mcp Cursor
Cursor'da bu URL ile gsc adlı Streamable HTTP MCP sunucusu ekleyin (yerel Cursor).
http://127.0.0.1:8080/mcp ChatGPT / Claude.ai
Buluttaki ChatGPT ve Claude bilgisayarınızdaki 127.0.0.1 adresine erişemez. Hesap izinlerinize göre kendi HTTPS Worker'ınızı veya desteklenen güvenli MCP tünelini kullanın.
Uzaktan erişim mi gerekiyor?Uzaktan erişim mi gerekiyor?
Cloudflare Workers üzerinde kendi sunucunuzu barındırma seçeneği sürer. Cloudflare ve Google OAuth kurulumu gerekir. Aşağıdaki örnek Bash içindir; tüm adımlar SETUP.md'de.
Hakkında
mcp-gsc nedir?
mcp-gsc, yapay zekâ istemcinizi doğrudan resmî Google Search Console API’sine bağlayan, kendiniz barındırabileceğiniz bir Model Context Protocol sunucusudur.
npm paketini yerel döngü HTTP üzerinden çalıştırın veya uzaktan HTTPS için kendi Cloudflare Worker'ınızı dağıtın. İkisi de Google OAuth kullanır.
Yerel başlatıcı şifrelenmiş oturum durumunu varsayılan olarak ~/.mcp-gsc/state altında tutar; Worker kendi Cloudflare hesabınızdaki depolamayı kullanır. DigestSEO tarafından yönetilen bir bağlantı değildir.
Web: multimodal performans dışa aktarımını yükleyerek sayfaları inceleyin. Bu araç fotoğrafları tanımaz veya düzenlemez. Google Lens ve çok modlu arama analiz aracı.
Yetkili sosyal hesaplarınızın Google Arama görünürlüğünü karşılaştırın; uygulama içi beğeni ve görüntülemeleri değil. Sosyal medya içeriklerinizin Google performansını karşılaştırın.
Araçlar
Sunucunun sunduğu yetenekler
Odaklı araçlar analizi, URL denetimini, site haritalarını, dizine eklemeyi, SEO tanılamasını ve haftalık performans özetini kapsar.
Listede isteğe bağlı yazma araçları da bulunur. GSC_ACCESS_MODE=readonly yalnızca değişiklik yapmayan araçları sunar; Google Indexing API belirli içerik türleriyle sınırlıdır.
get_capabilitiesKullanılabilir yetenekleri ve kimlik doğrulama durumunu listeler.
list_sitesBağlı hesabın erişebildiği Search Console mülklerini listeler.
query_search_analyticsÖzel tarih aralıklarında tıklama, gösterim, TO ve sıralamayı sorgular.
inspect_urlCanlı URL denetleme raporlarını ve dizine ekleme ayrıntılarını getirir.
list_sitemapsGönderilen site haritalarını tarama durumu ve uyarılarıyla listeler.
add_siteBağlı hesaba bir Search Console mülkü ekler.
delete_siteHesaptan bir Search Console mülkünü kaldırır.
submit_sitemapBir Search Console mülkü için site haritası gönderir.
delete_sitemapGönderilmiş bir site haritasını mülkten kaldırır.
get_sitemapGönderilen tek bir site haritasının ayrıntılı durumunu getirir.
identify_quick_wins8–20. sıralarda yer alan, gösterimi yüksek sorguları bulur.
detect_cannibalizationBirden fazla sayfanın görünürlük için yarıştığı sorguları bulur.
detect_content_decayAramadan gelen tıklamalarda en çok düşüş yaşayan sayfaları belirler.
request_indexingGoogle’ın Indexing API’si üzerinden dizine ekleme ister. Google şu anda bu API’yi JobPosting yapılandırılmış verisi içeren sayfalarla ya da VideoObject içinde BroadcastEvent barındıran canlı yayın sayfalarıyla sınırlıyor. Genel sayfa gönderimi için kullanılamaz.
list_indexed_pagesSearch Console’da gösterim almış sayfaları listeler.
compare_performanceTıklama, gösterim, TO ve sıralamayı dönemler arasında karşılaştırır.
weekly_digestSade bir dille haftalık SEO raporu oluşturur.
Dağıtım
Uzaktan erişim mi gerekiyor?
Cloudflare Workers üzerinde kendi sunucunuzu barındırma seçeneği sürer. Cloudflare ve Google OAuth kurulumu gerekir. Aşağıdaki örnek Bash içindir; tüm adımlar SETUP.md'de.
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 deployDepoya yıldız verin ve Search Console’u Claude’a taşıyın.
Açık kaynak ve kendi sunucunuzda çalışır. Google OAuth kılavuzunu izleyin veya kendi Worker'ınızı dağıtın.