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
É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.
É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.
É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.
| Outil MCP | Ce qu’il renvoie | Endpoint REST |
|---|---|---|
list_apps | Vos 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_rankings | Tous 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_changes | Les 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_competitors | Les 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_keywords | Les 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_insights | Les 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êta | Comment 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_changes | Les 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_score | Votre 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_brief | Le 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êta | Le 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 gratuitementForfait Gratuit · Sans carte bancaire · Résiliable à tout moment