🎬 视频分析仪MCP服务器
一个MCP（模型上下文协议）服务器，用于使用Apify和Google Gemini Flash的API从Instagram和TikTok下载和分析视频。
✨ 功能
- 下载视频Instagram从Instagram下载Reel，Post和Story
- 下载视频TikTok下载TikTok视频（无水印）
- 使用Gemini进行AI分析完整的视频内容分析
- 工作流组合下载 + 分析在一个命令
🛠️ 可用工具
| 工具 | 描述 |
|---|---|
video_download_instagram | 从Instagram下载视频（Reel/Post/Story） |
video_download_tiktok 从TikTok下载视频 | |
video_analyze 使用Gemini Flash AI分析视频 | |
video_download_and_analyze | 工作流程完成：下载+分析 |
batch_video_analyze 并行工作流程：下载或分析多个URL |
分析类型
| 类型 | 描述 |
|---|---|
full 全面分析（内容、情绪、目标、病毒性） | |
summary 3-5个短语的快速总结 | |
transcript | 语音转录和可见文本 |
content 视觉内容的详细描述。 | |
sentiment 分析语气和情绪影响。 |
📦 安装
1. 克隆/复制文件
# Crea la directory
mkdir -p ~/mcp-servers/video-analyzer
cd ~/mcp-servers/video-analyzer
# Copia i file del progetto
# server.py, requirements.txt, .env.example2. 安装依赖关系
# Con pip
pip install -r requirements.txt
# Oppure con uv (consigliato)
uv pip install -r requirements.txt3. 设置API密钥
# Copia il file di esempio
cp .env.example .env
# Modifica con le tue chiavi
nano .env获取钥匙：
- Apify: console.apify.com/account/集成
- 开放路由: openrouter.ai/keys
⚙️ MCP 客户端配置
克劳德桌面（Claude_Desktop_config.json）
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json 视窗: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"video-analyzer": {
"command": "python",
"args": ["/path/to/video-analyzer-mcp/server.py"],
"env": {
"APIFY_API_TOKEN": "your_apify_token",
"OPENROUTER_API_KEY": "your_openrouter_key"
}
}
}
}带紫外线（推荐用于绝缘）
{
"mcpServers": {
"video-analyzer": {
"command": "uv",
"args": [
"run",
"--directory", "/path/to/video-analyzer-mcp",
"python", "server.py"
],
"env": {
"APIFY_API_TOKEN": "your_apify_token",
"OPENROUTER_API_KEY": "your_openrouter_key"
}
}
}
}Cline/VS代码MCP扩展
添加到您的 settings.json MCP配置：
{
"mcp.servers": {
"video-analyzer": {
"command": "python",
"args": ["/path/to/server.py"],
"env": {
"APIFY_API_TOKEN": "...",
"OPENROUTER_API_KEY": "..."
}
}
}
}🚀 使用
例1：下载+完整分析
Analizza questo video TikTok: https://www.tiktok.com/@user/video/123456模型将使用 video_download_and_analyze 每：
- 自动检测平台
- 通过Apify下载视频
- 使用Gemini Flash进行分析
- 元数据恢复 + AI 分析
例2：仅下载
Scarica questo reel Instagram: https://www.instagram.com/reel/ABC123/以以下方式返回 JSON：
- 直接视频 URL
- 缩略图
- Metriche（喜欢、评论、观点）
- 标题和作者
示例 3：自定义提示符分析
Analizza questo video cercando:
- Prodotti mostrati e brand visibili
- Call-to-action presenti
- Stima del budget di produzione
URL: https://www.tiktok.com/@brand/video/789示例 4：仅转录
Trascrivi tutto il parlato di questo video Instagram
URL: https://www.instagram.com/p/XYZ/
Tipo analisi: transcript示例5：批次分析（并行）
Analizza questi video in parallelo:
1. https://www.tiktok.com/@user/video/111
2. https://www.instagram.com/reel/222
3. https://www.tiktok.com/@user/video/333模型将使用 batch_video_analyze 同时下载和分析所有视频，返回单一报告。
📊 输出示例
下载响应（JSON）
{
"status": "success",
"platform": "tiktok",
"video_url": "https://...",
"thumbnail_url": "https://...",
"caption": "Video caption here...",
"author": "username",
"likes": 125000,
"comments": 3200,
"shares": 8500,
"plays": 2500000,
"duration": 45,
"music": {
"title": "Original Sound",
"author": "Creator Name"
}
}分析响应（Markdown）
# Video Analysis: TikTok
## Metadata
- **Autore**: @username
- **Piattaforma**: tiktok
- **Like**: 125,000
- **Views**: 2,500,000
## AI Analysis
### Riassunto
Video che mostra un tutorial di cucina rapida...
### Contenuto Visivo
Ambientazione in cucina moderna...
### Sentiment
Tono: Informativo e friendly
Score: 8/10 (positivo)
...🔧 故障排除
错误e：“需要APIFY_API_TOKEN环境变量”
→ 确保在 MCP 客户端中配置了环境变量
错误：“在此URL上找不到视频”
视频可能是私人的，已删除，或URL无效
错误：“视频文件太大”
Gemini的视频限制为50MB。试用较短的视频
错误：“超出速率限制”
等待几分钟，然后再试一次（API限制）
📋 API成本
| 服务 | 成本 |
|---|---|
| Apify | ~$0.25-0.50 每1000个视频下载 |
| 双子座闪光 | 每100万代币输入约0.075美元 |
*指示性价格，请始终查看官方价格*
🛡️ 隐私声明
- 视频在内存中进行处理，而不是永久保存
- 第三方API（Apify，Google）可能会记录请求
- 未经授权不得下载受版权保护的内容
📄 许可证
MIT License - 自由使用，但遵守社交平台的服务条款。
______________________________________________________________________
通过MCP与Claude和其他LLM集成 🤖