GetAppNiche

GetAppNiche MCP — Inteligência da App Store e Google Play para agentes de IA

A superfície do Model Context Protocol do GetAppNiche: dados ao vivo da App Store e Google Play — descoberta de apps com dados de receita e downloads, pontuação de palavras-chave ASO, métricas históricas e feeds de avaliações — para Claude, Cursor, Codex, Gemini CLI e qualquer outro agente compatível com MCP.

Você provavelmente não precisa executar nada. O servidor está hospedado:

https://api.getappniche.com/mcp        Streamable HTTP · JSON-RPC 2.0
Authorization: Bearer YOUR_API_KEY     app.getappniche.com → Settings → API Keys

Configuração por cliente

Claude Code — um comando, sem reiniciar:

claude mcp add --transport http getappniche https://api.getappniche.com/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Cursor — .cursor/mcp.json (projeto) ou ~/.cursor/mcp.json (global):

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

Claude Desktop — claude_desktop_config.json, depois reinicie o aplicativo completamente:

{
  "mcpServers": {
    "getappniche": {
      "command": "npx",
      "args": ["-y", "@getappniche/mcp"],
      "env": { "GETAPPNICHE_API_KEY": "YOUR_API_KEY" }
    }
  }
}

VS Code (modo agente Copilot) — .vscode/mcp.json:

{
  "servers": {
    "getappniche": {
      "type": "http",
      "url": "https://api.getappniche.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Windsurf — ~/.codeium/windsurf/mcp_config.json (o campo é serverUrl):

{
  "mcpServers": {
    "getappniche": {
      "serverUrl": "https://api.getappniche.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Codex CLI — ~/.codex/config.toml, depois exporte GETAPPNICHE_API_KEY:

[mcp_servers.getappniche]
url = "https://api.getappniche.com/mcp"
bearer_token_env_var = "GETAPPNICHE_API_KEY"

Gemini CLI — ~/.gemini/settings.json (o campo é httpUrl):

{
  "mcpServers": {
    "getappniche": {
      "httpUrl": "https://api.getappniche.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Zed, Cline, Continue e JetBrains AI também são cobertos — getappniche.com/mcp tem todos os trechos de código. Habilidades de agente complementares: getappniche/aso-skills (npx skills add getappniche/aso-skills).

ChatGPT — Configurações → Conectores → crie um conector personalizado (modo Desenvolvedor), aponte para https://api.getappniche.com/mcp e escolha autenticação por chave de API, depois cole sua chave.

claude.ai na web documenta autenticação por cabeçalho de solicitação, mas sua interface de conectores atualmente expõe apenas campos OAuth — até que isso se resolva, use um dos clientes acima.

O que há neste repositório

Uma ponte stdio sem dependências para clientes que falam MCP via stdio e não conseguem enviar cabeçalhos HTTP — em duas versões: bin/cli.mjs (Node 18+, publicado como @getappniche/mcp) e server.py (Python 3.9+, apenas stdlib). Ambas encaminham cada mensagem JSON-RPC para o endpoint hospedado via TLS e transmitem as respostas de volta.

# Node — one-liner, no install
GETAPPNICHE_API_KEY="getappniche_..." npx -y @getappniche/mcp

# Python — no dependencies
GETAPPNICHE_API_KEY="getappniche_..." python3 server.py

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "getappniche": {
      "command": "npx",
      "args": ["-y", "@getappniche/mcp"],
      "env": { "GETAPPNICHE_API_KEY": "getappniche_..." }
    }
  }
}

server.json é o manifesto publicado no registro oficial de MCP como com.getappniche/mcp.

Sendo cerca de 150 linhas legíveis, também serve como referência do que trafega pela rede: sua chave de API vai apenas no cabeçalho Authorization das solicitações TLS para api.getappniche.com — nada mais, em nenhum outro lugar.

Ferramentas

• search_apps - Pesquise apps com mais de 25 filtros: loja, categorias, idiomas, modelo de preço, avaliação, comentários, downloads, receita, recência de lançamento e atualização, crescimento de avaliações - ordenado por qualquer coluna (1 crédito)
• get_app_detail - Obtenha um app pelo id canônico, id Apple simples, nome do pacote Android ou URL de loja colada (1 crédito)
• get_app_historicals - Séries temporais de métricas: avaliações, classificações, downloads, receita (1 crédito)
• get_keyword_difficulty - Popularidade, dificuldade, tráfego e oportunidade para uma palavra-chave (10 créditos)
• batch_keyword_difficulty - Pontue até 10 palavras-chave, ordenadas por oportunidade (10 créditos por palavra-chave)
• get_app_reviews - Avaliações ao vivo da App Store ou Google Play para qualquer app por id, nome do pacote ou URL, ou linhas enriquecidas para apps monitorados no seu espaço de trabalho (1 crédito)
• get_supported_countries - Liste códigos de país válidos da loja (grátis)

Créditos acompanham um plano GetAppNiche (Pro: 5.000/mês) e cada resultado informa credits_charged. Limite de taxa: 60 solicitações/minuto por chave.

Notas de protocolo

• Métodos: initialize → notifications/initialized → tools/list / tools/call. Erros de protocolo usam códigos JSON-RPC padrão; erros de nível de ferramenta (id inválido, sem créditos) retornam como resultados de ferramenta que seu agente pode ler.
• A ponte respeita Mcp-Session-Id e aceita respostas tanto em JSON quanto em framing SSE.
• OAuth para clientes cuja interface de conectores não pode definir cabeçalhos (claude.ai web) está em andamento; ChatGPT conecta hoje com autenticação por chave de API.

Licença

MIT. Criado por GetAppNiche · X @getappniche · LinkedIn