Serveur MCP pour le SEO avec des agents IA

Un serveur MCP local en stdio expose les mêmes outils à Claude Code, Claude Desktop, Codex, Cursor et d’autres clients MCP. L’enregistrement est présenté avant toute modification de fichier.

Ce qu'elle fait

Profils

--profile full expose tous les outils. Les profils audit, infra, quick-check et router en exposent des ensembles plus réduits pour des sessions ciblées, afin que l’agent voie moins de schémas. Le profil router n’annonce qu’un outil de diagnostic (doctor), l’inspection d’URL, le workflow d’audit et le catalogue d’outils ; l’agent trouve le reste via le catalogue. Un profil plus restreint bloque aussitôt les outils exclus, tandis qu’un client doit être redémarré pour voir les outils nouvellement activés.

  • audit : outils d’audit Screaming Frog bornés
  • infra : contrôles du domaine, du CDN, des technologies, de la sécurité, des en-têtes, de robots.txt et du sitemap
  • quick-check : contrôles rapides d’URL, y compris le contrôle par lot
  • seohead mcp status --json affiche le profil et le nombre exact d’outils

Enregistrement sécurisé

L’enregistrement passe d’abord par un plan. Lancez seohead mcp install avec --dry-run pour voir le bloc de configuration, le fichier qui serait modifié, le chemin de sauvegarde et le SHA-256 d’origine. Rien n’est écrit. Ajoutez --yes pour l’appliquer. La configuration du client est sauvegardée, remplacée de façon atomique puis analysée à nouveau, et les autres serveurs qu’elle contient sont conservés.

  • Clients : Claude Code, Claude Desktop, Codex et Cursor, au choix avec --client
  • --expected-sha256 refuse l’installation si le fichier a changé après l’aperçu
  • seohead mcp uninstall restaure la configuration depuis la sauvegarde
  • seohead mcp disable empêche le serveur d’accepter des appels

Des agents avec mémoire

Les projets conservent le périmètre, la politique de crawl, les scans et l’historique : le prochain agent reprend donc le projet enregistré, et non la conversation. La boîte de réception du projet conserve les notes du spécialiste et les objectifs proposés. Un hôte peut aussi restreindre un processus MCP à un nom de consommateur et à une liste de dossiers de projets autorisés.

  • workflow-status indique à un nouvel agent la prochaine étape enregistrée
  • Les écritures prennent la révision courante et échouent en cas de conflit
  • Les opérations payantes exigent une confirmation explicite, par exemple confirm_paid=true

Trois étapes, un seul scan enregistré

  1. Prévisualiser l’enregistrement

    Lancez d’abord l’installation avec --dry-run. Elle affiche le bloc de configuration exact, le fichier qu’elle modifierait, un chemin de sauvegarde et un sha256, sans rien écrire.

  2. Installer avec --yes

    Une fois le plan lu, ajoutez --yes. La configuration précédente est sauvegardée à côté, et --expected-sha256 refuse l’installation si le fichier a changé après l’aperçu.

  3. Les agents reprennent le projet enregistré

    Les projets conservent le périmètre, la politique de crawl, les scans et l’historique. Le prochain agent reprend le projet enregistré au lieu de repartir de la conversation.

Contrôles de cette fonctionnalité

ContrôleSignificationGravitéPreuve
REDIRECT_LOOPUne chaîne de redirections revient à une URL déjà visitée, et ne se stabilise donc jamaisCriticalChemin de boucle issu de la chaîne de redirections (export SF Redirect Chains, ou enregistrements des sauts d’un crawl natif)
BROKEN_INTERNAL_LINKUn lien interne pointe vers une URL qui renvoie un code 4xxCriticalLiens entrants en erreur client (4xx) : page source et position du lien
REDIRECT_CHAINPlus d’une redirection avant l’URL finaleImportantChaque saut, avec son code de statut et son en-tête Location
INTERNAL_LINK_TO_REDIRECTUn lien interne pointe vers une URL 3xx au lieu de la page finaleImportantLiens entrants en redirection (3xx) : page source et position dans le DOM
BAD_REDIRECT_TYPEUn 302, 303 ou 307 est utilisé alors qu’un déplacement permanent était vouluTipCode de statut pour chaque saut

Une seule commande

bash
claude mcp add seohead -- /absolute/path/to/spiderhead/.venv/bin/seohead mcp

Commencez par installer : guide d'installation. Chaque commande fonctionne aussi comme outil MCP pour les agents IA.

Ce qu'il vous faut

  • Un client MCP : Claude Code, Claude Desktop, Codex, Cursor ou tout client stdio
  • L’exécutable seohead d’un environnement virtuel, avec son chemin absolu
  • L’extra mcp du toolkit installé
  • Clés des fournisseurs uniquement pour les outils payants ou soumis à un compte

Limites

  • Il s’agit d’un serveur stdio local. Il n’existe pas de point d’accès MCP hébergé
  • Il n’existe pas encore de journal des appels : conservez votre propre journal si vous avez besoin d’une piste d’audit
  • Les outils peuvent envoyer des requêtes quand vous lancez un contrôle ou un crawl. Le catalogue indique lesquels
  • Ajouter l’entrée n’active pas MCP par lui-même, et toute écriture exige --yes

Questions

L’enregistrement du serveur modifie-t-il ma configuration ?
Pas en mode aperçu. --dry-run n’écrit rien et affiche le fichier qui serait modifié (pour Claude Code, ~/.claude.json), un chemin de sauvegarde et un sha256. La modification n’intervient qu’avec --yes.
Quels clients sont pris en charge ?
Claude Code, Claude Desktop, Codex et Cursor, à choisir avec --client. Tout autre client MCP peut utiliser la même commande de serveur stdio.
Combien d’outils un agent voit-il ?
Cela dépend du profil. Le profil full expose tous les outils enregistrés, et audit, infra, quick-check et router en exposent beaucoup moins. Lancez seohead mcp status --json pour voir le nombre exact d’outils de chaque profil dans votre installation.
Le serveur fonctionne-t-il dans le cloud ?
Non. C’est un processus stdio local. Les requêtes réseau ne partent que pour les contrôles que vous déclenchez, comme une URL ou un crawl. Un crawl écrit son scan dans ./scans/ par défaut.
Un agent peut-il dépenser mon argent ?
Pas à votre insu. Les opérations payantes exigent une confirmation explicite (confirm_paid=true) et vos propres clés de fournisseur. tool-catalog signale les outils qui peuvent engager des dépenses.
Comment le désactiver ?
Lancez seohead mcp disable. Un serveur en cours d’exécution rejette alors les appels d’outils suivants. uninstall retire l’entrée de la configuration d’un client et la restaure depuis la sauvegarde.