Repolode
GhostPeony

GhostPeony/clip-finder

自托管的 YouTube 字幕语义搜索工具,可跨频道、播放列表或单个视频查找内容并跳转到对应时间点。

Star
55
Fork
6
未关闭 Issue
0
最近提交
4个月前

这是什么?

SearchTube 可以索引 YouTube 频道、播放列表或单个视频的字幕,然后按语义而不是精确关键词进行搜索。每条结果都会链接到视频中对应的时间点,方便直接跳转到相关片段。

项目支持两种运行模式。本地模式无需登录,向量存储在本地 ChromaDB 目录中,Gemini 密钥由用户在浏览器中填写。Supabase 模式增加了用户认证、基于 pgvector 的 Postgres、用量配额和服务端托管的 Gemini 密钥,并可选择加密保存用户自己的密钥。

前端使用 React,后端使用 FastAPI,检索基于 Gemini 向量嵌入。项目还提供检索评估脚本,便于在更换嵌入模型或向量维度前对比效果。

核心功能

  • 01基于字幕的语义搜索,结果带时间戳链接
  • 02支持频道、播放列表和单个视频的索引
  • 03自动跳过已索引的视频
  • 04本地模式无需登录,Supabase 模式支持多用户登录
  • 05支持在浏览器中填写自己的 API 密钥,或加密存储在服务端
  • 06可下载 SRT 格式字幕并查看最近搜索记录

适用场景

  • 在长系列课程或教程频道中定位某个知识点的讲解
  • 在播放列表中按主题快速查找内容,无需逐个观看
  • 为团队或个人搭建私有化的字幕搜索服务

快速上手

  1. 1

    克隆代码仓库

    git clone https://github.com/GhostPeony/SearchTube.git
  2. 2

    创建 Python 虚拟环境并安装后端依赖

    python -m venv venv venv\Scripts\activate pip install -r requirements.txt
  3. 3

    安装前端依赖,然后创建包含 Gemini API 密钥的 .env.local

    npm install
  4. 4

    在一个终端启动后端,另一个终端启动前端,然后打开 http://localhost:3001

    python backend/server.py npm run dev

使用前须知

  • 本地模式需要 Gemini API 密钥用于向量嵌入和搜索。
  • 安装说明中的虚拟环境激活命令针对 Windows,其他系统需要使用不同的命令。
  • 没有字幕或受地区、年龄限制的视频无法获取转录文本。

标签

常见问题

clip-finder 是什么?
自托管的 YouTube 字幕语义搜索工具,可跨频道、播放列表或单个视频查找内容并跳转到对应时间点。 SearchTube 可以索引 YouTube 频道、播放列表或单个视频的字幕,然后按语义而不是精确关键词进行搜索。每条结果都会链接到视频中对应的时间点,方便直接跳转到相关片段。
clip-finder 可以免费使用吗?用的什么许可证?
clip-finder 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
clip-finder 还在维护吗?
半年内有更新。clip-finder 最近一次提交是在 2026年7月2日。
clip-finder 适合用来做什么?
在长系列课程或教程频道中定位某个知识点的讲解 在播放列表中按主题快速查找内容,无需逐个观看 为团队或个人搭建私有化的字幕搜索服务
clip-finder 怎么安装和运行?
克隆代码仓库: git clone https://github.com/GhostPeony/SearchTube.git 创建 Python 虚拟环境并安装后端依赖: python -m venv venv venv\Scripts\activate pip install -r requirements.txt 安装前端依赖,然后创建包含 Gemini API 密钥的 .env.local: npm install 在一个终端启动后端,另一个终端启动前端,然后打开 http://localhost:3001: python backend/server.py npm run dev
在哪里获取 clip-finder?
源代码和安装说明在 GitHub 上:https://github.com/GhostPeony/clip-finder

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目