用途
该技能用于总结 YouTube 视频。当用户分享 YouTube 链接并希望获得摘要、要点等内容时，可通过获取视频转录文本并生成结构化摘要来完成。
主要能力
- 通过 Supadata API 获取 YouTube 视频的转录文本。
- 将转录文本拼接后生成结构化、可读的摘要。
- 摘要结构包含（可根据视频内容调整）：
- 🎯 核心主题 — 视频讲的是什么？
- 📌 主要观点 — 关键论点或发现（3–7 条）。
- 📖 详细内容 — 按章节/主题展开的细分。
- 💡 结论 — 主要收获或结论。
- 可根据用户的语言偏好调整摘要语言。
使用方式
前提条件
该技能需要 Supadata API Key（免费额度对个人使用足够）。
- 在 supadata.ai 注册。
- 从仪表板获取 API Key。
- 将其设置为环境变量：
SUPADATA_API_KEY=sd_your_key_here
或在提示时直接提供。
工作流程
第 1 步：获取 YouTube URL
接受以下任意格式：
https://youtu.be/VIDEO_IDhttps://www.youtube.com/watch?v=VIDEO_ID
第 2 步：通过 Supadata API 获取转录
curl -s "https://api.supadata.ai/v1/youtube/transcript?url=VIDEO_URL" \
-H "x-api-key: $SUPADATA_API_KEY"
响应格式：
{
"content": [
{"text": "...", "offset": 0, "duration": 5000, "lang": "en"},
...
],
"lang": "en",
"availableLangs": ["en"]
}
提取 text 字段并拼接，得到完整转录文本。
第 3 步：生成摘要
使用转录文本生成包含上述分节的结构化摘要。
示例用法
用户：“帮我总结一下这个视频 https://youtu.be/BU9sIfGVhIQ”
智能体工作流程：
- 使用该 URL 调用 Supadata API。
- 解析并拼接转录文本。
- 生成中文结构化摘要（匹配用户语言）。
- 以 emoji 分节标题呈现摘要。
错误处理
| 错误 | 原因 | 解决方法 |
|---|---|---|
| 401 Unauthorized | API Key 无效或缺失 | 请用户检查其 Supadata API Key |
| 404 Not Found | 视频无转录 / 为私密视频 | 告知用户该视频无可用转录 |
| 429 Rate Limited | 请求过多 | 等待后重试，或升级 Supadata 套餐 |
| 内容数组为空 | 无可用字幕 | 告知用户并建议其确认视频是否有字幕 |
适用场景
- 用户分享 YouTube 链接并希望快速了解视频内容。
- 需要按固定结构（核心主题、主要观点、详细内容、结论）整理视频信息。
- 需要按用户语言输出摘要，包括非英语视频（Supadata 返回原文转录，按原文进行总结）。
限制与注意事项
- 无自动生成字幕或人工字幕的视频无法转录。
- Supadata 免费额度有每月配额，对偶尔使用足够。
- 非英语视频：Supadata 返回原文转录，据此相应地进行总结。
- 不要使用 youtube-transcript-api Python 库或 yt-dlp——云服务器 IP 会被 YouTube 屏蔽。应始终使用 Supadata API。
暂未提供的信息
除 Supadata 免费额度对个人使用足够外，资料未提供具体价格、付费套餐细节、处理速度或视频长度上限等信息。