Skip to content
cccskills
FreePublished on GitHub

youtube-digest

YouTube 提文案 — 输入 YouTube 视频链接或 ID,一键提取视频文字稿(字幕/口播文案),默认输出不带时间戳的纯文案;字幕中文轨优先、无中文轨回退英文后自动翻译为中文,结果以表格(标题/时长/文案内容)呈现,支持导出 Excel、可选带时间戳版本。

当用户需要提取 YouTube 视频文案、把视频转成文字稿、做视频笔记/总结/翻译/二次创作时使用。

The English summary is being prepared. Showing the original description.

Works withYouTubeExcel
See how to install

Files included (4)

  • SKILL.md8.9 KB
  • README.en.md4.4 KB
  • README.md3.9 KB
  • scripts/extract.py23.9 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

YouTube 提文案

输入 YouTube 视频链接,一键提取视频文字稿(口播文案),终端展示 + Markdown 存档 + 可导出 Excel。

支持的链接格式(视频链接必须包含视频 ID):

  • 完整URL:https://www.youtube.com/watch?v=dQw4w9WgXcQ
  • 短URL:https://youtu.be/dQw4w9WgXcQ
  • 视频ID:dQw4w9WgXcQ

默认行为(重要):

  • 默认输出不带时间戳的纯文案;需要带时间戳版本时加 --timestamp
  • 字幕按 zh,en,asr 优先级选轨:视频有中文字幕轨时直接输出中文;没有中文轨时回退英文,脚本自动将非中文字幕翻译为中文(基于 Google Translate,批量翻译提升效率);加 --no-translate 可禁用自动翻译、保留原文
  • 默认自动获取视频元数据(标题/时长),无需额外参数

需先配置 API Key,通过环境变量 REDFOX_API_KEY 或 --api-key 参数传入。 文字稿来源:视频字幕轨(手动字幕 + 自动生成字幕 asr),按语言优先级选轨、中文轨优先;非中文字幕由脚本端自动翻译为中文。


使用场景

当你需要执行以下任务时,应优先使用本技能:

场景示例
视频转文字稿丢一个 YouTube 链接,拿到完整口播文案
学习笔记整理提取教程/演讲文案后让 AI 总结成章节笔记
内容二次创作提取英文视频文案 → AI 翻译改写 → 公众号文章
播客/访谈存档提取访谈全文,导出 Excel 归档
竞品内容分析批量提取同行视频文案,分析话术与结构
视频选题调研先提文案再快速判断视频是否值得深看

使用方法

# 基础提取(默认:不带时间戳 + 自动获取标题等元数据)
python3 "$SKILL_PATH/scripts/extract.py" "https://www.youtube.com/watch?v=dQw4w9WgXcQ"

# 支持短链和纯视频 ID
python3 "$SKILL_PATH/scripts/extract.py" "https://youtu.be/dQw4w9WgXcQ"
python3 "$SKILL_PATH/scripts/extract.py" "dQw4w9WgXcQ"

# 带时间戳版本(方便定位原片进度)
python3 "$SKILL_PATH/scripts/extract.py" "URL" --timestamp

# 同时导出 Excel(标题/时长/视频链接/文案内容 四列)
python3 "$SKILL_PATH/scripts/extract.py" "URL" --excel

# 带时间戳文案 + 导出 Excel(Excel 内容与当前模式一致)
python3 "$SKILL_PATH/scripts/extract.py" "URL" --timestamp --excel

# 指定语言优先级(如只要英文字幕)
python3 "$SKILL_PATH/scripts/extract.py" "URL" --language "en"

# 输出原始 JSON / 不保存文件
python3 "$SKILL_PATH/scripts/extract.py" "URL" --json
python3 "$SKILL_PATH/scripts/extract.py" "URL" --no-save

终端输出:视频概要(标题/语言/片段数/总时长)+ 纯文案全文。

Markdown 存档默认保存在 ~/Downloads/QoderYoutubeDigest/,文件名 {视频ID}_{时间戳}.md,含视频信息头表 + 全文;Excel(.xlsx)同目录。


工作流程(AI 必须遵循)

  1. 提取:运行脚本获取文案
  2. 表格展示:按「返回结果展示规范」用表格呈现(标题/时长/文案内容),文案内容列展示中文译文全文(无时间戳;非中文字幕已自动翻译)
  3. 收尾询问:展示结束后,必须主动询问用户:

    「需要带时间戳的文案版本吗(方便定位原片进度)?也可以为你导出 Excel。」

    • 用户要带时间戳 → 加 --timestamp 重跑并展示
    • 用户要 Excel → 加 --excel 重跑(如需时间戳一并加 --timestamp),给出文件路径

注意:脚本默认自动将非中文字幕翻译为中文。如用户明确要求保留原文,加 --no-translate 重跑。


返回结果展示规范

向用户展示提取结果时,必须使用以下表格,不得省略字段:

序号字段说明
1标题视频标题(来自元数据)
2时长格式 MM:SS 或 HH:MM:SS
3文案内容不带时间戳的文案全文,非中文字幕已自动翻译为中文

展示示例:

| 标题 | 时长 | 文案内容 |
|------|------|----------|
| Rick Astley - Never Gonna Give You Up (Official Video) (4K Remaster) | 03:31 | 我们对爱情并不陌生 / 你知道规则,我也一样 / ……(中文译文全文) |
  • 文案内容列:多段落文案在单元格内用「/」或换行衔接,保持完整不截断;非中文字幕已自动翻译为中文展示
  • 表格后附一行存档信息:已存档:~/Downloads/QoderYoutubeDigest/dQw4w9WgXcQ_xxx.md

参数说明

参数说明默认值
video_urlYouTube 视频链接(完整URL/短URL/视频ID,必须含视频 ID,必填位置参数)—
--language字幕语言优先级,逗号分隔(中文轨优先,asr 为自动生成字幕兜底;脚本端选轨)zh,en,asr
--timestamp输出带 [MM:SS] 时间戳的文案默认不带时间戳
--excel同时导出 Excel(.xlsx,四列:标题/时长/视频链接/文案内容)不导出
--json终端输出原始 JSON 响应—
--no-save不保存 Markdown 文件自动保存
--output-dir输出目录~/Downloads/QoderYoutubeDigest
--no-translate禁用自动翻译,保留字幕原文输出默认自动翻译非中文字幕为中文
--api-key指定 RedFox API Key—

API Key 配置

任选一种方式配置个人 Key:

方式命令
环境变量(推荐)export REDFOX_API_KEY=ak_你的密钥
命令行参数--api-key ak_你的密钥
配置文件echo '{"api_key":"ak_你的密钥"}' > ~/.qoder/apis/redfox.json

注册地址:redfox.hk


功能特点

  • 三种输入格式:完整 URL、youtu.be 短链、纯视频 ID,自动识别
  • 默认纯文案:不带时间戳,直接可读、可直接喂给 AI 二次加工;--timestamp 随时切换
  • 自动翻译:非中文字幕自动翻译为中文(基于 Google Translate),加 --no-translate 可保留原文
  • 表格化交付:标题/时长/文案内容三字段表格呈现,信息一目了然
  • Excel 导出:--excel 一键导出 xlsx(自动换行、列宽适配),适合归档与分享
  • 中文轨优先:按 zh,en,asr 优先级选轨,有中文字幕直接输出中文;没有则回退英文轨并自动翻译为中文
  • 稳健重试:网络异常/状态码错误/数据为空自动递增延迟重试(0.5s→1.0s),限频(3108)自动等待 5 秒重试
  • AI 友好:可衔接总结、翻译、改写、公众号排版发布等后续技能

依赖

pip3 install requests openpyxl deep-translator

(openpyxl 仅 Excel 导出需要;deep-translator 仅自动翻译需要;未安装时对应功能自动降级,其余功能不受影响)


常见问题

Q:默认文案带时间戳吗? A:不带。默认输出纯文案;加 --timestamp 才输出 [MM:SS] 时间戳版本,提取结束后 AI 也会主动询问是否需要。

Q:英文视频能直接给我中文文案吗? A:可以。脚本检测到非中文字幕时会自动翻译为中文(基于 Google Translate)。视频有中文轨时直接输出中文,没有中文轨时回退英文后自动翻译。如需保留原文,加 --no-translate。

Q:Excel 里是什么内容? A:四列——标题、时长、视频链接、文案内容。文案内容与当前模式一致:加 --timestamp 时 Excel 内含时间戳,否则为纯文案。

Q:为什么提取失败提示"视频可能无字幕"? A:文字稿来自视频字幕轨。完全无字幕(含自动生成字幕)的视频无法提取;部分受限/私享视频也不支持。

Q:链接报错了怎么办? A:链接无效或视频提取失败时返回 3203 接口执行异常,积分未扣除,请检查链接是否正确、视频能否正常打开;Key 已禁用(3105)或无效/过期(3106/3107)请检查 API Key 配置;限频(3108)会自动等待重试。

Q:拿到文案后能做什么? A:可以让 AI 直接总结成笔记、翻译成中文、改写成公众号文章(配合 gzh-design 排版、md-to-wechat 一键推送草稿)。

Q:额度用完怎么办? A:前往 redfox.hk 注册获取 Token。

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

多平台账号主页视频提取器 — 输入平台名称和账号id/链接,自动拉取抖音/快手/B站/YouTube 四大平台主页作品,解析下载链接,支持批量下载。适用场景:竞品账号内容拆解与逐帧学习、收藏喜欢的创作者全部作品避免被删、批量搬运素材二次剪辑创作、保存自己账号作品做本地备份防丢失、课程/教程类视频离线囤货反复看、达人合作前快速拉取对方作品做背调分析。触发词:主页视频下载、批量下载视频、账号视频提取、快手主页下载、B站视频提取、YouTube频道下载、视频保存、无水印下载、竞品视频下载、博主视频备份。

The English summary is being prepared. Showing the original description.

redfox-data/redfox-community447Updated Oct 19, 2026

深度A股情报调查与分析工具,支持A股情报调查、竞品分析、舆情监测、人物背景调查、信息交叉验证,生成结构化调查报告。当用户需要调查A股公司/行业/概念、调查竞品、追踪热点事件、了解人物背景、验证信息真实性时使用。触发词:A股情报、股票调查、财报分析、概念追踪、资金流向、情报调查、竞品分析、舆情调查、背景调查、信息验证、多源搜索。

The English summary is being prepared. Showing the original description.

redfox-data/redfox-community447Updated Oct 19, 2026

B站AI信息源 — 每日扫描B站AI相关账号,按点赞量发现爆款视频,智能聚类话题后生成包含封面图、互动数据与订阅支持的HTML日报。同时基于热门话题执行AI情报调查,采用多引擎搜索与交叉验证,输出结构化调查报告。支持用户自定义关键词定向查询。⚠️数据每日15:00更新前一天数据,目标日期无数据时必须先告知用户并等待确认后才能调用接口,禁止自动获取。当用户需要AI-B站日报、B站爆款、AI-B站热点、B站AI内容、B站AI视频、B站情报或自定义关键词查询时使用。

The English summary is being prepared. Showing the original description.

redfox-data/redfox-community447Updated Oct 19, 2026

B站评论分析工具。输入B站视频链接或BV号即可获取一级评论数据,支持分页浏览、评论情感分析(积极/负面/需求/竞品),生成精美 HTML 报告。当用户需要查看B站视频评论、分析评论舆情、了解用户反馈时使用。触发词:B站评论、B站视频评论、评论查询、评论分析、评论舆情、看评论、bilibili评论。

The English summary is being prepared. Showing the original description.

redfox-data/redfox-community447Updated Oct 19, 2026

B站关键词搜账号工具。根据用户输入的关键词查询B站相关账号,支持按综合排序或粉丝数排序,返回账号列表(含粉丝数、等级、简介等信息)。当用户需要搜索B站账号、查找B站UP主、找B站同类账号时使用。

The English summary is being prepared. Showing the original description.

redfox-data/redfox-community447Updated Oct 19, 2026

B站关键词搜作品工具。根据用户输入的关键词调用 Redfox 接口搜索B站最新视频,支持按排序方式和发布时间筛选,返回新鲜数据(非缓存/历史数据)。当用户要求搜索B站最新内容、查看某关键词下的视频数据时使用。触发词:B站搜索、B站最新视频、B站热门、B站搜作品、bilibili搜索。

The English summary is being prepared. Showing the original description.

redfox-data/redfox-community447Updated Oct 19, 2026

See all skills by redfox-data

Report a problem with this skill