Aller au contenu

Le média du business en ligne et du marketing

Boîte à outils Bons plans
Newsletter
SEOGuide

MCP Haloscan : brancher Claude sur vos données SEO

Le MCP Haloscan sans le discours LinkedIn : ce qu'il apporte vraiment, ce qu'il coûte en crédits, ses ratés, puis l'installation pas à pas dans Claude Desktop et 6 demandes SEO prêtes à l'emploi.

Sommaire
  1. MCP Haloscan : le verdict en 30 secondes ⚡
  2. MCP Haloscan : c’est quoi exactement ? 🔌
  3. Que peut faire Claude avec le MCP Haloscan ?
  4. Le MCP Haloscan en conditions réelles : trois demandes types 🔎
  5. Les prérequis avant d’installer
  6. Installer le MCP Haloscan dans Claude Desktop, étape par étape
  7. Erreurs fréquentes et solutions 🛠️
  8. Et l’API Haloscan sans MCP ?
  9. 6 demandes SEO à taper dans Claude avec le MCP Haloscan 💡
  10. Limites et précautions ⚠️
  11. Mon verdict : le MCP Haloscan, pour qui ? 🎯
  12. Pour aller plus loin
  13. Questions fréquentes

Vous connaissez la routine : un onglet Haloscan pour les positions du concurrent, un autre pour les questions, un export CSV, puis un copier-coller dans Claude pour qu’il en tire quelque chose. Et vous recommencez au prochain client. 😮‍💨

Le MCP Haloscan supprime ces allers-retours : Claude interroge directement les données d’Haloscan pendant la conversation. Sur LinkedIn, on lit que « le SEO vient de changer de dimension ». La réalité est plus modeste, et plus utile : c’est un excellent assistant de lecture des données, à condition de lui poser des questions étroites et de vérifier ce qu’il en tire.

Ce guide ne se contente pas de recopier le tutoriel officiel. Il montre ce que renvoient de vraies demandes, ce qu’elles coûtent en crédits et où l’outil cale. Ensuite seulement viennent l’installation, les erreurs fréquentes et six demandes prêtes à copier.

MCP Haloscan : le verdict en 30 secondes ⚡

  • Ça vaut le coup si vous avez déjà une offre Haloscan Starter : l’installation prend quelques minutes, et lire une SERP, des volumes ou des positions devient une simple question.
  • Le gain n’est pas la vitesse, c’est la décision : une demande bien posée vous dit en une réponse ce que les 10 premiers résultats proposent, et ce qui leur manque.
  • Le coût en crédits est faible si vous filtrez : une recherche par demande, plus une ligne par résultat renvoyé.
  • Les limites sont réelles : réponses vides, erreurs ponctuelles, volumes aberrants. Gardez l’interface d’Haloscan ouverte pour vérifier.
Schéma : sans MCP, ouvrir Haloscan, filtrer, exporter en CSV, coller dans Claude et recommencer ; avec le MCP, une question à Claude et la réponse avec les données.

Sans MCP, cinq allers-retours ; avec, une question.

MCP Haloscan : c’est quoi exactement ? 🔌

Le MCP (Model Context Protocol) est le standard qui permet à une IA comme Claude d’appeler des outils externes. Si le principe est nouveau pour vous, notre guide MCP Claude explique le protocole et les offres Claude ; ici, on se concentre sur Haloscan.

Le MCP Haloscan est un petit programme, un serveur MCP, qui tourne sur votre ordinateur. Quand vous posez une question SEO à Claude, il choisit l’outil adapté, le serveur appelle l’API Haloscan avec votre clé, puis rend les données à Claude, qui les analyse.

Schéma : Claude Desktop envoie la demande au serveur MCP @occirank/haloscan-server, qui tourne sur l'ordinateur et appelle l'API Haloscan avec la clé API ; chaque appel décompte des crédits.
Le serveur MCP fait l’intermédiaire entre Claude et l’API Haloscan.

Point important : ce n’est pas un produit officiel d’Haloscan. La page d’installation publiée par Haloscan précise que le serveur a été créé bénévolement pour la communauté SEO par Jérémy Santos, présenté comme expert n8n. Le code est distribué sur npm sous le nom @occirank/haloscan-server, sous licence MIT. La version 2.0.28 date du 16 septembre 2026 ; le dépôt GitHub d’origine, lui, n’a plus bougé depuis juin 2025.

Capture de la page « Tutoriel : Installer et Configurer le MCP Haloscan pour Claude Desktop » publiée par l'équipe Haloscan le 8 septembre 2025, avec les logos Haloscan et Claude.
Capture : tutoriel MCP sur le blog d’Haloscan.

Que peut faire Claude avec le MCP Haloscan ?

Le paquet expose 46 outils, qui reprennent l’essentiel de l’API Haloscan et apparaissent dans Claude une fois le serveur branché.

Infographie : les 46 outils du serveur MCP Haloscan par famille. 12 mots-clés, 5 historique des SERP, 10 domaines et pages, 4 concurrents, 9 projets et suivi, 3 Google Business Profile, 2 domaines expirés, 1 compte.
Les familles d’outils du paquet @occirank/haloscan-server, version 2.0.28.

Les plus utiles au quotidien :

  • Mots-clés : volume, CPC, concurrence, indice KVI et historique de volume (get_keywords_overview), questions « Autres questions posées » (get_keywords_questions), recherches associées, et même un regroupement de mots-clés par proximité de SERP pour bâtir une structure de site (get_keywords_site_structure).
  • Domaines : positions d’un site avec filtres (position, volume, trafic), meilleures pages, historique de visibilité.
  • Concurrents : sites concurrents d’un domaine, leurs meilleures pages et l’écart de mots-clés entre vous et eux.
  • Projets : lire le suivi de positions de vos projets Haloscan. Trois outils peuvent aussi créer, modifier ou supprimer un projet.

Le MCP Haloscan en conditions réelles : trois demandes types 🔎

Voici trois demandes passées au serveur MCP Haloscan. Pour chacune : ce qui a été demandé, ce qui est revenu, et ce qu’il faut en retenir.

1. « Quelle est l’intention derrière rank math vs yoast ? » Claude appelle get_keywords_overview en demandant la SERP, les recherches associées et les questions. En une réponse : 56 résultats classés, avec titre et extrait. Le constat saute aux yeux : un fil Reddit en 2e position (« I have tried both… »), et autour, des comparatifs qui alignent tous les mêmes fonctions. Les internautes veulent un avis d’utilisateur, pas une fiche technique. C’est exactement le genre de lecture qui prend vingt minutes à la main.

2. « Que propose déjà Google sur mcp haloscan ? » Même outil, même méthode. En tête : le tutoriel d’installation d’Haloscan, la page d’accueil de l’outil, puis des posts LinkedIn enthousiastes et la page npm du serveur. Détail instructif : dans la même réponse, le bloc des questions associées est revenu en erreur, sans empêcher le reste de s’afficher. L’erreur tient dans un simple champ de la réponse, facile à manquer si Claude ne la mentionne pas.

3. « Quelles questions les internautes se posent sur haloscan ? » get_keywords_questions répond… 0 résultat. Le compteur de recherches est pourtant débité d’une unité. Leçon : une réponse vide n’est pas une absence de demande, c’est parfois une limite de la base.

Demande réelleCompteur débitéRésultats/exports
Questions sur un mot-clé (0 résultat)1 recherche de mots-clés0
Volumes de 8 mots-clés en une fois (get_keywords_bulk)1 recherche en masse8
Positions d’un domaine, 5 lignes (get_domains_positions)1 analyse de site5
SERP complète d’un mot-cléRecherche de mots-clés0
Crédits restantsAucun0

Sur un Starter (10 000 recherches de mots-clés et 700 000 résultats par mois), ces demandes sont indolores. Ce qui coûte, ce sont les demandes larges qui rapatrient des milliers de lignes. Pour garder la main, fixez-vous un plafond d’appels par tâche, par exemple une demi-douzaine.

Mon conseil : demandez à Claude de citer l'outil appelé et le nombre de lignes reçues à la fin de chaque réponse. Vous saurez ce qu'il a vraiment lu, et ce qu'il a déduit.

Les prérequis avant d’installer

Quatre choses à réunir, dont une seule payante côté Haloscan.

PrérequisDétail
Offre HaloscanStarter ou supérieure : l’accès API n’existe pas dans l’offre gratuite. Starter à 59 € HT/mois, ou 49,20 €/mois en annuel
Clé API HaloscanDans votre compte, page API (tool.haloscan.com/user/api)
Node.jsVersion LTS, à installer depuis nodejs.org : la configuration lance le serveur avec npx
ClaudeClaude Desktop sur Mac ou Windows ; Claude Code ou Cursor fonctionnent aussi

Côté Haloscan, la page tarifs le montre clairement : « Accès API » est coché à partir du Starter, avec 10 000 recherches de mots-clés et 3 000 analyses de site par mois. Le détail des offres est sur notre fiche Haloscan.

Capture du tableau des tarifs Haloscan : Free à 0 €, Starter à 59 €, Agency à 179 € et Guru à 449 € par mois ; l'accès API est coché à partir de Starter, avec les quotas de recherches et de résultats par offre.
Capture : page tarifs Haloscan, prix hors taxes.

Côté Claude, le tutoriel d’Haloscan mentionne un abonnement Pro ou Max. Côté Anthropic, la page tarifs de Claude inclut les extensions de bureau dans toutes les offres, gratuite comprise, et ne réserve pas les serveurs locaux aux abonnés (détail dans notre guide MCP Claude). À mon sens, l’offre Pro reste le choix réaliste : les réponses d’Haloscan sont volumineuses et épuisent vite le quota gratuit. Les offres sont comparées sur notre fiche Claude.

Installer le MCP Haloscan dans Claude Desktop, étape par étape

Comptez quelques minutes si Node.js est déjà installé : cinq étapes, de la clé API au premier test. 🚀

Étape 1 : récupérer votre clé API

Connectez-vous à Haloscan et ouvrez la page API de votre compte (tool.haloscan.com/user/api). Copiez la clé et traitez-la comme un mot de passe.

Étape 2 : installer Node.js

Téléchargez la version LTS sur nodejs.org, installez-la, puis vérifiez dans un terminal avec node --version, comme le recommande la documentation MCP. Si un numéro de version s’affiche, c’est bon.

Étape 3 : ouvrir le fichier de configuration de Claude Desktop

Dans Claude Desktop, passez par le menu de l’application (pas les réglages du compte) : Settings → Developer → Edit Config. Claude ouvre ou crée le fichier claude_desktop_config.json. Ses emplacements, si vous préférez l’ouvrir vous-même :

  • Mac : ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows : %APPDATA%\Claude\claude_desktop_config.json

Étape 4 : coller la configuration Haloscan

Si le fichier est vide, collez ce bloc tel quel, en remplaçant YOUR API KEY par votre clé. S’il contient déjà d’autres serveurs, ajoutez seulement l’entrée "haloscan" dans mcpServers, sans oublier la virgule qui la sépare de la précédente.

{   "mcpServers": {     "haloscan": {       "command": "npx",       "args": ["-y", "@occirank/haloscan-server", "start"],       "env": {         "HALOSCAN_API_KEY": "YOUR API KEY"       }     }   } }
Capture du tutoriel Haloscan : emplacements du fichier claude_desktop_config.json sous Windows et macOS, puis bloc JSON de configuration du serveur @occirank/haloscan-server avec la variable HALOSCAN_API_KEY.
Capture : configuration fournie par Haloscan.

Étape 5 : quitter, relancer, tester

Enregistrez, puis quittez complètement Claude Desktop : le tutoriel d’Haloscan insiste, réduire la fenêtre ne suffit pas. Relancez l’application. Dans une conversation, ouvrez le bouton + en bas à gauche, puis Connectors → Manage connectors : « haloscan » doit apparaître avec la liste de ses outils.

Premier test conseillé par Haloscan : « En utilisant le MCP Haloscan, peux-tu me donner mes crédits restants sur Haloscan ? ». Cet appel ne coûte aucun crédit, et la réponse détaille chaque compteur.

Et dans Claude Code ou Cursor ?

Dans Claude Code, une seule commande suffit, d’après la syntaxe documentée par Anthropic :

claude mcp add --env HALOSCAN_API_KEY=votre-cle --transport stdio haloscan -- npx -y @occirank/haloscan-server start

Vérifiez ensuite avec claude mcp list ou /mcp. Dans Cursor, le même bloc mcpServers se place dans ~/.cursor/mcp.json (pour tous vos projets) ou .cursor/mcp.json (pour un seul), selon la documentation de Cursor.

Erreurs fréquentes et solutions 🛠️

SymptômeCause probableSolution
« MCP haloscan: spawn npx ENOENT »Node.js absent ou introuvableInstaller Node.js (LTS), puis quitter et relancer Claude Desktop
Le serveur n’apparaît pas dans ClaudeJSON mal formé (virgule manquante ou en trop, guillemets typographiques) ou application pas vraiment redémarréeValider le fichier dans un vérificateur JSON, quitter complètement Claude, relancer
« API key not found »Variable HALOSCAN_API_KEY absente ou mal nomméeVérifier le nom exact de la variable dans le bloc env
Les appels échouent alors que le serveur est listéClé invalide, ou offre Free sans accès APIRecopier la clé depuis la page API, vérifier votre offre
Les réponses s’arrêtent en cours de moisUn compteur de crédits est à zéroDemander « mes crédits restants » pour voir lequel, attendre le renouvellement ou monter d’offre
Échec sous Windows avec ${APPDATA} dans les journauxChemin non résoluAjouter la valeur réelle de APPDATA dans le bloc env

Pour creuser, la documentation MCP indique où lire les journaux : ~/Library/Logs/Claude sur Mac, %APPDATA%\Claude\logs sur Windows (fichier mcp-server-haloscan.log).

Mon conseil : après chaque modification du fichier, refaites le test des crédits. Il est gratuit et il vous dit en une réponse si la connexion, la clé et l'offre sont bonnes.

Et l’API Haloscan sans MCP ?

Le MCP n’est qu’une façon d’utiliser l’API Haloscan. Si vous voulez alimenter un tableur, un tableau de bord ou un scénario n8n ou Make sans passer par Claude, vous pouvez l’appeler directement.

En deux mots : les appels partent vers https://api.haloscan.com/api, avec votre clé dans l’en-tête haloscan-api-key, sur des routes comme /keywords/overview, /keywords/questions, /domains/positions ou /domains/siteCompetitors. La documentation complète est accessible depuis la page API de votre compte, et l’API est incluse dans toutes les offres payantes. Si vous ne codez pas, le MCP reste plus simple : Claude choisit lui-même les bons filtres.

6 demandes SEO à taper dans Claude avec le MCP Haloscan 💡

Ces demandes sont des modèles à adapter. Précisez toujours le domaine, le nombre de résultats voulu et le format de sortie : c’est ce qui limite les crédits consommés.

Schéma : une demande type dont chaque partie est surlignée : le nombre de lignes, le site, les filtres et le résultat attendu.

Quatre éléments qui rendent une demande précise et économe en crédits.

1. Auditer les mots-clés d’un concurrent

« Avec le MCP Haloscan, trouve les 5 principaux concurrents de monsite.fr, puis liste les 30 mots-clés à plus fort volume sur lesquels concurrent.fr se positionne et pas monsite.fr. Présente le résultat en tableau. »

Claude enchaîne les outils concurrents (get_domains_competitors, puis get_domains_competitors_keywords_diff) et rend une liste d’opportunités triée.

2. Repérer les quick wins en positions 11 à 20

« Liste les 20 mots-clés de monsite.fr en positions 11 à 20, triés par volume, avec l’URL positionnée. Pour chacun, dis-moi ce que tu changerais dans la page pour gagner la première page. »

L’outil get_domains_positions renvoie, pour chaque mot-clé, la position, l’URL classée et deux volumes : celui d’Haloscan et celui de Google Ads. Exigez les deux. Sur un gros site d’avis logiciels interrogé pour la préparation de ce guide, Haloscan comptait plus de 20 000 mots-clés en positions 11 à 20 : sans filtre ni limite de lignes, la demande aurait vidé une bonne part du quota d’exports. Et dans les cinq premières lignes, le mot-clé « wero » affichait 50 millions de recherches mensuelles côté Haloscan, contre 165 000 côté Google Ads. Ce genre d’écart se repère d’un coup d’œil dans un tableau ; noyé dans une synthèse rédigée par Claude, il passe inaperçu.

3. Trouver des idées de contenus

« Pour le mot-clé « logiciel de facturation », donne-moi le volume, les questions posées par les internautes et les recherches associées, puis regroupe le tout en 5 idées d’articles avec un titre et l’intention de recherche. »

Les outils de questions et de recherches associées font le gros du travail. Pour une grappe complète, demandez un regroupement par proximité de SERP : c’est le rôle de get_keywords_site_structure.

4. Analyser une SERP et son évolution

« Compare la SERP de « crm pme » aujourd’hui et il y a 6 mois : qui est entré, qui est sorti, et quel type de page domine ? »

Claude interroge l’historique des SERP (get_keywords_serp_compare) et vous dit si Google privilégie les comparatifs, les pages produit ou les guides.

5. Détecter une cannibalisation

« Liste les mots-clés de monsite.fr pour lesquels au moins deux URL différentes sont positionnées, avec les positions de chacune. »

Les positions d’un domaine renvoient l’URL classée pour chaque mot-clé : Claude peut repérer les doublons. Limitez à votre top 200 ou 500 mots-clés, sinon la liste devient énorme.

6. Faire le point sur un projet suivi

« Donne-moi l’aperçu de mes projets Haloscan : visibilité, mots-clés gagnés et perdus cette semaine, et les trois baisses à traiter en priorité. »

Les outils de projets lisent votre suivi de positions. Pratique pour un point client du lundi, à condition d’avoir créé le projet dans Haloscan.

Limites et précautions ⚠️

Illustration : deux collègues vérifient un graphique sur une tablette, à côté d'un bouclier jaune marqué d'une coche et d'une bulle IA épinglée au tableau.

Les crédits. Chaque appel décompte vos quotas mensuels Haloscan, avec les mêmes compteurs que dans l’interface (voir le tableau de nos demandes réelles plus haut) : une recherche de mots-clés retire une recherche « keyword explorer », une analyse de domaine une recherche « site explorer », et chaque ligne renvoyée consomme un « résultat/export ». Une recherche sans aucun résultat est décomptée quand même.

Infographie : crédits Haloscan consommés par type de demande. Mot-clé : 1 recherche keyword explorer ; domaine : 1 recherche site explorer ; liste en masse : 1 recherche bulk ; chaque ligne renvoyée : 1 résultat ; crédits restants : gratuit.
Les compteurs et les quotas du Starter viennent de la page tarifs d’Haloscan.

Le vrai risque vient des demandes vagues : « analyse tout le site du concurrent » peut enchaîner les appels et rapatrier des milliers de lignes.

Le quota Claude. Les réponses d’Haloscan alourdissent la conversation ; Claude Code avertit au-delà de 10 000 jetons par réponse d’outil. Demandez des résultats filtrés.

Les données envoyées. Tout ce que renvoie Haloscan entre dans la conversation avec Claude. Pour des données publiques de positions, l’enjeu est faible. Pour les projets de vos clients, vérifiez ce que prévoient vos contrats.

Les chiffres à vérifier. Claude synthétise, il ne contrôle pas. Les volumes et le trafic estimés restent des estimations ; certains utilisateurs d’Haloscan jugent d’ailleurs le trafic organique peu fiable (retours cités sur notre fiche Haloscan). Pour un livrable client, recoupez dans l’interface.

Un serveur communautaire. Pas de support officiel, et pas de garantie qu’il suive les évolutions de l’API. La configuration ne fige aucune version : npx récupère le paquet publié sur npm, dont le code peut changer d’une version à l’autre sans que vous le voyiez. Votre clé API est aussi stockée en clair dans le fichier de configuration : ne le partagez pas.

Les outils d’écriture. create_project, update_project et delete_project modifient votre compte. Si vous n’en avez pas besoin, désactivez-les dans la liste des outils du connecteur.

Mon avis perso : commencez par des demandes étroites (un domaine, un filtre de positions, 20 lignes), regardez le compteur de crédits, puis élargissez. C'est la meilleure façon de garder la main sur ce que l'IA consomme.

Mon verdict : le MCP Haloscan, pour qui ? 🎯

  • Consultant SEO ou freelance sur Google France : oui. Vous avez déjà le Starter pour l’API, et le MCP transforme vos analyses répétitives (quick wins, écarts concurrentiels, idées de contenus) en demandes de quelques lignes.
  • E-commerçant qui suit son propre site : intéressant si vous êtes à l’aise avec un fichier de configuration. Le suivi de projet et les quick wins sont les usages les plus rentables.
  • Agence : utile pour préparer les points clients, mais encadrez l’usage : crédits partagés, données clients dans Claude, chiffres à relire avant envoi.
  • À éviter si vous êtes sur l’offre Free (pas d’API), si vous travaillez hors de France (Haloscan ne couvre que le marché français) ou si un serveur non officiel pose problème à votre client. Dans ce cas, un outil avec un MCP officiel sera plus rassurant (voir le duel Semrush vs Ahrefs).
Mon avis perso : le MCP Haloscan ne « change pas la dimension » du SEO, il change votre façon de lire les données. Lire une SERP entière, croiser des volumes, repérer ce qui manque aux 10 premiers résultats : tout cela tient en une question. La décision, elle, reste la vôtre, et les chiffres se vérifient dans l'interface. Si vous n'avez pas encore d'accès API, testez Haloscan avec l'offre gratuite, puis passez au Starter quand vous voudrez le brancher.

Pour aller plus loin

Questions fréquentes

Le MCP Haloscan est-il gratuit ?

Le serveur lui-même est gratuit et open source. En revanche, il passe par l’API Haloscan, qui demande une offre Starter ou supérieure (59 € HT par mois), et chaque appel décompte vos crédits mensuels.

Le MCP Haloscan est-il officiel ?

Non. Haloscan publie le tutoriel d’installation sur son site, mais le serveur a été créé bénévolement par un membre de la communauté. Il est distribué sur npm sous le nom @occirank/haloscan-server, sans support officiel de l’éditeur.

Où trouver sa clé API Haloscan ?

Dans votre compte Haloscan, page API (tool.haloscan.com/user/api), à condition d’avoir une offre Starter ou supérieure. L’offre gratuite ne donne pas accès à l’API.

Faut-il un abonnement Claude payant ?

Le tutoriel d’Haloscan mentionne Claude Pro ou Max, alors que la page tarifs de Claude ne réserve pas les serveurs locaux aux abonnés. En pratique, l’offre Pro est conseillée : les réponses d’Haloscan sont volumineuses et consomment vite le quota gratuit.

Le MCP Haloscan fonctionne-t-il avec ChatGPT ?

Ce n’est pas documenté. Le serveur est prévu pour tourner en local, dans Claude Desktop, Claude Code ou Cursor. ChatGPT accepte des serveurs MCP personnalisés, mais aucune procédure n’existe pour celui-ci : à réserver aux profils techniques prêts à tester.

Adrien

Adrien

Hello 👋 Dans le e-commerce et le marketing en ligne depuis plus de 15 ans, je partage ici mes découvertes, mes divers tests et expériences qui pourraient vous être utiles :) Au programme : e-business, tests d'outils et conseils actionnables rapidement.

Une question, un retour d'expérience ?

Votre e-mail ne sera pas publié.

Certains liens sont des liens partenaires : ils ne changent pas votre prix. Une info inexacte dans cet article ? Signalez-la-nous, nous corrigeons rapidement.

Ne ratez plus un article

Le meilleur de Heebiz dans votre boîte mail, sans spam.