Scribefy

scribefy-mcp

Claude Desktop サーバーである Scribefy — Claude Desktop、Cursor、Windsurf、ChatGPT カスタム GPT、その他の MCP 対応クライアントから YouTube の文字起こしを抽出できます。

公開中 — 以下の手順で1分で設定するか、ウェブアプリ scribefy.app をお試しください。

概要

YouTube の文字起こしツールの多くは、ブラウザー拡張機能や単発のウェブ UI として提供されています。このツールは Scribefy の API を MCP 標準に対応させるため、ユーザーが YouTube のリンクを貼り付けると、AI アシスタントがいつでも文字起こしを取得できます。手動でコピー＆ペーストしたり、別のタブを開いたりする必要はありません。

要件

• Node 20+
• API キーを取得するには、Scribefy の API + MCP プラン（月額 $25）のアカウントが必要です。最初はキーなしでインストールできます。MCP ホストがサーバーを正常に登録し、ツールを使おうとすると案内が表示されます。その後、scribefy.app/dashboard でキーを追加すると、文字起こしを抽出できるようになります。

セットアップ

Claude Desktop

設定ファイル（Settings → Developer → Edit Config）を開きます。

{
  "mcpServers": {
    "scribefy": {
      "command": "npx",
      "args": ["-y", "scribefy-mcp"],
      "env": {
        "SCRIBEFY_API_KEY": "sk_live_…"
      }
    }
  }
}

Claude Desktop を再起動します。利用可能なツールのパネルに extract_transcript ツールが表示されます。

Cursor

Settings → Cursor Settings → MCP → Add new MCP server：

{
  "scribefy": {
    "command": "npx",
    "args": ["-y", "scribefy-mcp"],
    "env": {
      "SCRIBEFY_API_KEY": "sk_live_…"
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json：

{
  "mcpServers": {
    "scribefy": {
      "command": "npx",
      "args": ["-y", "scribefy-mcp"],
      "env": {
        "SCRIBEFY_API_KEY": "sk_live_…"
      }
    }
  }
}

その他の環境

stdio トランスポートに対応する MCP ホストであれば利用できます。環境変数に SCRIBEFY_API_KEY を指定して、npx -y scribefy-mcp を起動してください。このサーバーは、標準の MCP JSON-RPC を stdin/stdout 経由で使用します。

提供するツール

ツールは4つあります。3つは無料のリサーチツールで、クレジットが消費されるのは extract_transcript のみです。

extract_transcript

YouTube 動画の文字起こしを取得します。

パラメーター	型	必須	説明
url	string	はい	YouTube の完全な URL — youtube.com/watch?v=…、youtu.be/…、または youtube.com/shorts/…
lang	string	いいえ	BCP-47 言語コード（例：en、es、fr、zh-Hans）。デフォルトは en です

戻り値： タイトル、チャンネル、長さ、言語、およびタイムスタンプ付きのセグメントに分割された文字起こしを含む Markdown。

料金： 1クレジット（15分以下）→ 8クレジット（2時間以上）。キャッシュ済みの文字起こしは無料です。

search_videos

YouTube のフリーテキスト検索です。

パラメーター	型	必須	説明
query	string	はい	検索クエリ — YouTube の検索バーで使える構文と同じです
limit	number	いいえ	結果の最大数、1–25（デフォルトは10）

戻り値： 各検索結果のタイトル／チャンネル／長さ／再生回数／URL をまとめた Markdown のリスト。

料金： 無料。

get_video_metadata

タイトル、チャンネル、長さ、再生回数、アップロード日、および利用可能な字幕トラックを取得します。文字起こしは取得しません。

パラメーター	型	必須	説明
url	string	はい	YouTube の完全な URL

戻り値： Markdown の概要と、言語コード付きのすべての字幕トラックのリスト（作成者によるもの ✏ または自動生成 ⚙）。

料金： 無料。抽出するかどうかを決める前に動画を確認したり、利用可能な字幕の言語を調べたりする際に使用してください。

get_related_videos

動画の YouTube「次の動画」フィードを取得します。

パラメーター	型	必須	説明
url	string	はい	起点となる動画の YouTube 完全 URL
limit	number	いいえ	関連動画の最大数、1–25（デフォルトは10）

戻り値： search_videos と同じ形式です。

料金： 無料。

今後のリリースで追加予定のツール

list_channel_videos と get_video_comments は 0.3.0 での提供を予定していましたが、YouTube の2026年のレスポンス形式変更への修正が upstream の youtubei.js から公開されるのを待つため、0.4.0 に延期されました。チャンネル一覧の取得は InnerTube 層で HTTP 400 エラーになり、info.getComments() は解析済みの VideoInfo に含まれなくなっています。ライブラリの対応が整い次第、両ツールを再び提供します。

スキル

このリポジトリには、アシスタントが必要に応じて読み込む SKILL.md であるエージェントスキルが含まれています。このスキルは、これらのツールを効果的に使う方法を教えます。クレジットを消費する前に無料ツールで候補を評価し、作成者による字幕を優先し、無料の文字起こしキャッシュを活用し、タイムスタンプ付きで回答を引用します。

• skills/youtube-research — YouTube リサーチのワークフロー：検索 → メタデータの評価 → 必要な部分だけを抽出 → [mm:ss] 形式の引用を使って統合。

Claude Code で使うには、フォルダーをプロジェクトの .claude/skills/（または、すべてのプロジェクトで使う場合は ~/.claude/skills/）にコピーしてください。Plugins 対応ホストは、リポジトリから直接検出します。

設定

Env var	Required	Default	Notes
SCRIBEFY_API_KEY	はい	—	sk_live_…（本番環境）または sk_test_…（Scribefy テストモード）
SCRIBEFY_API_BASE	いいえ	https://api.scribefy.app	ステージング環境（https://api-staging.scribefy.app）またはセルフホストインスタンス用の上書き

トラブルシューティング

SCRIBEFY_API_KEY is required MCP ホストの設定で env ブロックが設定されており、ホストが実際にそれを読み込んでいることを確認してください。ホストによってはデフォルトで環境変数を削除するため、ドキュメントを確認してください。

Scribefy rejected the API key キーが間違っている、無効化されている、またはサブスクリプションが API + MCP プランではなくなっている可能性があります。scribefy.app/dashboard を確認してください。

Not enough credits ツールはエラーメッセージに残高と料金を表示します。scribefy.app/pricing でチャージしてください。

MCP クライアントにツールが表示されない 設定を編集した後は、クライアントを完全に再起動してください（チャットウィンドウを閉じるだけでは不十分です）。ログを確認できる場合は、クライアントのログを末尾から確認してください。ほとんどのクライアントでは、MCP の標準エラー出力がそこに表示されます。サーバーは起動すると scribefy-mcp: ready を出力します。

ライセンス

MIT