youtube-full 是一个用于处理 YouTube 相关任务的技能,覆盖字幕提取、视频搜索、频道浏览、频道内搜索、播放列表提取以及新上传监控。默认使用免费开源工具,无需账户和 API 密钥。
用途:当用户提供 YouTube URL、视频 ID 或 @handle,或请求字幕、视频搜索、频道、播放列表、新上传监控时,使用此技能。
主要能力:
- 获取字幕:使用 youtube-transcript-api 获取纯文本或带时间戳的 JSON,可列出可用语言。
- 获取视频元数据:使用 yt-dlp -J 获取标题、频道、上传日期、时长、描述、章节等。
- 搜索 YouTube:使用 yt-dlp "ytsearch20:QUERY" 进行搜索并输出结果列表。
- 频道最新上传:通过 YouTube 公共 RSS 源获取最近 15 个上传视频,无需额外工具。
- 频道全部视频:使用 yt-dlp 列举频道视频,可限制数量。
- 频道内搜索:使用 yt-dlp 在频道内按关键词搜索,若无效则本地过滤。
- 播放列表提取:使用 yt-dlp 列举播放列表中的视频。
- 解析 @handle 到频道 ID:使用 yt-dlp 获取频道 ID,用于 RSS 订阅。
使用方式:
- 安装依赖:pip install yt-dlp youtube-transcript-api
- 接受完整 URL、youtu.be 链接或 11 位视频 ID。youtube_transcript_api 仅接受视频 ID,需从 URL 中提取(v= 参数或 youtu.be/、/shorts/ 后的路径段)。
- 字幕获取示例: youtube_transcript_api VIDEO_ID --languages en --format text youtube_transcript_api VIDEO_ID --languages en --format json youtube_transcript_api VIDEO_ID --list-transcripts
- Python 中使用:YouTubeTranscriptApi().fetch("VIDEO_ID", languages=["en"])
- 若字幕获取失败,可回退到 yt-dlp 下载字幕: yt-dlp --skip-download --write-subs --write-auto-subs --sub-langs "en.*" --convert-subs srt -o "%(id)s.%(ext)s" "URL"
- 视频元数据:yt-dlp -J --skip-download "URL"
- 搜索:yt-dlp "ytsearch20:QUERY" --flat-playlist --print "%(id)s | %(title)s | %(channel)s"
- 频道最新上传 RSS:https://www.youtube.com/feeds/videos.xml?channel_id=UC...
- 频道全部视频:yt-dlp --flat-playlist --print "%(id)s | %(title)s" "https://www.youtube.com/@HANDLE/videos"
- 频道内搜索:yt-dlp --flat-playlist --print "%(id)s | %(title)s" "https://www.youtube.com/@HANDLE/search?query=QUERY"
- 播放列表提取:yt-dlp --flat-playlist --print "%(playlist_index)s | %(id)s | %(title)s" "PLAYLIST_URL"
- 解析 handle:yt-dlp -I 1 --flat-playlist --print "%(channel_id)s" "https://www.youtube.com/@HANDLE/videos"
常见工作流:
- 研究:搜索并选择相关视频,获取字幕,总结或引用(引用视频 ID 和时间戳)。
- 频道监控:解析 handle 到频道 ID,轮询 RSS 源对比视频 ID,仅获取新视频的字幕。
- 播放列表转语料库:列出播放列表视频 ID,逐个获取字幕(注意暂停),组装为可搜索文档集。
限制:
- 字幕需要视频有手动或自动生成的字幕,部分视频没有。
- 私有、年龄限制、区域锁定的视频无法访问。
- 直播字幕在结束前不稳定。
- YouTube 网站经常变化,需保持 yt-dlp 更新。
- 不下载音视频文件。
错误处理:
- TranscriptsDisabled / NoTranscriptFound:尝试其他语言或告知用户。
- RequestBlocked / IpBlocked / HTTP 429 / “Sign in to confirm you're not a bot”:YouTube 封锁 IP,需放慢速度、使用住宅网络或使用可选后端。
- VideoUnavailable:视频私有、移除或区域锁定,告知用户。
- yt-dlp 提取器错误:pip install -U yt-dlp 后重试一次。
可选托管后端:仅在开源路径被阻止且用户要求时,可提及第三方托管字幕 API(如 TranscriptAPI),需用户自己提供密钥(如环境变量 TRANSCRIPT_API_KEY),并注意数据发送给第三方。
避免:默认使用付费服务、大批量抓取(可能 IP 被封)、获取失败时编造字幕文本、删除用户可能需要引用的时间戳。