Pour les développeurs

Tout ce que nous mesurons
se lit.

La même clé ouvre l'API REST et le point MCP ; les deux sont en lecture seule et les deux viennent avec la formule Studio. Vos données ne sont pas enfermées dans notre écran - elles arrivent à votre script, à votre tableau de bord ou à votre assistant sous la même forme.

Amenez-les dans votre tableau de bord
Tirez l'historique des positions vers un tableau de bord interne, un tableur ou un rapport hebdomadaire. Les données sont à vous ; elles n'ont pas à rester sur notre écran.
Un contrôle avant publication
Avant d'envoyer de nouvelles métadonnées, laissez votre script lire la bande cusp : à quelle position êtes-vous sur le mot que vous venez de retirer du sous-titre, et est-il vraiment sacrifiable ?
Demandez à votre assistant
Le point MCP branché, « lesquels de mes mots-clés sont dans la bande seuil et lequel est le plus populaire ? » trouve sa réponse sans la moindre capture d'écran.

Démarrer en une ligne

Trois entrées, une seule clé. Choisissez celle que vous êtes : un assistant qui parle MCP, un terminal, ou un script.

claude-code

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

Voilà toute l'installation. Le second en-tête est ce qui fait revenir les verdicts dans votre langue ; sans lui, ils arrivent en anglais. Demandez « lesquels de mes mots-clés sont dans la bande seuil ? » et l'assistant appellera de lui-même les outils ci-dessous.

La clé

Créez-la depuis l'écran Compte. Une clé n'est affichée qu'une fois - nous n'en gardons qu'un condensé, donc une clé perdue ne se récupère pas ; vous la révoquez et vous en prenez une autre.

Ce qu'un assistant peut faire

Neuf outils. Huit se contentent de lire ; le dernier ajoute des mots-clés, et le déclare au client avant d'être appelé. L'assistant y accède dès qu'il est connecté, et ce sont eux que la CLI appelle en dessous.

list_apps: Les applications et les rivales du compte. L'appId que réclament les autres outils vient d'ici.
cusp_actions: La bande 11-30, triée par popularité : la liste courte des mots qui valent la dépense de caractères.
get_keyword: Un mot-clé - position, popularité, difficulté - avec le verdict rédigé dans votre langue : faut-il le viser, et sur quels motifs.
ranking_keywords: Ce sur quoi une app se positionne déjà, tiré du relevé commun de chaque recherche que ce produit a menée. Pointez-le sur une rivale pour lire les siens : Apple ne publie aucun point d'accès pour cela, la réponse ne va donc pas plus loin que ce qui a été observé.
keyword_competitors: Qui d'autre se positionne sur une expression, plus loin que les dix de la première page. Une app en 40 là où vous êtes en 60, c'est celle qu'il faut étudier.
audit_metadata: Lit un brouillon de titre, de sous-titre et de champ mots-clés avant publication, et dit ce qui se répète, ce qui est perdu, et combien de caractères vous récupérez.
country_priorities: Quelle boutique mérite l'heure qui vient : le nombre de mots seuil par pays, et là où les rivales sont les plus faibles.
list_keywords: Tous les mots-clés suivis pour un pays, avec leur position et la précédente.
add_keywords: Le seul qui écrit. Ajoute des mots-clés au suivi d'une app dans une boutique, depuis une liste ou une ligne collée. Ils arrivent non notés - noter coûte des requêtes à Apple et attend le collecteur - donc une popularité nulle ici n'est pas un zéro.

La CLI

Un `curl` et une clé. Elle affiche des tableaux faits pour être lus dans un terminal - une valeur non mesurée y reste un tiret cadratin, aucun zéro n'est inventé.

terminal

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

rankcusp: Ouvre la session : à quoi vous êtes connecté, ce que vous pouvez demander, et une invite.
rankcusp apps: Les applications et les rivales du compte.
rankcusp keywords <appId> --country <cc>: Tous les mots-clés suivis dans une boutique.
rankcusp cusp <appId> --country <cc>: La bande seuil d'une application, triée par popularité.
rankcusp keyword <appId> <phrase> --country <cc>: Un seul mot-clé avec son verdict.
rankcusp audit --country <cc> --title … --keywords …: Vérifie un brouillon de métadonnées avant publication.
rankcusp countries <appId>: Sur quelle boutique travailler ensuite.
rankcusp tools: Liste les outils - c'est ainsi qu'un assistant s'oriente seul.

Points d'accès

GET/api/v1/apps: Les apps et les concurrents du compte. L'appId que réclament les autres appels vient d'ici.
GET/api/v1/keywords?app=…&country=…: Les mots-clés suivis : position, position précédente, popularité, difficulté, et s'il est dans la bande cusp.
GET/api/v1/keywords?app=…&country=…&cusp=1: La bande 11-30 seulement - ceux sur lesquels une retouche de métadonnées rapporte le plus.
GET/api/v1/keywords?app=…&country=…&keyword=…: Un seul mot-clé : sa première page et le verdict - faut-il le viser, et sur quel motif.
POST/api/mcp: Le point d'accès MCP (JSON-RPC 2.0). Il porte les neuf outils ci-dessus.

À quoi ressemble une réponse ?

L'exemple ci-dessous montre la forme d'un appel demandant la bande cusp. Regardez la deuxième ligne : previousRank et popularity valent null. Cela veut dire que le mot-clé vient d'être mesuré pour la première fois et que sa popularité n'a pas encore pu être lue - pas qu'elle est nulle.

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"
    }
  ]
}

Ce qu'il faut savoir

Une valeur non mesurée revient à `null`, jamais à zéro. rank: null veut dire « hors du top 200 », popularity: null veut dire « pas encore mesuré ». Un client qui les remplace par zéro finira par en faire la moyenne.
Les verdicts reviennent dans votre langue. Le point MCP lit la langue du client ; la CLI prend RANKCUSP_LANG=fr. Les chiffres, eux, sont les mêmes partout.
120 requêtes par minute. Au-delà, un 429 et un retry-after.
200 lignes par page au maximum ; avancez avec offset.
Tout est en lecture seule. L'API n'ajoute ni ne supprime de mots-clés.
country est requis à chaque appel : la même expression dans deux boutiques, ce sont deux recherches différentes, donc deux lignes différentes.
Une clé représente un compte, pas une personne. Générer des clés distinctes plutôt que d'en partager une permet d'en révoquer une sans casser l'autre.