AI导哈

YouTube视频洞察提取工具

一个通过MCP服务器获取YouTube视频字幕并使用Claude提取结构化洞察的工具，提供6种预设分析领域和24个洞察类别。

  • by guardkit
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 guardkit/youtube-transcript-mcp

使用说明

youtube洞察mcp

一个MCP服务器，使用Claude获取YouTube转录本并提取结构化见解。提供4个MCP工具和一个完整的CLI，在24个洞察类别中有6个焦点区域预设。

特性

  • 转录提取 具有智能语言回退功能
  • 结构化洞察分析 涵盖24个类别（商业、投资、技术、YouTube增长、人工智能学习）
  • 6个焦点区域预设：综合、创业、投资、技术、youtube频道、人工智能学习
  • 多种URL格式：youtube.com、youtu.be、嵌入链接或只是一个视频ID
  • 双模式：用于Claude Desktop的MCP服务器+独立CLI
  • Claude代码技能: /yt-insights 用于交互式洞察提取的slash命令
  • 智能分块 用于具有重叠的长转录本，以实现上下文连续性
  • 代理支持 适用于具有IP限制的环境

先决条件

你需要Python 3.10或更高版本。检查是否已安装：

python3 --version

如果没有安装Python：

  • macOS: brew install python （要求 家酿)或从以下网址下载 python.org
  • 视窗：从下载 python.org （安装时勾选“添加到PATH”）
  • Linux: sudo apt install python3 python3-pip （Debian/Ubuntu）或 sudo dnf install python3 python3-pip （Fedora）

安装

我们建议在虚拟环境中安装，以避免与其他Python包冲突：

# Create and activate a virtual environment
python3 -m venv youtube-mcp-env
source youtube-mcp-env/bin/activate  # On Windows: youtube-mcp-env\Scripts\activate

# Install the package
pip install youtube-insights-mcp

故障排除： 如果你看到 ModuleNotFoundError: No module named 'pip'，您的系统Python配置错误。首先创建一个虚拟环境（如上所示）——这为您提供了一个干净、可用的pip。

快速开始

Claude桌面配置

安装后，找到命令的绝对路径：

which youtube-insights-mcp

然后添加到您的Claude Desktop MCP配置中(claude_desktop_config.json):

{
  "mcpServers": {
    "youtube-insights-mcp": {
      "command": "/absolute/path/to/youtube-mcp-env/bin/youtube-insights-mcp",
      "env": {
        "LOG_LEVEL": "INFO"
      }
    }
  }
}

替换 /absolute/path/to/youtube-mcp-env/bin/youtube-insights-mcp 输出来自 which youtube-insights-mcp.

重要提示： Claude Desktop不使用shell的PATH或虚拟环境。您必须提供 完全绝对路径 命令。仅使用 "command": "youtube-insights-mcp" 除非在系统PATH上全局安装，否则将失败。

启动服务器

使用克劳德桌面 --无需手动启动。Claude Desktop使用上述配置自动启动和管理服务器进程。添加配置后，只需重新启动Claude Desktop。

手动启动 （用于测试或其他MCP客户端）：

# Start the MCP server (stdio transport)
youtube-insights-mcp

# Or using Python module directly
python -m youtube_insights_mcp

服务器使用MCP JSON-RPC协议通过stdin/stdout进行通信。它被设计为由MCP客户端（如Claude Desktop）启动，而不是交互式运行。

CLI使用情况

# Health check
youtube-insights-mcp cli ping

# Fetch a transcript
youtube-insights-mcp cli get-transcript "https://www.youtube.com/watch?v=VIDEO_ID"

# List available transcript languages
youtube-insights-mcp cli list-transcripts "https://www.youtube.com/watch?v=VIDEO_ID"

# Extract insights (pipe transcript from stdin)
youtube-insights-mcp cli get-transcript VIDEO_ID --no-segments | \
  jq -r '.full_text' | \
  youtube-insights-mcp cli extract-insights - --focus "entrepreneurial,investment"

# List all focus areas and categories
youtube-insights-mcp cli list-focus-areas

MCP工具

get_transcript

使用智能语言回退功能获取YouTube视频的文字记录。

参数 类型 默认值 说明
video_url string 必填 YouTube URL或视频ID
language 字符串 "en" 首选语言代码

回退顺序：请求的语言>自动生成的版本>任何英语变体>第一个可用。

list_available_transcripts

列出视频的所有可用转录语言。可用于在提取之前检查可用内容。

参数 类型 默认值 说明
video_url string 必填 YouTube URL或视频ID

extract_insights

为克劳德的结构化见解提取准备一份成绩单。返回提取提示、类别和分块转录数据。

参数 类型 默认值 说明
transcript string 必填 完整转录文本（至少100个字符）
focus_areas 字符串 "general" 逗号分隔的焦点区域
video_id 字符串 "" 用于跟踪的可选视频ID
max_insights 字符串 "10" 可提取的最大见解

list_focus_areas

列出所有可用的焦点区域预设及其类别定义。

重点领域

预设 类别
通用 关键点、行动项目、名言、背景
创业的 商业战略、增长策略、经验教训、应避免的错误
投资 市场趋势、机遇、风险、建议
技术的 技术、工具、最佳实践、陷阱
youtube频道 渠道策略、内容创意、受众增长、制作技巧
人工智能学习 人工智能概念、人工智能工具、心智模型、实际应用

使用 "all" 在每个类别中提取或组合预设： "entrepreneurial,investment".

克劳德桌面提示示例

配置MCP服务器后，您可以直接在Claude Desktop中使用这些提示：

成绩单和总结

获取以下内容的成绩单https://www.youtube.com/watch?v=VIDEO_ID给我一个简明的总结

获取此视频的文字记录，并列出5个最重要的要点：https://youtu.be/VIDEO_ID

商业与创业

获取以下内容的成绩单https://www.youtube.com/watch?v=VIDEO_ID并提取创业见解-专注于可操作的商业战略和增长策略

分析这一创业宣传，找出关键的商业模式、收入策略和错误，以避免：https://www.youtube.com/watch?v=VIDEO_ID

投资分析

获取此市场分析视频的文字记录，并提取投资见解，包括趋势、机遇和风险：https://www.youtube.com/watch?v=VIDEO_ID

技术学习

获取本次技术讲座的文字记录，并提取提到的关键技术、最佳实践和常见陷阱：https://www.youtube.com/watch?v=VIDEO_ID

总结本编程教程，并列出推荐的工具和框架：https://youtu.be/VIDEO_ID

YouTube频道增长

分析这段关于发展YouTube频道的视频，并提取内容策略技巧、受众增长策略和制作建议：https://www.youtube.com/watch?v=VIDEO_ID

人工智能与机器学习

获取本次人工智能演讲的文字记录，并提取关键概念、提到的工具和实际应用：https://www.youtube.com/watch?v=VIDEO_ID

多焦点分析

获取以下内容的成绩单https://www.youtube.com/watch?v=VIDEO_ID并从创业和投资类别中提取见解——我想要商业战略和市场机会

比较视频

获取这两个视频的成绩单，并比较他们对创业的建议：

  • https://www.youtube.com/watch?v=VIDEO_ID_1
  • https://www.youtube.com/watch?v=VIDEO_ID_2

与Claude Code和Cowork一起使用

该项目包括 /yt-insights 技能为 克劳德代码 它提供了一个交互式工作流程，用于从YouTube视频中提取见解。它同时适用于Claude Code（终端）和Claude Cowork（协作模式）。

设置

  1. 克隆存储库并将MCP服务器添加到您的Claude Code配置中(.mcp.json):
{
  "mcpServers": {
    "youtube-insights-mcp": {
      "command": "/absolute/path/to/youtube-mcp-env/bin/youtube-insights-mcp",
      "env": {
        "LOG_LEVEL": "INFO"
      }
    }
  }
}
  1. 这 /yt-insights 技能自动从项目的 .claude/commands/ 目录。

用法

在Claude Code或Cowork中运行该技能：

/yt-insights https://www.youtube.com/watch?v=VIDEO_ID

或者只是 /yt-insights 它将提示您输入URL。

该技能将：

  1. 请您选择重点领域（一般、创业、投资、技术、youtube频道、人工智能学习或全部）
  2. 获取视频记录
  3. 使用Claude提取结构化见解
  4. 保存两个markdown文件：
    • 洞察 --结构化分析，包括关键报价、行动项目和分类见解
    • 转录本 --全文供日后参考

联合工作模式

在协作中，技能会自动转换为协作技能。它直接使用MCP工具（而不是CLI命令），这意味着它通过MCP协议连接到youtube insights MCP服务器，以获得无缝体验。

配置

代理支持

如果YouTube屏蔽了您的IP，请通过环境变量配置代理：

{
  "env": {
    "PROXY_URL": "http://user:pass@proxy:8080",
    "WEBSHARE_USERNAME": "",
    "WEBSHARE_PASSWORD": ""
  }
}

优先级：网络共享凭据>PROXY_URL>无代理。

需求

  • Python>=3.10
  • 依赖关系： mcp, pydantic, youtube-transcript-api, yt-dlp

许可证

麻省理工学院

相关 MCP