yt-fts

命令行全文搜索 YouTube 字幕，秒级定位视频内容。

yt-fts 是一个命令行工具，用于对 YouTube 视频进行全文搜索。它允许用户下载视频字幕，建立本地索引，并通过命令行快速搜索所有已索引视频中的文字内容。解决了 YouTube 官方搜索无法精确匹配字幕文本、无法跨频道批量检索的问题。核心能力包括：批量下载字幕、自动生成时间戳、支持正则表达式搜索、提供终端交互界面，以及通过本地 SQLite 数据库实现快速检索。用户可以通过简单的命令管理自己的视频库，并高效定位视频中的具体话语。

开源 free 搜索知识

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1813

维护状态低维护

是否开源是

定价模式 free

项目数据

分类搜索知识

开发团队NotJoeMartinez

所属国家

官网地址

GitHubhttps://github.com/NotJoeMartinez/yt-fts

定价模式free

价格说明开源项目，Unlicense 许可证，完全免费，无付费版本。

访问状态

是否开源是

开源协议Unlicense

主要语言Python

技术栈/模型chromadb,cli,click,full-text-search,llm,rag,semantic-search,sqlite,youtube,yt-dlp

GitHub 星标★ 1813

30天Star增速

HF 下载量

上线时间2023-05-20 00:00:00

最近更新2026-09-21 00:00:00

维护状态低维护

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数1

使用教程

难度：入门约 10 分钟部署方式：命令行工具 5 步

环境要求

Python 环境（项目为 Python 编写，需可用的 pip）
可访问 YouTube 的网络环境（字幕下载依赖 yt-dlp）
语义搜索可选：OpenAI 或 Gemini 的 Embedding API 密钥

安装与启动步骤

1安装 yt-fts

README 提供的唯一安装方式是 pip。在已装好 pip 的环境直接执行，建议使用虚拟环境避免依赖冲突。
```
pip install yt-fts
```
2下载频道字幕

download 命令接受频道或播放列表 URL，-jobs 用于并行下载提速；执行后会抓取该频道全部视频字幕并写入本地数据库。
```
yt-fts download --jobs 4 "https://www.youtube.com/@channelname"
```
3处理登录限制

若下载报错提示需要登录，加 --cookies-from-browser 读取浏览器 Cookie，把浏览器名换成你实际使用的（如 chrome、firefox）。
```
yt-fts download --cookies-from-browser chrome "https://www.youtube.com/@channelname"
```
4增量更新字幕

README 提到可多次运行 update 命令，用于补齐之前未抓取完整或新发布的字幕，避免重复全量下载。
```
yt-fts update
```
5启用语义搜索

README 提到 vsearch 走 OpenAI / Gemini Embedding API 并借助 chromadb，需先配置对应密钥；具体参数以本机帮助为准。

关键配置

配置项	必填	说明	示例
`OPENAI_API_KEY`	否	使用 OpenAI Embedding 做语义搜索时需要	`sk-xxxxxxxxxxxxxxxx`
`GEMINI_API_KEY`	否	使用 Gemini Embedding 做语义搜索时需要	`AIzaSyxxxxxxxxxxxx`

如何确认成功

执行 pip show yt-fts 能显示版本信息，即说明命令行工具已装好。

常见问题

Q：下载字幕时报错要求登录怎么办？

A：使用 --cookies-from-browser 参数指定你已登录 YouTube 的浏览器（如 chrome、firefox），从浏览器读取 Cookie 后再下载。

Q：下载速度很慢怎么优化？

A：download 命令支持 --jobs 参数，把它调大可以并行下载多个视频的字幕，但过高可能触发限流。

Q：普通搜索也要花钱吗？

A：不需要。关键词全文搜索基于本地 SQLite 数据库，离线免费；只有 vsearch 语义搜索才需要 OpenAI 或 Gemini 的 Embedding API 密钥。

Q：这个项目还在维护吗？

A：README 开头明确写着项目已 abandoned（停止维护），可能不再修复问题或更新依赖，请自行评估风险。

注意事项

README 声明项目已停止维护，遇到报错可能无人修复。
README 未给出完整命令参数表，实际使用时建议先查看工具自带的帮助输出。
字幕抓取依赖 yt-dlp，网络受限或被 YouTube 限流时会失败。
语义搜索会把字幕内容发送到第三方 Embedding 接口，注意隐私与费用。

核心亮点

支持正则表达式，精准匹配字幕文本，远超官方搜索
本地索引，搜索速度快，隐私性好
提供交互式终端界面，操作流畅

不足之处

依赖 YouTube 字幕，无字幕视频无法搜索
需自行管理字幕下载和索引更新，自动化程度有限
文档/社区待观察

适用场景

研究者批量分析多个视频中的特定话题
内容创作者快速检索自己视频中的引用或观点
个人整理收藏的 YouTube 视频，建立可搜索的知识库

替代项目

youtube-transcript-api、yt-dlp、Whisper

项目介绍

yt-fts 是搜索知识领域的开源项目，由 NotJoeMartinez 开发，2023 年首次发布。

在全站 13,090 个收录项目中，它的 GitHub 星标数（1,813）位列前 30%，在搜索知识分类中处于中上游。

项目已超过三个月没有代码更新，维护节奏明显放缓，最近一次代码更新于 2026-09-21。Unlicense 许可证，完全免费，无付费版本。

它主要面向的使用场景是：研究者批量分析多个视频中的特定话题。同类可对比的替代方案包括 youtube-transcript-api、yt-dlp、Whisper。

上一篇：RAGHub

下一篇：RAG-Survey