Identifiez les meilleurs spots netlinking selon leur performance Google réelle, analysez vos positions et générez des rapports SEO — directement depuis votre assistant IA, sans aucune installation technique.

Vue d'ensemble

Ce serveur MCP permet aux utilisateurs de Référencime d'accéder à leurs données SEO directement dans Claude ou ChatGPT. Les outils sont générés dynamiquement depuis l'API WordPress via OpenAPI.

Cas d'usage principaux

Netlinking data-driven — Classez les spots par performance Google réelle dans votre thématique (pas des métriques théoriques manipulables)
Bilan SEO mensuel — Générez des rapports structurés avec comparaisons M-1 / N-1, par catégorie
Suivi de positions — Détectez les changements significatifs, entrées/sorties du Top 10
Analyse concurrentielle — Suivez les mouvements de vos concurrents dans les SERP

Architecture

WordPress (plugin Easy Links)
    │
    ├── openapi.yaml ──────────────────────────────► ChatGPT
    │   (compilé en JSON : /wp-json/easy-links/v1/openapi.json)     (import direct)
    │
    └── openapi.json ──► server.js (Node.js) ──SSE──► Claude
                         (génère les outils MCP        (connecteur remote)
                          dynamiquement au démarrage)

Claude se connecte via SSE à https://mcp.referencime.fr/sse
ChatGPT importe le schéma OpenAPI directement depuis WordPress
Les outils sont auto-générés depuis l'OpenAPI — ajouter un endpoint WordPress le rend disponible dans l'IA après reconnexion (cache 1h)

Configuration pour l'utilisateur final

Claude (Pro, Max, Team, Enterprise)

Dans le dashboard WordPress → Analyse IA
Générer une clé API
Ouvrir claude.ai/settings/connectors
Coller l'URL unique :

https://mcp.referencime.fr/sse?api_key=VOTRE_CLE_API

ChatGPT (Pro, Plus, Team, Enterprise)

Ouvrir GPT Editor → Créer une nouvelle action
Authentification : Bearer + votre clé API
Importer le schéma depuis :

https://referencime.fr/wp-json/easy-links/v1/openapi.json

Déploiement (o2switch)

Prérequis

Node.js 18+
Plugin Easy Links installé sur WordPress
Hébergement compatible Node.js (cPanel → Node.js Apps)

Installation

git clone https://github.com/ThomasViennet/mcp-referencime.git
cd mcp-referencime
npm install --production

Variables d'environnement

PORT=3000
NODE_ENV=production
WORDPRESS_API_URL=https://referencime.fr/wp-json/easy-links/v1
JWT_SECRET=your-secret-key
ALLOWED_ORIGINS=*
TRUST_PROXY=true
LOG_LEVEL=info

Démarrage

npm start

Script de déploiement automatisé

chmod +x deploy-o2switch.sh
./deploy-o2switch.sh

Vérification

curl https://mcp.referencime.fr/         # Statut serveur
curl https://mcp.referencime.fr/health   # Santé
curl https://mcp.referencime.fr/debug/tools  # Outils générés

Outils disponibles

Les outils sont générés automatiquement depuis l'OpenAPI de WordPress. Liste actuelle :

Outil	Description
`listWebsitesByUser`	Liste les sites de l'utilisateur
`listKeywordsByWebsite`	Mots-clés d'un site
`listCategoriesByWebsite`	Catégories thématiques
`identifyNetlinkingTargets`	Opportunités netlinking (positions 3-20)
`getNetlinkingSpotsRanking`	Spots classés par proximité sémantique
`getWebsitePerformanceSummary`	Résumé GSC avec comparaisons
`detectRankingChanges`	Changements de positions significatifs
`getCompetitorsOverview`	Vue d'ensemble concurrentielle
`getGscProgress`	Statut d'indexation GSC
`analyzeKeywordPerformance`	Analyse détaillée d'un mot-clé
`getPositionEvolution`	Historique de positions
`getKeywordIdeas`	Suggestions de mots-clés

Sécurité

Authentification JWT — Chaque connexion SSE valide le token WordPress
Rate limiting — 100 req / 15 min par IP (global)
Heartbeat — Ping toutes les 15s pour maintenir la connexion (anti-Nginx timeout)
Isolation par session — Chaque utilisateur a son propre serveur MCP instancié