多平台视频下载 + 本地转录

功能特点

• ✅ yt-dlp 免费下载 — B站/抖音/TikTok/YouTube/小红书/微博/快手
• ✅ MLX Whisper — Apple Silicon 原生 Metal GPU 加速（Mac M系列首选）
• ✅ faster-whisper — CPU/CUDA 通用兜底（非 Apple Silicon 也能用）
• ✅ 短视频同步转录 — <5 分钟视频直接返回完整结果
• ✅ 长视频后台转录 — ≥5 分钟自动后台运行，返回 transcript_id 可查询
• ✅ 可检索 — 转录结果支持关键词查询相关片段 + 时间戳

支持的平台

MCP 工具（9个）

analyze_video（分析视频）

mcporter call douyin-analyzer.analyze_video url="https://..."

• 短视频（<5min）：同步返回 transcript + segments
• 长视频（≥5min）：立即返回 transcript_id，后台转录中

get_transcript（获取转录结果）

mcporter call douyin-analyzer.get_transcript transcript_id="<id>"

query_transcript（检索转录内容）

mcporter call douyin-analyzer.query_transcript transcript_id="<id>" query="关键词" top_k=3

get_video_info（仅获取信息）

mcporter call douyin-analyzer.get_video_info url="https://..."

download_video（下载到本地）

mcporter call douyin-analyzer.download_video url="https://..." output_dir="/tmp/"

返回结构

{
  "status": "ready",
  "transcript_id": "47cd0a6f47d2",
  "video_info": { "title": "...", "duration": 885, "uploader": "..." },
  "transcript": "完整转录文本...",
  "segments": [
    { "start": 0.0, "end": 5.5, "text": "今天我们来聊..." }
  ]
}

环境变量

工作流程

发送视频链接 → analyze_video
    ├── <5min：直接返回 transcript + segments
    └── ≥5min：返回 transcript_id
              → 等待几秒 → get_transcript transcript_id
              → 拿到 transcript + segments
              → 直接让我总结 / query_transcript 检索关键词

MLX Whisper 本地转录（补充说明）

环境变量（关键！）

mlx_whisper 即使模型已缓存，运行时会尝试连接 HuggingFace Hub 验证 repo 元数据（可能触发 401 认证错误）。解决方案：强制离线模式。

import os
os.environ["HF_HUB_OFFLINE"] = "1"  # 必须放在 import mlx_whisper 之前！

import mlx_whisper
result = mlx_whisper.transcribe(
    "/path/to/video.mp4",
    path_or_hf_repo="mlx-community/whisper-small-mlx",
    verbose=True
)

推荐 Whisper 模型

本地缓存路径：~/.cache/huggingface/hub/ 或 ~/.cache/mlx/

常见问题