Três primeiras tarefas com o servidor MCP do Storelift

Dados de exemplo e versão

As respostas abaixo vêm do conjunto de dados de exemplo do Storelift (2026-09-28): um app de exemplo (Lumen — Sleep Sounds) acompanhado nos EUA com 8 palavras-chave e três rivais de exemplo (Example App A, Example App B, Example App C). A sua conta devolve os seus próprios apps e os seus próprios números.

As três tarefas rodam no storelift-mcp 1.1.1 com estas ferramentas de leitura: list_apps, get_history, get_rivals, get_store_page, get_keywords. Se você ainda não conectou, os guias de configuração: Claude, Claude Code, Cursor.

1. Quais palavras-chave se moveram em uma semana?

Pergunte: “Quais das minhas palavras-chave nos EUA estão em posição pior do que há uma semana?” O assistente chama list_apps e 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]
    ]
  }
}

• Dias comparados: 2026-09-20 → 2026-09-27 (US)
• Caíram: sleep timer 37 → 39; nature sounds 28 → 29
• Subiram: rain sounds 37 → 34; relax 52 → 49
• Sem mudança: meditation music 42
• Medidas nos dois dias, fora dos resultados: sleep sounds; brown noise
• Fora da comparação: white noise (última medição em 2026-09-25, posição 55)

O que você decide com isso: qual palavra-chave abrir primeiro. No exemplo é sleep timer (37 → 39).

O que a resposta cobre:

• Dois dias medidos são comparados: 2026-09-20 e 2026-09-27. Os dias entre eles estão na mesma resposta, em series, para quando você quiser o caminho e não só as duas pontas.
• Um ponto cuja posição é null foi medido com o app fora dos resultados naquele dia; a resposta diz isso e não põe nenhum número no lugar.
• Uma palavra-chave sem ponto em 2026-09-27 é citada com a última posição medida e o dia dela, e fica fora da comparação.
• A resposta mostra quais palavras-chave se moveram. A segunda tarefa compara os apps que estão à sua frente e as mudanças datadas na sua própria página na loja; essas observações, sozinhas, não estabelecem a causa.

2. Quem está à frente nas palavras-chave que caíram?

Pergunte: “Quem está acima de mim nas palavras-chave que caíram, e a minha página na loja mudou naquela semana?” O assistente reaproveita a resposta de histórico da primeira tarefa e chama get_rivals e 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" }
  ]
}

• Palavras-chave que caíram: sleep timer e nature sounds (2026-09-20 → 2026-09-27, US)
• Apps acima de você, com as posições: 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)
• Sua posição: sleep timer 39, nature sounds 29
• Sua própria página na loja: a mudança datada mais recente é de antes da semana: uma nova versão (2026-09-16)

O que você decide com isso: qual página abrir primeiro: a do app que está em primeiro na maioria das palavras-chave que caíram. No exemplo é Example App A (primeiro em 2 de 2).

O que a resposta cobre:

• get_rivals devolve o último dia medido: quem está acima de você em cada palavra-chave, em que posição (theirRank) e onde você está (ourRank).
• Um ourRank igual a null significa que você foi medido naquela palavra-chave e está fora dos resultados.
• timeline, na resposta de get_store_page, lista as mudanças datadas da sua própria página na loja. Uma mudança que cai dentro da semana comparada é o primeiro registro a colocar ao lado de um movimento de posição.
• Quando um movimento de posição for ligado a uma mudança, informe as duas datas lado a lado: o dia da mudança e o dia em que a posição foi medida.

3. Quando uma palavra-chave não tem medição hoje

Pergunte: “Em que posição eu estou para ‘white noise’ nos EUA hoje?” O assistente chama get_keywords e 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: última medição em 2026-09-25, posição 55; dois dias antes do dia mais recente da conta (2026-09-27)
• rain sounds: posição 34 em 2026-09-27
• sleep sounds: medida em 2026-09-27, fora dos resultados

O que você decide com isso: se o número na sua frente é o de hoje. No exemplo, a posição de ‘white noise’ tem a data 2026-09-25 e é usada como a leitura daquele dia.

O que a resposta cobre:

• Toda posição na resposta vem com o dia em que foi medida.
• Todo ponto da série é um dia medido; médias e contagens são feitas sobre esses pontos.

Leia também