{"_id":"@aurelienbour-stack/majestic-mcp","_rev":"2-063f6e8347d42bf24d2ab37e52857de3","name":"@aurelienbour-stack/majestic-mcp","dist-tags":{"latest":"0.2.0"},"versions":{"0.1.0":{"name":"@aurelienbour-stack/majestic-mcp","version":"0.1.0","keywords":["mcp","model-context-protocol","majestic","seo","backlinks","trust-flow","citation-flow","claude","claude-code"],"author":{"name":"Aurélien Bour","email":"aurelien.bour@internet-factory.com"},"license":"MIT","_id":"@aurelienbour-stack/majestic-mcp@0.1.0","maintainers":[{"name":"aurelienbour-stack","email":"aurelien.bour@internet-factory.com"}],"homepage":"https://github.com/aurelienbour-stack/majestic-mcp#readme","bugs":{"url":"https://github.com/aurelienbour-stack/majestic-mcp/issues"},"bin":{"majestic-mcp":"src/index.js"},"dist":{"shasum":"6b855c22ca7bf87aa16b0ae283acef84909724b9","tarball":"https://registry.npmjs.org/@aurelienbour-stack/majestic-mcp/-/majestic-mcp-0.1.0.tgz","fileCount":5,"integrity":"sha512-WS+kkfln7cZxQB4xAya2GfiSKn67cB+8/HQnGPTJQLeR0pI+rh7FzhWaZ3XcxbvKCKHomeZyUZ7uZt9OvFeFLw==","signatures":[{"sig":"MEQCIEFuuJTx8Kv3nTsxTVYMP3fiKRo6Sa0IhQ0FtfVZHwqxAiAIZC8uJq2sk4UI52cvx8USYsRFHt+7ktE80xVV07BkuA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":23522},"main":"src/index.js","type":"module","engines":{"node":">=18"},"gitHead":"2407b87781cbded1a0b09c2f629acdd82919525c","scripts":{"start":"node src/index.js","test:auth":"node src/test-auth.js"},"_npmUser":{"name":"aurelienbour-stack","email":"aurelien.bour@internet-factory.com"},"repository":{"url":"git+https://github.com/aurelienbour-stack/majestic-mcp.git","type":"git"},"_npmVersion":"10.9.2","description":"MCP server for the Majestic SEO API — Trust Flow, Citation Flow, backlinks, referring domains, anchors, topical TF, PBN detection, and more","directories":{},"_nodeVersion":"22.14.0","dependencies":{"dotenv":"^16.4.5","@modelcontextprotocol/sdk":"^1.0.4"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/majestic-mcp_0.1.0_1778597380433_0.4139546673856376","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@aurelienbour-stack/majestic-mcp","version":"0.2.0","description":"MCP server for the Majestic SEO API — Trust Flow, Citation Flow, backlinks, referring domains, anchors, topical TF, PBN detection, and more","type":"module","main":"src/index.js","bin":{"majestic-mcp":"src/index.js"},"scripts":{"start":"node src/index.js","test:auth":"node src/test-auth.js","test:integration":"node test/integration.mjs"},"keywords":["mcp","model-context-protocol","majestic","seo","backlinks","trust-flow","citation-flow","claude","claude-code"],"author":{"name":"Aurélien Bour","email":"aurelien.bour@internet-factory.com"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/aurelienbour-stack/majestic-mcp.git"},"homepage":"https://github.com/aurelienbour-stack/majestic-mcp#readme","bugs":{"url":"https://github.com/aurelienbour-stack/majestic-mcp/issues"},"publishConfig":{"access":"public"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.4","dotenv":"^16.4.5"},"engines":{"node":">=18"},"_id":"@aurelienbour-stack/majestic-mcp@0.2.0","gitHead":"5987fd2a06990d0c7379f1a3ef02dce951848493","_nodeVersion":"22.14.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-B4pVJlLteIquLkgLj95Q0oS0RIco3LbxmNz8l9VpR0gl1JOEvwTbFqbwoZpMDIF19eDorltFJT9qdVBUs5vW3Q==","shasum":"b19b680fc825befa665337f948d94ef46a28a798","tarball":"https://registry.npmjs.org/@aurelienbour-stack/majestic-mcp/-/majestic-mcp-0.2.0.tgz","fileCount":5,"unpackedSize":29066,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIFkwFnsGZpLwS5eyOwx6T1+4e2LObp/bHjgsYn52yJulAiEAm5qSWbo46YDWt2JpKgYLFg9nBoHMwDfjzqfvINE291c="}]},"_npmUser":{"name":"aurelienbour-stack","email":"aurelien.bour@internet-factory.com"},"directories":{},"maintainers":[{"name":"aurelienbour-stack","email":"aurelien.bour@internet-factory.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/majestic-mcp_0.2.0_1778600380540_0.6209502068094095"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-12T14:49:40.312Z","modified":"2026-05-12T15:39:40.770Z","0.1.0":"2026-05-12T14:49:40.667Z","0.2.0":"2026-05-12T15:39:40.666Z"},"bugs":{"url":"https://github.com/aurelienbour-stack/majestic-mcp/issues"},"author":{"name":"Aurélien Bour","email":"aurelien.bour@internet-factory.com"},"license":"MIT","homepage":"https://github.com/aurelienbour-stack/majestic-mcp#readme","keywords":["mcp","model-context-protocol","majestic","seo","backlinks","trust-flow","citation-flow","claude","claude-code"],"repository":{"type":"git","url":"git+https://github.com/aurelienbour-stack/majestic-mcp.git"},"description":"MCP server for the Majestic SEO API — Trust Flow, Citation Flow, backlinks, referring domains, anchors, topical TF, PBN detection, and more","maintainers":[{"name":"aurelienbour-stack","email":"aurelien.bour@internet-factory.com"}],"readme":"# @aurelienbour-stack/majestic-mcp\n\nServeur 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.\n\n## ⚡ Installation rapide (une commande)\n\nRécupère ta clé API sur https://fr.majestic.com/account/api-keys (onglet \"API d'OpenApps\"), puis :\n\n```bash\nclaude mcp add --scope user majestic --env MAJESTIC_API_KEY=APP_xxxxxxxxxxxx -- npx --yes @aurelienbour-stack/majestic-mcp\n```\n\nRedémarre Claude Code, tape `/mcp`, tu dois voir `majestic` listé. C'est tout.\n\n## Outils exposés\n\n| Outil | Endpoint Majestic | Usage |\n|---|---|---|\n| `get_subscription_info` | GetSubscriptionInfo | Vérifier quota et licence |\n| `get_index_item_info` | GetIndexItemInfo | Trust/Citation Flow d'1 à 100 URLs (inclut RefIPs et RefSubNets en agrégat) |\n| `get_topics` | GetIndexItemInfo (extrait) | Topical Trust Flow propre (top 10 catégories) |\n| `compare_items` | GetIndexItemInfo (comparé) | Benchmark 2–100 cibles côte à côte |\n| `get_top_backlinks` | GetBackLinkData (dédupliqué) | Meilleurs backlinks (1 max par domaine référent, tri natif Trust Flow) |\n| `get_backlink_data` | GetBackLinkData | Liste brute des backlinks (type, attribut, position) |\n| `get_ref_domains` | GetRefDomains | Domaines référents avec tri par Trust Flow |\n| `get_anchor_text` | GetAnchorText | Distribution des ancres (Mode 0 = agrégé, 1 = par ref domain, 2 = backlinks bruts) |\n| `get_top_pages` | GetTopPages | Pages d'un domaine les plus liées |\n| `get_new_lost_backlinks` | GetNewLostBackLinks | Monitoring gains/pertes (LinksType=0 fait 2 appels) |\n| `get_hosted_domains` | GetHostedDomains | Domaines hébergés sur la même IP/domaine racine (détection PBN/voisinage) |\n| `majestic_raw` | (tout endpoint) | Échappatoire pour les commandes avancées |\n\n## Breaking changes en 0.2.0\n\n- **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`.\n- **`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`).\n- **`get_ref_domains`** : suppression de `Mode` et `From` (l'endpoint ne les accepte pas). Pagination via `AnalysisDepth`. Ajout de `OrderDir`.\n- **`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`.\n- **`get_top_pages`** : suppression de `Mode` (l'endpoint ne l'accepte pas). Ajout de `UsePrefixScan`.\n- **`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.\n\n## Installation alternative (dev local / contribuer)\n\nSi tu veux cloner le repo et lancer le serveur en local (pour développer ou ajouter des outils) :\n\n```bash\ngit clone https://github.com/aurelienbour-stack/majestic-mcp.git\ncd majestic-mcp\n```\n\n**Sur Windows** (PowerShell) :\n```powershell\n.\\install.ps1\n```\n\n**Sur macOS / Linux** :\n```bash\nchmod +x install.sh && ./install.sh\n```\n\nLe 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.\n\n## Installation 100% manuelle\n\n```bash\nnpm install\ncp .env.example .env   # puis éditer .env avec ta clé\nnpm run test:auth      # vérifier que la clé fonctionne\nclaude mcp add majestic node \"$(pwd)/src/index.js\"   # macOS/Linux\n# ou sur Windows PowerShell :\n# claude mcp add majestic node \"$PWD\\src\\index.js\"\n```\n\n## Brancher à Claude Desktop\n\n`%APPDATA%\\Claude\\claude_desktop_config.json` (Windows) ou `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) :\n\n```json\n{\n  \"mcpServers\": {\n    \"majestic\": {\n      \"command\": \"node\",\n      \"args\": [\"CHEMIN/ABSOLU/VERS/majestic-mcp/src/index.js\"]\n    }\n  }\n}\n```\n\nRedémarre Claude Desktop après modification.\n\n## Notes API\n\n- **Datasource** : `fresh` (90 derniers jours, par défaut) ou `historic` (5 ans, plus de crédits).\n- **Mode** : `0`=URL exacte, `1`=sous-domaine, `2`=domaine racine.\n- **Crédits** : chaque appel consomme un nombre variable d'analyses (`Analysis Unit`). `get_subscription_info` te donne le solde.\n- Référence officielle : https://developer-support.majestic.com/api/commands.shtml\n","readmeFilename":"README.md"}