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.创建项目目录```bash
mkdir youtube-channel-analyzer
cd youtube-channel-analyzer
2.创建虚拟环境```bash
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
### 3.安装依赖项```bash
pip install -r requirements.txt
4.获取YouTube API密钥
- 首选 谷歌云控制台
- 创建新项目或选择现有项目
- 启用YouTube数据API v3
- 创建凭据(API密钥)
- 将API密钥限制为YouTube Data API v3(推荐)
5.创建环境文件(可选)```bash
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.创建项目目录```bash
mkdir youtube-channel-analyzer
cd youtube-channel-analyzer
mkdir src
### 2.创建虚拟环境```bash
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
3.安装依赖项```bash
pip install mcp httpx python-dateutil
### 4.获取YouTube API密钥
1. 首选 谷歌云控制台
1. 创建新项目或选择现有项目
1. 启用YouTube数据API v3
1. 创建凭据(API密钥)
1. 将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`
添加此配置:```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_x5XG1OV2P6uZZ5FSM9Ttwhttps://www.youtube.com/c/ChannelNamehttps://www.youtube.com/user/Usernamehttps://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` 是正确和绝对的
1. 确保Python在你的PATH中
1. 验证是否已安装所有依赖项
1. 检查Claude Desktop日志是否有错误
### API关键问题
1. 确保您的API密钥有效
1. 检查YouTube Data API v3是否已在Google云控制台中启用
1. 验证尚未超过API配额
### Windows上的路径问题
在配置中使用正斜杠或双反斜杠:```json
"args": ["C:/path/to/your/project/src/server.py"]
或```json
"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 方法:```python
Current weights:
Recent activity: 40%
Engagement: 30%
Subscribers: 20%
Content volume: 10%
```
分析参数
- 最近分析的视频:50(可配置)
- “最近”的时间段:30天
- 年度分析:过去365天
🛠️ 发展
添加新功能
- 扩展
YouTubeAnalyzer类 - 在分析中添加新指标
- 更新评分算法
- 修改报告格式
错误处理
该服务器包括全面的错误处理功能,用于:
- 无效的YouTube URL
- API费率限制
- 缺少频道
- 网络问题
📄 许可证
该项目是开源的,可在MIT许可证下使用。
