Tech & Performance

MCP Semrush avec Claude : offres, connexion, unités

MCP Semrush avec Claude : offres qui l’incluent, connexion par l’app Claude ou Claude Code, outils de découverte, unités d’API consommées et limites à connaître.

Publié le 16/11/2026Par Maxence Vanderswalmen

Semrush publie un serveur MCP qui donne à un assistant comme Claude un accès à ses API : données SEO, données de trafic et de marché, et lecture des projets du compte. L'accès est inclus dans plusieurs offres, il consomme les unités d'API de l'abonnement et il se branche par OAuth ou, à défaut, par clé d'API. Ce guide reprend la documentation de Semrush pour les offres, la connexion et les limites. Il s'insère dans notre guide Claude et MCP pour le marketing e-commerce.

Ce que le serveur expose

Selon Semrush, le serveur MCP donne aux agents IA un accès sécurisé à ses API publiques. Trois familles de données sont couvertes :

  • toute l'API Trends, selon le niveau d'abonnement Trends API ;
  • toute l'API SEO ;
  • toutes les méthodes en lecture seule de l'API Projects (v3) : on lit les données de ses projets, on n'en crée pas et on n'en modifie pas les réglages.

Semrush liste comme clients compatibles Claude, Claude Code, Microsoft Copilot, ChatGPT, Cursor, VS Code, Antigravity 2.0 et Antigravity CLI, Perplexity, Lovable et Notion. Parmi les usages qu'elle cite : surveiller chaque jour des données de mots-clés et de backlinks pour repérer les baisses de position, suivre le trafic de concurrents, ou produire un rapport mensuel de trafic et de SEO dans Google Docs ou Notion.

Quelles offres incluent l'accès

La page de Semrush distingue les données SEO (API standard) et les données de trafic et de marché (API Trends).

  • Données SEO : Semrush One Starter, Semrush One Pro+, SEO Classic Pro et SEO Classic Guru, qui incluent 50 000 unités d'API renouvelées à la date de renouvellement de l'abonnement.
  • Le MCP s'utilise aussi avec SEO Classic Business ou Semrush One Advanced, à condition d'y ajouter un forfait d'unités d'API. Les forfaits sont de 2, 5, 10 ou 20 millions d'unités.
  • Données de trafic et de marché : tout abonnement Trends API, Basic ou Premium, inclut l'accès au MCP.

Cette liste reprend les offres indiquées dans la documentation de Semrush. Les offres peuvent changer : vérifiez-la sur votre compte avant de vous appuyer sur elle.

Connecter Claude

Le serveur utilise uniquement le transport Streamable HTTP, à l'adresse https://mcp.semrush.com/v2/mcp. L'authentification par défaut est OAuth, sans réglage ni en-tête à ajouter : l'agent s'enregistre et vous redirige vers la page de connexion Semrush. Un client qui ne gère pas OAuth peut utiliser une clé d'API passée dans l'en-tête Authorization au format Apikey VOTRE_CLE.

Avec l'app Semrush dans Claude

  1. Ouvrir Claude, puis « Customize » et « Connect your apps ».
  2. Chercher « Semrush », sélectionner l'app et cliquer sur « Connect ».
  3. Lire les accès demandés sur l'écran d'autorisation de Semrush, puis cliquer sur « Approve ».
  4. Retrouver Semrush dans la liste des connecteurs, puis le citer dans une conversation avec @Semrush.

Avec Claude Code

  1. Lancer dans le terminal claude mcp add semrush https://mcp.semrush.com/v2/mcp -t http.
  2. Ouvrir Claude Code et exécuter /mcp.
  3. Sélectionner Semrush MCP dans la liste, puis « Authenticate » : le flux OAuth 2.1 redirige vers la page de connexion Semrush.

Comment l'agent interroge Semrush

Semrush indique que l'agent devrait utiliser trois types d'outils. Des outils de découverte permettent de trouver les rapports disponibles : domain_overview, organic_research, keyword_research, competitors_research, backlinks_research, audience_research, traffic_overview, paid_search_research, shopping_research, position_tracking, site_audit et projects. L'outil get_report_schema donne les paramètres d'un rapport précis, et execute_report le lance. La page ne détaille pas le contenu de chaque outil de découverte. Si la liste affichée dans Claude après la connexion ne contient pas tous ces outils, Semrush demande de vérifier que l'authentification est terminée, l'accès au compte Semrush et les messages d'erreur de la console de l'agent.

Pour démarrer, Semrush propose une bibliothèque de plus de 50 prompts prêts à copier, ainsi que des skills, c'est-à-dire des jeux d'instructions qui indiquent à l'agent quels outils appeler, dans quel ordre et avec quels paramètres. Ils sont aussi publiés dans un dépôt public de skills Semrush sur GitHub. Pour le principe d'un skill, voir notre guide sur les skills Claude pour le marketing.

Unités d'API

  • Le serveur MCP applique le même système d'unités que l'API de Semrush : chaque requête consomme un nombre d'unités qui dépend du type de rapport et du volume de données demandé.
  • Semrush précise qu'il n'y a pas de frais d'usage MCP supplémentaires, ni de frais Claude supplémentaires pour l'app.
  • Pour connaître son solde, Semrush renvoie vers « My Profile », « Subscription info », puis « Summary ».
  • Sans abonnement Trends API Basic ou Premium, les données Trends ne sont pas accessibles par le MCP.

Un compte d'entreprise : l'autorisation gérée

Par défaut, chaque membre connecte Semrush dans Claude par son propre flux OAuth. Semrush documente aussi une autorisation gérée par l'entreprise (enterprise-managed authorization), qui active le connecteur pour toute l'organisation Claude : les membres n'ont plus à se connecter ni à consentir individuellement. Selon la page, elle est disponible sur les comptes entreprise de Semrush, réservée au propriétaire du compte entreprise et aux administrateurs d'organisation Claude (offres Team et Enterprise), la configuration passant par l'un puis par l'autre, et ne fonctionne qu'avec les modèles d'Anthropic. Elle ne modifie ni les permissions ni les limites : chaque membre garde l'accès et l'allocation d'unités qu'il a déjà.

Semrush et Ahrefs : ce que disent les deux documentations

Le tableau reprend uniquement des points écrits dans les pages des deux éditeurs. Le choix entre les deux outils relève d'un autre débat, traité dans notre comparatif des outils de keyword gap.

PointSemrushAhrefs
Adresse du serveurhttps://mcp.semrush.com/v2/mcp, Streamable HTTP uniquementhttps://api.ahrefs.com/mcp/mcp, Streamable HTTP
Offre requiseOffre éligible : quatre offres incluent 50 000 unités, deux autres demandent un forfait d'unitésOffre payante à partir de Lite
ConnexionOAuth par défaut, clé d'API dans l'en-tête Authorization si le client ne gère pas OAuthOAuth ou clé MCP générée dans le compte
ConsommationUnités d'API, sans frais MCP supplémentairesUnités d'API de l'allocation mensuelle de l'offre
Limiter les outils annoncésAucun paramètre décrit dans la page de présentationParamètre d'URL tools pour choisir les groupes

À notre avis, l'abonnement que l'équipe paie déjà décide du choix, puisque l'accès MCP est disponible avec les offres des deux éditeurs. Brancher les deux sur un même compte Claude se justifie surtout pour croiser deux sources de données SEO sur une même question, et la consommation d'unités se suit alors dans deux comptes.

Une première série de demandes

Semrush donne deux exemples de demandes : lister les domaines d'un secteur pour un mois donné, et chercher qui gagne du trafic parmi des services d'un pays. Les demandes ci-dessous sont notre assemblage pour un site e-commerce, à valider sur votre compte avant de s'y fier :

  1. Les dix pages organiques de votre domaine qui reçoivent le plus de trafic, avec leur position.
  2. Les concurrents organiques de votre domaine, classés par nombre de mots-clés communs.
  3. Le volume de recherche d'une liste de dix termes de catégorie dans la base du pays visé.
  4. Les problèmes remontés par le dernier audit de site, regroupés par type.
  5. L'évolution des positions d'un projet de suivi sur les trente derniers jours.

Garde-fous

  • Vérifier les réponses : Semrush avertit que les réponses d'une IA peuvent être incomplètes ou inexactes et qu'il faut les vérifier avant toute décision ou publication.
  • Suivre les unités après les premières sessions, car chaque rapport demandé en consomme.
  • À notre avis, il vaut mieux ne pas ranger de clé d'API dans un dépôt partagé. Le guide sur CLAUDE.md donne notre avis sur ce qu'un fichier de contexte ne doit pas contenir : ni identifiants de connexion ni mot de passe.
  • Poser des règles de permission par outil : voir notre article sur l' injection de prompt et les serveurs MCP.
  • Croiser avec la source de Google quand une décision en dépend : voir le guide du MCP Search Console.

Questions fréquentes sur le MCP Semrush

Faut-il un abonnement Semrush pour utiliser le MCP ?

Oui. La documentation de Semrush indique qu’une offre éligible est nécessaire et que les données accessibles dépendent de l’abonnement et de l’accès à l’API. Pour les données SEO, la page cite quatre offres qui incluent 50 000 unités d’API, et deux autres qui demandent un forfait d’unités en plus.

Les requêtes de Claude consomment-elles des unités d’API ?

Oui. D’après Semrush, les requêtes passées par le MCP consomment les mêmes unités d’API que les requêtes directes, sans frais d’usage MCP supplémentaires. Pour l’app Semrush dans Claude, la page précise aussi qu’il n’y a pas de frais Claude supplémentaires.

Claude peut-il modifier mes projets Semrush ?

Pas avec ce serveur, d’après la documentation : le MCP donne accès aux méthodes en lecture seule de l’API Projects. On peut y lire les données d’un projet, mais pas en créer ni en modifier les réglages.

Que vérifier quand des outils manquent dans Claude ?

Semrush recommande de s’assurer que l’authentification est terminée, de vérifier l’accès au compte Semrush et de consulter les messages d’erreur de la console de l’agent. Les données Trends exigent en plus un abonnement Trends API Basic ou Premium.

Sources documentaires

Pour aller plus loin sur Claude et les données SEO : MCP Search Console, MCP GA4. Pour cadrer un chantier SEO sur votre catalogue, voir notre page SEO e-commerce et la grille de priorisation d'audit SEO e-commerce.

Un SEO piloté à la marge

Les outils sortent des listes de mots-clés ; le diagnostic dit lesquels méritent un investissement compte tenu de votre catalogue.

Demander un diagnostic SEO

Pour avancer à votre rythme

Passer des outils IA à une méthode de travail

Retrouvez nos ressources pour utiliser l’IA dans votre marketing et garder la main sur vos décisions.

Recevoir le Playbook IA

Gardez un œil sur ce qui compte.

Nos analyses, méthodes et ressources pour piloter la croissance de votre e-commerce. Directement dans votre boîte mail.

En vous inscrivant, vous recevrez les emails Make Sense. Désinscription en un clic. Données personnelles.