youtube toolkit

YouTube工具包

MCP服务器，用于YouTube内容分析、转录提取和创建者风格分析，具有智能缓存和速率限制保护。

该工具包使AI助手能够：

• 分析YouTube频道及其内容策略
• 提取视频转录，没有速率限制问题（使用智能缓存）
• 搜索YouTube并分析特定细分市场的趋势
• 比较创作者风格和教学方法
• 识别内容差距和机会
• 跟踪信道性能随时间的变化

Claude代码自定义命令

该工具包在 .claude/commands/ 自动化常见YouTube分析工作流程的目录：

• /分析渠道 -全面的渠道分析，包括指标、内容战略见解和增长机会
• /研究利基 -研究任何YouTube利基市场中的成功内容，以了解哪些内容有效
• /比较创作者 -比较多个视频之间的教学风格和内容方法
• /赛道表现 -通过详细分析跟踪渠道性能随时间的变化趋势
• /找出内容差距 -识别您所在细分市场中服务不足的主题和内容机会

要在Claude Code中使用这些命令：

1. 确保已安装并配置MCP服务器（请参阅下面的快速入门）
2. 类型 / 在Claude Code中查看可用命令
3. 例子： /analyze-channel "UCBJycsmduvYEL83R_U4JriQ"

这些命令自动处理数据获取、分析和报告生成的所有复杂性。

MCP客户快速入门

1.安装MCP服务器

# Install using uvx (recommended for stability)
uvx --from youtube-toolkit youtube-toolkit-server

2.配置您的MCP客户端

克劳德代码

# Add with automatic configuration
claude mcp add youtube-toolkit --uvx youtube-toolkit

# Or with full configuration including API key
claude mcp add-json -s user youtube-toolkit '{"type":"stdio","command":"uvx","args":["--from","youtube-toolkit","youtube-toolkit-server"],"env":{"YOUTUBE_API_KEY":"your-api-key-here","TRANSCRIPT_CACHE_DIR":"~/youtube-transcript-cache","DEFAULT_TRANSCRIPT_DELAY":"10.0","MAX_CACHE_AGE_DAYS":"30"}}'

适用于克劳德桌面

增添 ~/Library/Application Support/Claude/claude_desktop_config.json （macOS）或 %APPDATA%\Claude\claude_desktop_config.json （Windows）：

{
  "mcpServers": {
    "youtube-toolkit": {
      "command": "uvx",
      "args": ["--from", "youtube-toolkit", "youtube-toolkit-server"],
      "env": {
        "YOUTUBE_API_KEY": "your-youtube-api-key-here",
        "TRANSCRIPT_CACHE_DIR": "~/youtube-transcript-cache",
        "DEFAULT_TRANSCRIPT_DELAY": "10.0",
        "MAX_CACHE_AGE_DAYS": "30"
      }
    }
  }
}

对于克莱恩

增添 .vscode/settings.json 在您的项目中：

{
  "cline.MCP.mcpServers": {
    "youtube-toolkit": {
      "command": "uvx",
      "args": ["--from", "youtube-toolkit", "youtube-toolkit-server"],
      "env": {
        "YOUTUBE_API_KEY": "your-youtube-api-key-here",
        "TRANSCRIPT_CACHE_DIR": "~/youtube-transcript-cache",
        "DEFAULT_TRANSCRIPT_DELAY": "10.0",
        "MAX_CACHE_AGE_DAYS": "30"
      }
    }
  }
}

3.获取您的凭证（如果需要）

• YouTube API密钥 （可选但推荐）：获取 谷歌云控制台

1. 创建新项目或选择现有项目 1. 启用YouTube数据API v3 1. 创建凭据（API密钥） 1. 为安全起见，将密钥限制为YouTube Data API v3

备注：该工具包通过使用转录功能在没有API密钥的情况下工作，但频道/视频元数据需要API密钥。

4.开始使用工具

配置后，您可以要求您的AI助手：

• “分析YouTube频道UCBJycsmduvYEL83R_U4JriQ”
• “研究哪些内容在Python编程领域取得了成功”
• “比较这3个YouTube视频之间的教学风格：\[URL\]”
• “找出人工智能编码工具利基市场的内容差距”
• “跟踪过去90天UCxxxxxx频道的性能趋势”

特性

• 具有综合指标的YouTube频道分析
• 具有智能缓存和速率限制保护的转录提取
• 视频元数据获取（观看次数、点赞、持续时间等）
• 具有多种排序选项的YouTube搜索
• 内容差距识别和机会分析
• 支持stdio和SSE传输
• 自动旋转综合测井
• 跨平台兼容性（Linux、macOS、Windows）

可用工具

youtube_get_video_transcript

使用灵活的提取模式获取和缓存视频转录本。

参数：

• video_id （必填）：YouTube视频ID或URL
• extract_mode （可选，默认值：'full'）：'full'、'analysis'、'intro_only'或'outro_only'
• use_cache （可选，默认值：true）：使用缓存的转录（如果可用）
• delay_seconds （可选）：抓取前等待的秒数

退货：

• 带有计时数据和元数据（包括缓存状态）的转录文本

youtube_get_视频_元数据

获取YouTube视频的全面元数据。

参数：

• video_id （必填）：YouTube视频ID或完整URL
• include_statistics （可选，默认值：true）：包括查看/点赞/评论计数

退货：

• 视频标题、描述、频道信息、持续时间、统计数据等

youtube_get_channel_videos

列出YouTube频道的最新视频及其详细元数据。

参数：

• channel_id （必填）：YouTube频道ID（必须以“UC”开头）
• max_results （可选，默认值：10）：要返回的视频数量（1-50）
• include_transcripts （可选，默认值：false）：获取每个视频的转录
• use_cache （可选，默认值：true）：在可用时使用缓存的转录本
• delay_seconds （可选）：获取成绩单之间的秒数

退货：

• 频道信息和订阅者数量，包含元数据的视频数组

youtube搜索视频

使用排序选项搜索YouTube视频。

参数：

• query （必填）：搜索词
• max_results （可选，默认值：10）：结果数量（1-50）
• order （可选，默认：“相关性”）：按“相关性”、“日期”、“viewCount”或“评级”排序
• published_after （可选）：ISO 8601日期字符串

退货：

• 带有元数据的视频结果数组

youtube_get_channel_元数据

获取全面的渠道信息。

参数：

• channel_id （必填）：频道ID、用户名或句柄

退货：

• 频道标题、统计数据、品牌和配置

替代配置方法

使用不同的MCP客户端

上述配置适用于Claude Desktop、Claude Code和Cline。对于其他MCP客户端：

1. 使用 uvx --from youtube-toolkit youtube-toolkit-server 作为命令
2. 设置任何所需的环境变量
3. 有关具体配置格式，请参阅MCP客户的文档

从源代码运行（仅限开发）

对于源代码的开发或测试：

{
  "youtube_toolkit": {
    "command": "python",
    "args": ["-m", "youtube_toolkit.server.app"],
    "env": {
      "PYTHONPATH": "/path/to/youtube_toolkit"
    }
  }
}

故障排除

常见问题

1. “找不到工具”错误

- 确保服务器正在运行且配置正确 - 检查工具名称拼写是否正确（例如。， youtube_get_video_transcript) - 验证您的MCP客户端是否已连接到服务器

1. 未配置YouTube API密钥

- 该工具包仍将工作，但只有转录功能可用 - 频道和视频元数据工具将返回错误 - 添加 YOUTUBE_API_KEY 到您的环境配置

1. 速率限制错误

- 转录提取包括内置延迟，以防止速率限制 - 如果你仍然达到极限，增加 DEFAULT_TRANSCRIPT_DELAY - 缓存的成绩单在可用时会自动使用

1. 缓存目录问题

- 确保 TRANSCRIPT_CACHE_DIR 存在并且可写 - 默认值为 ~/youtube-transcript-cache - 缓存早于的文件 MAX_CACHE_AGE_DAYS 自动清洁

服务器连接问题

如果MCP服务器连接失败：

1. 验证是否已安装uvx:

   # Install uv if needed
   curl -LsSf https://astral.sh/uv/install.sh | sh  # macOS/Linux
   # Or for Windows:
   powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

1. 直接测试服务器:

   # This should output "YouTube Toolkit MCP Server running"
   uvx --from youtube-toolkit youtube-toolkit-server --version

1. 检查您的MCP客户端日志 有关特定错误消息

需求

• Python 3.11或3.12

• 操作系统：Linux、macOS、Windows

• YouTube Data API v3密钥（可选，用于完整功能）

• 互联网访问YouTube API和成绩单获取

• 对成绩单存储的缓存目录进行写访问

日志记录

服务器将所有活动记录到stderr和旋转日志文件中。日志文件存储在操作系统特定的位置：

• macOS: ~/Library/Logs/mcp-servers/youtube_toolkit.log
• Linux: ~/.local/state/mcp-servers/logs/youtube_toolkit.log
• 视窗: %LOCALAPPDATA%\mcp-servers\logs\youtube_toolkit.log

日志以10MB的速度轮换，保留5个备份。通过以下方式控制冗长 LOG_LEVEL:

LOG_LEVEL=DEBUG uvx youtube_toolkit-server

发展

有关开发设置、测试和贡献指南，请参阅 Developpent.md.

AI助手配置

有关AI编码助手（Claude、Cline等）的详细设置说明，请参阅 SETUP_PROMPT.md.

许可证

该项目根据MIT许可证获得许可。请参阅 许可证 文件以获取详细信息。

作者

蒂姆·基钦斯timkitch@codingthefuture.ai