Le serveur MCP de Ranktracker est désormais opérationnel

Introduction

Le serveur MCP de Ranktracker est officiellement opérationnel.

Vous pouvez désormais connecter directement à votre compte Ranktracker les assistants IA et outils de développement pris en charge, notamment ChatGPT, Claude, Cursor et d'autres clients compatibles avec le protocole Model Context Protocol.

Une fois la connexion établie, vous pouvez poser des questions sur vos performances SEO en langage naturel.

Par exemple :

• Lequel de mes mots-clés suivis a le plus chuté cette semaine ?
• Affichez-moi les mots-clés actuellement classés entre les positions 11 et 20.
• Quels mots-clés ont gagné en visibilité au cours des 30 derniers jours ?
• Résumez la tendance des backlinks pour mon site web.
• Quels problèmes techniques ont été détectés lors de mon dernier audit de site web ?
• Lequel de mes mots-clés suivis apparaît dans un aperçu IA ?
• Affichez-moi les backlinks les plus récemment détectés.
• Quel est le statut de mon dernier rapport SEO ?

L'assistant IA sélectionne l'outil Ranktracker approprié, récupère en toute sécurité les données pertinentes de votre compte et les utilise pour répondre à votre question.

Vous n’avez pas besoin d’exporter manuellement un fichier CSV, de basculer entre plusieurs rapports ou de créer une intégration personnalisée avant de pouvoir commencer à analyser vos données.

L’accès au MCP est inclus dans tous les forfaits Ranktracker.

Consultez la documentation complète à l'adresse suivante :

https://developers.ranktracker.com/mcp

Qu'est-ce que le Model Context Protocol ?

Le Model Context Protocol, communément appelé MCP, fournit un moyen standard permettant aux applications d'IA de se connecter à des outils et des sources de données externes.

Un modèle d’IA n’a normalement accès qu’aux informations contenues dans sa conversation et aux connaissances générales mises à sa disposition. Il ne peut pas consulter automatiquement les projets, mots-clés, rapports ou audits présents dans votre compte Ranktracker.

Une connexion MCP change la donne.

Une fois que vous avez autorisé Ranktracker, le client IA peut découvrir un ensemble défini d’outils Ranktracker. Lorsque vous posez une question pertinente, le client peut choisir l’outil approprié, fournir les identifiants de compte requis et récupérer les données nécessaires pour répondre.

Au lieu de parcourir manuellement les différentes sections de Ranktracker, vous pouvez poser votre question de manière conversationnelle.

Par exemple, lorsque vous demandez :

Quels mots-clés du site example.com ont perdu le plus de positions ce mois-ci ?

L'assistant peut :

1. Trouvez le domaine suivi pertinent.
2. Récupérez ses mots-clés suivis.
3. Consultez l'historique des classements.
4. Comparez les positions actuelles et précédentes.
5. Résumez les baisses les plus significatives.

Le serveur MCP de Ranktracker gère la connexion entre l’assistant IA et votre compte.

Connecter Ranktracker à ChatGPT, Claude et Cursor

Le serveur MCP de Ranktracker est un serveur distant hébergé qui fonctionne avec les clients prenant en charge les connexions MCP HTTP Streamable.

Il peut être connecté à :

• ChatGPT
• Claude Desktop
• Claude Code
• Cursor
• MCP Inspector
• Autres clients MCP compatibles
• Agents IA internes et outils de développement

Le serveur est accessible via un point de terminaison hébergé :

https://api.ranktracker.com/mcp

Vous n'avez pas besoin de télécharger ni d'héberger un serveur Ranktracker séparé.

Pour la plupart des outils d'IA interactifs, OAuth est la méthode de connexion recommandée. Il vous suffit d'ajouter l'URL du serveur Ranktracker au client, d'autoriser l'accès via votre navigateur, et la connexion est établie automatiquement.

Aucun code personnalisé requis

L'un des principaux avantages de MCP est que vous n'avez pas besoin de développer vous-même l'intégration.

Avec une intégration API traditionnelle, un développeur doit généralement :

• Consultez la documentation de l'API
• Créer des requêtes pour des points de terminaison individuels
• Gérer l'authentification
• Traiter la réponse
• Enregistrer ou afficher les données
• Créer une interface pour l'utilisateur

Le serveur MCP de Ranktracker présente des outils clairement définis directement au client IA.

L'assistant détecte automatiquement ces outils et décide lesquels utiliser en fonction de votre requête.

Cela signifie qu’un utilisateur peut connecter Ranktracker et commencer à poser des questions sans avoir à écrire de code ni à créer une application de reporting distincte.

Les développeurs peuvent toujours utiliser l’API REST de Ranktracker pour les systèmes entièrement automatisés, les pipelines de données planifiés et les applications personnalisées. Le MCP est conçu pour les cas où une personne ou un agent IA explore activement les données.

À quelles données Ranktracker les assistants IA peuvent-ils accéder ?

La version initiale de Ranktracker MCP propose 14 outils.

Treize d’entre eux sont en lecture seule. Un outil supplémentaire permet de générer en toute sécurité une nouvelle exécution d’un rapport existant.

Les outils disponibles couvrent les sites web suivis, les mots-clés, les classements, les concurrents, la recherche de mots-clés, les backlinks, les rapports et les audits de sites web.

Domaines suivis

Votre assistant peut répertorier les domaines disponibles dans votre compte Ranktracker et récupérer la configuration d’un projet spécifique.

Cela constitue le point de départ de la plupart des conversations, car les ressources de Ranktracker sont reliées à l’aide d’identifiants de projet uniques.

Voici quelques exemples de questions :

• Répertorier tous les sites web de mon compte Ranktracker.
• Rechercher mon projet pour example.com.
• Afficher la configuration de suivi pour ce domaine.
• Quelles sont les limites de suivi configurées pour ce projet ?

La connexion ne peut voir que les domaines appartenant au compte Ranktracker qui l'a autorisée.

Mots-clés suivis et classements actuels

Votre assistant peut récupérer les mots-clés suivis pour un domaine ainsi que leurs derniers résultats de classement.

Cela permet de poser la question suivante :

• Quels sont mes mots-clés les mieux classés ?
• Quels mots-clés apparaissent actuellement en première page ?
• Affichez-moi les mots-clés classés entre les positions 11 et 20.
• Quels mots-clés suivis ne figurent pas dans le Top 100 ?
• Quels sont les mots-clés actuellement mis en pause ?
• Affichez-moi les 50 meilleurs mots-clés pour ce domaine.

Par défaut, les données relatives aux mots-clés sont classées par meilleure position en référencement naturel, ce qui permet à l’assistant d’identifier rapidement les meilleurs classements actuels.

Évolution historique des classements

Le serveur MCP peut récupérer l'historique quotidien des classements pour un mot-clé suivi donné.

Cela comprend :

• Position organique
• Position absolue dans les SERP
• Position dans le pack local
• Présence dans les fonctionnalités de la SERP
• Visibilité de l'aperçu IA
• Historique du classement sur une période sélectionnée

La période par défaut couvre le mois précédent, mais le client peut demander des dates de début et de fin spécifiques.

Vous pouvez poser des questions telles que :

• Comment ce mot-clé a-t-il évolué au cours des 30 derniers jours ?
• Quand ce mot-clé est-il entré dans le Top 10 ?
• Avons-nous perdu notre extrait en vedette ?
• Notre position dans le « local pack » s'est-elle améliorée ?
• Ce domaine figure-t-il dans l'aperçu IA actuel ?
• Quelle a été la meilleure position de ce mot-clé ce mois-ci ?

Cela facilite l'analyse des variations de classement sans avoir à ouvrir et comparer manuellement chaque graphique.

Données sur les concurrents

L'assistant peut répertorier les sites web concurrents configurés pour un domaine suivi.

Voici quelques exemples de questions :

• Quels sont les concurrents suivis dans le cadre de ce projet ?
• Veuillez dresser la liste des concurrents associés à example.com.
• Surveillons-nous competitor.com ?
• Résumez l'environnement concurrentiel de ce site web.

Le serveur MCP ne récupère que les concurrents déjà configurés dans le compte Ranktracker. Il n’ajoute pas automatiquement de nouveaux concurrents et ne modifie pas les paramètres du projet.

Recherches dans Keyword Finder

L'assistant peut récupérer les sessions de recherche existantes de Keyword Finder depuis votre compte.

Cela vous permet de retrouver et de discuter des recherches déjà effectuées.

Vous pourriez demander :

• Affichez mes dernières sessions de recherche de mots-clés.
• Quels sont les projets de recherche de mots-clés disponibles ?
• Recherchez la session de recherche créée pour notre nouvelle catégorie de produits.
• Résumez les recherches de mots-clés disponibles dans mon compte.

La connexion MCP ne lance pas de nouvelles recherches de mots-clés payantes. Elle se contente de lire les sessions de recherche existantes, ce qui permet d'éviter qu'un client utilisant l'IA n'épuise vos quotas à votre insu.

Suivi des backlinks

Les outils MCP de Ranktracker peuvent récupérer des informations sur les backlinks d’un domaine suivi.

Les données disponibles sur les backlinks comprennent :

• URL source
• URL cible
• Texte d'ancrage
• Statut « dofollow »
• Score de spam
• Classement du domaine et de la page
• Date de première détection
• Date de dernière détection

Cela signifie que vous pouvez demander :

• Affichez-moi les derniers liens retour détectés pour mon site web.
• Quels sont les nouveaux liens entrants « dofollow » ?
• Y a-t-il des liens suspects présentant un score de spam élevé ?
• Quelles pages ont reçu les liens les plus récents ?
• Quel texte d'ancrage est le plus fréquemment utilisé ?
• Affichez les liens retour les plus puissants récemment découverts.

Les backlinks sont affichés en commençant par les liens les plus récents, ce qui rend cette connexion particulièrement utile pour analyser l’activité récente de création de liens.

Tendances du profil de liens entrants

Outre les liens individuels, l'assistant peut extraire des résumés historiques du profil de liens entrants.

Ces résumés peuvent inclure :

• Classement du domaine
• Nombre total de liens entrants
• Nouveaux liens entrants
• Liens perdus
• Domaines référents
• Aperçus historiques du profil

Voici quelques exemples de questions :

• Résumez l'évolution de nos liens entrants ce mois-ci.
• Avons-nous gagné ou perdu des domaines référents ?
• Quand la plus forte baisse du nombre de liens entrants s'est-elle produite ?
• Notre profil global de liens retour est-il en croissance ?
• Comparez le dernier aperçu des liens entrants avec le précédent.

Cela permet à un assistant IA d’expliquer la tendance plutôt que de se contenter de renvoyer une liste de liens.

Résumés de surveillance

L'assistant peut générer un résumé de suivi combiné pour un domaine, couvrant des aspects tels que :

• Suivi des mots-clés
• Suivi des liens entrants
• Suivi des audits de sites web

Cette fonctionnalité permet d’obtenir un aperçu concis d’un site web sans avoir à consulter individuellement chaque outil de Ranktracker.

Par exemple :

Donne-moi un résumé de suivi SEO pour example.com.

Le client peut récupérer les données de suivi disponibles et les transformer en une liste claire des changements, des risques et des points nécessitant une attention particulière.

Rapports SEO

Votre assistant peut répertorier les rapports déjà configurés dans votre compte Ranktracker.

Il peut également récupérer des informations sur un rapport particulier, notamment :

• Calendrier des rapports
• Destinataires
• Dernière exécution
• Historique des dernières exécutions
• État actuel du rapport
• URL du fichier du rapport terminé

Vous pouvez demander :

• Afficher la liste de mes rapports SEO configurés.
• Quand le dernier rapport client a-t-il été généré ?
• Le rapport de cette semaine s'est-il déroulé avec succès ?
• Afficher le dernier rapport disponible.
• Quels destinataires sont configurés pour ce rapport ?
• Quel est le calendrier actuel des rapports ?

Cela peut s’avérer particulièrement utile pour les agences qui gèrent plusieurs rapports clients récurrents.

Exécuter un rapport existant

Le serveur MCP inclut une action d'écriture soigneusement contrôlée : run_report.

Cela permet à un assistant IA de générer une nouvelle exécution d’un rapport que vous avez déjà configuré dans Ranktracker.

Cette action est volontairement limitée.

Elle :

• Ne crée pas de nouveau rapport
• N'envoie pas le rapport par e-mail aux destinataires
• N'achète pas de données supplémentaires
• N'ajoute pas de mots-clés
• Ne modifie pas les projets suivis
• Ne consomme pas de crédits de suivi des mots-clés
• Impossible d'exécuter plusieurs fois le même rapport au cours d'une même période de reporting

Le rapport généré s'affiche dans Ranktracker, et l'outil peut renvoyer son statut et le fichier une fois l'exécution terminée.

Cela offre aux utilisateurs une fonctionnalité utile sans permettre à un client IA d’effectuer des modifications importantes ou coûteuses sur le compte.

Audits de sites web

L'assistant peut répertorier les audits de sites web associés à un domaine et récupérer les résultats d'un audit spécifique.

Les informations d'audit disponibles comprennent :

• Statut de l'audit
• Progression de l'exploration
• Statistiques d'exploration
• Scores d'audit
• Avertissements
• Vérifications techniques SEO
• État du SSL
• État HTTP/2
• Vérifications du plan du site
• Vérifications du fichier robots.txt
• Informations sur l'indexation

Vous pourriez demander :

• Quels ont été les principaux problèmes identifiés lors de notre dernier audit de site web ?
• L'audit a-t-il identifié des problèmes d'indexation ?
• Le site web utilise-t-il le protocole HTTP/2 ?
• Y a-t-il eu des problèmes liés au plan du site ou au fichier robots.txt ?
• Résumez les avertissements techniques les plus prioritaires.
• Le dernier audit est-il terminé ?
• Comparez le nombre d'avertissements avec celui de l'audit précédent.

Cela permet aux équipes SEO de comprendre plus rapidement les résultats des audits techniques et de les transformer en actions prioritaires.

Poser des questions sur différents outils Ranktracker

La véritable valeur d’une connexion IA ne se limite pas à récupérer un champ à la fois.

Un assistant peut interroger plusieurs outils au cours d’une même conversation et combiner les résultats pour fournir une réponse plus complète.

Par exemple, vous pourriez demander :

Prépare un résumé SEO hebdomadaire pour example.com.

En fonction de la demande et des informations disponibles, l’assistant pourrait examiner :

• Positions actuelles des mots-clés
• Évolutions récentes du classement
• Visibilité de l'IA
• Nouveaux backlinks et backlinks perdus
• Tendances du profil de liens entrants
• État actuel de l'audit du site web
• Concurrents configurés
• Disponibilité des rapports

Il peut ensuite présenter les conclusions sous la forme d’un résumé de gestion, d’une mise à jour client, d’une liste de priorités ou d’un plan d’action technique.

Vous pouvez poursuivre la conversation en posant des questions complémentaires telles que :

• Quelle perte de classement devons-nous examiner en priorité ?
• Affichez-moi les mots-clés associés.
• Transformez cela en un résumé accessible au client.
• Distinguez les gains rapides des problèmes à plus long terme.
• Quelle alerte technique pourrait avoir le plus grand impact sur le référencement ?

Au lieu d'exporter et de reformater les données à plusieurs reprises, l'analyse peut s'effectuer directement au sein de la conversation.

Comment connecter Ranktracker avec OAuth

OAuth est l'option recommandée pour ChatGPT, Claude, Cursor et d'autres clients interactifs.

La procédure de configuration générale est la suivante :

1. Ouvrez les paramètres MCP ou du connecteur dans votre client IA.
2. Ajoutez le point de terminaison MCP de Ranktracker : https://api.ranktracker.com/mcp
3. Laissez le champ d’authentification manuelle vide.
4. Autorisez le client à détecter le flux OAuth de Ranktracker.
5. Connectez-vous à Ranktracker dans la fenêtre du navigateur.
6. Vérifiez les autorisations demandées.
7. Validez la connexion.
8. Revenez au client IA et vérifiez que les outils Ranktracker sont disponibles.

Seul un administrateur de compte Ranktracker peut approuver une connexion, car le client connecté peut accéder aux données de l'ensemble du compte autorisé.

Connecter ChatGPT

Dans ChatGPT :

1. Ouvrez les Paramètres.
2. Ouvrez « Connecteurs ».
3. Sélectionnez « Ajouter un connecteur personnalisé ».
4. Collez l'URL du serveur MCP de Ranktracker.
5. Suivez la procédure d'autorisation dans le navigateur.

Aucun en-tête d'authentification manuelle n'est requis lors de l'utilisation d'OAuth.

Connexion à Claude Code

Les utilisateurs de Claude Code peuvent ajouter Ranktracker via :

L'écran de consentement du navigateur s'ouvre lorsqu'une authentification est requise.

Connexion à Claude Desktop ou Cursor

Claude Desktop et Cursor peuvent utiliser la configuration de serveur suivante :

Après avoir enregistré la configuration, connectez-vous au serveur et autorisez l'accès via l'écran de consentement de Ranktracker dans le navigateur.

L'emplacement exact du fichier de configuration dépend du client. Des instructions complètes spécifiques à chaque client sont disponibles dans la documentation MCP de Ranktracker.

Autorisations MCP et sécurité du compte

L'écran de consentement OAuth indique quelle application demande l'accès, quel compte Ranktracker sera connecté et quelles autorisations sont demandées.

Les champs d'autorisation disponibles sont les suivants :

• mcp:read — lire les projets, les mots-clés, les classements, les concurrents, les liens entrants, les audits et les rapports
• mcp:write — générer une nouvelle exécution d'un rapport existant

Les jetons d'accès OAuth ont une durée de validité d'une heure et sont automatiquement actualisés par le client connecté. La connexion reste active jusqu'à ce qu'elle soit révoquée.

Le client ne peut accéder qu'aux informations appartenant au compte Ranktracker ayant approuvé la connexion.

La plupart des actions MCP disponibles sont en lecture seule. Les actions susceptibles de consommer des crédits payants ou d’entraîner des modifications importantes du suivi sont délibérément exclues.

Un client IA ne peut pas utiliser le serveur MCP pour :

• Ajouter de nouveaux domaines suivis
• Ajouter ou supprimer des mots-clés
• Acheter des données supplémentaires
• Lancer une nouvelle recherche avec Keyword Finder
• Actualiser le classement des mots-clés
• Modifier les fréquences de suivi
• Supprimer des projets
• Modifier les concurrents
• Envoyer les rapports par e-mail aux destinataires

Ces restrictions permettent aux utilisateurs d’analyser leurs données SEO sans confier à un assistant IA un contrôle illimité sur leur compte Ranktracker.

OAuth ou jeton MCP ?

La plupart des utilisateurs devraient se connecter via OAuth.

OAuth ne nécessite pas de copier, d'enregistrer ou de coller un jeton permanent. Le client IA ouvre Ranktracker dans votre navigateur, demande votre autorisation et gère automatiquement les identifiants d'accès temporaires.

Un jeton MCP dédié est également disponible pour :

• Pipelines CI
• Scripts
• Agents internes
• Environnements automatisés
• Clients ne prenant pas en charge OAuth

Les jetons MCP commencent par :

tkn_mcp_usr_...

Ils sont distincts des clés API REST Ranktracker habituelles et ne fonctionnent qu'avec le point de terminaison MCP.

Une clé API REST commençant par tkn_usr_... ne fonctionnera pas comme identifiant MCP. De même, un jeton MCP ne peut pas être utilisé avec les points de terminaison de l'API REST de Ranktracker.

Le fait de séparer les identifiants permet de révoquer un jeton MCP sans affecter les intégrations API existantes d’une organisation.

Ranktracker MCP vs l'API REST de Ranktracker

Le serveur MCP et l’API REST se connectent aux mêmes données de compte Ranktracker, mais ils sont conçus pour des flux de travail différents.

Ranktracker MCP	API REST Ranktracker
Conçu pour les assistants et agents IA	Conçu pour les applications et les systèmes backend
Prend en charge l'exploration conversationnelle des données	Utilise des points de terminaison programmatiques fixes
L'IA sélectionne l'outil approprié	Un développeur sélectionne et appelle chaque point de terminaison
Principalement en lecture seule	Prend en charge des opérations plus étendues de création, lecture, mise à jour et suppression
Idéal lorsqu’une personne ou un agent pose des questions	Idéal pour les transferts de données planifiés et automatisés
Utilise OAuth ou un jeton MCP dédié	Utilise une clé API REST

Utilisez le MCP lorsque vous souhaitez explorer, expliquer ou résumer vos données SEO via une conversation alimentée par l’IA.

Utilisez l’API REST lorsque vous devez créer un tableau de bord, gérer un entrepôt de données, synchroniser des systèmes ou exécuter une intégration planifiée.

De nombreuses équipes utilisent les deux : le MCP pour l’analyse conversationnelle et l’API REST pour l’automatisation structurée.

Conçu pour gérer les grands comptes SEO

Les tableaux de mots-clés et de liens retour peuvent contenir un volume important de données.

Par défaut, Ranktracker MCP renvoie des données JSON structurées et lisibles. Pour les ensembles de résultats plus volumineux, les utilisateurs peuvent activer le format de réponse TOON en ajoutant :

?format=toon

à l'URL de l'endpoint MCP.

TOON renvoie les mêmes informations sous-jacentes dans un format tabulaire plus compact. Selon la documentation de Ranktracker, cela peut réduire la consommation de jetons d’environ 40 % à 60 % pour les grands ensembles de données.

Le point de terminaison standard est :

https://api.ranktracker.com/mcp

Le point de terminaison optimisé en termes de jetons est :

https://api.ranktracker.com/mcp?format=toon

La plupart des utilisateurs peuvent conserver le format JSON standard pour la connexion. L'option compacte est principalement utile pour les ensembles de données volumineux de mots-clés et de liens retour.

Limites de débit

Le point de terminaison Ranktracker MCP a des limites distinctes de celles de l'API REST :

• 200 requêtes par minute pour chaque identifiant MCP
• 300 requêtes par minute pour chaque adresse IP

Les requêtes dépassant la limite renvoient une réponse HTTP 429 et doivent être réessayées après un certain délai.

Ces limites sont suffisantes pour une utilisation normale, tout en contribuant à protéger les comptes et l’infrastructure contre les requêtes automatisées excessives.

L'accès au MCP est inclus dans tous les forfaits Ranktracker

Le serveur MCP de Ranktracker est disponible avec tous les forfaits d’abonnement Ranktracker.

Cela signifie que les clients des formules « Launch », « Growth », « Scale » et « Authority » peuvent connecter des clients IA pris en charge aux données de leur compte.

La quantité de données disponibles dépendra des projets, des mots-clés, des backlinks, des audits et des rapports déjà disponibles dans le cadre de l’abonnement et des quotas existants du compte.

Aucun abonnement MCP distinct n’est requis pour commencer à connecter votre compte Ranktracker à un client IA pris en charge.

Commencez à utiliser Ranktracker avec votre assistant IA

Le serveur MCP de Ranktracker offre une nouvelle façon de travailler avec les données SEO.

Au lieu de passer d’un écran à l’autre, de télécharger des feuilles de calcul et de préparer manuellement des synthèses, vous pouvez connecter votre assistant IA et lui poser des questions directes sur votre compte.

Vous pouvez analyser :

• Mots-clés suivis
• Évolution des classements
• Visibilité sur la synthèse IA
• Concurrents
• Recherche de mots-clés
• Nouveaux liens entrants et liens perdus
• Tendances du profil de liens entrants
• Audits de sites web
• Rapports programmés

La connexion est rapide à configurer, fonctionne avec les principaux clients MCP et est conçue avec des autorisations contrôlées qui empêchent toute modification coûteuse ou préjudiciable de votre compte.

Connectez votre client IA préféré et consultez les instructions de configuration complètes à l'adresse suivante :

https://developers.ranktracker.com/mcp