mcpField
K
kb-yt-channel

kb-yt-channel

github.com/pedronauck生产力644164 次安装1 周前更新
代码仓库

关于 kb-yt-channel

用于将 YouTube 频道或播放列表视频导入知识库的工作流技能。它结合 `kb ingest channel` 与辅助脚本,支持主题整理、元数据、索引、验证和运行报告。

主要功能

  1. 01解析频道或播放列表输入
  2. 02选择视频及转录策略
  3. 03按主题整理内容
  4. 04为导入材料建立索引并验证
  5. 05查看运行报告与失败项

适用场景

  1. 01将频道视频导入知识库
  2. 02限定导入指定视频
  3. 03出错后继续导入
  4. 04索引后检查主题内容是否可搜索

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/pedronauck/skills --skill kb-yt-channel

安装后在 Claude Code 中输入/kb-yt-channel确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

assets/
report-template.md
references/
channel-topic-contract.md
troubleshooting.md
scripts/
ingest-channel.py

详细介绍

KB YouTube 频道

使用原生的 kb ingest channel 处理频道解析、字幕转录、去重与续传、重试和请求间隔。捆绑的 scripts/ingest-channel.py 会在 yt-channels/ 下添加主题组织、元数据、索引、验证和运行报告。

  1. 根据请求确定知识库位置、频道/播放列表 URL、主题 slug/标题/领域、视频选择(--limit N 或 --all)以及字幕转录策略(captions、auto 或 stt)。只询问无法合理推断的选项。
  2. 检查必需工具时仅检查一次,并复用当前已有的证据:kb、yt-dlp,以及用于建立索引的 qmd;如果请求 STT,还需检查 ffmpeg 和已配置的提供方。默认的预检中不要安装可选的网络依赖项。
  3. 使用 --vault、--channel-url、--topic-slug、--title、--domain、视频选择参数和 --transcribe 运行 python3 <kb-yt-channel-dir>/scripts/ingest-channel.py。从此技能目录解析辅助脚本。默认使用原语言字幕;仅在需要时覆盖 --sub-langs。--no-index 会延后建立索引;--embed 会请求生成嵌入。
  4. 预览是可选的。现有的 --dry-run 会创建/更新主题框架和元数据,然后列出摄取计划,但不会处理字幕转录;它不是只读预览。仅在已获授权创建/更新主题的范围内使用。不要强制要求先预览,再重复完整预检。
  5. 检查辅助脚本的 JSON 摘要和失败项。复用其已完成的主题信息/lint/索引验证;仅在缺少证据时补充检查。如果任务包含验证可搜索性,则在建立索引后,于该主题/集合中验证一次有代表性的 kb search。
  6. 报告实际摄取/跳过/失败的数量以及报告路径。仅当任务包含综合整理时才编写 wiki 文章;仅摄取字幕转录并不意味着需要编写文章。

失败处理与参考资料

首先使用现有网络配置,以及原生的有限重试/退避机制。遇到速率限制时,遵循服务器指引、降低并发量或延长请求间隔。仅当实际遇到访问/网络问题时,才配置经过身份验证的 Cookie 或获准使用的代理;绝不要泄露凭据,也不要为大型频道强制要求使用住宅代理。

如需了解元数据/输出详情,请阅读 references/channel-topic-contract.md;如需查看实际故障案例,请阅读 references/troubleshooting.md。修复后继续处理同一请求;原生去重机制会保留已成功摄取的内容。缺少字幕时,如果相应范围和提供方费用已获授权,可使用 auto/STT。保留部分输出;针对特定字幕转录,使用受支持的刷新方式,而不是默认删除用户数据。

评论

支持 Markdown