Hugo SEO Linking Agent
Analyzes and optimizes internal linking for a Hugo static site, auditing the site's link graph for orphan or under-linked pages, indexing content to find semantic link opportunities, and updating Hugo Markdown source files without altering front matter.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Hugo SEO Linking Agentaudit my Hugo site's internal links and list orphan pages"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Hugo SEO Linking Agent (Serveur MCP)
Un agent IA sous forme de serveur MCP (Model Context Protocol) permettant Ă Claude (Desktop ou Code) d'analyser, d'optimiser et d'automatiser le maillage interne d'un site statique Hugo.
🚀 Fonctionnalités
Analyse de graphe (NetworkX) : cartographie tous les liens internes existants et repère automatiquement les pages orphelines ou sous-maillées.
Recherche sémantique (ChromaDB) : vectorise le contenu paragraphe par paragraphe pour trouver les meilleures opportunités de liens contextuels.
Mise Ă jour automatique : permet Ă l'agent de modifier directement les fichiers Markdown
.mdsources sans altérer le front matter.
Related MCP server: Noleemits Vision Builder MCP
🛠️ Prérequis & installation
Python 3.10 ou supérieur
Un projet Hugo avec un dossier
content/
Installation via plugin Claude Code
/plugin marketplace add lgrdev/mcp_seo_hugo
claude plugin install lgrdev-mcp-seo@lgrdev-mcp-seo
pip install -r requirements.txtL'installation du plugin déclare le serveur MCP automatiquement dans Claude Code ; les dépendances Python restent à installer manuellement (le système de plugins ne gère pas les dépendances Python).
Si pip install est oublié, le serveur MCP refuse de démarrer et les commandes apparaissent sans outils. Le message dans les logs MCP indique alors la dépendance manquante et le chemin exact du requirements.txt à installer.
Installation manuelle
sudo apt update
sudo apt install -y build-essential python3-dev python3-pip python3-venv
pip install -r requirements.txtoutils MCP exposés
Outil MCP | Description |
sync_and_get_site_audit | Analyse le graphe du site, indexe le contenu dans ChromaDB et génère le rapport HTML dans |
find_link_opportunities | Cherche dans la base vectorielle les paragraphes les plus pertinents pour mailler vers une page cible. |
update_markdown_paragraph | Remplace proprement un paragraphe dans le fichier .md d'origine avec l'ancre insérée par l'IA. |
generate_proposals_report | Génère |
apply_approved_proposals | Applique uniquement les propositions cochées |
archive_proposals_report | Archive le rapport dans |
repair_content_encoding | Répare les fichiers Markdown dont l'UTF-8 est cassé. |
get_index_status | Lecture seule : index à jour ou décalé, modèle utilisé, fichiers illisibles, propositions en cours. Ne charge pas le modèle. |
Premier lancement : le modèle d'embeddings multilingue (
paraphrase-multilingual-MiniLM-L12-v2, adapté au contenu français) est téléchargé automatiquement (~500 Mo avec torch).
Commandes
Commande | Description |
| Initialise l'index SEO et audite le maillage interne (première utilisation). |
| Resynchronise l'index après modification d'articles dans |
| Boucle de validation : génère les propositions de liens, applique celles cochées |
| État de l'index et du contenu, sans rien modifier. Indique la prochaine action utile. |
| Répare l'encodage des fichiers Markdown cassés (simulation d'abord, puis réparation avec sauvegarde). |
| Maille une page précise : cherche les meilleurs paragraphes d'accueil et insère le lien après validation. |
init-seo et sync-seo appellent le même outil : le premier passage encode tout le contenu, les suivants sont incrémentaux.
Tests
pip install -r requirements-dev.txt
pytestLes tests couvrent la logique pure (ancres, parsing du rapport de propositions, résolution des liens internes, filtres de contenu, garde-fous d'écriture). fastmcp et chromadb sont remplacés par des stubs dans tests/conftest.py, donc l'installation de test reste légère (pas de torch).
This server cannot be deployed
Maintenance
Related MCP Connectors
Live SEO workflow tools for Claude Code, Codex, and AI agents.
Read, edit, publish, and preview your pepita websites from Claude.
- platform7nOAuthtech.p7n
Connect Claude to your Platform7n workspaces — chat, links, and tasks. One-click OAuth.
Run SEO + AI-visibility (GEO) audits from Claude, Cursor & other AI clients.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceConnects Claude Desktop to Obsidian vaults to enable reading, writing, searching, and intelligent organization of markdown notes. It features pre-configured structures for personal and family data management through natural conversation.2-
- AlicenseBqualityDmaintenanceConnects Claude Desktop to WordPress sites to manage Elementor pages, Gutenberg content, and Rank Math SEO settings. It enables users to create styled pages, manage section layouts, and perform content updates through natural language commands.395 npmGPL 2.0
- FlicenseAqualityCmaintenanceEnables Claude Desktop to perform advanced web scraping and crawling operations, extracting structured data, analyzing website architectures, and discovering content relationships through natural conversation.54-
- AlicenseNot gradedqualityCmaintenanceEnables Claude to perform full SEO audits on unpublished HTML, Markdown, or Word documents, including keyword analysis, meta tag suggestions, readability scoring, and heading structure validation.8 npmMIT