サンプルデータとバージョン
以下の答えは、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]
]
}
}- 比較した日: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" }
]
}- 下がったキーワード: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]
]
}
}- 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 が数値 | 計測済みで、これが順位 | 順位とその日付 |
- 答えの中の順位はすべて、計測した日付と一緒に示します。
- 系列の点はすべて計測済みの日です。平均や件数は、その点だけを対象に計算します。
自分のアプリで確かめる
ストアのリンクを貼り付けて、キーワードを追加するだけ。順位、上位のアプリ、需要を毎日計測します。
無料プラン:1 アプリ、2 つのストアフロントでそれぞれ 25 キーワード、30 日分の履歴。カード不要、期限なし。Pro は月額 $20。
無料で始める →
