# Storelift MCP サーバーの最初の 3 つのタスク

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

Storelift MCP サーバーを接続し、ツールが一覧に表示されました。ここから判断にたどり着くための 3 つの質問を紹介します。それぞれに、アシスタントが行う呼び出し、サンプルデータに対してサーバーが返す内容、正しく読んだ場合に行き着く答えを添えています。

## サンプルデータとバージョン

以下の答えは、Storelift のサンプルデータセット（2026-09-28）のものです。米国で 8 個のキーワードを追跡しているサンプルアプリ 1 つ（Lumen — Sleep Sounds）と、サンプルの競合 3 つ（Example App A, Example App B, Example App C）が入っています。自分のアカウントでは、自分のアプリと自分の数値が返ります。

3 つのタスクはすべて storelift-mcp 1.1.1 で、次の読み取りツールを使って実行できます：list_apps, get_history, get_rivals, get_store_page, get_keywords。まだ接続していない場合は、セットアップガイドをご覧ください：Claude, Claude Code, Cursor。

## 1. この 1 週間で動いたキーワードはどれか

こう尋ねます：「米国のキーワードで、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）です。

この答えがカバーする範囲：

- 計測済みの 2 日、2026-09-20 と 2026-09-27 を比較しています。その間の日は同じ答えの series に入っているので、両端だけでなく途中の推移も確認できます。
- 順位が null の点は、その日に計測したもののアプリが圏外だったことを表します。答えではそのとおりに伝え、代わりの数値は入れません。
- 2026-09-27 に点がないキーワードは、最後に計測された順位と日付を添えて挙げ、比較には含めません。
- この答えで分かるのは、どのキーワードが動いたかです。2 つ目のタスクでは、自分より上位のアプリと、自分のストアページの日付つきの変更を比べます。こうした観察だけでは、原因は確定しません。

## 2. 下がったキーワードで上にいるのは誰か

こう尋ねます：「下がったキーワードで自分より上にいるのは誰？その週に自分のストアページは変わった？」アシスタントは 1 つ目のタスクの履歴の答えを再利用し、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 は、自分のストアページの日付つきの変更を一覧にします。比較した週の中にある変更は、順位の動きと最初に並べて見るべき記録です。
- 順位の動きを変更と結びつけるときは、変更の日と順位を計測した日の 2 つの日付を並べて示します。

## 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 が数値 | 計測済みで、これが順位 | 順位とその日付 |

- 答えの中の順位はすべて、計測した日付と一緒に示します。
- 系列の点はすべて計測済みの日です。平均や件数は、その点だけを対象に計算します。