用途:把 YouTube 视频字幕(transcript)索引成可搜索的知识库,便于检索频道内容。触发场景包括“index YouTube”“add YouTube channel”“update video index”“index transcripts”等。
主要能力:支持两种模式。模式一(推荐)依赖 solograph MCP,若可用 source_search、source_list、source_tags 等工具,则用 solograph 完成索引与语义搜索;模式二为无 MCP 的独立回退方案,直接用 yt-dlp 下载字幕并分析。
使用方式:先确认 yt-dlp 可用:which yt-dlp || echo "MISSING: install yt-dlp (brew install yt-dlp / pip install yt-dlp / pipx install yt-dlp)"。参数解析 $ARGUMENTS:为空或 all 时索引全部频道;给出频道 handle 时只索引这些频道;可选 -n <limit>(每频道最大视频数,默认 10)与 --dry-run(仅解析)。
模式一:安装 solograph 用 pip install solograph 或 uvx solograph;索引命令如 solograph-cli index-youtube -c GregIsenberg -n 10,多频道可重复 -c,全部频道直接 solograph-cli index-youtube -n 10,--dry-run 仅解析不写库;若命令不在 PATH 可用 uvx solograph-cli index-youtube -c <handle> -n 10。验证用 source_list、source_search("startup idea", source="youtube")、source_tags、source_related(video_id)。
模式二:用 yt-dlp --flat-playlist --print url 获取视频列表;用 --write-auto-sub --sub-lang en --skip-download --sub-format vtt 下载字幕;用 sed 与 awk 去除 VTT 格式;读取字幕提取标题、主题、要点、时间戳,写入 docs/youtube/index.md;用 grep -ri 搜索。
输出:报告索引视频数、下载与跳过的字幕数、含章节标记数、索引文件位置及搜索方式。
限制:无字幕的视频无法索引;YouTube 可能限流,可降低 -n、加 --sleep-interval 2 或 --cookies-from-browser chrome;solograph-cli 未安装或不在 PATH 时需先安装。具体收费、平台支持等资料暂未提供。