@aurelienbour-stack/majestic-mcp

Serveur MCP pour l'API Majestic SEO (api.majestic.com). Expose les principaux endpoints de l'OpenApps API en tant qu'outils MCP utilisables depuis Claude Code, Claude Desktop, ou tout autre client MCP.

⚡ Installation rapide (une commande)

Récupère ta clé API sur https://fr.majestic.com/account/api-keys (onglet "API d'OpenApps"), puis :

claude mcp add --scope user majestic --env MAJESTIC_API_KEY=APP_xxxxxxxxxxxx -- npx --yes @aurelienbour-stack/majestic-mcp

Redémarre Claude Code, tape /mcp, tu dois voir majestic listé. C'est tout.

Outils exposés

| Outil | Endpoint Majestic | Usage | |---|---|---| | get_subscription_info | GetSubscriptionInfo | Vérifier quota et licence | | get_index_item_info | GetIndexItemInfo | Trust/Citation Flow d'1 à 100 URLs (inclut RefIPs et RefSubNets en agrégat) | | get_topics | GetIndexItemInfo (extrait) | Topical Trust Flow propre (top 10 catégories) | | compare_items | GetIndexItemInfo (comparé) | Benchmark 2–100 cibles côte à côte | | get_top_backlinks | GetBackLinkData (dédupliqué) | Meilleurs backlinks (1 max par domaine référent, tri natif Trust Flow) | | get_backlink_data | GetBackLinkData | Liste brute des backlinks (type, attribut, position) | | get_ref_domains | GetRefDomains | Domaines référents avec tri par Trust Flow | | get_anchor_text | GetAnchorText | Distribution des ancres (Mode 0 = agrégé, 1 = par ref domain, 2 = backlinks bruts) | | get_top_pages | GetTopPages | Pages d'un domaine les plus liées | | get_new_lost_backlinks | GetNewLostBackLinks | Monitoring gains/pertes (LinksType=0 fait 2 appels) | | get_hosted_domains | GetHostedDomains | Domaines hébergés sur la même IP/domaine racine (détection PBN/voisinage) | | majestic_raw | (tout endpoint) | Échappatoire pour les commandes avancées |

Breaking changes en 0.2.0

• Outils supprimés : get_ref_ips, get_ref_subnets, get_neighbour_check. Les endpoints Majestic GetRefIPs, GetRefSubNets et GetNeighbourCheck n'existent pas. Pour la diversité IP/subnet en métrique agrégée, lis RefIPs et RefSubNets dans get_index_item_info. Pour le voisinage IP réel, utilise get_hosted_domains.
• get_top_backlinks appelle désormais GetBackLinkData (l'ancien GetTopBackLinks était deprecated et renvoyait des résultats vides). Nouveaux paramètres : SortBy, SortDir, MaxSourceURLsPerRefDomain. Le Mode est passé à 0|1 (anciennement 0|1|2).
• get_ref_domains : suppression de Mode et From (l'endpoint ne les accepte pas). Pagination via AnalysisDepth. Ajout de OrderDir.
• get_anchor_text : sémantique de Mode corrigée. 0 = agrégé par anchor (recommandé, c'était l'intention), 1 = par ref domain, 2 = backlinks bruts (gros volume). L'ancien default 0 faisait par contre déjà la bonne chose ; les utilisateurs qui passaient explicitement Mode=2 doivent désormais utiliser Mode=0 ou get_backlink_data.
• get_top_pages : suppression de Mode (l'endpoint ne l'accepte pas). Ajout de UsePrefixScan.
• get_new_lost_backlinks : Count capé à 1000 (limite réelle de l'API). LinksType=0 (défaut) renvoie maintenant un objet { new, lost } issu de deux appels API.

Installation alternative (dev local / contribuer)

Si tu veux cloner le repo et lancer le serveur en local (pour développer ou ajouter des outils) :

git clone https://github.com/aurelienbour-stack/majestic-mcp.git
cd majestic-mcp

Sur Windows (PowerShell) :

.\install.ps1

Sur macOS / Linux :

chmod +x install.sh && ./install.sh

Le script crée un .env, te demande d'y coller la clé, teste l'auth, et enregistre le MCP dans Claude Code en pointant vers ton clone local.

Installation 100% manuelle

npm install
cp .env.example .env   # puis éditer .env avec ta clé
npm run test:auth      # vérifier que la clé fonctionne
claude mcp add majestic node "$(pwd)/src/index.js"   # macOS/Linux
# ou sur Windows PowerShell :
# claude mcp add majestic node "$PWD\src\index.js"

Brancher à Claude Desktop

%APPDATA%\Claude\claude_desktop_config.json (Windows) ou ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) :

{
  "mcpServers": {
    "majestic": {
      "command": "node",
      "args": ["CHEMIN/ABSOLU/VERS/majestic-mcp/src/index.js"]
    }
  }
}

Redémarre Claude Desktop après modification.

Notes API

• Datasource : fresh (90 derniers jours, par défaut) ou historic (5 ans, plus de crédits).
• Mode : 0=URL exacte, 1=sous-domaine, 2=domaine racine.
• Crédits : chaque appel consomme un nombre variable d'analyses (Analysis Unit). get_subscription_info te donne le solde.
• Référence officielle : https://developer-support.majestic.com/api/commands.shtml