# Três primeiras tarefas com o servidor MCP do Storelift

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

O servidor MCP do Storelift está conectado e as ferramentas aparecem na lista. Estas três perguntas levam você daí até uma decisão: cada uma traz as chamadas que o assistente faz, o que o servidor devolve para os dados de exemplo e a resposta a que uma leitura correta chega.

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

NOTE: Uma resposta correta diz:

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

NOTE: Uma resposta correta diz:

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

NOTE: Uma resposta correta diz:

- 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:

| Linha de get_keywords | Significado | O que o assistente diz |
| --- | --- | --- |
| measured: false | A palavra-chave não tem medição no dia mais recente | A última posição medida e o dia dela (o último ponto da série de get_history) |
| measured: true, rank: null | Medida, o app está fora dos resultados | “Medida, fora dos resultados” |
| measured: true, rank com um número | Medida, esta é a posição | A posição e o dia dela |

- 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.