ytch MCP

YouTube频道分析器MCP服务器

📁 项目文件结构

youtube-channel-analyzer/
├── src/
│   └── server.py                     # Main MCP server code
├── requirements.txt                   # Python dependencies
├── README.md                         # Project documentation
├── .env.example                      # Environment variables example
└── setup.py                         # Package setup (optional)

🚀 安装说明

1.创建项目目录

mkdir youtube-channel-analyzer
cd youtube-channel-analyzer

2.创建虚拟环境

python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

3.安装依赖项

pip install -r requirements.txt

4.获取YouTube API密钥

1. 首选 谷歌云控制台
2. 创建新项目或选择现有项目
3. 启用YouTube数据API v3
4. 创建凭据（API密钥）
5. 将API密钥限制为YouTube Data API v3（推荐）

5.创建环境文件（可选）

# Create .env file
echo "YOUTUBE_API_KEY=your_api_key_here" > .env

YouTube频道分析器MCP服务器

📁 项目文件结构

youtube-channel-analyzer/
├── src/
│   └── server.py                     # Main MCP server code
├── requirements.txt                   # Python dependencies
├── README.md                         # Project documentation
├── .env.example                      # Environment variables example
├── claude_desktop_config.json        # Claude Desktop configuration
└── setup.py                         # Package setup (optional)

🚀 Claude桌面设置说明

1.创建项目目录

mkdir youtube-channel-analyzer
cd youtube-channel-analyzer
mkdir src

2.创建虚拟环境

python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

3.安装依赖项

pip install mcp httpx python-dateutil

4.获取YouTube API密钥

1. 首选 谷歌云控制台
2. 创建新项目或选择现有项目
3. 启用YouTube数据API v3
4. 创建凭据（API密钥）
5. 将API密钥限制为YouTube Data API v3（推荐）

5.保存服务器代码

复制主服务器代码并将其另存为 src/server.py

6.配置克劳德桌面

创建或编辑您的Claude Desktop配置文件：

在 macOS 上： ~/Library/Application Support/Claude/claude_desktop_config.json 在Windows上： %APPDATA%\Claude\claude_desktop_config.json

添加此配置：

{
  "mcpServers": {
    "youtube-analyzer": {
      "command": "python",
      "args": ["/full/path/to/your/youtube-channel-analyzer/src/server.py"],
      "env": {
        "YOUTUBE_API_KEY": "your_youtube_api_key_here"
      }
    }
  }
}

重要提示： 替换 /full/path/to/your/youtube-channel-analyzer/ 使用项目目录的实际绝对路径。

7.重新启动克劳德桌面

关闭并重新打开Claude Desktop以使配置生效。

🔧 在Claude Desktop中使用该工具

配置后，您可以直接在Claude Desktop对话中使用该工具：

示例用法：

Analyze this YouTube channel: https://www.youtube.com/@MrBeast

或

Can you check if this channel is still active? https://www.youtube.com/channel/UC_x5XG1OV2P6uZZ5FSM9Ttw

支持的URL格式：

• https://www.youtube.com/channel/UC_x5XG1OV2P6uZZ5FSM9Ttw
• https://www.youtube.com/c/ChannelName
• https://www.youtube.com/user/Username
• https://www.youtube.com/@Handle

🔧 API密钥使用手册

如果您不希望在环境中设置API密钥，可以直接提供：

Analyze this channel with API key: https://www.youtube.com/@channel_name
API Key: your_api_key_here

🐛 故障排除

服务器未显示

1. 检查中的文件路径 claude_desktop_config.json 是正确和绝对的
2. 确保Python在你的PATH中
3. 验证是否已安装所有依赖项
4. 检查Claude Desktop日志是否有错误

API关键问题

1. 确保您的API密钥有效
2. 检查YouTube Data API v3是否已在Google云控制台中启用
3. 验证尚未超过API配额

Windows上的路径问题

在配置中使用正斜杠或双反斜杠：

"args": ["C:/path/to/your/project/src/server.py"]

或

"args": ["C:\\path\\to\\your\\project\\src\\server.py"]

📊 分析指标

服务器根据以下内容分析频道：

1.最近的活动（40%重量）

• 过去30天内的上传
• 自上次视频以来的天数
• 上传频率模式

2.参与度指标（30%权重）

• 每个视频的平均浏览量
• 中值视图
• 查看一致性

3.用户基础（20%权重）

• 用户总数
• 渠道覆盖潜力

4.含量体积（10%重量）

• 视频总数
• 内容库大小

🎯 判决尺度

• 🟢 非常活着 （70-100分）：高活跃频道
• 🟡 活着 （50-69分）：定期活跃频道
• 🟠 下降 （30-49分）：活动减少
• 🔴 差点死了 （15-29分）：活动最少
• 💀 死 （0-14分）：非活动通道

📋 样本输出

# YouTube Channel Analysis Report

## 📊 Channel Overview
**Name:** MrBeast
**Subscribers:** 123,456,789
**Total Videos:** 234
**Total Views:** 12,345,678,901
**Created:** 2012-02-20

## 🎯 Verdict: 🟢 VERY ALIVE
**Health Score:** 85/100

### Analysis Factors:
• Very active uploads (4+ videos/month)
• High average views (10K+)
• Large subscriber base (100K+)
• Substantial content library (100+ videos)

## 📈 Recent Activity Metrics
**Videos Analyzed:** 50 recent videos
**Upload Frequency:** Very Active (15+ videos/month)
**Uploads Last 30 Days:** 8
**Average Days Between Uploads:** 3.5

## 👁️ View Metrics
**Average Views:** 50,123,456
**Median Views:** 45,678,901
**Total Views (Recent Videos):** 2,506,172,800

## 📺 Content Activity
**Videos in Last Year:** 45

## 🎬 Latest Video
**Title:** I Gave Away $1,000,000
**Published:** 2024-05-25
**Views:** 75,432,109

🔧 高级配置

自定义评分权重

您可以在 analyze_channel_health 方法：

# Current weights:
# Recent activity: 40%
# Engagement: 30%
# Subscribers: 20%
# Content volume: 10%

分析参数

• 最近分析的视频：50（可配置）
• “最近”的时间段：30天
• 年度分析：过去365天

🛠️ 发展

添加新功能

1. 扩展 YouTubeAnalyzer 类
2. 在分析中添加新指标
3. 更新评分算法
4. 修改报告格式

错误处理

该服务器包括全面的错误处理功能，用于：

• 无效的YouTube URL
• API费率限制
• 缺少频道
• 网络问题

📄 许可证

该项目是开源的，可在MIT许可证下使用。