RankFlow SEO — MCP

Serveur MCP qui expose l'audit on-page et le scoring RankFlow (le meme que l'extension Chrome, computeScore porte verbatim) a n'importe quel agent IA : Claude Code, Claude Desktop, etc.

But : donner a l'agent la data SEO d'une page directement, sans copier-coller, pour qu'il note et optimise avec ta methodo a toi.

Ce que fait la v0.3

Outil rankflow_audit_page(url, { keyword, pagespeed, checkLinks, resources }) :

• Couverture semantique SERP (v0.6, si keyword fourni) : scrape le top-N de la SERP gratuitement (DuckDuckGo, fallback Bing), analyse le vocabulaire des pages concurrentes, et renvoie le champ semantic = pourcentage de couverture + liste des mots/expressions a ajouter (avec le nombre de pages du top-N ou chacun apparait). La couverture nourrit aussi le score.
• Recupere le HTML de l'URL (analyse statique, sans rendu JS).
• Extrait : title, meta, canonical, lang, OG/Twitter, robots, arborescence Hn, word count (hors nav/footer), liens internes/externes + nofollow interne, images sans alt, densite de mots-cles, types JSON-LD, viewport.
• Calcule le score /100 RankFlow : 5 categories (Technique 25, Meta & SERP 15, Contenu 30, Liens 20, Perf 10), malus (max -20), caps bloquants (noindex, canonical externe, thin content), bonus Excellence.
• Calcule le score GEO / AI-readiness /10 : citabilite par ChatGPT, Claude, Perplexity, AI Overviews. 4 piliers (clarte, FAQ, donnees structurees, differenciation), detection du type de page, actions concretes.
• Modules qualite portes verbatim de l'extension : Helpful/profondeur, E-E-A-T (expertise/autorite/confiance), intention SEO, lisibilite, scanabilite, sur-optimisation (densite + ancres + titres), risque Core Update, detection de contenu IA.
• Core Web Vitals reels via PageSpeed Insights (LCP, CLS, Speed Index, INP terrain). Necessite une cle API gratuite (voir plus bas), sinon Google limite les requetes sans cle.
• Liens casses : echantillon des liens internes teste en HTTP (cape a 15).
• Renvoie les verdicts (Optimal / Solide / Passable / Insuffisant / Critique), le detail par critere et des recommandations priorisees.

Cle PageSpeed (Core Web Vitals reels)

Sans cle, Google renvoie souvent une erreur 429 (quota) et la categorie Perf reste neutre. Pour activer les CWV reels :

1. Cree une cle gratuite : https://developers.google.com/speed/docs/insights/v5/get-started (API PageSpeed Insights).
2. Exporte-la : export RANKFLOW_PSI_KEY="ta_cle" (ou dans la config MCP via env).

Installation pour les utilisateurs (une fois publie sur npm)

Guide pas a pas (Claude Code, Claude Desktop, Cursor) : voir INSTALLATION.md.

En une commande dans Claude Code :

claude mcp add rankflow-seo -- npx -y rankflow-mcp

Publication sur npm (a faire une fois)

cd rankflow-mcp
npm login                 # compte npm de Vincent
npm publish --access public

Verifier avant publication que le nom rankflow-mcp est libre (npm view rankflow-mcp). Sinon, publier en scope : @vincenthego/rankflow-mcp (ajuster name dans package.json et la commande d'install).

Developpement local (Vincent)

cd rankflow-mcp
npm install               # Node >= 18 (Node 20 via nvm)
node src/cli.js https://www.vincenthego.com/     # test CLI

Deja enregistre en local au scope user (chemin Node 20 absolu pour eviter le conflit Node Anaconda) :

claude mcp add rankflow-seo -s user -- \
  /Users/vincenthego/.nvm/versions/node/v20.20.2/bin/node \
  /Users/vincenthego/vincenthego.com/rankflow-mcp/src/server.js

Une fois le paquet publie, remplacer cet enregistrement local par la version npx ci-dessus.

Limite connue (v0.1)

Analyse statique : les pages 100 % rendues en JavaScript (React/Next, certaines landing) renvoient peu de contenu dans le HTML brut, donc un score sous-evalue. Deux pistes de contournement (roadmap).

Plan d'action commercialisation

Phase 1 - Distribution facile (maintenant, gratuit). Publier sur npm -> installation en une commande npx partout, y compris environnements cloud. Guide INSTALLATION.md fourni. Cible : SEO et devs qui ont deja Claude Code / Cursor.

Phase 2 - Fidelite du score (on-page pur). FAIT (v0.4) : GEO / AI-readiness, Helpful, E-E-A-T, intention, lisibilite, scanabilite, sur-optimisation, risque Core Update, detection contenu IA, Core Web Vitals reels (PageSpeed), liens casses, poids de page + images lourdes, robots.txt + sitemap.xml, CMS/technologie/contact, hreflang valide, distribution des ancres, taille HTML, plan d'actions chiffre, SWOT. Reste uniquement : couverture semantique SERP (People Also Ask, sujets manquants, score semantique concurrents) qui necessite un scraper SERP (tier a part).

Phase 3 - Rendu JS. Option Playwright/headless a la demande pour bien noter les sites React/Next.

Phase 4 - MCP distant heberge (grand public). Heberger le serveur en remote (HTTP/SSE) + authentification + facturation, pour que des non-devs l'ajoutent via une simple URL + cle. C'est la version "produit" a large audience.

Option premium - Pont navigateur. Lire la vraie page rendue dans le Chrome de l'utilisateur via l'extension RankFlow (pages privees, staging, Web Vitals live).