RankFabrik

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

Outil	Ce qu'il rend	Facturation
youtube_inspect	Métadonnées + pistes de sous-titres disponibles, sans télécharger le texte	gratuit
youtube_transcribe	Transcription complète : texte, segments minutés, chapitres, SRT/VTT, verbatims	1 unité
youtube_search	Identifiants de vidéos pour un terme	par identifiant
youtube_harvest	Cherche et transcrit un thème en un appel (≤ 30 vidéos)	par vidéo transcrite
youtube_transcribe_batch	Transcrit une liste d'identifiants/URL (≤ 50) en parallèle	par vidéo transcrite

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

Places — établissements

Outil	Ce qu'il rend	Facturation
places_search	Établissements pour un terme autour d'un lieu (ville ou lat+lon), enrichissables (e-mails, horaires, photos) — ≤ 20	par établissement
places_scan	Balayage plus large d'une zone (grille de points)	par établissement
places_cities	Liste des villes reconnues pour le paramètre ville	gratuit

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

Jobs — emplois

Outil	Ce qu'il rend	Facturation
jobs_search	Offres d'emploi pour un métier, éventuellement filtrées par lieu	par offre
jobs_full	Idem avec le détail complet de chaque offre (+ profil société optionnel)	par offre
jobs_company	Profil public de recrutement d'une société (nom ou slug)	par société

Verify — vérification d'e-mails

Outil	Ce qu'il rend	Facturation
verify_email	Vérdict de délivrabilité d'une adresse (syntaxe, domaine, MX, sondage SMTP)	1 unité
verify_emails	Idem pour une liste d'adresses	par adresse vérifiée

Configuration

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

Variable	Rôle	Défaut
RANKFABRIK_API_KEY	Clé rf_… présentée aux 4 API (fédérée)	— (obligatoire)
RANKFABRIK_EN_TETE_CLE	En-tête portant la clé	x-cle-api
RANKFABRIK_URL_CLE	URL affichée pour obtenir/activer une clé	https://rankfabrik.com/tarifs
MCP_TRANSPORT	stdio ou http	stdio
PORT	Port en transport http	8090

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é.