Para desarrolladores

Todo lo que medimos
se puede leer.

Una misma clave abre la REST API y el punto MCP; ambos son de solo lectura y ambos vienen con el plan Studio. Tus datos no están encerrados en nuestra pantalla: llegan igual a tu script, a tu panel o a tu asistente.

Llévalo a tu propio panel
Trae el histórico de posiciones a un panel interno, a una hoja de cálculo o a un informe semanal. Los datos son tuyos; no tienen por qué quedarse en nuestra pantalla.
Comprobación antes de publicar
Antes de enviar los metadatos nuevos, deja que tu script lea la banda cusp: ¿en qué posición estás con la palabra que acabas de quitar del subtítulo, y de verdad es prescindible?
Pregúntale a tu asistente
Con el punto MCP conectado, «¿qué palabras mías están en la banda umbral y cuál es la más popular?» se responde sin una sola captura de pantalla.

Empieza en una línea

Tres maneras de entrar, una sola clave. Elige la que eres: un asistente que habla MCP, una terminal o un script.

claude-code

claude mcp add --transport http rankcusp \
  https://rankcusp.com/api/mcp \
  --header "Authorization: Bearer rc_live_…" \
  --header "Accept-Language: tr"

Esa es toda la configuración. La segunda cabecera es lo que hace que los veredictos vuelvan en tu idioma; si la quitas, llegan en inglés. Pregunta «¿cuáles de mis palabras están en la banda umbral?» y el asistente llamará por su cuenta a las herramientas de abajo.

La clave

Créala desde la pantalla Cuenta. La clave se muestra una sola vez: solo guardamos su resumen, así que si se pierde no podemos recuperarla; la revocas y tomas una nueva.

Qué puede hacer un asistente

Nueve herramientas. Ocho solo leen; la última añade palabras, y se lo dice al cliente antes de ser llamada. El asistente las alcanza en cuanto se conecta, y son las que la CLI llama por debajo.

list_apps: Las apps y los rivales de la cuenta. El appId que piden las demás herramientas sale de aquí.
cusp_actions: La banda 11-30, ordenada por popularidad: la lista corta de palabras en las que vale la pena gastar caracteres.
get_keyword: Una palabra -posición, popularidad, dificultad- con el veredicto escrito en tu idioma: si merece la pena apuntarle y con qué fundamento.
ranking_keywords: Para qué palabras posiciona ya una app, a partir del registro común de cada búsqueda que este producto ha hecho. Apúntala a un rival para leer las suyas: Apple no publica ningún punto de acceso para esto, así que la respuesta llega hasta donde llega lo observado.
keyword_competitors: Quién más posiciona para una expresión, más hondo que los diez de la primera página. Una app en el puesto 40 donde tú estás en el 60 es la que conviene estudiar.
audit_metadata: Lee un borrador de título, subtítulo y campo de palabras antes de publicarlo, y dice qué se repite, qué se desperdicia y cuántos caracteres recuperas.
country_priorities: Qué tienda merece la próxima hora: cuántas palabras umbral hay por país y dónde están más débiles los rivales.
list_keywords: Todas las palabras seguidas de un país, con su posición y la anterior.
add_keywords: La única que escribe. Añade palabras al seguimiento de una app en una tienda, desde una lista o una línea pegada. Llegan sin puntuar -puntuar cuesta peticiones a Apple y espera al recolector-, así que una popularidad nula aquí no es un cero.

La CLI

Un `curl` y una clave. Imprime tablas pensadas para leerse en una terminal: un valor sin medir sigue siendo una raya, así que nunca se inventa un cero.

terminal

$ rankcusp cusp 1544… --country us
KEYWORD          RANK   Δ  POP  DIFF  CUSP
───────────────  ────  ──  ───  ────  ────
habit tracker      14  +5   32    41  •   
streak tracking    23   -    -    38  •

rankcusp: Abre la sesión: a qué estás conectado, qué puedes pedir y un prompt.
rankcusp apps: Las apps y los rivales de la cuenta.
rankcusp keywords <appId> --country <cc>: Todas las palabras seguidas en una tienda.
rankcusp cusp <appId> --country <cc>: La banda umbral de una app, ordenada por popularidad.
rankcusp keyword <appId> <phrase> --country <cc>: Una sola palabra con su veredicto.
rankcusp audit --country <cc> --title … --keywords …: Revisa un borrador de metadatos antes de publicarlo.
rankcusp countries <appId>: En qué tienda trabajar a continuación.
rankcusp tools: Lista las herramientas: así se orienta solo un asistente.

Puntos de acceso

GET/api/v1/apps: Las apps y los rivales de la cuenta. El appId que piden las demás llamadas sale de aquí.
GET/api/v1/keywords?app=…&country=…: Palabras clave seguidas: posición, posición anterior, popularidad, dificultad y si está en la banda cusp.
GET/api/v1/keywords?app=…&country=…&cusp=1: Solo la banda 11-30: aquellas en las que una edición de metadatos rinde más.
GET/api/v1/keywords?app=…&country=…&keyword=…: Una sola palabra clave: su primera página y el veredicto, si conviene atacarla y con qué motivo.
POST/api/mcp: El punto de acceso MCP (JSON-RPC 2.0). Lleva las nueve herramientas de arriba.

¿Qué aspecto tiene una respuesta?

El ejemplo de abajo muestra la forma de una llamada que pide la banda cusp. Fíjate en la segunda fila: previousRank y popularity son null. Significa que la palabra se midió por primera vez y su popularidad todavía no se pudo leer, no que valga cero.

json

{
  "total": 2,
  "maxPageSize": 200,
  "keywords": [
    {
      "keyword": "habit tracker",
      "country": "us",
      "rank": 14,
      "previousRank": 19,
      "delta": 5,
      "popularity": 32,
      "difficulty": 41,
      "cusp": true,
      "lastMeasuredAt": "2026-08-12T04:12:09.114Z"
    },
    {
      "keyword": "streak tracking",
      "country": "us",
      "rank": 23,
      "previousRank": null,
      "delta": null,
      "popularity": null,
      "difficulty": 38,
      "cusp": true,
      "lastMeasuredAt": "2026-08-12T04:12:11.902Z"
    }
  ]
}

Lo que conviene saber

Un valor no medido vuelve como `null`, nunca como cero. rank: null significa «fuera del top 200» y popularity: null significa «aún sin medir». Un cliente que los cambie por cero terminará, tarde o temprano, promediándolos.
Los veredictos vuelven en tu propio idioma. El punto MCP lee el idioma del cliente; la CLI toma RANKCUSP_LANG=es. Los números son los mismos en todos los idiomas.
120 peticiones por minuto. Al pasarte, un 429 y un retry-after.
Como mucho 200 filas por página; avanza con offset.
Todo es de solo lectura. Por la API no se añaden ni se borran palabras clave.
country es obligatorio en cada llamada: la misma expresión en dos tiendas son dos búsquedas distintas y, por tanto, dos filas distintas.
Una clave representa una cuenta, no una persona. Generar claves separadas en vez de compartir una permite revocar una sin romper la otra.