Serpapi Youtube MCP Server

🚀 YouTube 數據 MCP 服務器

這是一個基於 Model Context Protocol (MCP) 的服務器，專門用於提取 YouTube 視頻的文字稿和評論。藉助該服務器，你能夠輕鬆獲取 YouTube 視頻的文字稿和評論，為後續的分析和總結工作提供有力支持。

🚀 快速開始

本服務器提供了一系列實用工具，可用於獲取 YouTube 視頻的文字稿和評論，方便進行分析和總結。

✨ 主要特性

• getTranscript：從 YouTube 視頻中提取字幕/文字稿。
• getVideoInfo：獲取 YouTube 視頻的基本信息。
• getReplies：檢索 YouTube 視頻的評論（使用 SerpAPI）。
• getCommentReplies：獲取特定 YouTube 評論的回覆。

📦 安裝指南

開發者安裝步驟

# 克隆倉庫
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）。
  • 返回：
    • 當前頁面的回覆列表和新的分頁標記。

🔧 技術細節

需求

• Node.js 16+
• TypeScript
• SerpAPI API 密鑰（用於評論功能）

故障排除

• 如果遇到 400 錯誤，請檢查您的 SerpAPI 密鑰是否有效且正確設置在 .env 文件中。
• 查看服務器日誌以獲取詳細錯誤信息和調試數據。
• 對於評論相關問題，請確保 SerpAPI 支持當前使用的 YouTube Video API 格式。

📄 許可證

本項目採用 MIT 許可證。