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.

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.

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.

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é.

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éelle | Compteur débité | Résultats/exports |
|---|---|---|
| Questions sur un mot-clé (0 résultat) | 1 recherche de mots-clés | 0 |
Volumes de 8 mots-clés en une fois (get_keywords_bulk) | 1 recherche en masse | 8 |
Positions d’un domaine, 5 lignes (get_domains_positions) | 1 analyse de site | 5 |
| SERP complète d’un mot-clé | Recherche de mots-clés | 0 |
| Crédits restants | Aucun | 0 |
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érequis | Détail |
|---|---|
| Offre Haloscan | Starter 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 Haloscan | Dans votre compte, page API (tool.haloscan.com/user/api) |
| Node.js | Version LTS, à installer depuis nodejs.org : la configuration lance le serveur avec npx |
| Claude | Claude 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.

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" } } } }

É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ôme | Cause probable | Solution |
|---|---|---|
| « MCP haloscan: spawn npx ENOENT » | Node.js absent ou introuvable | Installer Node.js (LTS), puis quitter et relancer Claude Desktop |
| Le serveur n’apparaît pas dans Claude | JSON mal formé (virgule manquante ou en trop, guillemets typographiques) ou application pas vraiment redémarrée | Valider le fichier dans un vérificateur JSON, quitter complètement Claude, relancer |
| « API key not found » | Variable HALOSCAN_API_KEY absente ou mal nommée | Vé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 API | Recopier la clé depuis la page API, vérifier votre offre |
| Les réponses s’arrêtent en cours de mois | Un compteur de crédits est à zéro | Demander « mes crédits restants » pour voir lequel, attendre le renouvellement ou monter d’offre |
Échec sous Windows avec ${APPDATA} dans les journaux | Chemin non résolu | Ajouter 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.

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 ⚠️

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.

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
- Bien utiliser l’interface d’Haloscan avant d’automatiser : comment utiliser Haloscan.
- Le protocole, les offres Claude et les autres outils marketing branchables : notre guide MCP Claude.
- Être cité dans les réponses des IA, l’autre versant du sujet : notre guide du GEO.
- Les alternatives : le classement des outils SEO et le duel SE Ranking vs Semrush.
- Tous nos guides de la rubrique SEO.
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.