SerpBeats MCP
SerpBeats MCP sunucusunun teknik özeti: desteklenen AI ajanları, OAuth ve kişisel token ile yetkilendirme, 12 salt okunur araç ve sundukları veri, erişimi kaldırma ve limitler.
SerpBeats hesabınızdaki projelerin verisini bir AI ajanına açan, salt okunur MCP sunucusu. Tüm ücretli paketlerde, ek ücret olmadan.
Sunucu: https://serpbeats.com/mcp · Taşıma: Streamable HTTP (MCP), POST https://serpbeats.com/mcp · Yetkilendirme: OAuth 2.1 + PKCE ya da kişisel token · Erişim: Salt okunur · Kimde var: Tüm ücretli paketler; ücretsiz denemede yok
İstemciler
Streamable HTTP MCP konuşan her istemci bağlanabilir. Aşağıdakiler için kurulum adımı hazır. Claude (OAuth): Ayarlar → Bağlayıcılar → Özel bağlayıcı ekle. URL: https://serpbeats.com/mcp. Kimlik doğrulama: Sign in now, OAuth client: Register automatically. · ChatGPT (OAuth): Ayarlar → Uygulamalar → özel MCP sunucusu ekle (gerekirse önce Geliştirici modunu açın). URL: https://serpbeats.com/mcp, kimlik doğrulama: OAuth. · Gemini uygulaması (OAuth): Ayarlar → Bağlı uygulamalar → Özel uygulama ekle. URL: https://serpbeats.com/mcp. Google bunu şimdilik yalnızca ABD'de, kişisel hesaplarda ve İngilizce sunuyor. · Claude Code (Token): claude mcp add · Codex (Token): ~/.codex/config.toml · Cursor (Token): ~/.cursor/mcp.json · Gemini CLI (Token): gemini mcp add · Diğer MCP istemcileri (Token): URL ve Authorization başlığı
OAuth 2.1: hesapla giriş
Nereden: İstemcide bağlayıcıyı eklersiniz; SerpBeats'in onay sayfası açılır, hesabınızla giriş yapıp izin verirsiniz. Token oluşturmanız gerekmez. · Akış: Authorization Code + PKCE (S256); genel istemci, client secret yok · İstemci kaydı: Dynamic Client Registration (RFC 7591): POST /oauth/register, uygulama kendini kaydeder · Uç noktalar: /oauth/authorize · /oauth/token · Keşif: /.well-known/oauth-authorization-server · /.well-known/oauth-protected-resource · Kapsam: mcp:use · Süreler: Erişim anahtarı 1 saat, yenileme anahtarı 30 gün · İzinli dönüş adresleri: claude.ai, claude.com, chatgpt.com, chat.openai.com, platform.openai.com, gemini.google.com, Google'ın oauth-redirect ara adresleri, localhost ve 127.0.0.1
Kişisel token
Nereden: Giriş yaptıktan sonra /ai-connection sayfasında Token oluştur · Kullanım: Authorization: Bearer sbk_… başlığı · Süre: 30, 90, 365 gün ya da süresiz; oluştururken seçilir · Yetki: agent:read (yalnızca okuma) · Saklama: Token bir kez gösterilir; yalnızca özeti (hash) saklanır · Adet: En fazla 5 Her çağrıda hesabın aktif ücretli paketi olduğu kontrol edilir. Kimlik bilgisi yoksa ya da geçersizse 401, deneme sürümünde ve paket bittikten sonra 403 döner.
Servisler ve sundukları veri
12 araç aktif, hepsi salt okunur. Veri saklanan taramalardan gelir, canlı sorgu yoktur; her yanıt verinin tarihini taşır (data_as_of). list_projects dışındaki araçların hepsi project alır: id, alan adı ya da ad; hesapta tek proje varsa verilmeyebilir. list_projects: Hesaptaki projeler: id, ad, alan adı, ülke, takip edilen kelime sayısı, son tarama tarihi. · get_project_summary: Proje özeti: top 100 / 50 / 30 / 10 / 3 / 1 dağılımı (kümülatif), yükselen, düşen ve sıralamadan çıkan kelime sayısı, görünürlük, ortalama sıra, tahmini aylık tık ve değişimleri. · get_keyword_rankings: Takip edilen ve Google'da listelenmiş kelimeler: sıra, önceki sıra, değişim, aylık hacim, zorluk, niyet, sıralanan sayfa, tahmini tık, AI Overview ve SERP özellikleri. sort=dropped_out sıralamadan çıkanları verir. · get_keyword_history: Tek kelime: günlük sıra (7–90 gün), en iyi ve en kötü sıra, sıralanan sayfa ve değiştiği günler, 12 aylık hacim, AI Overview (metin, kaynaklar, siteyi anıp anmadığı), sonuç sayfası (ilk 20) ve rakiplerin yeri. · get_site_audit: Son taramadan site sağlığı: skor ve değişimi, taranan sayfa sayısı, hata / uyarı / öneri sayıları, dört alan skoru, Core Web Vitals. · get_audit_issues: Her site sorunu: önem derecesi, alan, etkilediği sayfa sayısı, düzeltilince kazanılacak puan. Tek bir sorun için anlamı, nasıl düzeltileceği ve etkilenen sayfalar. · get_audit_pages: Taranan sayfalar: durum kodu, skor, yüklenme süresi, boyut, tıklama derinliği, kelime sayısı, title, description, H1, sorunlar ve her sorunun kanıtı. url ile tek sayfa tam açılır. · get_audit_links: Sayfalar arası bulgular: kırık linkler (hedefe göre, bulunduğu her sayfa ve bağlantı metniyle), yönlendirilen linkler, yönlendirme zincirleri, arama motorlarından gizlenen sayfalar. · get_competitors: Takip edilen rakipler (görünürlük, ortalama sıra, ortak kelimelerde kimin önde olduğu) ve yanınızda sürekli çıkan, henüz takip edilmeyen rakip önerileri. · get_ai_visibility: AI cevaplarında görünürlük: skor (0–100), platform başına skor ve değişimi, haftalık trend, takip edilen her soru için anıldı, anılmadı ya da veri yok. · get_local_seo: Haritalardaki işletme (puan, yorum, profil eksikleri) ve her yerel kelime için tarama noktalarındaki ortalama sıra, ilk 3'te olunan nokta payı, mesafeye göre pay, liderler ve güçlü rakipler. · get_report_data: Rapor için tek çağrı: dağılım, hareketler, site sağlığı, rakipler ve AI görünürlüğü.
Erişimi kaldırma
OAuth uygulaması: /ai-connection sayfasında uygulamanın yanındaki Erişimi kaldır. Uygulamanın tüm anahtarları o anda iptal olur. · Token: Aynı sayfada token'ın yanındaki Sil. Token anında geçersiz olur. · Paket bitince: Paket bittiğinde ya da hesap pasife alındığında bütün bağlantılar kapanır (403). · Kayıt: Hangi aracın ne zaman çağrıldığı kaydedilir; dönen veri saklanmaz.
Limitler
İstek hızı: Bağlantı başına dakikada 60, saatte 1.500 istek; aşılırsa 429. · Yanıt boyutu: En fazla yaklaşık 120 KB; büyük listeler limit ve offset ile sayfalanır. · Sayfa başına: get_keyword_rankings ve get_ai_visibility en fazla 100, get_audit_pages ve get_audit_links en fazla 50 satır. · Geçmiş: get_keyword_history 7 ile 90 gün arası. · Veri tazeliği: Günlük taramalardan; canlı sorgu yok. Eski kalan bölümler yanıtta işaretlenir (age_days, stale_sections). · Okuma: Hiçbir araç tarama başlatmaz, kredi harcamaz, ayar değiştirmez ya da bir şey silmez. · Token: Hesap başına en fazla 5; OAuth erişim anahtarı 1 saat, yenileme 30 gün. · Kapsam dışı veri: Hiç listelenmemiş kelimeler yalnızca sayılır, listelenmez. Yerel SEO için yerel kelime, AI görünürlüğü için AI Bundle yoksa ilgili araç veri yok döner.
Bir yapay zeka ajanı mısınız? SerpBeats ürün ve paket özetini okuyun.