MCP sunucusu ve REST API
ASO verileriniz yapay zeka asistanınızın içinde
Rankglass MCP sunucusu sayesinde Claude Code, Cursor, Claude Desktop, Codex, ChatGPT masaüstü uygulaması ve diğer MCP istemcileri takip ettiğiniz anahtar kelimeleri, sıralamaları, rakipleri ve sayfa skorlarını okuyabilir. REST API de aynı verileri kendi script’lerinize sunar.
Kısaca
- MCP uç noktası
https://app.rankglass.com/api/mcp- Aktarım
- Streamable HTTP
- Kimlik doğrulama
- Authorization: Bearer YOUR_API_KEY olarak gönderilen bir çalışma alanı API anahtarı
- Erişim
- Salt okunur
- Planlar
- Starter, Pro ve Agency
- İstek limitleri
- Anahtar başına dakikada 60, günde 2.000 istek
Header gönderebilen MCP istemcileriyle çalışır
Rankglass her istekte API anahtarını kontrol eder; istemcinin yalnızca anahtarı header olarak göndermesi yeterli. Aşağıda şu istemcilerin kurulumu var:
- Claude Code
- Cursor
- Claude Desktop, mcp-remote üzerinden (Node.js gerekir)
- Codex ve ChatGPT masaüstü uygulaması
- Diğer MCP istemcileri ve kendi geliştirdiğiniz ajanlar, yukarıdaki uç nokta ve header ile
Yalnızca OAuth girişiyle bağlanabilen bir istemci anahtarı gönderemez, bu yüzden Rankglass’ı henüz ekleyemez.
Üç adımda kurun
Adım 1
API anahtarı oluşturun
Rankglass’ta Ayarlar → Çalışma alanı → API ve MCP sayfasını açıp bir anahtar oluşturun. Anahtar yalnızca bir kez gösterilir, hemen kopyalayın. Bir anahtar tek bir çalışma alanını okur; her asistan ya da script için ayrı bir anahtar oluşturursanız her birini ayrı ayrı iptal edebilirsiniz.
Adım 2
Rankglass’ı asistanınıza ekleyin
İstemcinizin kurulum kodunu yapıştırın ve YOUR_API_KEY yerine kendi anahtarınızı yazın.
Claude Code
Bunu bir terminalde çalıştırın. --scope user ile Rankglass bütün projelerinizde kullanılabilir.
claude mcp add --transport http --scope user rankglass https://app.rankglass.com/api/mcp --header "Authorization: Bearer YOUR_API_KEY"Cursor ve diğer istemciler
Cursor için bunu ~/.cursor/mcp.json dosyasına ya da bir projedeki .cursor/mcp.json dosyasına ekleyin. Diğer istemciler MCP sunucularını kendi ayarlarında tutar; ihtiyaç duydukları tek şey uç nokta ve header.
{ "mcpServers": { "rankglass": { "url": "https://app.rankglass.com/api/mcp", "headers": { "Authorization": "Bearer YOUR_API_KEY" } } } }Claude Desktop
Bunu claude_desktop_config.json dosyasına ekleyin (Settings → Developer → Edit Config), sonra Claude’u yeniden başlatın. mcp-remote’u npx ile çalıştırdığı için Node.js kurulu olmalı.
{ "mcpServers": { "rankglass": { "command": "npx", "args": [ "-y", "mcp-remote", "https://app.rankglass.com/api/mcp", "--header", "Authorization:${RANKGLASS_AUTH}" ], "env": { "RANKGLASS_AUTH": "Bearer YOUR_API_KEY" } } } }Codex ve ChatGPT masaüstü uygulaması
Bunu, Codex CLI, Codex IDE eklentisi ve ChatGPT masaüstü uygulamasının ortak kullandığı ~/.codex/config.toml dosyasına ekleyin. Anahtarınızı, Bearer olmadan, RANKGLASS_API_KEY adlı bir ortam değişkenine koyun.
[mcp_servers.rankglass] url = "https://app.rankglass.com/api/mcp" bearer_token_env_var = "RANKGLASS_API_KEY"Authorization header’ını ayarlayamayan istemciler bunun yerine x-api-key: YOUR_API_KEY gönderebilir.
Adım 3
Kendi cümlelerinizle sorun
Asistanınız doğru aracı kendisi seçer. Hiçbiri çalışma alanınızda bir şey değiştiremez.
Asistanınızın okuyabildikleri
11 salt okunur araç. Her birinin REST API’de karşılığı olan bir GET uç noktası var.
| MCP aracı | Ne döndürür | REST uç noktası |
|---|---|---|
list_apps | Uygulamalarınız; mağazaları, takip edilen ülkeleri, anahtar kelime sayıları ve bu haftanın öne çıkan rakamlarıyla. İlk çağrı için iyi bir başlangıç. | GET /v1/apps |
get_keyword_rankings | Bir uygulamanın tek bir mağaza ve ülkede takip edilen tüm anahtar kelimeleri: sıra, 7 günlük değişim, sonuçlara giriş ya da çıkış, en iyi sıra, tahmini aylık arama, zorluk ve rakiplerin sıraları. | GET /v1/keywords |
get_rank_changes | Son günlerdeki en büyük sıralama yükselişleri ve düşüşleri; tüm anahtar kelimeler, mağazalar ve ülkeler genelinde. İlk 10’a giren ya da oradan çıkan anahtar kelimeler de dahil. | GET /v1/rank-changes |
get_competitors | İzlenen rakipler; puanları, her iki tarafın kaç anahtar kelimede daha üstte olduğu ve rakibin ilk 10’da olup sizin olmadığınız anahtar kelimeler. | GET /v1/competitors |
get_competitor_keywords | Bir rakibin tek bir ülkede sıralamaya girdiği anahtar kelimeler; henüz takip etmedikleriniz dahil, aylık arama, zorluk ve iki tarafın sırasıyla. | GET /v1/competitor-keywords |
get_competitor_insights | Bir rakibin mağaza bilgileri, yıldızlara göre değerlendirme dağılımı, liste sıraları, tahmini aylık indirme ve geliri, en son yapay zeka yorum özeti. | GET /v1/competitor-insights |
get_competitor_growthBeta | Bir rakibin kullanıcı kazanma yolları: reklamları, sosyal medya hesapları, içerik üreticileri, mağaza araması ve web sitesi; tahmini reklam harcaması, reklamlardan gelen indirme ve sosyal medya erişimiyle, en son yapay zeka stratejisiyle birlikte. Pro ve Agency. | GET /v1/competitor-growth |
get_store_page_changes | Sizin ve rakiplerinizin mağaza sayfalarındaki son değişiklikler: başlık, alt başlık, açıklama, ekran görüntüleri, sürüm ve sürüm notları. | GET /v1/store-page-changes |
get_aso_score | Tek bir mağaza ve ülke için 0–100 arası ASO skorunuz, arkasındaki kontroller, hızlı anahtar kelime kazanımları ve en son yapay zeka sayfa önerileri. | GET /v1/aso-score |
get_weekly_brief | Uygulamanızın en son haftalık raporu: ne değişti, muhtemel nedenleri ve sonra yapılacak en fazla üç şey. | GET /v1/weekly-brief |
get_keyword_game_planBeta | Takip edilen bir anahtar kelimenin en son oyun planı: hedef sıra ve oraya ulaşmak için en fazla beş adım. | GET /v1/keyword-game-plan |
REST API
Aynı veriler, kendi script’leriniz, panelleriniz ve tablolarınız için JSON olarak. Her uç nokta https://app.rankglass.com/api/v1 altında bir GET isteğidir ve aynı anahtarla çalışır.
İlk istek: son yedi günün en büyük sıralama değişimleri.
curl "https://app.rankglass.com/api/v1/rank-changes?days=7" -H "Authorization: Bearer YOUR_API_KEY"Limitler ve erişim
- Salt okunur. Araçlar ve uç noktalar yalnızca Rankglass’ın sakladığı verileri okur; hiçbir zaman yeni bir arama başlatmaz. Bir rakibin yeni bir ülkedeki anahtar kelimelerini bulmak gibi ücretli işler panelden başlatılır.
- Her anahtar dakikada 60, günde 2.000 istek yapabilir; bu limit MCP sunucusu ve REST API arasında ortaktır. Limit aşılınca istekler Retry-After header’ı içeren bir 429 yanıtı alır.
- API ve MCP erişimi Starter, Pro ve Agency planlarında var. Erişim yoksa istekler 403 yanıtı alır.
- Bir anahtar kendi çalışma alanındaki her şeyi okur, bu yüzden onu bir şifre gibi koruyun. Ayarlar sayfası her anahtarın en son ne zaman kullanıldığını gösterir; anahtarı oradan iptal edebilirsiniz.
Deneyebileceğiniz sorular
- Bu hafta hangi anahtar kelimelerimde düşüş oldu?
- Uygulamam Almanya’da “habit tracker” için kaçıncı sırada ve kimler benden önde?
- En büyük rakibim, benim henüz takip etmediğim hangi anahtar kelimelerde sıralamaya giriyor?
- Rakiplerim bu ay mağaza sayfalarında neleri değiştirdi?
- Birleşik Krallık’taki ASO skorum ne ve önce neyi düzeltmeliyim?
- Uygulamalarımın her biri için bu haftanın raporunu özetle.
MCP sunucusu hakkında sorular
ChatGPT ile çalışıyor mu?
Evet, ChatGPT masaüstü uygulamasında. Uygulama MCP sunucularını ~/.codex/config.toml dosyasında Codex CLI ve Codex IDE eklentisiyle ortak kullanır; bu dosya anahtarınızı bir ortam değişkeninden gönderebilir (bearer_token_env_var). Yapılandırma yukarıdaki kurulumda var. Web’deki ChatGPT ise araçları yalnızca OAuth girişi sunan bağlayıcılarla ekliyor ve bunlar henüz anahtarı gönderemiyor. Header ile API çağrısı yapabilen her şey bunun yerine REST API’yi kullanabilir.
Asistanım Rankglass’ta bir şeyi değiştirebilir mi?
Hayır. Her araç ve uç nokta yalnızca okur. Uygulama eklemek, anahtar kelime takip etmek ve arama başlatmak panelden yapılır.
Veriler ne kadar güncel?
Paneldekiyle aynı: ücretli planlarda takip edilen her anahtar kelime günde bir kez kontrol edilir ve haftalık rapor her pazartesi yazılır. Araçlar Rankglass’ın sakladığı verileri okur, hiçbir zaman kontrol başlatmaz.
Verilerim nereye gidiyor?
Yalnızca onları isteyen istemciye ve yalnızca anahtarın ait olduğu çalışma alanından. Oradan sonra verileri asistanınızın sağlayıcısı kendi koşullarına göre işler. Erişimi durdurmak için anahtarı istediğiniz zaman silin.
Adım adım anlatım mı istersiniz? Rankglass MCP sunucusu nasıl kurulur yazısını okuyun.
Uygulamanız için sıradaki adımı öğrenin
Tek bir mağaza bağlantısıyla uygulamanızı ekleyin, bugün hangi sırada olduğunuzu görün.
Ücretsiz başlaÜcretsiz plan · Kredi kartı gerekmez · İstediğiniz zaman iptal edin