Codex için GSC MCP

OpenAI Codex'te Google Search Console

Codex kodunuzu zaten okuyor. Ona arama verilerinizi de verin. GSC Wizard MCP sunucusu, Codex'e Search Console, Bing Webmaster ve GA4 verilerinizi sunan barındırılan bir Model Context Protocol uç noktasıdır; böylece şablonlarınızı düzenleyen ajan, hangi sayfaların tıklama kaybettiğini, bir sayfanın hangi sorgularda sıralandığını ve bir URL'nin dizine eklenip eklenmediğini de görebilir.

Tek bir komut, yerel sunucu yok, Google Cloud projesi yok. Hepsi aynı ~/.codex/config.toml dosyasını okuyan Codex CLI'da, IDE eklentisinde ve masaüstü uygulamasında çalışır.

codex mcp add gsc-wizard --url https://mcp.gscwizard.com/mcp
codex mcp login gsc-wizard
Uç nokta
https://mcp.gscwizard.com/mcp
Taşıma
Streamable HTTP
Kimlik doğrulama
OAuth (codex mcp login) or Bearer key
Araçlar
112 · GSC, Bing, GA4

Ücretsiz deneme, kredi kartı gerekmez. MCP erişimi her plana dahildir.

01

Search Console neden Codex'te olmalı

SEO düzeltmelerinin çoğu sonunda bir kod değişikliğine dönüşür: bir başlık şablonu, bir canonical etiketi, bir yönlendirme haritası, bir site haritası oluşturucu, bir iç bağlantı bloğu. Bir sohbet asistanında verileri analiz eder, ardından sonucu editörünüze kopyalarsınız. Codex'te analiz ve değişiklik aynı oturumda, aynı depo üzerinde gerçekleşir.

Veri, diff'in hemen yanında

Codex, bir sayfanın başlığını yeniden yazmadan önce o sayfanın tıklama aldığı sorguları arayabilir; anahtar kelimeleri tahmin etmek zorunda kalmaz.

Analiz sunucu tarafında çalışır

Değer kaybı, yamyamlık, TO eğrileri ve fırsat puanlama sunucuda hesaplanır. Codex, üzerinde aritmetik yapması gereken ham bir dışa aktarım değil, sonuçları ve arkasındaki satırları alır.

API'den daha fazla geçmiş

Okumaların çoğu, GSC Wizard'ın sakladığı verilerinizi içeren veri ambarından gelir; bu ambar Google'ın 16 aylık penceresinin ötesine uzanır ve API'nin satır örneklemesinden kaçınır.

02

Üç adımda kurulum

  1. 1

    Mülklerinizi bağlayın

    Bir GSC Wizard hesabı oluşturun, Google ile oturum açın ve Codex'in görmesini istediğiniz Search Console mülklerini seçin. Codex yalnızca burada bağlanan mülkleri okuyabilir.

  2. 2

    Sunucuyu Codex'e ekleyin

    Herhangi bir terminalden:

    codex mcp add gsc-wizard --url https://mcp.gscwizard.com/mcp

    Bu komut, ~/.codex/config.toml dosyasına bir [mcp_servers.gsc-wizard] tablosu yazar. Bloğu elle de yazabilirsiniz.

  3. 3

    Oturum açın ve kontrol edin

    OAuth girişini çalıştırın; bu, tarayıcınızı GSC Wizard'ın onay ekranında açar. Ardından Codex'i başlatın ve araçların listelendiğini doğrulamak için /mcp yazın.

    codex mcp login gsc-wizard
    codex
    > /mcp
    > List my Search Console sites and show clicks for the last 28 days.
03

config.toml bloğu

Codex yapılandırmanızı bir dotfiles deposunda tutuyorsanız veya ajanın nelere ulaşabileceğini sınırlamak istiyorsanız ~/.codex/config.toml dosyasını doğrudan düzenleyin.

Minimal (OAuth)

[mcp_servers.gsc-wizard]
url = "https://mcp.gscwizard.com/mcp"

Ortam değişkeninden API anahtarı

bearer_token_env_var değişkenin adını belirtir; Codex değerini Authorization: Bearer olarak gönderir. Anahtarın kendisi yapılandırma dosyasında hiç durmaz.

[mcp_servers.gsc-wizard]
url = "https://mcp.gscwizard.com/mcp"
bearer_token_env_var = "GSCW_API_KEY"
export GSCW_API_KEY="gscw_live_..."

Odaklı: yalnızca bir görevin ihtiyaç duyduğu araçlar

Her araç tanımı, her turda bağlam harcar. Yalnızca performansı ve dizine eklemeyi kontrol etmesi gereken bir kodlama ajanı için izin listesi oturumu hafif tutar ve getirilen içerikteki bir istem enjeksiyonunun ulaşabileceği alanı daraltır.

[mcp_servers.gsc-wizard]
url = "https://mcp.gscwizard.com/mcp"
bearer_token_env_var = "GSCW_API_KEY"
enabled_tools = [
  "list_sites",
  "get_site_summary",
  "query_top_pages",
  "get_page_performance",
  "get_query_performance",
  "find_decaying_content",
  "analyze_cannibalization",
  "inspect_url",
  "list_sitemaps"
]
tool_timeout_sec = 120

Uzun tarih aralıklarındaki analiz araçları düz bir sorgudan daha uzun sürebilir; bu yüzden cömert bir tool_timeout_sec değeri, sunucu hâlâ yanıt verirken Codex'in çağrıyı yarıda bırakmasını önler. Bloğu silmeden sunucuyu kapatmak için enabled = false ayarlayın.

04

OAuth veya API anahtarı

codex mcp login ile OAuth

Kendi makinenizde etkileşimli çalışma için en iyisi. Codex yetkilendirme sunucusunu keşfeder, kendini kaydeder ve tarayıcıda bir oturum açma ekranı açar. Kopyalanacak, saklanacak veya yenilenecek bir anahtar yoktur. İzin hem okuma hem yazma araçlarını kapsar ve GSC Wizard hesabınızdan iptal edebilirsiniz.

Kapsamlı gscw_live_ anahtarı

codex exec, CI işlem hatları, bulut görevleri ve tarayıcısı olmayan her şey için en iyisi. GSC Wizard'da Hesap → API anahtarları altında bir tane oluşturun; bir kez gösterilir ve yalnızca karma olarak saklanır.

Ajanlar için okuma kapsamlı bir anahtar kullanın. Bir okuma anahtarı, submit_sitemap, submit_indexnow_urls veya add_site gibi 32 değiştirme aracının hiçbirini çağıramaz. Denetim, araç çalışmadan önce sunucuda yapılır; bu yüzden bir ajan ikna edilerek bunun yanından geçirilemez. Google kimlik bilgileri Codex'e hiçbir zaman ulaşmaz: bunları sunucu tutar, Codex yalnızca bir GSC Wizard kimlik bilgisi tutar.

05

Codex'e ne sorulmalı

Yararlı istemler, arama verilerini Codex'in açık tuttuğu depoyla birleştirir.

Başlıkları gerçek sorgu verileriyle düzeltin

"example.com üzerinde 4 ile 15. konumlar arasında sıralanan ve TO'su eğrinin altında kalan sayfaları bul. Her biri için bu depoda başlığını belirleyen şablonu veya içerik dosyasını bul ve en çok gösterim alan sorgusunu içeren bir başlık öner."

Yayına almadan önce bir site taşımasını kontrol edin

"Bu dalın kaldırdığı veya yeniden adlandırdığı URL'leri, son 90 günde tıklamaya göre ilk 500 sayfayla karşılaştır. redirects.json içinde yönlendirmesi olmayan, trafik alan her URL'yi listele."

Yenilenecek içerikleri bulun

"/blog/ bölümü için bir değer kaybı analizi çalıştır, ardından content/ içindeki en çok değer kaybeden beş yazıyı aç ve her biri için kaybettikleri sorguları kullanarak bir güncelleme planı taslağı hazırla."

Yamyamlığı kodda çözün

"Sayfalarımızdan ikisinin veya daha fazlasının yarıştığı sorguları bul. Her çift için şablonlardaki iç bağlantıları ve canonical etiketlerini kontrol et ve hangi sayfanın öne çıkması gerektiğini öner."

Dağıtımdan sonra dizine eklemeyi doğrulayın

"Son commit'te eklenen on URL'yi denetle ve hangilerinin henüz dizine eklenmediğini Google'ın gerekçesiyle birlikte söyle."

Codex'e bir kez söyleyin, AGENTS.md içinde

Codex, bir oturumun başında AGENTS.md dosyasını okur. Oraya yazılan birkaç satır, mülkü ve ev kurallarını her istemde tekrarlamaktan sizi kurtarır.

## Search data
- Search Console property: sc-domain:example.com (use the gsc-wizard MCP tools).
- Before changing a title, meta description or URL, look up the page's
  current queries with get_page_performance and keep its top query in the title.
- Treat the last 3 days as incomplete; report settledThrough with any numbers.
- Never call submit_sitemap or submit_indexnow_urls without asking first.
06

Codex'in çağırabileceği araçlar

128 araç her hesap için kullanılabilir. Her biri readOnlyHint ve destructiveHint gibi MCP ek açıklamalarını bildirir; böylece Codex, onay isteyip istemeyeceğine karar verirken okumaları yazmalardan ayırt edebilir.

Grup Örnek araçlar Kapsam
Arama analizleriquery_search_analytics, query_top_queries, query_top_pages, get_page_performanceokuma
Analizfind_decaying_content, analyze_cannibalization, analyze_ctr_curve, score_opportunitiesokuma
Tespitdetect_anomalies, detect_change_points, get_ranking_changes, forecast_trafficokuma
Dizine ekleme & sayfa içiinspect_url, bulk_inspect_urls, list_sitemaps, audit_onpage_seookuma
Diğer kaynaklarBing Webmaster, GA4 (LLM yönlendirme trafiği dahil), Core Web Vitalsokuma
Değiştirme araçlarısubmit_sitemap, submit_indexnow_urls, create_annotation, create_topic_clusteryazma

Tarihler her araçta isteğe bağlıdır: belirtilmeyen aralık son 28 tam güne ayarlanır; böylece Codex'in bugünün tarihini bilmesi gerekmez. Satır sınırlı araçlar, daha fazla satır olup olmadığını belirten bir sayfalama bloğu döndürür; böylece ajan kırpılmış bir listeyi eksiksiz sanamaz. Argümanlarla birlikte tam katalog mcp.gscwizard.com adresindedir, protokol ayrıntıları ise sunucu referansında yer alır.

07

Sorun giderme

/mcp, gsc-wizard'ı listelemiyor

Girdinin var olduğunu doğrulamak için codex mcp list komutunu çalıştırın ve ~/.codex/config.toml içindeki bloğun bir command girdisi değil, bir url girdisi olduğunu kontrol edin. Dosyayı düzenledikten sonra Codex'i yeniden başlatın; yapılandırmayı başlangıçta okur.

Her çağrı 401 unauthorized döndürüyor

Anahtarla: bearer_token_env_var içinde adı geçen değişken, Codex'i başlatan kabukta dışa aktarılmış olmalı ve tam gscw_live_ anahtarını içermelidir. OAuth ile: codex mcp login gsc-wizard komutunu yeniden çalıştırın. Hangisini kullanırsanız kullanın, hesabın etkin bir denemesi veya aboneliği ve bağlı en az bir Search Console mülkü olmalıdır.

Bir yazma aracı reddediliyor

Bu, okuma kapsamının işini yapmasıdır. Codex'in site haritaları veya IndexNow URL'leri göndermesini gerçekten istiyorsanız yazma kapsamlı bir anahtar oluşturun veya OAuth girişini kullanın ve bu kimlik bilgisini gözetimsiz çalıştırmaların dışında tutun.

Büyük mülklerde çağrılar zaman aşımına uğruyor

Sunucu için tool_timeout_sec değerini artırın ve isteği daraltın: bir yol filtresi veya daha kısa bir tarih aralığı, tüm siteyi kapsayan on altı aylık bir sorgudan daha hızlı yanıt verir.

Rakamlar Search Console arayüzünden farklı

Yanıttaki settledThrough ve dataSource alanlarını kontrol edin. Varsayılan aralık son tam günde biter; arayüz ise kısmi en son günleri de içerir.

08

Sıkça sorulan sorular

Codex, GSC Wizard gibi uzak MCP sunucularını destekler mi?

Evet. Codex, ~/.codex/config.toml içinde bir url ile yapılandırılan veya codex mcp add --url ile eklenen Streamable HTTP MCP sunucularını destekler. GSC Wizard sunucusu https://mcp.gscwizard.com/mcp adresinde çalışır; dolayısıyla yerel olarak kurulacak veya çalıştırılacak bir şey yoktur.

Codex ile OAuth mu yoksa API anahtarı mı kullanmalıyım?

Etkileşimli kullanım için codex mcp login, OAuth akışını tarayıcınızda çalıştırır ve anahtar yönetimi gerektirmez. codex exec, CI işleri ve diğer gözetimsiz çalıştırmalar için, bir ortam değişkeninde saklanan ve bearer_token_env_var ile başvurulan okuma kapsamlı bir gscw_live_ API anahtarı kullanın; böylece gizli bilgi config.toml içine hiç girmez.

Codex CLI, IDE eklentisi ve uygulama aynı MCP kurulumunu paylaşır mı?

Evet. Hepsi aynı ~/.codex/config.toml dosyasını okur; dolayısıyla gsc-wizard'ı bir kez eklemek, onu terminalde, IDE eklentisinde ve masaüstü uygulamasında kullanılabilir kılar.

Codex, Search Console'umda herhangi bir şeyi değiştirebilir mi?

Yalnızca yazma kapsamlı bir kimlik bilgisiyle. Okuma kapsamlı bir API anahtarı, 32 değiştirme aracının hiçbirini (submit_sitemap veya submit_indexnow_urls gibi) çağıramaz; denetim, araç çalışmadan önce sunucuda yapılır. Araç listesini istemci tarafında config.toml içindeki enabled_tools ile de daraltabilirsiniz.

Codex kaç araca erişir?

128 araç her hesap için kullanılabilir; Search Console performansını, analizi, dizine eklemeyi, Bing Webmaster'ı, Yandex Webmaster'ı, GA4'ü ve Google Merchant Center'ı kapsar. Hepsini göndermek her turda bağlam harcar; bu yüzden çoğu Codex kurulumu enabled_tools içinde yalnızca bir görevin ihtiyaç duyduğu araçları listeler.

Ücretli mi?

MCP erişimi GSC Wizard planlarına ve kredi kartı gerektirmeyen ücretsiz denemeye dahildir. Codex kullanımı her zamanki gibi OpenAI tarafından faturalandırılır. Bkz. fiyatlandırma.

İlgili

Codex'e arama verilerinizi verin

Bir mülk bağlayın, tek bir komut çalıştırın ve sitenizi düzenleyen ajanın sitenin aramada nasıl performans gösterdiğini görmesini sağlayın.

Search Console ipuçları gelen kutunuzda

Pratik GSC ve GA4 iş akışları, ürün güncellemeleri ve SEO deneyleri. Spam yok, istediğiniz zaman abonelikten çıkabilirsiniz.