Storelift MCP sunucusuyla ilk üç görev

Örnek veri ve sürüm

Aşağıdaki cevaplar Storelift örnek veri setinden (2026-09-28): ABD'de 8 kelimesi izlenen örnek bir uygulama (Lumen — Sleep Sounds) ve üç örnek rakip (Example App A, Example App B, Example App C). Kendi hesabın kendi uygulamalarını ve kendi sayılarını döndürür.

Üç görev de storelift-mcp 1.1.1 ile, şu okuma araçlarıyla yapılır: list_apps, get_history, get_rivals, get_store_page, get_keywords. Henüz bağlanmadıysan kurulum rehberleri: Claude, Claude Code, Cursor.

1. Bir haftada hangi kelimelerde sıram değişti?

Şunu sor: “ABD'de hangi kelimelerde geçen haftaya göre daha aşağıdayım?” Asistan list_apps ve get_history çağırır:

list_apps {}
{
  "apps": [
    { "id": "sbx-lumen", "name": "Lumen — Sleep Sounds", "countries": ["us", "gb", "de"] }
  ]
}

get_history {"appId":"sbx-lumen","country":"us"}
{
  "country": "us",
  "series": {
    "ios|white noise": [
      ["2026-09-20", 57], ["2026-09-21", 56], ["2026-09-22", 54], ["2026-09-23", 58],
      ["2026-09-24", 56], ["2026-09-25", 55]
    ],
    "ios|sleep timer": [
      ["2026-09-20", 37], ["2026-09-21", 38], ["2026-09-22", 39], ["2026-09-23", 40],
      ["2026-09-24", 41], ["2026-09-25", 37], ["2026-09-26", 38], ["2026-09-27", 39]
    ]
  }
}

• Karşılaştırılan günler: 2026-09-20 → 2026-09-27 (US)
• Düşen: sleep timer 37 → 39; nature sounds 28 → 29
• Yükselen: rain sounds 37 → 34; relax 52 → 49
• Aynı: meditation music 42
• İki gün de ölçüldü, sonuçların dışında: sleep sounds; brown noise
• Karşılaştırmanın dışında: white noise (son ölçüm 2026-09-25, sıra 55)

Buradan verdiğin karar: önce hangi kelimeye bakacağın. Örnekte sleep timer (37 → 39).

Cevabın kapsamı:

• Ölçülmüş iki gün karşılaştırılır: 2026-09-20 ve 2026-09-27. Aradaki günler aynı cevabın series alanında; iki ucu değil yolu görmek istediğinde oradan okunur.
• Noktada sıra null ise kelime o gün ölçüldü ve uygulama sonuçların dışındaydı; cevap bunu sayıya çevirmeden böyle söyler.
• 2026-09-27 gününde noktası olmayan kelime son ölçülen sırası ve günüyle anılır, karşılaştırmaya girmez.
• Cevap hangi kelimenin yer değiştirdiğini gösterir. İkinci görevde önündeki uygulamalara ve kendi sayfandaki tarihli değişikliklere bakarsın; bunlar tek başına değişimin nedenini kanıtlamaz.

2. Düştüğüm kelimelerde kim önümde?

Şunu sor: “Düştüğüm kelimelerde önümde kimler var, o hafta kendi sayfamda bir şey değişti mi?” Asistan ilk görevin geçmiş cevabını kullanır ve get_rivals ile get_store_page çağırır:

get_rivals {"appId":"sbx-lumen","country":"us"}
{
  "country": "us",
  "rivals": [
    {
      "name": "Example App A",
      "terms": [
        { "term": "sleep timer", "theirRank": 1, "ourRank": 39 },
        { "term": "nature sounds", "theirRank": 1, "ourRank": 29 }
      ]
    },
    {
      "name": "Example App B",
      "terms": [
        { "term": "sleep timer", "theirRank": 2, "ourRank": 39 },
        { "term": "nature sounds", "theirRank": 2, "ourRank": 29 }
      ]
    },
    {
      "name": "Example App C",
      "terms": [
        { "term": "sleep timer", "theirRank": 3, "ourRank": 39 },
        { "term": "nature sounds", "theirRank": 3, "ourRank": 29 }
      ]
    }
  ]
}

get_store_page {"appId":"sbx-lumen","country":"us"}
{
  "country": "us",
  "timeline": [
    { "day": "2026-09-16", "kind": "version" }
  ]
}

• Düşen kelimeler: sleep timer ve nature sounds (2026-09-20 → 2026-09-27, US)
• Önündeki uygulamalar ve sıraları: Example App A (sleep timer 1, nature sounds 1); Example App B (sleep timer 2, nature sounds 2); Example App C (sleep timer 3, nature sounds 3)
• Senin sıran: sleep timer 39, nature sounds 29
• Kendi sayfan: son tarihli değişiklik haftadan önce: yeni sürüm (2026-09-16)

Buradan verdiğin karar: önce hangi uygulamanın sayfasını açacağın: düşen kelimelerin çoğunda birinci olan. Örnekte Example App A (düşen 2 kelimenin 2 tanesinde birinci).

Cevabın kapsamı:

• get_rivals en son ölçülen günü verir: her kelimede önünde kim var, kaçıncı sırada (theirRank) ve sen kaçıncısın (ourRank).
• ourRank değeri null ise o kelimede ölçüldün ve sonuçların dışındasın.
• get_store_page cevabındaki timeline kendi sayfandaki tarihli değişiklikleri listeler. Karşılaştırılan haftanın içine düşen bir değişiklik, sıra hareketinin yanına konacak ilk kayıttır.
• Bir sıra hareketini bir değişikliğe bağlarken iki tarihi yan yana söyle: değişikliğin günü ve sıranın ölçüldüğü gün.

3. Bir kelimenin bugünkü ölçümü yoksa

Şunu sor: “ABD'de ‘white noise’ için bugün kaçıncıyım?” Asistan get_keywords ve get_history çağırır:

get_keywords {"appId":"sbx-lumen","country":"us"}
{
  "country": "us",
  "keywords": [
    { "term": "sleep sounds", "measured": true, "rank": null },
    { "term": "white noise", "measured": false, "rank": null },
    { "term": "rain sounds", "measured": true, "rank": 34 }
  ]
}

get_history {"appId":"sbx-lumen","country":"us"}
{
  "country": "us",
  "series": {
    "ios|white noise": [
      ["2026-09-20", 57], ["2026-09-21", 56], ["2026-09-22", 54], ["2026-09-23", 58],
      ["2026-09-24", 56], ["2026-09-25", 55]
    ]
  }
}

• white noise: son ölçüm 2026-09-25, sıra 55; hesaptaki en yeni günden (2026-09-27) iki gün önce
• rain sounds: 2026-09-27 günü sıra 34
• sleep sounds: 2026-09-27 günü ölçüldü, sonuçların dışında

Buradan verdiğin karar: elindeki sayının bugüne mi ait olduğu. Örnekte ‘white noise’ sırası 2026-09-25 tarihli; o günün okuması olarak kullanılır.

Cevabın kapsamı:

• Cevaptaki her sıra, ölçüldüğü günle birlikte söylenir.
• Serideki her nokta ölçülmüş bir gündür; ortalama ve sayım o noktalar üzerinden yapılır.

Devamı