youtube-full

youtube-full 是一个基于 TranscriptAPI 的 YouTube 数据获取技能，用于获取字幕、搜索视频、浏览频道、频道内搜索、提取播放列表以及监控新上传。它被定位为 ingest-youtube 的 API 替代方案：ingest-youtube 使用 yt-dlp，而 yt-dlp 在云服务器 IP 上会失效；youtube-full 则调用 TranscriptAPI 的 API，可在任意运行时工作，包括本地机器、云服务器、无服务器函数或 CI 环境。据资料，该技能通过 skills CLI 有 686 次安装。

用途与适用场景

该技能适用于以下情况：用户要求获取、抓取或检索某个 YouTube 视频的字幕；用户要求按主题搜索 YouTube 视频；用户希望监控某个频道的新上传；用户需要频道元数据、视频列表或播放列表内容；智能体部署在云服务器上，yt-dlp 调用失败（YouTube 屏蔽云 IP）；从 YouTube 会议演讲、教程或访谈构建研究语料；竞品情报，即监控竞争对手频道的新内容。

不适用的情况包括：下载实际的视频或音频文件（应直接使用 yt-dlp 并加 -f best）；获取 YouTube 评论、点赞或互动数据（API 中不包含）；访问私密或年龄限制视频（无用户认证时不可访问）；直播字幕（直播结束前不稳定）。

安装与使用方式

第一步，安装技能：npx skills add ZeroPointRepo/youtube-skills --skill youtube-full。附带 100 个免费额度。首次调用时通过 TranscriptAPI OAuth 自动配置 API 密钥，无需手动设置。

第二步，通过向 Claude 提问来使用，例如：获取 https://www.youtube.com/watch?v=VIDEO_ID 的字幕；搜索 YouTube 上的“LLM reasoning 2026”并总结前 3 个结果；@3Blue1Brown 的最新上传有哪些；列出此播放列表中的所有视频：https://www.youtube.com/playlist?list=PLAYLIST_ID。

第三步，可用操作。get_transcript(video_id) 获取字幕，消耗 1 额度；search_youtube(query) 搜索 YouTube，每页 1 额度；get_channel_videos(handle) 获取频道视频列表，每页 1 额度；search_in_channel(handle, query) 频道内搜索，每页 1 额度；get_playlist_videos(playlist_id) 提取播放列表，每页 1 额度；channel_latest(handle) 跟踪新上传，免费；channel_resolve(handle) 解析频道句柄，免费。失败或限流的调用消耗零额度。

示例

示例一，从会议演讲构建研究语料：搜索 YouTube 上的“NeurIPS 2025 keynote”并获取前 5 个结果的字幕，总结所有演讲的主要主题。智能体调用 search_youtube，选择前 5 个结果，对每个结果调用 get_transcript，然后进行综合。

示例二，竞品频道监控：检查 @AnthropicAI 和 @OpenAI 频道在过去一周内是否有新视频。对每个新视频获取字幕并提取任何产品公告。智能体对每个频道调用 channel_latest（免费），获取新上传的字幕，并提取信号。

示例三，带时间戳的直接字幕：获取 https://www.youtube.com/watch?v=dQw4w9WgXcQ 的带时间戳完整字幕。智能体调用 get_transcript(video_id, timestamps=true) 并返回全文。

最佳实践

在 get_transcript 之前使用 channel_latest（免费）检查视频是否为新视频；在工作流中缓存字幕，因为每次 get_transcript 调用消耗 1 额度；当已知频道时使用 search_in_channel 以避免宽泛搜索的噪声；对于课程或讲座系列，优先使用 get_playlist_videos，比按查询搜索更便宜；除非用户明确要求，不要批量转录整个频道；当已有视频 URL 时不要使用 search_youtube，直接跳到 get_transcript。

限制

该技能不能替代特定环境的验证、测试或专家审查。如果缺少必需的输入、权限或安全边界，应停止并请求澄清。字幕仅在 YouTube 有字幕（手动或自动生成）时可用，部分视频没有字幕。超出免费 100 额度层级后需要 API 密钥，可在 transcriptapi.com 获取。存在速率限制：月度计划为 200 RPM，年度计划为 300 RPM，更高限制需联系支持。

安全与安全说明

该技能向 transcriptapi.com 发起 HTTPS API 调用，不写入本地数据。API 密钥存储在智能体的凭据存储中，而非此 SKILL.md 中。无 shell 命令、无二进制执行、无本地系统变更。风险等级：安全。

常见陷阱

问题：智能体在云服务器上运行时 yt-dlp 失败。解决方案：这正是 youtube-full 的用例。API 通过 TranscriptAPI 的基础设施路由，可在任意云运行时工作。问题：工作流中途额度耗尽。解决方案：在获取前使用 channel_latest（免费）检查；使用有针对性的搜索只获取需要的视频。问题：视频没有可用字幕。解决方案：API 返回结构化错误（不扣额度）。请用户提供替代来源。

技能介绍