Black Friday25 % de réduction sur votre premier mois avec les forfaits mensuels Profiter de l’offre

Serveur MCP et API REST

Vos données ASO dans votre assistant IA

Le serveur MCP de Rankglass permet à Claude Code, Cursor, Claude Desktop, Codex, l’app de bureau ChatGPT et d’autres clients MCP de lire vos mots-clés suivis, vos positions, vos concurrents et vos scores de fiche. Une API REST fournit les mêmes données à vos propres scripts.

En bref

Endpoint MCP
https://app.rankglass.com/api/mcp
Transport
Streamable HTTP
Authentification
Une clé API de l’espace de travail, envoyée sous la forme Authorization: Bearer YOUR_API_KEY
Accès
Lecture seule
Forfaits
Starter, Pro et Agency
Limites de requêtes
60 requêtes par minute et 2 000 par jour, par clé

Compatible avec les clients MCP capables d’envoyer un en-tête

Rankglass vérifie une clé API à chaque requête : un client n’a qu’à l’envoyer dans un en-tête. Ces clients sont configurés ci-dessous :

  • Claude Code
  • Cursor
  • Claude Desktop, via mcp-remote (nécessite Node.js)
  • Codex et l’app de bureau ChatGPT
  • Autres clients MCP et agents que vous développez, avec l’endpoint et l’en-tête ci-dessus

Un client qui ne peut se connecter que par une connexion OAuth ne peut pas envoyer la clé : il ne peut donc pas encore ajouter Rankglass.

Configuration en trois étapes

  1. Étape 1

    Créer une clé API

    Dans Rankglass, ouvrez Paramètres → Espace de travail → API et MCP et créez une clé. Elle ne s’affiche qu’une fois : copiez-la tout de suite. Une clé lit un seul espace de travail ; créez-en une par assistant ou par script pour pouvoir les révoquer séparément.

  2. Étape 2

    Ajouter Rankglass à votre assistant

    Collez la configuration de votre client et remplacez YOUR_API_KEY par votre clé.

    Claude Code

    Exécutez cette commande dans un terminal. Avec --scope user, Rankglass est disponible dans tous vos projets.

    claude mcp add --transport http --scope user rankglass https://app.rankglass.com/api/mcp --header "Authorization: Bearer YOUR_API_KEY"

    Cursor et autres clients

    Pour Cursor, ajoutez ceci à ~/.cursor/mcp.json, ou à .cursor/mcp.json dans un projet. Les autres clients gardent leurs serveurs MCP dans leurs propres paramètres ; l’endpoint et l’en-tête suffisent.

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

    Claude Desktop

    Ajoutez ceci à claude_desktop_config.json (Settings → Developer → Edit Config), puis redémarrez Claude. La configuration lance mcp-remote avec npx : Node.js doit donc être installé.

    {
      "mcpServers": {
        "rankglass": {
          "command": "npx",
          "args": [
            "-y",
            "mcp-remote",
            "https://app.rankglass.com/api/mcp",
            "--header",
            "Authorization:${RANKGLASS_AUTH}"
          ],
          "env": {
            "RANKGLASS_AUTH": "Bearer YOUR_API_KEY"
          }
        }
      }
    }

    Codex et l’app de bureau ChatGPT

    Ajoutez ceci à ~/.codex/config.toml, que partagent la CLI Codex, l’extension Codex pour IDE et l’app de bureau ChatGPT. Placez votre clé, sans Bearer, dans une variable d’environnement nommée RANKGLASS_API_KEY.

    [mcp_servers.rankglass]
    url = "https://app.rankglass.com/api/mcp"
    bearer_token_env_var = "RANKGLASS_API_KEY"

    Les clients qui ne peuvent pas définir l’en-tête Authorization peuvent envoyer x-api-key: YOUR_API_KEY à la place.

  3. Étape 3

    Demander avec vos propres mots

    Votre assistant choisit le bon outil. Aucun ne peut modifier quoi que ce soit dans votre espace de travail.

Ce que votre assistant peut lire

11 outils en lecture seule. Chacun a un endpoint GET correspondant dans l’API REST.

Les outils MCP et leurs endpoints REST
Outil MCPCe qu’il renvoieEndpoint REST
list_appsVos apps avec leurs stores, les pays suivis, le nombre de mots-clés et les chiffres clés de la semaine. Un bon premier appel.GET /v1/apps
get_keyword_rankingsTous les mots-clés suivis d’une app dans un store et un pays : position, variation sur 7 jours, entrée dans les résultats ou sortie, meilleure position, recherches mensuelles estimées, difficulté et positions des concurrents.GET /v1/keywords
get_rank_changesLes plus fortes hausses et baisses de position des derniers jours, tous mots-clés, stores et pays confondus, et les mots-clés entrés dans le top 10 ou sortis.GET /v1/rank-changes
get_competitorsLes concurrents suivis avec leurs notes, le nombre de mots-clés sur lesquels chaque app devance l’autre, et les mots-clés où un concurrent est dans le top 10 et pas vous.GET /v1/competitors
get_competitor_keywordsLes mots-clés sur lesquels un concurrent se classe dans un pays, y compris ceux que vous ne suivez pas encore, avec les recherches mensuelles, la difficulté et vos positions respectives.GET /v1/competitor-keywords
get_competitor_insightsLes informations du store d’un concurrent, ses notes par nombre d’étoiles, ses classements dans les tops, ses téléchargements et revenus mensuels estimés, et sa dernière synthèse IA des avis.GET /v1/competitor-insights
get_competitor_growthBêtaComment un concurrent attire ses utilisateurs : ses publicités, ses comptes sur les réseaux sociaux, les créateurs, la recherche dans le store et son site web, avec les dépenses publicitaires, les installations issues des pubs et la portée sur les réseaux sociaux estimées, et la dernière stratégie IA. Pro et Agency.GET /v1/competitor-growth
get_store_page_changesLes modifications récentes de vos pages du store et de celles de vos concurrents : titre, sous-titre, description, captures d’écran, version et notes de version.GET /v1/store-page-changes
get_aso_scoreVotre score ASO de 0 à 100 pour un store et un pays, les vérifications qui le composent, les gains rapides sur les mots-clés et les dernières suggestions IA pour la fiche.GET /v1/aso-score
get_weekly_briefLe dernier brief hebdomadaire de votre app : ce qui a changé, les raisons probables et jusqu’à trois actions à mener.GET /v1/weekly-brief
get_keyword_game_planBêtaLe dernier plan d’action d’un mot-clé suivi : la position visée et jusqu’à cinq étapes pour l’atteindre.GET /v1/keyword-game-plan

API REST

Les mêmes données en JSON pour vos propres scripts, tableaux de bord et feuilles de calcul. Chaque endpoint est une requête GET sous https://app.rankglass.com/api/v1 et utilise la même clé.

Une première requête : les plus fortes variations de position des sept derniers jours.

curl "https://app.rankglass.com/api/v1/rank-changes?days=7" -H "Authorization: Bearer YOUR_API_KEY"

Limites et accès

  • Lecture seule. Les outils et les endpoints lisent uniquement ce que Rankglass a déjà enregistré ; ils ne lancent jamais de nouvelle recherche. Les travaux payants, comme la recherche des mots-clés d’un concurrent dans un nouveau pays, se lancent depuis le tableau de bord.
  • Chaque clé peut effectuer 60 requêtes par minute et 2 000 par jour, partagées entre le serveur MCP et l’API REST. Au-delà, les requêtes reçoivent une réponse 429 avec un en-tête Retry-After.
  • L’accès à l’API et au MCP est inclus dans les forfaits Starter, Pro et Agency. Sans cet accès, les requêtes reçoivent une réponse 403.
  • Une clé lit tout le contenu de son espace de travail : traitez-la comme un mot de passe. La page des paramètres indique la dernière utilisation de chaque clé, et vous pouvez l’y révoquer.

Questions à essayer

  • Lesquels de mes mots-clés ont baissé cette semaine ?
  • Quelle est la position de mon app sur « habit tracker » en Allemagne, et qui est devant moi ?
  • Sur quels mots-clés mon principal concurrent se classe-t-il alors que je ne les suis pas encore ?
  • Qu’ont modifié mes concurrents sur leurs pages du store ce mois-ci ?
  • Quel est mon score ASO au Royaume-Uni, et que dois-je corriger en premier ?
  • Que dit le brief de cette semaine pour chacune de mes apps ?

Questions sur le serveur MCP

Est-ce que ça fonctionne avec ChatGPT ?

Oui, dans l’app de bureau ChatGPT. Elle partage ses serveurs MCP avec la CLI Codex et l’extension Codex pour IDE dans ~/.codex/config.toml, qui peut envoyer votre clé depuis une variable d’environnement (bearer_token_env_var) ; la configuration ci-dessus le montre. ChatGPT sur le web ajoute des outils via des connecteurs qui ne proposent qu’une connexion OAuth, et ceux-ci ne peuvent pas encore envoyer la clé. Tout ce qui peut appeler une API avec un en-tête peut utiliser l’API REST à la place.

Mon assistant peut-il modifier quelque chose dans Rankglass ?

Non. Chaque outil et chaque endpoint ne fait que lire. L’ajout d’apps, le suivi de mots-clés et le lancement de recherches se font dans le tableau de bord.

Les données sont-elles récentes ?

Comme dans le tableau de bord : sur les forfaits payants, chaque mot-clé suivi est vérifié une fois par jour, et le brief hebdomadaire est rédigé chaque lundi. Les outils lisent ce que Rankglass a enregistré et ne lancent jamais de vérification.

Où vont mes données ?

Uniquement vers le client qui les demande, et uniquement depuis l’espace de travail auquel appartient la clé. Ensuite, le fournisseur de votre assistant les traite selon ses propres conditions. Supprimez la clé pour y mettre fin à tout moment.

Vous préférez un guide pas à pas ? Lisez comment configurer le serveur MCP de Rankglass.

Découvrez ce qu’il faut faire ensuite pour votre app

Ajoutez votre app avec un seul lien du store et voyez où vous vous classez aujourd’hui.

Commencer gratuitement

Forfait Gratuit · Sans carte bancaire · Résiliable à tout moment