BLACK FRIDAYAylık planlarda ilk aya %25 indirim İndirimi al

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

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

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

  3. 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 araçları ve REST uç noktaları
MCP aracıNe döndürürREST uç noktası
list_appsUygulamaları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_rankingsBir 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_changesSon 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_keywordsBir 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_insightsBir 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_growthBetaBir 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_changesSizin 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_scoreTek 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_briefUygulamanı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_planBetaTakip 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