Sonar
Optimización de la App Store para agentes de IA: investigación de palabras clave, seguimiento de posiciones, minería de reseñas y análisis de competidores para iOS y Android.
Documentación
@sonarapp/mcp
El servidor MCP oficial de Sonar — herramientas de optimización de App Store para agentes de IA.
Para el plugin alojado de Grok Build y Cursor marketplace, consulta configuración del plugin, autenticación y permisos.
Permite que Claude Desktop, Claude Code, Cursor, Cline y cualquier cliente compatible con Model Context Protocol busque aplicaciones, investigue palabras clave, audite ASO, analice reseñas y estime ingresos en la App Store de iOS y Google Play. Impulsado por Sonar.
Herramientas
Herramientas de lectura — sin estado
| Herramienta | Qué hace |
|---|---|
sonar_app_lookup | Busca metadatos de una aplicación por ID de tienda |
sonar_app_search | Busca aplicaciones por palabra clave (devuelve el orden de clasificación de la tienda) |
sonar_app_aso_score | Puntuación de auditoría ASO (0-100) con verificaciones detalladas |
sonar_app_extract_keywords | Extrae palabras clave objetivo del listado de una aplicación |
sonar_app_reviews | Obtiene reseñas con filtros de calificación y opciones de orden |
sonar_app_revenue | Estima ingresos mensuales con metodología |
sonar_keyword_search | Investigación de palabras clave (dificultad, popularidad, términos relacionados) |
sonar_keyword_metrics | Dificultad + popularidad para palabras clave específicas (individual o en lote) |
sonar_keyword_suggestions | Sugerencias de autocompletado de la tienda |
sonar_top_charts | Ranking de los mejores gratuitos/de pago/más rentables con movimiento día a día |
Las herramientas sin estado funcionan en cualquier plan con créditos, tanto para iOS como para Android.
Herramientas de lectura — tu espacio de trabajo (plan Indie)
| Herramienta | Qué hace |
|---|---|
sonar_list_apps | Lista tus aplicaciones rastreadas con las últimas instantáneas (calificación, reseñas, instalaciones) |
sonar_get_app | Detalle de la aplicación + hasta 90 días de historial de instantáneas |
sonar_app_keywords | Palabras clave rastreadas para una aplicación, con dificultad + popularidad |
sonar_app_rankings | Historial diario de clasificación para las palabras clave rastreadas de una aplicación |
sonar_app_changes | Lanzamientos detectados, ediciones de metadatos, cambios de capturas de pantalla/precio/categoría |
sonar_keyword_rankings | Historial SERP para una palabra clave rastreada (quién clasificó, cuándo) |
sonar_competitor_keywords | Palabras clave por las que clasifica un competidor + análisis de brechas frente a tu aplicación |
sonar_competitor_landscape | Panorama competitivo completo para una de tus propias aplicaciones — estadísticas de brecha/ganable/amenaza/liderazgo + última información de IA |
Las lecturas del espacio de trabajo requieren un plan Indie (una prueba activa cuenta); la clave con alcance read predeterminada es suficiente.
Herramientas de escritura (plan Indie + alcance de escritura)
| Herramienta | Qué hace |
|---|---|
sonar_create_product | Crea un producto en tu espacio de trabajo de Sonar y comienza a rastrear sus aplicaciones |
sonar_track_app | Vincula la versión de la segunda tienda (iOS ↔ Android) de un producto existente |
sonar_track_competitor | Agrega una aplicación competidora bajo un producto |
sonar_track_keywords | Inicia el rastreo diario de clasificación para palabras clave en una aplicación (en lote, idempotente) |
sonar_update_keyword_note | Establece o elimina la nota en una palabra clave rastreada |
sonar_scan_competitor | Ejecuta un escaneo de descubrimiento de palabras clave en un competidor (lee los resultados con sonar_competitor_keywords) |
sonar_analyze_competitors | Genera una nueva información competitiva de IA para una de tus propias aplicaciones (enfriamiento de 7 días; léela con sonar_competitor_landscape) |
Las herramientas de escritura modifican tu espacio de trabajo y requieren un plan Indie (una prueba activa cuenta) además de una clave API creada con el alcance write. El servidor aplica ambos — sin ellos, las llamadas devuelven un 403 explicando qué corregir.
Juntas cierran el ciclo para los agentes: configura el rastreo con las herramientas de escritura y luego lee clasificaciones, cambios y análisis de brechas con las herramientas del espacio de trabajo.
Pruébalo gratis — no se necesita clave API
El servidor funciona sin clave en modo gratuito: sonar_app_search, sonar_app_lookup, sonar_app_aso_score, sonar_app_extract_keywords y sonar_keyword_suggestions comparten una asignación gratuita de 30 solicitudes/día por IP, y sonar_keyword_metrics (dificultad + popularidad de palabras clave) obtiene 5 palabras clave/día. Solo instálalo sin bloque env y pregúntale a tu agente sobre ASO. Cuando alcances el límite, el error te indica cómo registrarte.
Obtén una clave API
Para todo lo demás (rastreo, clasificaciones, competidores, límites más altos) necesitarás una clave API de Sonar — consíguela en trysonar.app/developers.
El camino más económico son los créditos API prepagados — paquetes desde $10 (1,000 créditos), con 50 créditos gratuitos al registrarte y sin suscripción. Diseñado específicamente para este caso de uso. Consulta precios.
Instalación
Claude Desktop
Agrega a tu archivo de configuración (~/Library/Application Support/Claude/claude_desktop_config.json en macOS, %APPDATA%\Claude\claude_desktop_config.json en Windows):
{
"mcpServers": {
"sonar": {
"command": "npx",
"args": ["-y", "@sonarapp/mcp"],
"env": {
"SONAR_API_KEY": "aso_your_key_here"
}
}
}
}
Reinicia Claude Desktop. Las herramientas sonar_* aparecerán en el selector de herramientas.
Claude Code
claude mcp add sonar -e SONAR_API_KEY=aso_your_key_here -- npx -y @sonarapp/mcp
Cursor
Agrega a ~/.cursor/mcp.json (o al .cursor/mcp.json de tu proyecto):
{
"mcpServers": {
"sonar": {
"command": "npx",
"args": ["-y", "@sonarapp/mcp"],
"env": {
"SONAR_API_KEY": "aso_your_key_here"
}
}
}
}
Cline / otros clientes MCP
La mayoría de los clientes usan la misma forma de command + args + env que la anterior. Apunta el comando a npx -y @sonarapp/mcp y pasa SONAR_API_KEY en el entorno.
Configuración
| Variable | Requerida | Predeterminado | Descripción |
|---|---|---|---|
SONAR_API_KEY | no (modo gratuito sin ella) | — | Tu clave API de Sonar (aso_...) |
SONAR_API_URL | no | https://trysonar.app | Sobrescribe la URL base de la API (solo para autoalojamiento / staging) |
Ejemplos de indicaciones
"Usa Sonar para buscar Spotify en iOS en la tienda de EE. UU. e informa su calificación, cantidad de reseñas y categoría."
"Ejecuta una auditoría ASO en
com.duolingoen Android y dime qué corregir."
"Investiga la palabra clave 'habit tracker' en iOS — dame dificultad, popularidad y 5 términos relacionados con menor dificultad que debería considerar."
"Obtén las 50 reseñas más recientes de 1 y 2 estrellas de
1517783697en iOS EE. UU. y agrupa las quejas por tema."
"Busca 'meditation' en la App Store y estima los ingresos mensuales de los 5 mejores resultados."
Política de privacidad
Política completa: https://trysonar.app/privacy
El servidor MCP es un cliente ligero alrededor de la API REST de Sonar — no almacena nada localmente y este paquete no registra datos.
- Datos recopilados: las entradas de las herramientas (IDs de aplicaciones, palabras clave, códigos de país) se envían a la API de Sonar a través de HTTPS para producir resultados; las solicitudes autenticadas incluyen tu clave API como token
Bearer. Sonar registra las solicitudes de API (endpoint, estado, tiempo) para limitación de velocidad y prevención de abuso. - Uso de datos: las entradas se usan únicamente para atender la solicitud (métricas de palabras clave, búsquedas de aplicaciones, etc.); el JSON resultante se devuelve a tu cliente de IA.
- Almacenamiento y retención: el paquete no mantiene estado en disco. Los registros de solicitudes del servidor se retienen durante 90 días; los datos del espacio de trabajo (aplicaciones/palabras clave rastreadas) persisten en tu cuenta de Sonar hasta que los elimines.
- Compartición con terceros: no se venden ni comparten datos de usuarios con terceros; las consultas contra datos públicos de tiendas de aplicaciones (Apple, Google) no contienen información personal.
- Contacto: hello@trysonar.app
Solución de problemas
"SONAR_API_KEY is not set — running in free mode" — Esperado si no has configurado una clave: las herramientas gratuitas siguen funcionando con límites diarios por IP. Si SÍ configuraste una clave, el cliente MCP no pasó la variable de entorno — revisa la sección env del archivo de configuración de tu cliente. Algunos clientes requieren una ruta absoluta a npx — intenta con which npx y usa esa.
"Authentication failed" — Tu clave es inválida, expiró o tu suscripción caducó. Visita trysonar.app/developers para verificarlo.
"Access denied. Endpoint may require Indie plan" — Las 10 herramientas de lectura sin estado funcionan en cualquier plan con créditos. Las herramientas de lectura del espacio de trabajo y las de escritura requieren un plan Indie (una prueba activa cuenta); las herramientas de escritura además necesitan una clave API creada con el alcance write. Si estás en un plan de configuración o con prueba expirada, reactívalo primero.
Complemento: CLI
¿Prefieres la terminal? Usa @sonarapp/cli (binario sonar) — los mismos datos, la misma clave API.
Licencia
MIT © Peter Sutarik