Nouvelle étudeTechnical SEO & AI Search · 2027Découvrir le framework

Connecter Crawlens à Claude et aux autres outils IA

Crawlens intègre un serveur MCP. Une fois connecté, l’application IA que vous utilisez déjà peut lire vos crawls et vos audits, expliquer les problèmes, prioriser les corrections et rédiger des tickets. Le tout avec votre propre abonnement IA, sans clé API.

L’interface de Crawlens n’existe pour l’instant qu’en anglais. Les noms des réglages, boutons, outils et prompts restent donc en anglais ici, pour que vous les retrouviez tout de suite dans l’application.

Compatible avecClaude DesktopClaude CodeCodexCursorVS Codeet les autres applications MCP

À quoi il sert

MCP (Model Context Protocol) est la façon standard dont les applications IA utilisent des outils externes. Quand votre application IA a besoin de données de Crawlens, elle lance le serveur MCP de Crawlens sur votre ordinateur. Le serveur lit vos crawls et audits enregistrés et renvoie des résultats compacts, paginés.

  • Lecture seule. Il ne peut ni lancer de crawl, ni modifier les réglages, ni rien supprimer.
  • Local. Il tourne sur votre ordinateur et n’ouvre aucun port réseau. Crawlens lui-même n’envoie rien en ligne.
  • Crawlens n’a pas besoin d’être ouvert. L’application IA démarre le serveur à la demande avec l’environnement d’exécution de Crawlens. Inutile d’installer Node.js.

1. L’activer dans Crawlens

Le partage est désactivé par défaut. Les outils IA ne voient rien tant que vous ne l’activez pas.

  1. Ouvrez Crawlens et allez dans Settings → Integrations → AI tools (MCP).
  2. Activez Share audits with AI tools.
  3. Sous Projects AI tools can read, gardez All projects, ou choisissez Only these projects.
  4. Facultatif : activez Hide Search Console and Analytics data pour que les clics, impressions, sessions et résultats d’inspection d’URL restent invisibles pour les outils IA.

Il vous faut au moins un projet avec un crawl audité. Si vous n’avez encore rien crawlé, commencez par là : d’ici là, l’IA n’a rien à lire.

2. Connecter votre outil IA

Dans la même carte de réglages, chaque application a un bouton Copy setup for. Utilisez-le : il insère les chemins exacts de votre installation. Les extraits ci-dessous montrent à quoi ressemble cette configuration, avec des chemins d’exemple.

Claude Desktop

  1. Cliquez sur Add to Claude Desktop.
  2. Quittez Claude Desktop et rouvrez-le. Fermer la fenêtre ne suffit pas : quittez l’application depuis la zone de notification de la barre des tâches.
  3. Dans une nouvelle conversation, ouvrez le menu des outils. crawlens doit y figurer.

Crawlens s’ajoute à claude_desktop_config.json en conservant vos autres serveurs MCP. Si le fichier existe déjà, Crawlens enregistre d’abord une sauvegarde datée à côté. La version classique de Claude Desktop et celle du Microsoft Store sont toutes deux prises en charge.

Vous préférez modifier la configuration vous-même ?

Ajoutez ceci à %APPDATA%\Claude\claude_desktop_config.json, en le fusionnant avec les mcpServers éventuellement présents :

{
  "mcpServers": {
    "crawlens": {
      "command": "C:\\path\\to\\Crawlens.exe",
      "args": ["C:\\path\\to\\resources\\mcp\\server.mjs", "--user-data", "C:\\Users\\you\\AppData\\Roaming\\Crawlens"],
      "env": { "ELECTRON_RUN_AS_NODE": "1" }
    }
  }
}

Claude Code

  1. Cliquez sur Copy setup for → Claude Code.
  2. Collez la commande dans un terminal et exécutez-la.
  3. Lancez claude et exécutez /mcp pour vérifier que crawlens est connecté.

La commande enregistre Crawlens pour votre compte utilisateur (--scope user), il est donc disponible dans tous vos projets :

claude mcp add crawlens --scope user --env ELECTRON_RUN_AS_NODE=1 -- "C:\path\to\Crawlens.exe" "C:\path\to\resources\mcp\server.mjs" --user-data "C:\Users\you\AppData\Roaming\Crawlens"

Codex

Une seule configuration couvre la CLI Codex, l’extension pour IDE et l’application.

  1. Cliquez sur Copy setup for → Codex.
  2. Collez-la à la fin de ~/.codex/config.toml (créez le fichier s’il n’existe pas).
  3. Redémarrez Codex.
[mcp_servers.crawlens]
command = 'C:\path\to\Crawlens.exe'
args = ['C:\path\to\resources\mcp\server.mjs', '--user-data', 'C:\Users\you\AppData\Roaming\Crawlens']

[mcp_servers.crawlens.env]
ELECTRON_RUN_AS_NODE = '1'

La configuration copiée contient aussi, en commentaire, la commande codex mcp add … équivalente, si vous préférez l’exécuter.

Cursor

  1. Cliquez sur Copy setup for → Cursor.
  2. Ouvrez ~/.cursor/mcp.json et collez-la. Si le fichier contient déjà des serveurs, ajoutez l’entrée crawlens dans les mcpServers existants.
  3. Vérifiez Cursor Settings → MCP : crawlens doit apparaître comme activé.
{
  "mcpServers": {
    "crawlens": {
      "command": "C:\\path\\to\\Crawlens.exe",
      "args": ["C:\\path\\to\\resources\\mcp\\server.mjs", "--user-data", "C:\\Users\\you\\AppData\\Roaming\\Crawlens"],
      "env": { "ELECTRON_RUN_AS_NODE": "1" }
    }
  }
}

VS Code

  1. Cliquez sur Copy setup for → VS Code.
  2. Collez-la dans .vscode/mcp.json dans votre espace de travail. Vous pouvez aussi exécuter MCP: Add Server depuis la palette de commandes.
  3. Ouvrez Copilot Chat en mode Agent et cherchez crawlens dans la liste des outils.
{
  "servers": {
    "crawlens": {
      "type": "stdio",
      "command": "C:\\path\\to\\Crawlens.exe",
      "args": ["C:\\path\\to\\resources\\mcp\\server.mjs", "--user-data", "C:\\Users\\you\\AppData\\Roaming\\Crawlens"],
      "env": { "ELECTRON_RUN_AS_NODE": "1" }
    }
  }
}

Autres applications MCP : tout ce qui prend en charge les serveurs MCP stdio fonctionne. Utilisez la même commande, les mêmes arguments et la même variable d’environnement ELECTRON_RUN_AS_NODE=1 que ci-dessus.

3. Tester la connexion

Dans Crawlens, cliquez sur Test connection. Crawlens démarre le serveur exactement comme le fera votre application IA et indique ce qu’il a trouvé, par exemple :

Working: 8 tools, 3 prompts · 2 projects shared

Si le test réussit mais que votre application IA n’affiche pas Crawlens, le problème vient de l’application. Redémarrez-la et consultez le dépannage.

Quoi demander

Désignez votre projet par son nom ou son domaine. Vous pouvez poser vos questions en français. Quelques prompts qui marchent bien :

Résume le dernier audit Crawlens de example.com et donne-moi une liste de corrections priorisée.
Écris de nouveaux titles pour les pages qui n’en ont pas.
Explique les chaînes de redirection à notre développeur.
Qu’est-ce qui s’est dégradé depuis le dernier crawl ?
Quelles pages reçoivent des clics depuis la recherche mais renvoient des erreurs ou sont en noindex ?
Trouve les pages indexables en positions 11 à 20 et propose comment les faire passer en première page.

Outils & prompts

Voici ce que voit votre application IA. Les résultats sont paginés (50 lignes par défaut) pour que les gros sites ne saturent pas la conversation.

OutilCe qu’il renvoie
list_projectsLes projets partagés par Crawlens, avec leur dernier crawl.
list_crawlsLes crawls d’un projet, du plus récent au plus ancien, avec le score de santé et le nombre de problèmes.
get_overviewLe résumé d’un crawl audité : score de santé, problèmes par gravité, principaux problèmes, codes de statut, indexabilité, Core Web Vitals et totaux Search Console, Analytics et logs serveur quand ils existent.
list_issuesChaque contrôle en échec : ce qu’il signifie, comment le corriger et combien d’URL sont concernées (les plus graves en premier).
get_issue_urlsLes URL touchées par un problème, avec le détail pour chacune.
query_urlsFiltrer, trier et parcourir les URL crawlées comme dans le tableau des URL, colonnes Search Console, GA4 et extraction personnalisée comprises.
get_url_detailsTout sur une URL : champs SEO, problèmes, liens, redirections, en-têtes, données structurées, HTML brut ou rendu, Core Web Vitals et données de recherche.
compare_crawlsCe qui a changé entre deux crawls : score de santé, problèmes nouveaux et corrigés par contrôle, et changements d’URL.

Des prompts prêts à l’emploi apparaissent dans le menu des prompts ou des commandes slash de votre application IA, quand elle le permet :

PromptCe qu’il fait
Summarise the audit & prioritise fixesUne synthèse du dernier audit et un plan de corrections classé par impact et par effort, avec un responsable et des URL d’exemple pour chaque point.
Rewrite titles & meta descriptionsDe nouveaux titles (30–60 caractères) et descriptions (70–160) pour les pages qui ont des problèmes de title ou de description, chacun dans la langue de la page.
Explain an issue for developersUn problème expliqué avec les vraies URL et valeurs de ce site : cause, vérification, correction et une checklist.

Confidentialité & sécurité

  • Désactivé tant que vous ne l’activez pas, et désactivable à tout moment. Le serveur refuse alors toute requête.
  • Lecture seule. Le serveur ouvre vos données en lecture seule. Il ne peut ni crawler, ni modifier les réglages, ni rien supprimer.
  • Aucun port réseau. Il communique avec votre application IA uniquement par l’entrée et la sortie standard, sur votre ordinateur.
  • Vous choisissez ce qui est visible : tous les projets ou seulement certains, avec ou sans les données Search Console et Analytics.

Crawlens n’envoie rien en ligne, mais votre application IA envoie ce qu’elle lit à son propre service d’IA, dans le cadre de la conversation. Ce sont alors les règles de confidentialité de l’application IA qui s’appliquent : vérifiez-les avant de partager des données de clients.

Dépannage

Crawlens n’apparaît pas dans mon application IA
Redémarrez complètement l’application après la configuration. Claude Desktop continue de tourner dans la zone de notification : quittez-le depuis là. Pour Cursor et VS Code, vérifiez que le JSON est toujours valide après le collage : une virgule manquante rend tout le fichier inutilisable.
« Sharing audits with AI tools is turned off »
Activez Share audits with AI tools dans Settings → Integrations → AI tools (MCP).
« No shared project matches … »
Le projet ne figure pas dans la liste que les outils IA peuvent lire, ou son nom ne correspond pas. Le message d’erreur liste les projets disponibles. Ajoutez le projet sous Projects AI tools can read, ou reformulez votre question avec l’un de ces noms.
« This project has no audited crawl yet »
Crawlez d’abord le site dans Crawlens. L’IA lit des audits : elle a besoin d’au moins un crawl terminé et audité.
« This data was saved by an older Crawlens »
Ouvrez une fois le projet dans Crawlens. Ses données sont alors mises à jour et l’application IA peut de nouveau les lire.
Ça ne marche plus depuis que j’ai déplacé ou réinstallé Crawlens
La configuration contient le chemin de Crawlens.exe. Copiez à nouveau la configuration depuis Crawlens (ou cliquez de nouveau sur Add to Claude Desktop) pour que les chemins soient à jour. Déplacer le dossier de données depuis Crawlens ne pose en revanche aucun problème : le serveur le suit automatiquement.
« … is not valid JSON, so Crawlens left it untouched »
Votre claude_desktop_config.json contenait déjà une erreur de syntaxe, Crawlens ne l’a donc pas modifié. Corrigez ou supprimez le fichier, puis cliquez à nouveau sur Add to Claude Desktop.

Vous n’avez pas encore Crawlens ?

Téléchargez-le, crawlez un site, puis revenez ici pour connecter vos outils IA.

Télécharger gratuitement pour Windows