RankFabrik

RankFabrik — MCP チャネル

RankFabrik の公開データ API 4 種類を、エージェント（Claude、ChatGPT、Cursor など）向けの MCP ツール として提供します。軽量なサーバーです。独自にデータを収集することはなく、本番稼働中の REST ファサードを呼び出して、レスポンスをそのまま返します。キー、クォータ、使用量のカウント、請求はすべて既存 API のものが適用されます。

キー 1 つで 4 つの製品。 無料トライアルキー（月 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	1 回の呼び出しでテーマを検索 して 文字起こし（動画 30 本以下）	文字起こしした動画ごと
youtube_transcribe_batch	ID／URL のリストを並列で文字起こし（50 件以下）	文字起こしした動画ごと

video には、4 種類の形式（watch、youtu.be、embed/shorts/live）の YouTube URL、または 11 文字の ID を指定できます。

Places — 施設

ツール	返される内容	課金
places_search	場所（都市 または 緯度＋経度）周辺で検索語に一致する施設。メールアドレス、営業時間、写真などで拡充可能 — 20 件以下	施設ごと
places_scan	エリアをより広範囲にスキャン（ポイントのグリッド）	施設ごと
places_cities	ville パラメーターで認識される都市の一覧	無料

場所の指定には、既知の都市名を表す ville（places_cities を参照）、またはその他の任意の場所を表す latitude ＋ longitude を使用します。

Jobs — 求人

ツール	返される内容	課金
jobs_search	職種ごとの求人。場所で絞り込むこともできます	求人ごと
jobs_full	同上。各求人の詳細情報も返します（任意で企業プロフィールも取得可能）	求人ごと
jobs_company	企業の公開採用プロフィール（名前またはスラッグ）	企業ごと

Verify — メールアドレスの検証

ツール	返される内容	課金
verify_email	メールアドレスの配信可能性の判定（構文、ドメイン、MX、SMTP の確認）	1 ユニット
verify_emails	同上。メールアドレスのリストを検証します	検証したアドレスごと

設定

必須の変数は1つだけです。フェデレーションキーです。

変数	役割	デフォルト
RANKFABRIK_API_KEY	4つのAPIに提示するrf_…キー（フェデレーションキー）	—（必須）
RANKFABRIK_EN_TETE_CLE	キーを格納するヘッダー	x-cle-api
RANKFABRIK_URL_CLE	キーの取得／有効化ページとして表示するURL	https://rankfabrik.com/tarifs
MCP_TRANSPORT	stdioまたはhttp	stdio
PORT	httpトランスポートで使用するポート	8090

高度な上書き設定（任意）。 各製品はデフォルトで、それぞれのサブドメイン（captions／places／jobs／verify.rankfabrik.com）を対象とします。製品ごとに対象URLと製品キーを上書きできます。RANKFABRIK_<PRODUIT>_URLおよびRANKFABRIK_<PRODUIT>_KEYを使用してください（例：RANKFABRIK_PLACES_KEY）。RANKFABRIK_BASE_URLは、Captionsの対象URLに対する従来のエイリアスとして引き続き使用できます。

クライアントへのインストール

すべてのデスクトップクライアントは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はエージェントモードで動作します。ファイル.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

設計

• 1つのツールにつきREST呼び出し1回。 データ収集ロジックの重複はありません。
• 適切な縮退動作。 ある製品にまだ対応していないキー（401/403）の場合、生のエラーではなく、操作可能なメッセージ（「…から試用キーを取得してください」）を返します。製品ごとに利用できるため、MCPチャネルは引き続き使用できます。
• 読みやすいエラー。 APIによる拒否（必須パラメーター不足、クォータ超過、キー不足）は、ツールの結果isErrorとして返されます。エージェントが内容を読み取り、修正できます。セッションを中断する例外として返されることはありません。
• 依存関係の分離。 このディレクトリにはMCP SDKとzodが含まれます。REST製品では「undici以外の依存関係ゼロ」というルールを維持します。
• ネイティブな課金。 すべての呼び出しは本番APIを経由します。既存のレジストリが利用状況を集計して課金し、ユーザーのキーはユーザー自身のMCP設定内を流れ、ここに保存されることはありません。

リポジトリ

このパッケージは、公開リポジトリ**finalburner/rankfabrik-mcp**から公開されています（MCPチャネルのみ）。RESTエンジンは別の非公開リポジトリにあります。