Ana içeriğe geç
Google Search Console · MCP
Google Search Console · MCP

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
Türkçe Google Search Console MCP | DigestSEO
mcp-gsc, Google Search Console’u Google OAuth ile Claude, ChatGPT, Cursor ve diğer MCP istemcilerine bağlar.

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

  1. Node.js ^22.18.0 / >=24.11.0 + npm
  2. Analiz edeceğiniz Search Console mülküne erişimi olan bir Google hesabı kullanın.
  3. Google Cloud'da bir OAuth istemcisi oluşturun, gerekli API'leri etkinleştirin ve tam yerel yönlendirme URI'sini kaydedin.
  4. 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

Tam kurulum kılavuzu (SETUP.md)

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.

01get_capabilities

Kullanılabilir yetenekleri ve kimlik doğrulama durumunu listeler.

02list_sites

Bağlı hesabın erişebildiği Search Console mülklerini listeler.

03query_search_analytics

Özel tarih aralıklarında tıklama, gösterim, TO ve sıralamayı sorgular.

04inspect_url

Canlı URL denetleme raporlarını ve dizine ekleme ayrıntılarını getirir.

05list_sitemaps

Gönderilen site haritalarını tarama durumu ve uyarılarıyla listeler.

06add_site

Bağlı hesaba bir Search Console mülkü ekler.

07delete_site

Hesaptan bir Search Console mülkünü kaldırır.

08submit_sitemap

Bir Search Console mülkü için site haritası gönderir.

09delete_sitemap

Gönderilmiş bir site haritasını mülkten kaldırır.

10get_sitemap

Gönderilen tek bir site haritasının ayrıntılı durumunu getirir.

11identify_quick_wins

8–20. sıralarda yer alan, gösterimi yüksek sorguları bulur.

12detect_cannibalization

Birden fazla sayfanın görünürlük için yarıştığı sorguları bulur.

13detect_content_decay

Aramadan gelen tıklamalarda en çok düşüş yaşayan sayfaları belirler.

14request_indexing

Google’ı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.

15list_indexed_pages

Search Console’da gösterim almış sayfaları listeler.

16compare_performance

Tıklama, gösterim, TO ve sıralamayı dönemler arasında karşılaştırır.

17weekly_digest

Sade 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.

~/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

Depoya 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.