RankFabrik

RankFabrik — MCP 渠道

RankFabrik 的 4 个公共数据 API，以 MCP 工具的形式提供给 Agent（Claude、ChatGPT、Cursor……）。这是一个轻量级服务：它本身不收集任何数据，只调用已投入生产的 REST 接口，并原样返回响应——密钥、配额、计数和计费均沿用现有 API。

一把密钥，四种产品。 获取免费试用密钥（每月 500 单位，无需银行卡），请访问 rankfabrik.com/tarifs，然后将密钥填入 RANKFABRIK_API_KEY。如果你的密钥尚未涵盖某项产品，相应工具会返回激活提示，而不是原始错误。

一键安装

通过 Smithery 安装（在你选择的客户端中安装并配置服务）：

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

--client 也接受 cursor、cline、windsurf……各客户端的手动配置见下文 安装到客户端。

工具

Captions — YouTube 转录

工具	返回内容	计费
youtube_inspect	元数据和可用字幕轨道，不下载文本	免费
youtube_transcribe	完整转录：文本、带时间戳的片段、章节、SRT/VTT、逐字稿	1 单位
youtube_search	某个搜索词对应的视频 ID	按 ID 计费
youtube_harvest	一次调用即可搜索 并 转录某个主题（≤ 30 个视频）	按转录视频计费
youtube_transcribe_batch	并行转录一组 ID/URL（≤ 50 个）	按转录视频计费

video 接受四种格式的 YouTube URL（watch、youtu.be、embed/shorts/live），也接受 11 个字符的原始 ID。

Places — 商家

工具	返回内容	计费
places_search	搜索某个地点周边符合条件的商家（城市 或 纬度+经度），可补充信息（电子邮件、营业时间、照片）——≤ 20 个	按商家计费
places_scan	扫描更大范围的区域（点网格）	按商家计费
places_cities	ville 参数支持的城市列表	免费

位置：使用 ville（已知城市名称，参见 places_cities），或使用 latitude + longitude 指定其他任意位置。

Jobs — 职位

工具	返回内容	计费
jobs_search	某个职业的招聘信息，可按地点筛选	按职位计费
jobs_full	同上，并返回每个职位的完整详情（可选公司资料）	按职位计费
jobs_company	某家公司的公开招聘资料（名称或 slug）	按公司计费

Verify — 电子邮件验证

工具	返回内容	计费
verify_email	电子邮件地址的可送达性判定（语法、域名、MX、SMTP 探测）	1 单位
verify_emails	对一组地址进行同样的验证	按已验证地址计费

配置

只需设置一个必填变量：联合密钥。

变量	作用	默认值
RANKFABRIK_API_KEY	提供给 4 个 API 的 rf_… 密钥（联合密钥）	—（必填）
RANKFABRIK_EN_TETE_CLE	携带密钥的请求头	x-cle-api
RANKFABRIK_URL_CLE	显示用于获取／激活密钥的网址	https://rankfabrik.com/tarifs
MCP_TRANSPORT	stdio 或 http	stdio
PORT	http 传输模式下的端口	8090

高级覆盖项（可选）。 每个产品默认使用各自的子域名——captions / places / jobs / verify.rankfabrik.com。可以按产品覆盖目标地址和产品密钥：RANKFABRIK_<PRODUIT>_URL 和 RANKFABRIK_<PRODUIT>_KEY（例如 RANKFABRIK_PLACES_KEY）。RANKFABRIK_BASE_URL 仍作为 Captions 目标地址的历史别名接受。

安装到客户端

所有桌面客户端都通过 npx 以 stdio 模式启动服务——无需克隆。请将 rf_xxx 替换为您的密钥。

Claude Desktop

文件 claude_desktop_config.json（菜单 设置 → 开发者 → 编辑配置）：

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

Cursor

点击上方的 添加到 Cursor，或使用文件 .cursor/mcp.json（项目级）／~/.cursor/mcp.json（全局）：

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

Cline

通过 UI MCP Servers → Configure（编辑 cline_mcp_settings.json）：

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

Continue

MCP 在 Agent 模式下运行。使用文件 .continue/mcpServers/rankfabrik.yaml（工作区级）或放在 ~/.continue/ 下（全局）：

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 }}

启动（开发／自托管）

从克隆的仓库启动，使用 stdio：

RANKFABRIK_API_KEY=rf_xxx node serveur.mjs

远程（Streamable HTTP）

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

设计

• 一个工具 = 一次 REST 调用。 不会重复实现数据采集逻辑。
• 平稳降级。 如果密钥尚未涵盖某个产品（401/403），则返回可执行的提示（“请获取一把试用密钥……”），而不是原始错误——各产品的通道仍可单独使用。
• 错误易于理解。 API 拒绝请求（缺少参数、配额耗尽、密钥缺失）时，会作为 isError 工具结果返回，供 Agent 查看并修正；不会作为异常中断会话。
• 依赖隔离。 此目录包含 MCP SDK 和 zod；REST 产品仍遵循“除 undici 外零依赖”的原则。
• 原生计费。 每次调用都会经过生产 API：现有注册表负责统计和计费，用户密钥保存在其自己的 MCP 配置中，绝不会存储在这里。

仓库

此软件包从公开仓库 finalburner/rankfabrik-mcp 发布（仅 MCP 通道）。REST 引擎仍位于单独的私有仓库中。