Geliştiriciler için

Ölçtüğümüz her şey
okunabilir.

Aynı anahtar hem REST API'yi hem MCP ucunu açar; ikisi de salt okunur ve Studio planına dahil. Veriniz bizim ekranımıza kilitli değil - betiğinize, panonuza ya da asistanınıza aynı biçimde gelir.

Kendi panonuza taşıyın
Sıralama geçmişini şirket içi panoya, bir tabloya ya da haftalık rapora çekin. Veri sizin; bizim ekranımızda kalmak zorunda değil.
Sürüm öncesi kontrol
Yeni metadata'yı göndermeden önce betiğiniz cusp bandını okusun: alt başlıktan çıkardığınız kelimede kaçıncı sıradasınız, gerçekten feda edilebilir mi?
Asistana sorun
MCP ucu bağlıyken “hangi keyword'lerim eşik bandında ve hangisi en popüler?” sorusunun cevabı ekran görüntüsü almadan gelir.

Tek satırda başlayın

Üç giriş yolu, tek anahtar. Hangisiyseniz onu seçin: MCP konuşan bir asistan, bir terminal ya da bir betik.

claude-code

claude mcp add --transport http rankcusp \
  https://rankcusp.com/api/mcp \
  --header "Authorization: Bearer rc_live_…" \
  --header "Accept-Language: tr"

Kurulum bundan ibaret. İkinci başlık hükümlerin kendi dilinizde dönmesini sağlar; kaldırırsanız İngilizce gelir. “Hangi keyword'lerim eşik bandında?” diye sorun, asistan aşağıdaki araçları kendisi çağırsın.

Anahtar

Hesap ekranından oluşturun. Anahtar yalnızca bir kez gösterilir - biz sadece özetini sakladığımız için kaybolursa geri getiremeyiz, iptal edip yenisini alırsınız.

Bir asistan ne yapabilir

Dokuz araç. Sekizi yalnızca okur; sonuncusu keyword ekler ve çağrılmadan önce bunu istemciye bildirir. Asistan bağlandığı anda bunlara erişir; CLI da altta bunları çağırır.

list_apps: Hesaptaki uygulamalar ve rakipler. Diğer araçların istediği appId buradan gelir.
cusp_actions: 11-30 bandı, popülerliğe göre sıralı: karakter harcamaya değecek kelimelerin kısa listesi.
get_keyword: Tek bir keyword - sıra, popülerlik, zorluk - ve kararı kendi dilinizde yazılı: hedeflemeye değer mi, hangi gerekçeyle.
ranking_keywords: Bir uygulamanın hâlihazırda sıralandığı kelimeler; bu ürünün yaptığı her aramanın havuzlanmış kaydından. Rakibe doğrultursanız onunkini okur - Apple bunun için bir uç yayımlamıyor, dolayısıyla cevap ancak gözlenmiş olan kadar geniştir.
keyword_competitors: Bir ifade için ilk sayfanın gösterdiği ondan daha derinde kim sıralanıyor. Sizin 60'ta olduğunuz yerde 40'ta duran uygulama, çalışılmaya değer olandır.
audit_metadata: Yayına almadan önce taslak başlığı, alt başlığı ve keyword alanını okur; ne tekrar ediyor, ne boşa gidiyor, kaç karakter geri kazanılıyor söyler.
country_priorities: Sıradaki saati hangi ülke hak ediyor: ülke başına eşik sayıları ve rakiplerin en zayıf olduğu yer.
list_keywords: Bir ülkedeki tüm takipli keyword'ler, sıraları ve önceki sıralarıyla.
add_keywords: Yazan tek araç. Bir uygulamanın takip listesine, bir storefront'ta keyword ekler; liste ya da yapıştırılmış satır alır. Skorsuz gelirler - skorlama Apple'a istek harcar ve toplayıcının sırasını bekler - yani buradaki boş popülerlik sıfır değildir.

CLI

Bir `curl` ve bir anahtar. Terminalde okunmak için tasarlanmış tablolar yazdırır - ölçülmemiş değer orada da uzun tire kalır, hiçbir yerde sıfır uydurulmaz.

terminal

$ rankcusp cusp 1544… --country us
KEYWORD          RANK   Δ  POP  DIFF  CUSP
───────────────  ────  ──  ───  ────  ────
habit tracker      14  +5   32    41  •   
streak tracking    23   -    -    38  •

rankcusp: Oturumu açar: neye bağlısınız, ne sorabilirsiniz ve bir komut satırı.
rankcusp apps: Hesaptaki uygulamalar ve rakipler.
rankcusp keywords <appId> --country <cc>: Bir ülkedeki tüm takipli keyword'ler.
rankcusp cusp <appId> --country <cc>: Bir uygulamanın eşik bandı, popülerliğe göre sıralı.
rankcusp keyword <appId> <phrase> --country <cc>: Tek bir keyword ve kararı.
rankcusp audit --country <cc> --title … --keywords …: Yayına almadan önce taslak metadata'yı denetler.
rankcusp countries <appId>: Sırada hangi ülkeye çalışmalı.
rankcusp tools: Araçları listeler - bir asistan yolunu böyle bulur.

Uçlar

GET/api/v1/apps: Hesaptaki uygulamalar ve rakipler. Diğer çağrıların istediği appId buradan gelir.
GET/api/v1/keywords?app=…&country=…: İzlenen keywordler: sıra, önceki sıra, popülerlik, zorluk, cusp bandında mı.
GET/api/v1/keywords?app=…&country=…&cusp=1: Yalnızca 11-30 bandı - metadata düzenlemesinden en çok getirisi olacaklar.
GET/api/v1/keywords?app=…&country=…&keyword=…: Tek keyword: ilk sayfası ve hüküm - hedeflenmeli mi, hangi gerekçeyle.
POST/api/mcp: MCP ucu (JSON-RPC 2.0). Yukarıdaki dokuz aracı taşır.

Yanıt neye benziyor?

Aşağıdaki örnek, cusp bandını isteyen bir çağrının biçimini gösteriyor. İkinci satıra dikkat edin: previousRank ve popularity alanları null. Bu keyword ilk kez ölçülmüş ve popülerliği henüz alınamamış demektir - sıfır değil.

json

{
  "total": 2,
  "maxPageSize": 200,
  "keywords": [
    {
      "keyword": "habit tracker",
      "country": "us",
      "rank": 14,
      "previousRank": 19,
      "delta": 5,
      "popularity": 32,
      "difficulty": 41,
      "cusp": true,
      "lastMeasuredAt": "2026-08-12T04:12:09.114Z"
    },
    {
      "keyword": "streak tracking",
      "country": "us",
      "rank": 23,
      "previousRank": null,
      "delta": null,
      "popularity": null,
      "difficulty": 38,
      "cusp": true,
      "lastMeasuredAt": "2026-08-12T04:12:11.902Z"
    }
  ]
}

Bilmeniz gerekenler

Ölçülmeyen değer `null` döner, asla sıfır. rank: null “ilk 200 dışında”, popularity: null “henüz ölçülmedi” demektir. Bunları sıfırla değiştiren bir istemci, eninde sonunda onların ortalamasını alır.
Hükümler kendi dilinizde döner. MCP ucu istemcinin dilini okur, CLI RANKCUSP_LANG=tr alır. Sayılar her dilde aynıdır.
Dakikada 120 istek. Aşarsanız 429 ve retry-after.
Sayfa başına en fazla 200 satır; offset ile ilerleyin.
Her şey salt okunur. API üzerinden keyword eklenmez, silinmez.
country her çağrıda gerekiyor: aynı ifade iki storefront'ta iki farklı aramadır, dolayısıyla iki farklı satırdır.
Anahtar bir hesabı temsil eder, bir kişiyi değil. Paylaşmak yerine ayrı anahtar üretmek, birini iptal etmeyi diğerini bozmadan mümkün kılar.