The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the RankFabrik listing page.
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.
Via Smithery (installe et configure le serveur dans le client de votre choix) :
--client accepte aussi cursor, cline, windsurf… Réglage manuel par client
plus bas dans Installer dans un client.
| 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.
| 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.
| 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é |
| 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 |
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.
Tous les clients de bureau lancent le serveur en stdio via npx — aucun clone
nécessaire. Remplacez rf_xxx par votre clé.
Fichier claude_desktop_config.json (menu Réglages → Développeur → Éditer la
configuration) :
Bouton Ajouter à Cursor
ci-dessus, ou fichier .cursor/mcp.json (projet) / ~/.cursor/mcp.json (global) :
Via l'UI MCP Servers → Configure (édite cline_mcp_settings.json) :
MCP fonctionne en mode agent. Fichier .continue/mcpServers/rankfabrik.yaml
(workspace) ou sous ~/.continue/ (global) :
Depuis un clone, en stdio :
isError, que l'agent peut lire
et corriger, jamais comme une exception qui coupe la session.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é.