Sonar

Otimização de App Store para agentes de IA — pesquisa de palavras-chave, monitoramento de rankings, mineração de avaliações e análise de concorrentes para iOS e Android.

GitHubExperimente este MCPPatrocinado

Documentação

@sonarapp/mcp

O servidor MCP oficial do Sonar — ferramentas de Otimização de App Store para agentes de IA.

Para o plugin hospedado Grok Build e Cursor marketplace, consulte configuração do plugin, autenticação e permissões.

Permite que Claude Desktop, Claude Code, Cursor, Cline e qualquer cliente compatível com Model Context Protocol consulte aplicativos, pesquise palavras-chave, audite ASO, analise avaliações e estime receita na App Store da Apple e no Google Play. Desenvolvido pela Sonar.

Ferramentas

Ferramentas de leitura — sem estado

Ferramenta	O que faz
`sonar_app_lookup`	Consulta metadados do aplicativo pelo ID da loja
`sonar_app_search`	Pesquisa aplicativos por palavra-chave (retorna ordem de classificação da loja)
`sonar_app_aso_score`	Pontuação de auditoria ASO (0-100) com verificações detalhadas
`sonar_app_extract_keywords`	Extrai palavras-chave alvo da listagem de um aplicativo
`sonar_app_reviews`	Busca avaliações com filtros de classificação e opções de ordenação
`sonar_app_revenue`	Estima receita mensal com metodologia
`sonar_keyword_search`	Pesquisa de palavras-chave (dificuldade, popularidade, termos relacionados)
`sonar_keyword_metrics`	Dificuldade + popularidade para palavras-chave específicas (única ou em lote)
`sonar_keyword_suggestions`	Sugestões de autocompletar da loja
`sonar_top_charts`	Gráfico dos principais gratuitos/pagos/mais lucrativos com variação dia a dia

As ferramentas sem estado funcionam em qualquer plano com créditos, tanto para iOS quanto para Android.

Ferramentas de leitura — seu espaço de trabalho (plano Indie)

Ferramenta	O que faz
`sonar_list_apps`	Lista seus aplicativos monitorados com os snapshots mais recentes (classificação, avaliações, instalações)
`sonar_get_app`	Detalhes do aplicativo + até 90 dias de histórico de snapshots
`sonar_app_keywords`	Palavras-chave monitoradas para um aplicativo, com dificuldade + popularidade
`sonar_app_rankings`	Histórico diário de classificação para as palavras-chave monitoradas de um aplicativo
`sonar_app_changes`	Versões detectadas, edições de metadados, alterações de captura de tela/preço/categoria
`sonar_keyword_rankings`	Histórico de SERP para uma palavra-chave monitorada (quem classificou, quando)
`sonar_competitor_keywords`	Palavras-chave que um concorrente classifica + análise de lacunas em relação ao seu aplicativo
`sonar_competitor_landscape`	Panorama competitivo completo para um dos seus próprios aplicativos — estatísticas de lacuna/vencível/ameaça/liderança + insight de IA mais recente

As leituras do espaço de trabalho exigem um plano Indie (um teste ativo conta); a chave padrão com escopo read é suficiente.

Ferramentas de escrita (plano Indie + escopo de escrita)

Ferramenta	O que faz
`sonar_create_product`	Cria um produto no seu espaço de trabalho Sonar e começa a monitorar seus aplicativos
`sonar_track_app`	Vincula a versão da segunda loja (iOS ↔ Android) de um produto existente
`sonar_track_competitor`	Adiciona um aplicativo concorrente sob um produto
`sonar_track_keywords`	Inicia o monitoramento diário de classificação para palavras-chave em um aplicativo (em lote, idempotente)
`sonar_update_keyword_note`	Define ou limpa a nota em uma palavra-chave monitorada
`sonar_scan_competitor`	Executa uma varredura de descoberta de palavras-chave em um concorrente (leia os resultados com `sonar_competitor_keywords`)
`sonar_analyze_competitors`	Gera um novo insight competitivo de IA para um dos seus próprios aplicativos (período de espera de 7 dias; leia com `sonar_competitor_landscape`)

As ferramentas de escrita alteram seu espaço de trabalho e exigem um plano Indie (um teste ativo conta) além de uma chave de API criada com o escopo write. O servidor aplica ambos — sem eles, as chamadas retornam um erro 403 explicando o que corrigir.

Juntas, elas fecham o ciclo para agentes: configure o monitoramento com as ferramentas de escrita e depois leia as classificações, alterações e análises de lacunas com as ferramentas do espaço de trabalho.

Experimente grátis — sem necessidade de chave de API

O servidor funciona sem chave no modo gratuito: sonar_app_search, sonar_app_lookup, sonar_app_aso_score, sonar_app_extract_keywords e sonar_keyword_suggestions compartilham uma cota gratuita de 30 solicitações/dia por IP, e sonar_keyword_metrics (dificuldade + popularidade de palavras-chave) recebe 5 palavras-chave/dia. Basta instalá-lo sem bloco env e pergunte ao seu agente sobre ASO. Quando você atingir o limite, o erro informará como se cadastrar.

Obtenha uma chave de API

Para todo o resto (monitoramento, classificações, concorrentes, limites maiores), você precisará de uma chave de API Sonar — obtenha uma em trysonar.app/developers.

O caminho mais barato é créditos de API pré-pagos — pacotes a partir de US$ 10 (1.000 créditos), com 50 créditos gratuitos no cadastro e sem assinatura. Feito especificamente para este caso de uso. Consulte preços.

Instalação

Claude Desktop

Adicione ao seu arquivo de configuração (~/Library/Application Support/Claude/claude_desktop_config.json no macOS, %APPDATA%\Claude\claude_desktop_config.json no Windows):

{
  "mcpServers": {
    "sonar": {
      "command": "npx",
      "args": ["-y", "@sonarapp/mcp"],
      "env": {
        "SONAR_API_KEY": "aso_your_key_here"
      }
    }
  }
}

Reinicie o Claude Desktop. As ferramentas sonar_* aparecerão no seletor de ferramentas.

Claude Code

claude mcp add sonar -e SONAR_API_KEY=aso_your_key_here -- npx -y @sonarapp/mcp

Cursor

Adicione a ~/.cursor/mcp.json (ou o .cursor/mcp.json do seu projeto):

{
  "mcpServers": {
    "sonar": {
      "command": "npx",
      "args": ["-y", "@sonarapp/mcp"],
      "env": {
        "SONAR_API_KEY": "aso_your_key_here"
      }
    }
  }
}

Cline / outros clientes MCP

A maioria dos clientes usa o mesmo formato command + args + env acima. Aponte o comando para npx -y @sonarapp/mcp e passe SONAR_API_KEY no ambiente.

Configuração

Variável	Obrigatória	Padrão	Descrição
`SONAR_API_KEY`	não (modo gratuito sem ela)	—	Sua chave de API Sonar (`aso_...`)
`SONAR_API_URL`	não	`https://trysonar.app`	Substitui a URL base da API (usada apenas para self-hosting / staging)

Exemplos de prompts

"Use o Sonar para consultar o Spotify no iOS na loja dos EUA e informe sua classificação, número de avaliações e categoria."

"Execute uma auditoria ASO no com.duolingo no Android e me diga o que corrigir."

"Pesquise a palavra-chave 'habit tracker' no iOS — me dê dificuldade, popularidade e 5 termos relacionados com menor dificuldade que eu deva considerar."

"Busque as 50 avaliações mais recentes de 1 e 2 estrelas do 1517783697 no iOS EUA e agrupe as reclamações por tema."

"Pesquise 'meditation' na App Store e estime a receita mensal dos 5 principais resultados."

Política de Privacidade

Política completa: https://trysonar.app/privacy

O servidor MCP é um cliente leve em torno da API REST do Sonar — ele não armazena nada localmente e nenhum dado é registrado por este pacote em si.

Dados coletados: entradas das ferramentas (IDs de aplicativos, palavras-chave, códigos de país) são enviadas à API do Sonar via HTTPS para produzir resultados; solicitações autenticadas incluem sua chave de API como token Bearer. O Sonar registra solicitações de API (endpoint, status, tempo) para limitação de taxa e prevenção de abuso.
Uso de dados: as entradas são usadas exclusivamente para atender à solicitação (métricas de palavras-chave, consultas de aplicativos etc.); o JSON resultante é retornado ao seu cliente de IA.
Armazenamento e retenção: o pacote não mantém estado em disco. Os registros de solicitações no servidor são retidos por 90 dias; os dados do espaço de trabalho (aplicativos/palavras-chave monitorados) persistem na sua conta Sonar até que você os exclua.
Compartilhamento com terceiros: nenhum dado do usuário é vendido ou compartilhado com terceiros; consultas contra dados públicos da loja de aplicativos (Apple, Google) não contêm informações pessoais.
Contato: hello@trysonar.app

Solução de problemas

"SONAR_API_KEY is not set — running in free mode" — Esperado se você não configurou uma chave: as ferramentas gratuitas continuam funcionando com limites diários por IP. Se você CONFIGUROU uma chave, o cliente MCP não repassou a variável de ambiente — verifique a seção env do arquivo de configuração do seu cliente. Alguns clientes exigem um caminho absoluto para npx — tente which npx e use esse.

"Authentication failed" — Sua chave é inválida, expirou ou sua assinatura foi cancelada. Visite trysonar.app/developers para verificar.

"Access denied. Endpoint may require Indie plan" — As 10 ferramentas de leitura sem estado funcionam em qualquer plano com créditos. As ferramentas de leitura do espaço de trabalho e as ferramentas de escrita exigem um plano Indie (um teste ativo conta); as ferramentas de escrita adicionalmente precisam de uma chave de API criada com o escopo write. Se você estiver em um plano de configuração ou com teste expirado, reative primeiro.

Complemento: CLI

Prefere o terminal? Use @sonarapp/cli (binário sonar) — mesmos dados, mesma chave de API.