Storelift MCP 서버로 해 볼 첫 작업 세 가지

샘플 데이터와 버전

아래 답은 Storelift 샘플 데이터 세트(2026-09-28)에서 나온 것입니다. 예시 앱 하나(Lumen — Sleep Sounds)를 미국에서 키워드 8개로 추적하며, 예시 경쟁 앱은 세 개입니다(Example App A, Example App B, Example App C). 내 계정에서는 내 앱과 내 숫자가 반환됩니다.

세 작업 모두 storelift-mcp 1.1.1에서 다음 읽기 도구로 실행됩니다: list_apps, get_history, get_rivals, get_store_page, get_keywords. 아직 연결하지 않았다면 설정 가이드를 보세요: Claude, Claude Code, Cursor.

1. 일주일 사이에 어떤 키워드가 움직였나요?

이렇게 물어보세요: “내 미국 키워드 중에 일주일 전보다 순위가 떨어진 게 뭐야?” 어시스턴트는 list_apps, get_history 도구를 호출합니다:

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]
    ]
  }
}

• 비교한 날짜: 2026-09-20 → 2026-09-27 (US)
• 하락: sleep timer 37 → 39; nature sounds 28 → 29
• 상승: rain sounds 37 → 34; relax 52 → 49
• 변동 없음: meditation music 42
• 두 날 모두 측정됨, 결과 밖: sleep sounds; brown noise
• 비교에서 제외: white noise(최근 측정 2026-09-25, 순위 55)

이 답으로 내리는 결정: 어떤 키워드를 먼저 열어 볼지입니다. 예시에서는 sleep timer입니다(37 → 39).

이 답이 다루는 범위:

• 측정된 두 날을 비교합니다: 2026-09-20, 2026-09-27. 그 사이의 날짜는 같은 응답의 series에 들어 있어, 양 끝만이 아니라 그 사이의 흐름까지 보고 싶을 때 쓸 수 있습니다.
• 순위가 null인 지점은 그날 측정했고 앱이 결과 밖이었다는 뜻입니다. 답에서는 그렇게 밝히고, 그 자리에 숫자를 넣지 않습니다.
• 2026-09-27에 지점이 없는 키워드는 마지막으로 측정된 순위와 날짜를 붙여 이름을 밝히고, 비교에서는 뺍니다.
• 이 답은 어떤 키워드가 움직였는지를 보여 줍니다. 두 번째 작업에서는 나보다 앞선 앱과, 내 스토어 페이지에서 날짜와 함께 기록된 변경을 비교합니다. 이런 관찰만으로 원인이 확정되지는 않습니다.

2. 순위가 떨어진 키워드에서 누가 앞서 있나요?

이렇게 물어보세요: “순위가 떨어진 키워드에서 나보다 위에 있는 앱은 어디야? 그 주에 내 스토어 페이지도 바뀌었어?” 어시스턴트는 첫 번째 작업의 순위 이력 응답을 다시 쓰고 get_rivals, get_store_page 도구를 호출합니다:

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" }
  ]
}

• 순위가 떨어진 키워드: sleep timer, nature sounds (2026-09-20 → 2026-09-27, US)
• 나보다 위에 있는 앱과 그 순위: 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)
• 내 순위: sleep timer 39, nature sounds 29
• 내 스토어 페이지: 날짜와 함께 기록된 가장 최근 변경은 그 주 이전입니다: 새 버전 (2026-09-16)

이 답으로 내리는 결정: 어느 앱의 스토어 페이지를 먼저 열어 볼지입니다. 순위가 떨어진 키워드 대부분에서 1위인 앱부터 봅니다. 예시에서는 Example App A입니다(2개 중 2개에서 1위).

이 답이 다루는 범위:

• get_rivals는 가장 최근에 측정된 날의 결과를 반환합니다. 키워드마다 누가 나보다 위에 있는지, 그 앱이 몇 위인지(theirRank), 내가 몇 위인지(ourRank)가 들어 있습니다.
• ourRank가 null이면 그 키워드를 측정했고 내 앱이 결과 밖에 있다는 뜻입니다.
• get_store_page 응답의 timeline에는 내 스토어 페이지에서 날짜와 함께 기록된 변경이 나열됩니다. 비교한 주 안에 있는 변경이 순위 변동과 가장 먼저 나란히 놓고 볼 기록입니다.
• 순위 변동을 어떤 변경과 연결할 때는 두 날짜를 나란히 적으세요. 변경이 있었던 날과 순위를 측정한 날입니다.

3. 오늘 측정이 없는 키워드가 있을 때

이렇게 물어보세요: “오늘 미국에서 ‘white noise’ 키워드로 내 앱이 몇 위야?” 어시스턴트는 get_keywords, get_history 도구를 호출합니다:

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: 최근 측정 2026-09-25, 순위 55. 계정의 가장 최근 날짜(2026-09-27)보다 2일 전
• rain sounds: 2026-09-27 기준 순위 34
• sleep sounds: 2026-09-27에 측정됨, 결과 밖

이 답으로 내리는 결정: 눈앞의 숫자가 오늘 것인지입니다. 예시에서 ‘white noise’의 순위는 2026-09-25에 측정된 값이며, 그날의 값으로 읽습니다.

이 답이 다루는 범위:

• 답에 나오는 모든 순위는 측정된 날짜와 함께 말합니다.
• 시계열의 모든 지점은 측정된 날입니다. 평균과 개수는 그 지점들로 계산합니다.

다음 읽을거리