yt-fts

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

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署搜索知识 🍴 复刻 98 🐛 待处理 13 👀 关注 10

GitHub ↗

GitHub 星标 ★ 1811

维护状态低维护

是否开源开源

定价模式 🏷️完全免费开源项目，Unlicense 许可证，完全免费，无付费版本。

项目预览

项目数据

分类搜索知识

开发团队NotJoeMartinez

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

定价模式🏷️完全免费

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

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议Unlicense

主要语言Python

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

GitHub 星标★ 1811

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

代码更新2026-01-22

仓库体积413 KB

本站数据更新2026-11-09

维护状态低维护

收录时间2026-08-09

浏览次数3

项目介绍

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

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1811

技术标签

chromadb cli full-text-search llm rag

使用教程

ℹ 本教程由 AI 依据该项目 README 整理，个别步骤可能需要按你的环境微调。

难度：入门约 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`