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

URL: https://storelift.net/ko/guide/storelift-mcp-first-tasks/
Language: ko
Updated: 2026-10-13

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

NOTE: 올바른 답에 담기는 내용:

- 비교한 날짜: 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" }
]
}

NOTE: 올바른 답에 담기는 내용:

- 순위가 떨어진 키워드: 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]
]
}
}

NOTE: 올바른 답에 담기는 내용:

- 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에 측정된 값이며, 그날의 값으로 읽습니다.

이 답이 다루는 범위:

| get_keywords의 행 | 의미 | 어시스턴트가 하는 말 |
| --- | --- | --- |
| measured: false | 가장 최근 날짜에 이 키워드의 측정이 없음 | 마지막으로 측정된 순위와 그 날짜(get_history 시계열의 마지막 지점) |
| measured: true, rank: null | 측정됨, 앱이 결과 밖 | “측정됨, 결과 밖” |
| measured: true, rank에 숫자 | 측정됨, 이 값이 순위 | 순위와 그 날짜 |

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