Interrogez Claude, Cursor et d’autres assistants IA sur votre SEO

1. Créez une API key

Dans serp.ac, ouvrez Paramètres → API et créez une clé (seuls le propriétaire du compte et les administrateurs le peuvent). Copiez-la — elle n’est affichée qu’une fois. Le serveur MCP utilise les mêmes clés, la même limite de débit (120 requêtes par minute et par clé) et les mêmes quotas que la REST API. Chaque clé donne un accès complet au compte qui l’a créée : gardez-la secrète et révoquez-la sur la même page en cas de fuite.

2. Connectez Claude

Claude (claude.ai et les applications Claude) — connecteur personnalisé

Allez dans Settings → Connectors → Add custom connector, nommez-le serp.ac et utilisez l’URL du serveur https://serp.ac/api/mcp. Le serveur authentifie chaque requête avec votre API key envoyée sous la forme Authorization: Bearer sk_live_… ; si la boîte de dialogue du connecteur de votre formule ne permet pas d’envoyer cet en-tête, utilisez plutôt la configuration Claude Desktop ci-dessous.

Claude Desktop — fichier de configuration

Ouvrez Settings → Developer → Edit config et ajoutez le serveur à claude_desktop_config.json. Il lance le pont mcp-remote (nécessite Node.js), qui transmet votre clé dans un en-tête. Redémarrez ensuite Claude Desktop.

{
  "mcpServers": {
    "serp-ac": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://serp.ac/api/mcp", "--header", "Authorization:${SERP_AC_AUTH}"],
      "env": { "SERP_AC_AUTH": "Bearer sk_live_..." }
    }
  }
}

Claude Code

claude mcp add --transport http serp-ac https://serp.ac/api/mcp \
  --header "Authorization: Bearer sk_live_..."

3. Connectez Cursor et d’autres clients

Cursor : ajoutez le serveur à ~/.cursor/mcp.json (tous les projets) ou à .cursor/mcp.json dans un projet, puis activez-le dans Settings → MCP.

{
  "mcpServers": {
    "serp-ac": {
      "url": "https://serp.ac/api/mcp",
      "headers": { "Authorization": "Bearer sk_live_..." }
    }
  }
}

Tout autre client MCP (ChatGPT, VS Code, Windsurf, votre propre agent) fonctionne de la même façon, à condition de prendre en charge le transport Streamable HTTP et de pouvoir envoyer l’en-tête Authorization. Les clients qui ne gèrent que stdio peuvent utiliser le pont mcp-remote présenté ci-dessus.

Vérification rapide depuis un terminal :

curl https://serp.ac/api/mcp \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Mode lecture seule

Les outils marqués Modifie les données ajoutent des éléments à votre compte et ceux marqués Consomme du quota utilisent vos quotas mensuels ; les assistants sont invités à vous demander d’abord. Pour n’exposer que les outils de lecture, connectez-vous avec https://serp.ac/api/mcp?readonly=1. Le mode lecture seule est un réglage de la connexion, pas de la clé — une clé porte toujours l’ensemble des droits du compte.

Outils

Chaque outil répond par un court résumé et les mêmes données en JSON structuré. Les listes sont plafonnées (jusqu’à 200 lignes) et ne contiennent jamais que les données de votre propre compte. Les projets peuvent être désignés par leur id ou leur domaine.

• list_projectsLecture

  Liste les projets serp.ac (sites web) de ce compte avec leurs id, domaines et le nombre de mots-clés, prompts IA et liens achetés suivis par chacun. Appelez cet outil en premier pour obtenir les id de projet.

• get_rankingsLecture

  Positions Google des mots-clés suivis d’un projet : position actuelle, variation depuis la vérification précédente (positif = progression), URL positionnée, présence d’un Google AI Overview citant le site, et heure de la dernière vérification. Filtres optionnels par texte de mot-clé et par appareil.

• get_ai_visibilityLecture

  Visibilité IA d’un projet dans ChatGPT, Perplexity, Gemini, Claude et Google AI Mode : part des réponses mentionnant la marque, taux de citation, position moyenne, chiffres par moteur, matrice prompt × moteur, principaux domaines sources cités, part de voix et autres marques recommandées par les assistants IA.

• get_backlinks_summaryLecture

  Vue d’ensemble des backlinks d’un projet : total des backlinks et domaines référents, domain rank, part de dofollow, nouveaux liens des 30 derniers jours, liens perdus et domaines référents les plus forts.

• list_purchased_linksLecture

  Liens achetés (payants) suivis dans Gestion de liens : statut (pending, active, issue, lost, expired, cancelled = en pause), problèmes détectés, prix, cycle de facturation, date du prochain paiement / renouvellement et vendeur, ainsi que les paiements dus dans les 30 prochains jours. Tous les projets, sauf si un projet est indiqué.

• get_index_jobLecture

  Statut d’une tâche de vérification d’indexation lancée avec check_index, avec le statut d’indexation de chaque URL (indexed, not_indexed, queued, error).

• get_usageLecture

  Formule et statut d’abonnement du compte, limites de la formule avec l’utilisation actuelle (projets, mots-clés, prompts IA, liens) et quotas mensuels restants (soumissions à l’indexeur, vérifications d’indexation, recherches de données de mots-clés).

• get_maps_rankingsLecture

  Suivi des positions Google Maps (grille géolocalisée locale) d’un projet : sans campagne, chaque campagne Maps avec son dernier score de présence locale (0–100), sa couverture du top 10 et sa position moyenne ; avec une campagne (id ou texte du mot-clé), la position du dernier scan à chaque point de la grille, l’historique des scans, les concurrents mieux classés et le local pack.

• track_keywordsModifie les données

  lance le suivi des positions Google de nouveaux mots-clés dans un projet. Chaque nouveau mot-clé est décompté de la limite de mots-clés SERP de la formule ; les mots-clés déjà suivis restent inchangés. Demandez à l’utilisateur avant d’ajouter de nombreux mots-clés.

• add_ai_promptsModifie les données

  ajoute des prompts (questions posées aux assistants IA) au suivi de visibilité IA d’un projet ; ils sont ensuite exécutés selon un calendrier. Chaque nouveau prompt est décompté de la limite de prompts IA de la formule ; les prompts déjà suivis restent inchangés.

• add_purchased_linkModifie les données

  ajoute un lien acheté (payant) à la Gestion de liens d’un projet pour que serp.ac le vérifie chaque jour et rappelle les paiements. Décompté de la limite de liens suivis de la formule. Échoue avec already_tracked si le même lien source → cible existe déjà.

• check_indexConsomme du quota

  lance une tâche qui vérifie si des URL sont indexées par Google. Chaque URL consomme 1 vérification d’indexation sur le quota mensuel (puis sur les packs achetés) ; rien n’est débité si le quota est insuffisant. Renvoie un id de tâche — appelez get_index_job pour obtenir les résultats.

• get_keyword_dataConsomme du quota

  volume de recherche, CPC, concurrence, difficulté, intention de recherche et tendance sur 12 mois par mot-clé. Chaque mot-clé non mis en cache est décompté du quota mensuel payant de recherches de mots-clés du compte (les mots-clés en cache sont gratuits) ; consultez get_usage d’abord pour les grandes listes.

Limites et erreurs

• Les outils d’écriture respectent votre formule exactement comme le tableau de bord et la REST API : limites de mots-clés, de prompts et de liens, moteurs IA inclus dans la formule, et formule ou essai actif.
• check_index consomme 1 vérification d’indexation par URL sur le quota mensuel, puis sur les packs ; get_keyword_data consomme le quota mensuel de recherches de mots-clés pour les mots-clés non mis en cache. Rien n’est débité si le quota est insuffisant.
• Les problèmes liés à un appel (projet inconnu, arguments invalides, limite atteinte) sont renvoyés sous forme d’erreur d’outil lisible par l’assistant. Une clé manquante ou révoquée renvoie HTTP 401, un compte suspendu 403 et un excès de requêtes 429.

Vous automatisez sans assistant IA ? Consultez la référence de la REST API dans Paramètres → API.