Desarrolladores: MCP y API REST

Hay dos formas de llegar a tus datos de StoRank: conectarlos a Claude o ChatGPT y preguntar en el chat (MCP), o usar una clave de API desde tu propio código (API REST). Ambas son de solo lectura; nunca se cambia nada.

1. Conectar con Claude y ChatGPT (MCP)

Una vez conectado, pregunta «¿en qué palabras clave bajé esta semana y por qué?» o «¿dónde me supera mi competidor?»; la IA responde con tus datos de StoRank.

URL del servidor

https://storank.app/mcp

Claude

Ajustes → Connectors → Add custom connector.
Nombre: StoRank, URL: la URL del servidor de abajo → Add → Connect.
Inicia sesión en la pantalla de StoRank que se abre y pulsa Permitir.

ChatGPT

Ajustes → Apps & Connectors → Advanced settings → activa Developer mode.
Create: nombre StoRank, URL la URL del servidor de abajo, autenticación OAuth.
Inicia sesión en la pantalla de StoRank que se abre y pulsa Permitir.

Puedes quitar la conexión cuando quieras en StoRank → Ajustes → Conexiones de IA. Cambiar tu contraseña las desconecta automáticamente.

2. API REST

Crea una clave en StoRank → Ajustes → Claves de API (se muestra una vez). Envíala en cada solicitud con la cabecera Authorization. Las respuestas son JSON.

curl -H "Authorization: Bearer srk_YOUR_KEY" https://storank.app/v1/apps

curl -H "Authorization: Bearer srk_YOUR_KEY" "https://storank.app/v1/apps/123/keywords?country=us&only_ranking=true"

Límite: 60 solicitudes por minuto por cuenta (429 con Retry-After si se supera). Solo se ven tus propias apps. Las cuentas con la prueba terminada reciben 403.

3. Endpoints

`GET /v1/apps`	Tus apps, países seguidos y cifras principales
`GET /v1/apps/{app_id}/keywords`	Últimas posiciones de palabras clave en un país frente a la medición anterior (country, only_ranking, limit)
`GET /v1/apps/{app_id}/keywords/{keyword_id}/history`	Historial diario de una palabra clave, con competidores (days)
`GET /v1/apps/{app_id}/competitors`	Competidores en un país y comparación (country)
`GET /v1/apps/{app_id}/reviews`	Reseñas recientes con puntuación y respuestas (limit)
`GET /v1/apps/{app_id}/radar`	Radar mundial: países donde la app está publicada, puntuaciones, posiciones en listas
`GET /v1/apps/{app_id}/suggestions`	Último informe de sugerencias ASO con IA y cuáles se aplicaron

4. Errores

`401`	Falta la clave o no es válida
`403`	Sin plan activo (la prueba terminó)
`404`	La app o la palabra clave no es de esta cuenta
`429`	Límite por minuto superado

{"error": {"code": "not_found", "message": "App not found in this StoRank account."}}

Definición legible por máquina de todos los endpoints (OpenAPI 3.1): https://storank.app/v1/openapi.json

← Inicio