Black Friday25% de desconto no primeiro mês dos planos mensais Aproveitar a oferta

Servidor MCP e API REST

Seus dados de ASO dentro do seu assistente de IA

O servidor MCP do Rankglass permite que o Claude Code, o Cursor, o Claude Desktop, o Codex, o app ChatGPT para desktop e outros clientes MCP leiam suas palavras-chave monitoradas, posições, concorrentes e pontuações da página. Uma API REST entrega os mesmos dados aos seus próprios scripts.

Em resumo

Endpoint MCP
https://app.rankglass.com/api/mcp
Transporte
Streamable HTTP
Autenticação
Uma chave de API do espaço de trabalho, enviada como Authorization: Bearer YOUR_API_KEY
Acesso
Somente leitura
Planos
Starter, Pro e Agency
Limites de requisições
60 requisições por minuto e 2.000 por dia por chave

Funciona com clientes MCP que conseguem enviar um cabeçalho

O Rankglass verifica uma chave de API em cada requisição, então o cliente só precisa enviá-la no cabeçalho. Estes clientes estão configurados abaixo:

  • Claude Code
  • Cursor
  • Claude Desktop, via mcp-remote (exige Node.js)
  • Codex e o app ChatGPT para desktop
  • Outros clientes MCP e agentes que você cria, com o endpoint e o cabeçalho acima

Um cliente que só se conecta por login OAuth não consegue enviar a chave, então ainda não pode adicionar o Rankglass.

Configure em três passos

  1. Passo 1

    Crie uma chave de API

    No Rankglass, abra Configurações → Espaço de trabalho → API e MCP e crie uma chave. Ela aparece só uma vez, então copie na hora. Uma chave lê um espaço de trabalho; crie uma por assistente ou script para poder revogar cada uma separadamente.

  2. Passo 2

    Adicione o Rankglass ao seu assistente

    Cole a configuração do seu cliente e substitua YOUR_API_KEY pela sua chave.

    Claude Code

    Execute isto em um terminal. Com --scope user, o Rankglass fica disponível em todos os seus projetos.

    claude mcp add --transport http --scope user rankglass https://app.rankglass.com/api/mcp --header "Authorization: Bearer YOUR_API_KEY"

    Cursor e outros clientes

    No Cursor, adicione isto a ~/.cursor/mcp.json, ou a .cursor/mcp.json em um projeto. Outros clientes guardam os servidores MCP nas próprias configurações; o endpoint e o cabeçalho são tudo de que precisam.

    {
      "mcpServers": {
        "rankglass": {
          "url": "https://app.rankglass.com/api/mcp",
          "headers": {
            "Authorization": "Bearer YOUR_API_KEY"
          }
        }
      }
    }

    Claude Desktop

    Adicione isto a claude_desktop_config.json (Settings → Developer → Edit Config) e reinicie o Claude. Ele executa o mcp-remote com npx, então o Node.js precisa estar instalado.

    {
      "mcpServers": {
        "rankglass": {
          "command": "npx",
          "args": [
            "-y",
            "mcp-remote",
            "https://app.rankglass.com/api/mcp",
            "--header",
            "Authorization:${RANKGLASS_AUTH}"
          ],
          "env": {
            "RANKGLASS_AUTH": "Bearer YOUR_API_KEY"
          }
        }
      }
    }

    Codex e o app ChatGPT para desktop

    Adicione isto a ~/.codex/config.toml, compartilhado pela Codex CLI, pela extensão Codex para IDE e pelo app ChatGPT para desktop. Coloque sua chave, sem Bearer, em uma variável de ambiente chamada RANKGLASS_API_KEY.

    [mcp_servers.rankglass]
    url = "https://app.rankglass.com/api/mcp"
    bearer_token_env_var = "RANKGLASS_API_KEY"

    Clientes que não conseguem definir o cabeçalho Authorization podem enviar x-api-key: YOUR_API_KEY no lugar.

  3. Passo 3

    Pergunte com suas palavras

    Seu assistente escolhe a ferramenta certa. Nenhuma delas pode alterar nada no seu espaço de trabalho.

O que seu assistente pode ler

11 ferramentas somente leitura. Cada uma tem um endpoint GET correspondente na API REST.

Ferramentas MCP e seus endpoints REST
Ferramenta MCPO que retornaEndpoint REST
list_appsSeus apps com as lojas, os países monitorados, o número de palavras-chave e os principais números da semana. Uma boa primeira chamada.GET /v1/apps
get_keyword_rankingsTodas as palavras-chave monitoradas de um app em uma loja e um país: posição, variação em 7 dias, entrada ou saída dos resultados, melhor posição, buscas mensais estimadas, dificuldade e posições dos concorrentes.GET /v1/keywords
get_rank_changesOs maiores ganhos e perdas de posição dos últimos dias, em todas as palavras-chave, lojas e países, e as palavras-chave que entraram ou saíram do top 10.GET /v1/rank-changes
get_competitorsConcorrentes seguidos com as avaliações, em quantas palavras-chave cada lado está mais bem posicionado e as palavras-chave em que um concorrente está no top 10 e você não.GET /v1/competitors
get_competitor_keywordsAs palavras-chave para as quais um concorrente ranqueia em um país, inclusive as que você ainda não monitora, com buscas mensais, dificuldade e as duas posições.GET /v1/competitor-keywords
get_competitor_insightsOs dados de loja de um concorrente, avaliações por estrelas, posições nas paradas, downloads e receita mensais estimados e o resumo de resenhas com IA mais recente.GET /v1/competitor-insights
get_competitor_growthBetaComo um concorrente conquista usuários: anúncios, contas em redes sociais, criadores de conteúdo, busca na loja e site, com gasto com anúncios, instalações vindas de anúncios e alcance nas redes sociais estimados, e a estratégia de IA mais recente. Pro e Agency.GET /v1/competitor-growth
get_store_page_changesAlterações recentes nas suas páginas da loja e nas dos concorrentes: título, subtítulo, descrição, capturas de tela, versão e notas da versão.GET /v1/store-page-changes
get_aso_scoreSua pontuação de ASO de 0 a 100 para uma loja e um país, as verificações por trás dela, ganhos rápidos de palavras-chave e as sugestões de IA mais recentes para a página.GET /v1/aso-score
get_weekly_briefO briefing semanal mais recente do seu app: o que mudou, os motivos prováveis e até três coisas a fazer em seguida.GET /v1/weekly-brief
get_keyword_game_planBetaO plano de ação mais recente de uma palavra-chave monitorada: a posição-alvo e até cinco passos para chegar lá.GET /v1/keyword-game-plan

API REST

Os mesmos dados em JSON para seus scripts, painéis e planilhas. Cada endpoint é uma requisição GET em https://app.rankglass.com/api/v1 e usa a mesma chave.

Uma primeira requisição: as maiores variações de posição dos últimos sete dias.

curl "https://app.rankglass.com/api/v1/rank-changes?days=7" -H "Authorization: Bearer YOUR_API_KEY"

Limites e acesso

  • Somente leitura. As ferramentas e os endpoints só leem o que o Rankglass já armazenou; nunca iniciam uma nova busca. Trabalhos pagos, como encontrar as palavras-chave de um concorrente em um novo país, são iniciados no painel.
  • Cada chave pode fazer 60 requisições por minuto e 2.000 por dia, compartilhadas entre o servidor MCP e a API REST. Acima disso, as requisições recebem uma resposta 429 com o cabeçalho Retry-After.
  • O acesso à API e ao MCP vem com os planos Starter, Pro e Agency. Sem ele, as requisições recebem uma resposta 403.
  • Uma chave lê tudo no espaço de trabalho dela, então trate-a como uma senha. A página de configurações mostra quando cada chave foi usada pela última vez, e você pode revogá-la ali.

Perguntas para testar

  • Quais das minhas palavras-chave caíram esta semana?
  • Em que posição meu app está para “habit tracker” na Alemanha, e quem está acima de mim?
  • Para quais palavras-chave meu principal concorrente ranqueia que eu ainda não monitoro?
  • O que meus concorrentes mudaram nas páginas da loja neste mês?
  • Qual é minha pontuação de ASO no Reino Unido, e o que devo corrigir primeiro?
  • Resuma o briefing desta semana de cada um dos meus apps.

Perguntas sobre o servidor MCP

Funciona com o ChatGPT?

Sim, no app ChatGPT para desktop. Ele compartilha os servidores MCP com a Codex CLI e a extensão Codex para IDE em ~/.codex/config.toml, que consegue enviar sua chave a partir de uma variável de ambiente (bearer_token_env_var); a configuração acima mostra como. O ChatGPT na web adiciona ferramentas por conectores que só oferecem login OAuth, e esses ainda não conseguem enviar a chave. Qualquer coisa que chame uma API com um cabeçalho pode usar a API REST no lugar.

Meu assistente pode alterar algo no Rankglass?

Não. Todas as ferramentas e endpoints só leem. Adicionar apps, monitorar palavras-chave e iniciar buscas acontece no painel.

Com que frequência os dados são atualizados?

Com a mesma frequência do painel: nos planos pagos, cada palavra-chave monitorada é verificada uma vez por dia, e o briefing semanal é escrito toda segunda-feira. As ferramentas leem o que o Rankglass armazenou e nunca iniciam uma verificação.

Para onde vão meus dados?

Só para o cliente que os pede, e só do espaço de trabalho ao qual a chave pertence. A partir daí, o provedor do seu assistente os trata segundo os próprios termos. Exclua a chave para interromper o acesso a qualquer momento.

Prefere um passo a passo? Leia como configurar o servidor MCP do Rankglass.

Descubra o próximo passo para o seu app

Adicione seu app com um link da loja e veja sua posição hoje.

Começar grátis

Plano Gratuito · Sem cartão de crédito · Cancele quando quiser