SerpBeats MCP

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://stage.serpbeats.com/mcp
Taşıma
Streamable HTTP (MCP), POST https://stage.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
Makine tarafından okunabilir
/seo-mcp-sunucusu.md · /llms.txt

İstemciler

Streamable HTTP MCP konuşan her istemci bağlanabilir. Aşağıdakiler için kurulum adımı hazır.

İstemciYetkilendirmeNereden eklenir
ClaudeOAuthAyarlar → Bağlayıcılar → Özel bağlayıcı ekle. URL: https://stage.serpbeats.com/mcp. Kimlik doğrulama: Sign in now, OAuth client: Register automatically.
ChatGPTOAuthAyarlar → Uygulamalar → özel MCP sunucusu ekle (gerekirse önce Geliştirici modunu açın). URL: https://stage.serpbeats.com/mcp, kimlik doğrulama: OAuth.
Gemini uygulamasıOAuthAyarlar → Bağlı uygulamalar → Özel uygulama ekle. URL: https://stage.serpbeats.com/mcp. Google bunu şimdilik yalnızca ABD'de, kişisel hesaplarda ve İngilizce sunuyor.
Claude CodeTokenclaude mcp add
CodexToken~/.codex/config.toml
CursorToken~/.cursor/mcp.json
Gemini CLITokengemini mcp add
Diğer MCP istemcileriTokenURL ve Authorization başlığı

Token ile bağlananların yapılandırması

YOUR_TOKEN yerine /ai-connection sayfasında oluşturduğunuz token gelir.

Claude Code
claude mcp add --transport http --scope user serpbeats https://stage.serpbeats.com/mcp --header "Authorization: Bearer YOUR_TOKEN"
Codex · ~/.codex/config.toml
[mcp_servers.serpbeats]
url = "https://stage.serpbeats.com/mcp"
http_headers = { Authorization = "Bearer YOUR_TOKEN" }
Cursor · ~/.cursor/mcp.json
{
  "mcpServers": {
    "serpbeats": {
      "url": "https://stage.serpbeats.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}
Gemini CLI
gemini mcp add --transport http --header "Authorization: Bearer YOUR_TOKEN" serpbeats https://stage.serpbeats.com/mcp
Diğer
URL: https://stage.serpbeats.com/mcp
Authorization: Bearer YOUR_TOKEN

Yetkilendirme

İki yöntem var; ikisi de aynı verilere aynı yetkiyle (salt okuma) erişir. Sohbet uygulamaları OAuth ile hesabınızla giriş yapar, giriş penceresi açamayan kod araçları token kullanır.

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.

AraçSunduğu veriParametreler
Projeler ve sıralamalar
list_projectsHesaptaki projeler: id, ad, alan adı, ülke, takip edilen kelime sayısı, son tarama tarihi.yalnızca project
get_project_summaryProje ö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.period_days7 | 30
get_keyword_rankingsTakip 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.period_days7 | 30sortposition | volume | gain | loss | dropped_outlimit1–100
get_keyword_historyTek 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.keyword*days7–90
Site denetimi
get_site_auditSon 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.yalnızca project
get_audit_issuesHer 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.issueseveritycritical | warning | recommendation
get_audit_pagesTaranan 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.urlissuestatusok | errorsortworst | slowest | largest | deepest | thinnest | lowest_scorelimit1–50offset
get_audit_linksSayfalar 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.kind*broken_links | redirected_links | redirect_chains | non_indexable_pagespagelimit1–50offset
Rakipler, AI görünürlüğü, yerel SEO ve rapor
get_competitorsTakip 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.period_days7 | 30suggestions1–20
get_ai_visibilityAI 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.Gerekir: AI Bundlelimit1–100
get_local_seoHaritalardaki 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.Gerekir: yerel kelimeyalnızca project
get_report_dataRapor için tek çağrı: dağılım, hareketler, site sağlığı, rakipler ve AI görünürlüğü.period_days7 | 30

* zorunlu

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.