youtube-full

核心功能

YouTube Full 是基于 TranscriptAPI.com 的综合性 YouTube 数据访问工具，提供六大核心能力：

1. 视频转录（1 credit）

支持提取带时间戳的字幕文本，可输出 JSON 或纯文本格式，同时返回视频元数据（标题、作者、缩略图）。支持直接传入 YouTube URL 或 11 位视频 ID。

2. 全局搜索（1 credit）

可搜索视频或频道，支持 1-50 条结果自定义，查询长度 1-200 字符，适合快速定位目标内容。

3. 频道管理（部分免费）

• Handle 解析：免费将 @用户名 转为标准 channel_id
• 最新 15 条视频：免费获取，包含精确播放量和 ISO 格式发布时间
• 完整视频列表：1 credit/页，每页 100 条，支持翻页续传
• 频道内搜索：1 credit，精准定位频道历史内容

4. 播放列表（1 credit/页）

支持 PL/UU/LL/FL/OL 前缀的标准播放列表，返回完整列表元数据及分页续传 token。

显著优点

• 成本可控：核心监控功能（解析 Handle、获取最新视频）完全免费，适合长期自动化追踪
• 数据结构化：所有返回均为标准 JSON，包含完整的元数据和时间戳，便于下游处理
• 分页友好：频道视频和播放列表均支持 continuation token 续传，可处理大规模数据
• 验证严格：内置正则校验（channel_id、playlist_id 格式），减少无效请求

局限性与风险

• 依赖第三方服务：TranscriptAPI 为商业 API，存在服务中断、价格调整、速率限制等外部风险
• 字幕覆盖率：部分视频无字幕或仅限自动生成，返回 404
• 配额消耗：高频场景（如完整频道归档） credits 消耗较快，免费额度仅 100 credits
• 地理/内容限制：部分视频因地区限制或私享状态无法访问

适合人群

• 内容研究者：需要批量获取视频转录进行分析
• 频道运营者：监控竞品动态、追踪热点话题
• AI 开发者：构建基于 YouTube 内容的 RAG 应用或训练数据管道
• 自动化工作流：结合 cron 或 n8n 实现定期内容抓取

常规风险提示

• API Key 需妥善保管，避免泄露导致配额被盗用
• 注意 429 速率限制，生产环境应实现指数退避重试
• 408 超时错误建议 2 秒后重试一次
• 需关注 credits 余额，402 错误时及时充值或降级免费功能

核心用法

youtube-full 是一套完整的 YouTube 数据获取工具集，基于 TranscriptAPI.com 服务实现。该 Skill 为纯 Markdown 文档（T-MD 分类），不包含可执行代码，所有功能通过外部 API 调用完成。

主要功能模块：

| 功能 | 端点 | 消耗 |

|------|------|------|

| 视频字幕提取 | `/youtube/transcript` | 1 credit |

| 视频/频道搜索 | `/youtube/search` | 1 credit |

| 频道句柄解析 | `/youtube/channel/resolve` | **免费** |

| 频道最新视频 | `/youtube/channel/latest` | **免费** |

| 频道全部视频 | `/youtube/channel/videos` | 1 credit/页 |

| 频道内搜索 | `/youtube/channel/search` | 1 credit |

| 播放列表内容 | `/youtube/playlist/videos` | 1 credit/页 |

典型工作流：
1. 研究场景：search → 选择视频 → transcript 获取字幕分析
2. 频道监控：channel/resolve 解析句柄 → channel/latest 获取更新 → transcript 转录内容

显著优点

• 功能全面：单 Skill 覆盖 YouTube 字幕、搜索、频道、播放列表四大核心场景
• 成本友好：频道解析和最新视频接口完全免费，免费额度（100 credits）可支持大量基础操作
• 输出格式灵活：字幕支持 JSON（含时间戳）或纯文本，便于下游处理
• 分页设计合理：频道视频和播放列表支持 continuation token 分页，可处理大规模数据
• 验证规则清晰：对 channel_id、playlist_id 等关键参数提供明确的正则校验规则

潜在缺点与局限性

• 外部依赖单一：完全依赖 TranscriptAPI.com 服务可用性，无备用方案
• 来源可信度 T3：由个人开发者/社区维护，非企业级服务背书
• 计费模式限制：高频调用或大规模频道扫描需付费（Starter $5/月，1000 credits）
• 无离线能力：所有操作均需网络连接和有效 API Key
• 速率限制：免费档 300 req/min，需注意批量任务节奏

适合人群

• 内容研究者：需要批量获取视频字幕进行 NLP 分析或知识提取
• 营销/运营人员：监控特定频道更新，追踪竞品内容动态
• 数据分析师：构建 YouTube 数据集，进行趋势研究
• 自动化工作流开发者：将 YouTube 数据获取集成到 Agent 或 RPA 流程中

常规风险

• API Key 泄露风险：Key 存储于环境变量，需避免提交到版本控制
• 成本控制风险：分页接口可能快速消耗 credits，需预估调用量
• 服务连续性风险：T3 来源项目，建议关注服务状态并保留迁移方案
• 合规风险：抓取 YouTube 内容需遵守平台 ToS 及当地数据法规