Rankfabrik MCP Server

RankFabrik — canal MCP

Les 4 APIs de données publiques de RankFabrik, exposées comme outils MCP pour les agents (Claude, ChatGPT, Cursor…). Serveur mince : il ne collecte rien lui-même, il appelle les façades REST déjà en production et rend la réponse telle quelle — clés, quotas, comptage et facturation restent ceux de l'API existante.

Une clé, quatre produits. Prenez une clé d'essai gratuite (500 unités/mois, sans carte bancaire) sur rankfabrik.com/tarifs, puis renseignez-la dans RANKFABRIK_API_KEY. Si votre clé ne couvre pas encore un produit, l'outil concerné vous rend un message d'activation — jamais une erreur brute.

Installer en un clic

Via Smithery (installe et configure le serveur dans le client de votre choix) :

npx -y @smithery/cli install rankfabrik-mcp --client claude

--client accepte aussi cursor, cline, windsurf… Réglage manuel par client plus bas dans Installer dans un client.

Outils

Captions — transcription YouTube

video accepte une URL YouTube sous ses quatre écritures (watch, youtu.be, embed/shorts/live) ou un identifiant brut à onze caractères.

Places — établissements

Localisation : soit ville (nom de ville connue, voir places_cities), soit latitude + longitude pour n'importe où ailleurs.

Jobs — emplois

Verify — vérification d'e-mails

Configuration

Une seule variable est obligatoire : la clé fédérée.

Surcharges avancées (optionnelles). Chaque produit vise son sous-domaine par défaut — captions / places / jobs / verify.rankfabrik.com. On peut surcharger cible et clé produit par produit : RANKFABRIK_<PRODUIT>_URL et RANKFABRIK_<PRODUIT>_KEY (ex. RANKFABRIK_PLACES_KEY). RANKFABRIK_BASE_URL reste accepté comme alias historique de la cible Captions.

Installer dans un client

Tous les clients de bureau lancent le serveur en stdio via npx — aucun clone nécessaire. Remplacez rf_xxx par votre clé.

Claude Desktop

Fichier claude_desktop_config.json (menu Réglages → Développeur → Éditer la configuration) :

{
  "mcpServers": {
    "rankfabrik": {
      "command": "npx",
      "args": ["-y", "rankfabrik-mcp"],
      "env": { "RANKFABRIK_API_KEY": "rf_xxx" }
    }
  }
}

Cursor

Bouton Ajouter à Cursor ci-dessus, ou fichier .cursor/mcp.json (projet) / ~/.cursor/mcp.json (global) :

{
  "mcpServers": {
    "rankfabrik": {
      "command": "npx",
      "args": ["-y", "rankfabrik-mcp"],
      "env": { "RANKFABRIK_API_KEY": "rf_xxx" }
    }
  }
}

Cline

Via l'UI MCP Servers → Configure (édite cline_mcp_settings.json) :

{
  "mcpServers": {
    "rankfabrik": {
      "command": "npx",
      "args": ["-y", "rankfabrik-mcp"],
      "env": { "RANKFABRIK_API_KEY": "rf_xxx" },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Continue

MCP fonctionne en mode agent. Fichier .continue/mcpServers/rankfabrik.yaml (workspace) ou sous ~/.continue/ (global) :

name: RankFabrik
version: 0.0.1
schema: v1
mcpServers:
  - name: RankFabrik
    command: npx
    args:
      - "-y"
      - "rankfabrik-mcp"
    env:
      RANKFABRIK_API_KEY: ${{ secrets.RANKFABRIK_API_KEY }}

Démarrer (dev / auto-hébergé)

Depuis un clone, en stdio :

RANKFABRIK_API_KEY=rf_xxx node serveur.mjs

À distance (Streamable HTTP)

MCP_TRANSPORT=http PORT=8090 RANKFABRIK_API_KEY=rf_xxx node serveur.mjs
# point d'entrée : POST http://localhost:8090/mcp

Conception

• Un outil = un appel REST. Aucune logique de collecte dupliquée.
• Dégradation propre. Une clé qui ne couvre pas encore un produit (401/403) rend un message actionnable (« prenez une clé d'essai sur … ») plutôt qu'une erreur brute — le canal reste utilisable produit par produit.
• Erreurs lisibles. Un rejet de l'API (paramètre manquant, quota épuisé, clé absente) revient comme résultat d'outil isError, que l'agent peut lire et corriger, jamais comme une exception qui coupe la session.
• Dépendances isolées. Ce dossier porte le SDK MCP et zod ; le produit REST garde sa règle « zéro dépendance sauf undici ».
• Facturation native. Chaque appel passe par l'API de production : le registre existant compte et facture, la clé de l'utilisateur circule dans sa propre configuration MCP et n'est jamais stockée ici.

Dépôt

Ce paquet est publié depuis le dépôt public finalburner/rankfabrik-mcp (canal MCP uniquement). Le moteur REST reste dans un dépôt privé séparé.