Video Analyzer MCP

🎬 视频分析仪MCP服务器

一个MCP（模型上下文协议）服务器，用于使用Apify和Google Gemini Flash的API从Instagram和TikTok下载和分析视频。

✨ 功能

• 下载视频Instagram从Instagram下载Reel，Post和Story
• 下载视频TikTok下载TikTok视频（无水印）
• 使用Gemini进行AI分析完整的视频内容分析
• 工作流组合下载 + 分析在一个命令

🛠️ 可用工具

分析类型

📦 安装

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.example

2. 安装依赖关系

# Con pip
pip install -r requirements.txt

# Oppure con uv (consigliato)
uv pip install -r requirements.txt

3. 设置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 每：

1. 自动检测平台
2. 通过Apify下载视频
3. 使用Gemini Flash进行分析
4. 元数据恢复 + 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成本

*指示性价格，请始终查看官方价格*

🛡️ 隐私声明

• 视频在内存中进行处理，而不是永久保存
• 第三方API（Apify，Google）可能会记录请求
• 未经授权不得下载受版权保护的内容

📄 许可证

MIT License - 自由使用，但遵守社交平台的服务条款。

______________________________________________________________________

通过MCP与Claude和其他LLM集成 🤖