대화 기록을 원문 그대로 저장하고 의미 검색으로 찾아주는 로컬 우선 AI 메모리 시스템으로, MCP 서버와 CLI를 제공합니다.
GhostPeony/clip-finder
YouTube 자막을 의미 기반으로 검색해 채널, 재생목록, 동영상에서 원하는 시점으로 바로 이동
- 스타
- 55
- 포크
- 6
- 열린 이슈
- 0
- 마지막 커밋
- 4개월 전
어떤 프로젝트인가요?
SearchTube는 채널, 재생목록 또는 단일 동영상의 YouTube 자막을 색인한 뒤, 정확한 키워드가 아니라 의미를 기준으로 검색할 수 있게 해줍니다. 각 검색 결과는 해당 동영상의 일치하는 시점으로 연결되므로, 관련 클립으로 바로 이동할 수 있습니다.
두 가지 모드로 실행됩니다. 로컬 모드에서는 로그인할 필요가 없고 벡터를 로컬 ChromaDB 디렉터리에 저장하며, Gemini 키는 브라우저에서 직접 입력합니다. Supabase 모드에서는 사용자 인증, pgvector를 사용하는 Postgres, 사용량 할당량, 서버에서 관리하는 Gemini 키를 지원하며, 사용자별 키를 선택적으로 암호화해 저장할 수도 있습니다.
React 프론트엔드와 FastAPI 백엔드로 구성되며, 검색에는 Gemini 임베딩을 사용합니다. 기본값을 변경하기 전에 임베딩 모델과 차원을 비교할 수 있는 평가 스크립트도 포함되어 있습니다.
핵심 기능
- 01타임스탬프 링크를 제공하는 YouTube 자막 의미 기반 검색
- 02채널, 재생목록 및 단일 동영상 색인
- 03이미 색인된 동영상은 건너뜀
- 04인증이 필요 없는 로컬 모드 또는 다중 사용자 로그인을 지원하는 Supabase 모드
- 05브라우저에서 직접 키를 입력하거나 서버 측에 키를 암호화해 저장
- 06SRT 형식 자막 다운로드 및 최근 검색 기록
활용 사례
- 긴 강의 시리즈나 튜토리얼 채널에서 특정 설명 찾기
- 모든 동영상을 시청하지 않고 재생목록 전체에서 주제 검색
- 팀 또는 개인 아카이브를 위한 비공개 셀프 호스팅 자막 검색 운영
빠른 시작
- 1
저장소를 클론합니다
git clone https://github.com/GhostPeony/SearchTube.git - 2
Python 가상 환경을 만들고 백엔드 종속성을 설치합니다
python -m venv venv venv\Scripts\activate pip install -r requirements.txt - 3
프런트엔드 종속성을 설치한 다음 Gemini API 키를 입력한 .env.local 파일을 만듭니다
npm install - 4
한 터미널에서 백엔드를 시작하고 다른 터미널에서 프런트엔드를 시작한 다음 http://localhost:3001 을 엽니다
python backend/server.py npm run dev
사용 전 알아둘 점
- 로컬 모드에서 임베딩과 검색을 사용하려면 Gemini API 키가 필요합니다.
- 설정 안내에는 Windows 전용 venv 활성화 명령이 사용됩니다. 다른 플랫폼에서는 별도의 활성화 명령이 필요합니다.
- 자막이 없거나 지역 또는 연령 제한이 있는 동영상은 스크립트를 사용할 수 없습니다.
토픽
자주 묻는 질문
- clip-finder은(는) 무엇인가요?
- YouTube 자막을 의미 기반으로 검색해 채널, 재생목록, 동영상에서 원하는 시점으로 바로 이동 SearchTube는 채널, 재생목록 또는 단일 동영상의 YouTube 자막을 색인한 뒤, 정확한 키워드가 아니라 의미를 기준으로 검색할 수 있게 해줍니다. 각 검색 결과는 해당 동영상의 일치하는 시점으로 연결되므로, 관련 클립으로 바로 이동할 수 있습니다.
- clip-finder은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- clip-finder은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- clip-finder은(는) 아직 유지보수되고 있나요?
- 6개월 이내 업데이트. 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
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
AI 앱을 위한 오픈 소스 임베딩 데이터베이스로, 문서와 벡터를 저장해 시맨틱·하이브리드·전체 텍스트 검색을 지원합니다.
BAAI의 검색 툴킷으로, BGE 임베딩 및 리랭커 모델과 검색·RAG를 위한 학습, 평가, 튜토리얼을 제공합니다.
OpenAI 호환 API로 임베딩, 리랭킹, OCR, 추출, 안전성 및 LLM 모델을 제공하는 셀프 호스팅 추론 서버
React 프런트엔드, FastAPI 백엔드, Docker 환경에서 이미지와 PDF에 DeepSeek-OCR을 실행하는 웹 앱
영어 문법과 용법을 중국어 자막과 핵심 영어 단어 강조가 포함된 30초 세로형 교육 영상으로 만드는 AI 도구입니다.