Serpapi Youtube MCP Server

🚀 YouTube データ MCP サーバ

このサーバは、YouTube 動画の文字起こしとコメントを抽出するための Model Context Protocol (MCP) サーバです。分析や要約のために、YouTube 動画の文字起こしとコメントを取得するツールを提供します。

🚀 クイックスタート

この MCP サーバは、YouTube 動画の文字起こしとコメントを抽出するために使用できます。以下のセクションでは、サーバの機能、必要条件、インストール方法、構成方法、実行方法、Claude との連携方法、API ツールの使用方法、トラブルシューティング方法、およびライセンス情報について説明します。

✨ 主な機能

• getTranscript：YouTube 動画から字幕/文字起こしを抽出します。
• getVideoInfo：YouTube 動画の基本情報を取得します。
• getReplies：YouTube 動画のコメントを検索します（SerpAPI を使用）。
• getCommentReplies：特定の YouTube コメントの返信を取得します。

📦 インストール

必要条件

• Node.js 16+
• TypeScript
• SerpAPI API キー（コメント機能に必要）

インストール手順（開発者向け）

# リポジトリをクローン
git clone https://github.com/diasm3/serpapi-youtube-mcp-server.git
cd youtube-data-mcp

# 依存関係をインストール
npm install

📚 ドキュメント

構成

プロジェクトのルートディレクトリに .env ファイルを作成し、SerpAPI キーを追加します。

SERPAPI_KEY=your_serpapi_key_here

SerpAPI で登録すると、SerpAPI キーを取得できます。

ビルドと実行

# プロジェクトをビルド
npm run build

# サーバを起動
npm start

サーバは起動し、stdin/stdout のコマンドを待ち受けます。

Claude との連携

この MCP サーバを Claude と連携するには、以下の手順を実行します。

1. サーバを Claude の設定ファイルに追加します。

{
  "mcpServers": {
    "youtube-data": {
      "command": "npx",
      "args": ["-y","youtube-data-mcp"],
      "env": {
        "SERPAPI_KEY": "your_serpapi_key_here"
      }
    }
  }
}

2. Claude を再起動して設定を適用します。
3. 以下の機能を使用できます。
   • getTranscript：YouTube 動画から文字起こしを抽出します。
   • getVideoInfo：動画情報を取得します。
   • getReplies：コメントを取得します。
   • getCommentReplies：返信を取得します。

API ツール

• youtube_search(query)：キーワードで YouTube 動画を検索します。

  • パラメータ：
    • query: 検索するキーワードまたはフレーズ。
  • 戻り値：
    • 動画 ID とタイトルを含む検索結果のリスト。

• get_transcript(video_id)：指定された YouTube 動画から文字起こしを抽出します。

  • パラメータ：
    • video_id: YouTube 動画の一意の識別子。
  • 戻り値：
    • 字幕内容とメタデータ。

• get_video_info(video_id)：YouTube 動画の詳細情報を取得します。

  • パラメータ：
    • video_id: YouTube 動画の一意の識別子。
  • 戻り値：
    • 動画のタイトル、説明、投稿者情報、統計情報（視聴回数、いいね数など）。

• get_comments(video_id, page_token)：YouTube 動画のコメントを取得し、ページングをサポートします。

  • パラメータ：
    • video_id: YouTube 動画の一意の識別子。
    • page_token: 追加のコメントを取得するためのページングトークン（オプション、デフォルトは null）。
  • 戻り値：
    • 現在のページのコメントリストと新しいページングトークン。

• get_comment_replies(comment_id, page_token)：特定のコメントのすべての返信を取得し、ページングをサポートします。

  • パラメータ：
    • comment_id: 特定のコメントの一意の識別子。
    • page_token: 追加の返信を取得するためのページングトークン（オプション、デフォルトは null）。
  • 戻り値：
    • 現在のページの返信リストと新しいページングトークン。

トラブルシューティング

• 400 エラーが発生した場合は、SerpAPI キーが有効であり、.env ファイルに正しく設定されていることを確認してください。
• サーバのログを確認して、詳細なエラー情報とデバッグデータを取得してください。
• コメント関連の問題が発生した場合は、SerpAPI が現在使用している YouTube Video API 形式をサポートしていることを確認してください。

📄 ライセンス

MIT