creavores-aeo-mcp
v1.0.1
Published
MCP server for AEO/AI-search audits: direct-answer detection, JSON-LD validation, llms.txt compliance, E-E-A-T signals, agentic-browsing readiness, and AI citation simulation for any URL.
Downloads
274
Maintainers
Readme
creavores-aeo-mcp
An MCP (Model Context Protocol) server that audits any URL for AEO (Answer Engine Optimization) and AI-search readiness — a practical diagnostic tool, not a gadget. It checks the same things ChatGPT, Perplexity, Google AI Overviews, and agentic browsers actually look for: a citable direct answer, valid JSON-LD, llms.txt compliance, E-E-A-T trust signals, and whether AI crawlers/agents can read and navigate the page at all.
Built by Les Créavores, a web & SEO/AEO agency. The scoring logic is compatible with (and extends) the public @macalc/aeo-score package and the free AEO audit tool — scores you get here match what you'd see there.
Installation
No install step needed — run it directly with npx:
npx creavores-aeo-mcpClaude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"creavores-aeo": {
"command": "npx",
"args": ["-y", "creavores-aeo-mcp"]
}
}
}Claude Code
claude mcp add creavores-aeo -- npx -y creavores-aeo-mcpOr add it to .mcp.json at the root of your project:
{
"mcpServers": {
"creavores-aeo": {
"command": "npx",
"args": ["-y", "creavores-aeo-mcp"]
}
}
}No API key, no configuration, no environment variables required. The server fetches pages directly with a self-identifying User-Agent (creavores-aeo-mcp/1.0 (+https://lescreavores.fr)), a 15-second timeout, and never throws — every tool returns clean JSON (including { "error": "..." } on failure) so it's safe to call from any agent loop.
Tools
1. audit_aeo
Full AEO audit: crawlability (30 pts) + content structure for AI extraction (35 pts) + E-E-A-T trust (35 pts), plus llms.txt and AI-bot access checks. Returns a 0-100 score, a verdict, and prioritized recommendations.
{ "url": "https://example.com/pricing" }→ { score: 78, verdict: "good", subScores: {...}, topRecommendations: [...], issues: [...] }
2. check_direct_answer
Detects a 40-60 word direct-answer paragraph right under the H1 — the strongest single citability signal for AI engines.
{ "url": "https://example.com/pricing" }3. extract_structured_data
Extracts and validates every JSON-LD block: types found, parse errors, common schema.org mistakes (missing acceptedAnswer, missing datePublished, etc.), and confirms the data ships server-side (not injected client-side via useEffect, which many AI crawlers never execute).
{ "url": "https://example.com/pricing" }4. check_llms_txt
Checks existence and llmstxt.org spec compliance: H1 title, blockquote summary, ## Section headings, and Markdown link list items.
{ "domain": "example.com" }5. check_eeat_signals
Byline/author, publish/modified dates, source citations, About/Methodology page links, legal-notice links, Organization schema.
{ "url": "https://example.com/blog/article" }6. check_agentic_readiness
Differentiator tool, aligned with Lighthouse's new "Agentic Browsing" audit category: is this page readable and navigable by an AI agent (not just a search crawler)? Checks llms.txt, AI-crawler access in robots.txt, heading hierarchy, image alt-text coverage, ARIA landmarks, viewport meta, and canonical.
{ "url": "https://example.com/app" }7. simulate_ai_citation
Simulates how an AI engine would extract a citable passage: scans paragraphs, list items, table rows, and FAQ answers, scores each for self-containedness, and returns the single passage most likely to be quoted — with an explanation of why (or why not).
{ "url": "https://example.com/blog/article" }8. compare_aeo
Compares 2-3 URLs' AEO scores side by side — use it to benchmark yourself against a competitor.
{ "urls": ["https://example.com", "https://competitor.com"] }About
Made by Les Créavores, a French web & SEO/AEO agency (Metz, France & Luxembourg). We build the tools we use ourselves — see the free AEO audit tool (same scoring engine, browser version) and the website pricing barometer (open dataset, CC-BY).
creavores-aeo-mcp (Français)
Un serveur MCP (Model Context Protocol) qui audite n'importe quelle URL pour l'AEO (Answer Engine Optimization) et la préparation aux moteurs de recherche IA — un outil de diagnostic concret, pas un gadget. Il vérifie exactement ce que regardent ChatGPT, Perplexity, les AI Overviews de Google et les agents de navigation autonomes : une réponse directe citable, des données structurées JSON-LD valides, la conformité du fichier llms.txt, les signaux de confiance E-E-A-T, et la capacité des robots/agents IA à lire et naviguer réellement la page.
Développé par Les Créavores, une agence web et SEO/AEO. La logique de scoring est compatible avec le package public @macalc/aeo-score et l'outil gratuit d'audit AEO en ligne — les scores obtenus ici correspondent à ceux affichés là-bas.
Installation
Aucune étape d'installation nécessaire — lancez-le directement avec npx :
npx creavores-aeo-mcpClaude Desktop
Ajoutez ceci à votre claude_desktop_config.json :
{
"mcpServers": {
"creavores-aeo": {
"command": "npx",
"args": ["-y", "creavores-aeo-mcp"]
}
}
}Claude Code
claude mcp add creavores-aeo -- npx -y creavores-aeo-mcpOu ajoutez-le dans le fichier .mcp.json à la racine de votre projet :
{
"mcpServers": {
"creavores-aeo": {
"command": "npx",
"args": ["-y", "creavores-aeo-mcp"]
}
}
}Aucune clé API, aucune configuration ni variable d'environnement requise. Le serveur récupère les pages directement avec un User-Agent identifiable (creavores-aeo-mcp/1.0 (+https://lescreavores.fr)), un délai d'attente de 15 secondes, et ne lève jamais d'exception non gérée : chaque outil renvoie un JSON propre (y compris { "error": "..." } en cas d'échec), ce qui le rend sûr à appeler depuis n'importe quelle boucle d'agent.
Les 8 outils
1. audit_aeo
Audit AEO complet : crawlabilité (30 pts) + structure du contenu pour l'extraction IA (35 pts) + confiance E-E-A-T (35 pts), plus vérification du llms.txt et de l'accès des robots IA. Renvoie un score sur 100, un verdict et des recommandations priorisées et actionnables.
{ "url": "https://exemple.fr/tarifs" }2. check_direct_answer
Détecte une réponse directe de 40 à 60 mots placée juste sous le H1 — le signal de citabilité le plus fort pour les moteurs IA.
{ "url": "https://exemple.fr/tarifs" }3. extract_structured_data
Extrait et valide chaque bloc JSON-LD : types trouvés, erreurs de parsing, erreurs courantes du schéma (par exemple acceptedAnswer ou datePublished manquants), et confirme que les données sont bien présentes côté serveur (et non injectées côté client via useEffect, que de nombreux robots IA n'exécutent jamais).
{ "url": "https://exemple.fr/tarifs" }4. check_llms_txt
Vérifie l'existence et la conformité à la spécification llmstxt.org : titre H1, résumé en citation, sections ## Titre, et liste de liens au format Markdown.
{ "domain": "exemple.fr" }5. check_eeat_signals
Signature/auteur, dates de publication et de mise à jour, citations de sources, liens vers une page À propos/Méthodologie, liens vers les mentions légales, schéma Organization.
{ "url": "https://exemple.fr/blog/article" }6. check_agentic_readiness
Outil différenciant, aligné sur la nouvelle catégorie d'audit Lighthouse « Agentic Browsing » : cette page est-elle lisible et navigable par un agent IA (pas seulement un robot d'indexation classique) ? Vérifie le llms.txt, l'accès des robots IA dans le robots.txt, la hiérarchie des titres, la couverture des attributs alt sur les images, les repères ARIA, la balise viewport et l'URL canonique.
{ "url": "https://exemple.fr/application" }7. simulate_ai_citation
Simule la façon dont un moteur IA extrairait un passage citable : analyse les paragraphes, les listes, les tableaux et les réponses de FAQ, note chacun selon son autonomie de sens (auto-suffisance), et renvoie le passage le plus susceptible d'être cité — avec une explication du pourquoi (ou du pourquoi pas).
{ "url": "https://exemple.fr/blog/article" }8. compare_aeo
Compare les scores AEO de 2 à 3 URL côte à côte — utile pour se comparer directement à un concurrent.
{ "urls": ["https://exemple.fr", "https://concurrent.fr"] }À propos
Développé par Les Créavores, une agence web et SEO/AEO basée à Metz, en France, avec une activité au Luxembourg. Nous construisons les outils que nous utilisons nous-mêmes : découvrez l'audit AEO gratuit (même moteur de scoring, version navigateur) et le baromètre des prix de création de site internet (jeu de données ouvert, licence CC-BY).
Une question, une suggestion, une envie de faire auditer votre site par une équipe humaine plutôt qu'un score automatisé ? Écrivez-nous via lescreavores.fr.
