GetAppNiche

GetAppNiche MCP — inteligencia de App Store y Google Play para agentes de IA

La superficie del Model Context Protocol de GetAppNiche: datos en vivo de App Store y Google Play — descubrimiento de apps con datos de ingresos y descargas, puntuación de palabras clave ASO, métricas históricas y fuentes de reseñas — para Claude, Cursor, Codex, Gemini CLI y cualquier otro agente compatible con MCP.

Probablemente no necesitas ejecutar nada. El servidor está alojado:

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

Configuración por cliente

Claude Code — un comando, sin reiniciar:

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

Cursor — .cursor/mcp.json (proyecto) o ~/.cursor/mcp.json (global):

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

Claude Desktop — claude_desktop_config.json, luego reinicia la app por completo:

{
  "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 (el campo es serverUrl):

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

Codex CLI — ~/.codex/config.toml, luego exporta GETAPPNICHE_API_KEY:

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

Gemini CLI — ~/.gemini/settings.json (el campo es httpUrl):

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

Zed, Cline, Continue y JetBrains AI también están cubiertos — getappniche.com/mcp tiene todos los fragmentos. Habilidades de agente complementarias: getappniche/aso-skills (npx skills add getappniche/aso-skills).

ChatGPT — Configuración → Conectores → crea un conector personalizado (modo Desarrollador), apúntalo a https://api.getappniche.com/mcp y elige autenticación con clave API, luego pega tu clave.

claude.ai en la web documenta autenticación por cabecera de solicitud, pero su interfaz de conectores actualmente solo expone campos OAuth — hasta que eso se resuelva, usa uno de los clientes anteriores.

Qué hay en este repositorio

Un puente stdio de cero dependencias para clientes que hablan MCP sobre stdio y no pueden enviar cabeceras HTTP — en dos variantes: bin/cli.mjs (Node 18+, publicado como @getappniche/mcp) y server.py (Python 3.9+, solo stdlib). Ambos reenvían cada mensaje JSON-RPC al endpoint alojado a través de TLS y transmiten las respuestas de vuelta.

# 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 es el manifiesto publicado en el registro oficial de MCP como com.getappniche/mcp.

Con ~150 líneas legibles, sirve también como referencia de lo que viaja por la red: tu clave API solo va en la cabecera Authorization de las solicitudes TLS a api.getappniche.com — nada más, en ningún otro lugar.

Herramientas

• search_apps - Busca apps con más de 25 filtros: tienda, categorías, idiomas, modelo de precio, valoración, reseñas, descargas, ingresos, novedad de lanzamiento y actualización, crecimiento de reseñas - ordenado por cualquier columna (1 crédito)
• get_app_detail - Obtén una app por id canónico, id de Apple, nombre de paquete de Android o una URL de tienda pegada (1 crédito)
• get_app_historicals - Series temporales de métricas: reseñas, valoraciones, descargas, ingresos (1 crédito)
• get_keyword_difficulty - Popularidad, dificultad, tráfico y oportunidad para una palabra clave (10 créditos)
• batch_keyword_difficulty - Puntúa hasta 10 palabras clave, ordenadas por oportunidad (10 créditos por palabra clave)
• get_app_reviews - Reseñas en vivo de App Store o Google Play para cualquier app por id, nombre de paquete o URL, o filas enriquecidas para apps monitorizadas en tu espacio de trabajo (1 crédito)
• get_supported_countries - Lista los códigos de país válidos de la tienda (gratis)

Los créditos se incluyen con un plan de GetAppNiche (Pro: 5,000/mes) y cada resultado informa credits_charged. Límite de velocidad: 60 solicitudes/minuto por clave.

Notas de protocolo

• Métodos: initialize → notifications/initialized → tools/list / tools/call. Los errores de protocolo usan códigos JSON-RPC estándar; los errores a nivel de herramienta (id incorrecto, sin créditos) vuelven como resultados de herramienta que tu agente puede leer.
• El puente respeta Mcp-Session-Id y acepta respuestas tanto JSON como con marco SSE.
• OAuth para clientes cuya interfaz de conectores no puede establecer cabeceras (claude.ai web) está en progreso; ChatGPT se conecta hoy con autenticación de clave API.

Licencia

MIT. Creado por GetAppNiche · X @getappniche · LinkedIn