RankFabrik

io.github.finalburnerPublished by GitHub account finalburnerv2.0.0Updated Oct 24, 2026

Proxy MCP des 4 API RankFabrik : Places, Jobs, Captions, Verify. Une cle federee pour les 4.

The publisher's own server: Rank Fast

Overview

AI-generated overview

Exposes RankFabrik's four public data APIs — YouTube captions, local businesses, jobs, and email verification — as MCP tools for an assistant.

What you can do
A thin proxy that calls RankFabrik's existing REST APIs and returns their responses unchanged. Tools cover YouTube caption inspection, transcription, search and batch harvesting; business searches and area scans around a city or coordinates; job listings, full job details and company hiring profiles; and single or bulk email deliverability checks. Each tool maps to one REST call, and API errors come back as readable tool errors rather than session-breaking exceptions.
When to use it
Worth adding when an assistant needs YouTube transcripts, local business listings, job postings, or email deliverability checks without building its own integrations. It is a convenience wrapper, so it only makes sense if you already want RankFabrik's data and accept its per-call unit billing.
Requirements
Runs locally as an npm package via npx (Node.js required), stdio by default; MCP_TRANSPORT=http and PORT enable a Streamable HTTP endpoint. A required RankFabrik API key goes in RANKFABRIK_API_KEY; a free trial key with 500 units per month is offered. Optional variables set the key header name, the key URL, and per-product endpoint or key overrides. Network access to RankFabrik's APIs is needed.
Before you install
The RANKFABRIK_API_KEY secret is sent to RankFabrik's APIs and should be kept out of shared configs. Calls are billed in units against your key: transcription, business lookups, job listings and email verification each consume units, and batch tools can spend many at once. The server itself stores nothing, but all queries and submitted email addresses go to a third party.

Installation

In SourceWeft

  1. Open RankFabrik in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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

[Ajouter à Cursor]

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

bash
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

OutilCe qu'il rendFacturation
youtube_inspectMétadonnées + pistes de sous-titres disponibles, sans télécharger le textegratuit
youtube_transcribeTranscription complète : texte, segments minutés, chapitres, SRT/VTT, verbatims1 unité
youtube_searchIdentifiants de vidéos pour un termepar identifiant
youtube_harvestCherche et transcrit un thème en un appel (≤ 30 vidéos)par vidéo transcrite
youtube_transcribe_batchTranscrit une liste d'identifiants/URL (≤ 50) en parallèlepar 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

OutilCe qu'il rendFacturation
places_searchÉtablissements pour un terme autour d'un lieu (ville ou lat+lon), enrichissables (e-mails, horaires, photos) — ≤ 20par établissement
places_scanBalayage plus large d'une zone (grille de points)par établissement
places_citiesListe des villes reconnues pour le paramètre villegratuit

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

Jobs — emplois

OutilCe qu'il rendFacturation
jobs_searchOffres d'emploi pour un métier, éventuellement filtrées par lieupar offre
jobs_fullIdem avec le détail complet de chaque offre (+ profil société optionnel)par offre
jobs_companyProfil public de recrutement d'une société (nom ou slug)par société

Verify — vérification d'e-mails

OutilCe qu'il rendFacturation
verify_emailVérdict de délivrabilité d'une adresse (syntaxe, domaine, MX, sondage SMTP)1 unité
verify_emailsIdem pour une liste d'adressespar adresse vérifiée

Configuration

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

VariableRôleDéfaut
RANKFABRIK_API_KEYClé rf_… présentée aux 4 API (fédérée)— (obligatoire)
RANKFABRIK_EN_TETE_CLEEn-tête portant la cléx-cle-api
RANKFABRIK_URL_CLEURL affichée pour obtenir/activer une cléhttps://rankfabrik.com/tarifs
MCP_TRANSPORTstdio ou httpstdio
PORTPort en transport http8090

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) :

json
{  "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) :

json
{  "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) :

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) :

yaml
name: RankFabrikversion: 0.0.1schema: v1mcpServers:  - 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 :

bash
RANKFABRIK_API_KEY=rf_xxx node serveur.mjs

À distance (Streamable HTTP)

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

Source: README.md at commit 33763ab

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v2.0.0LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Rank integrations