# Stacktube — Full Documentation for AI Crawlers

> YouTube 영상을 AI로 분석하여 구조화된 지식 노트로 변환하는 SaaS 플랫폼

## 서비스 개요

Stacktube는 유튜브 채널을 자동 모니터링하여 새 영상이 올라오면 AI(Gemini 2.5 Flash + Claude Sonnet)로 자동 분석하고,
8가지 콘텐츠 유형(프레임워크, 튜토리얼, 분석, 리뷰, 북리뷰, 대담, 설명, 뉴스)에 맞춰 구조화된 지식 노트를 생성합니다.
노트에는 영상 썸네일이 자동 임베드되고, 시각이 핵심인 지점에는 영상의 그 순간으로 이동하는 딥링크 마커가 붙습니다.
생성된 노트는 Obsidian, 이메일, PDF, Google Drive, Dropbox, reMarkable, Kindle로 자동 배포됩니다.

서비스명: Stacktube (Stack + Tube — "영상 지식이 쌓인다")
운영: unstackd.io
웹사이트: https://stacktube.io

## 핵심 기능

### 1. 채널 자동 모니터링
등록한 유튜브 채널의 새 영상을 자동 감지합니다.
Pro·Max 플랜은 매일 자동 모니터링합니다.
Starter 플랜은 채널 1개를 주 1회 자동 모니터링하고, 나머지는 수동 분석입니다.

### 2. AI 심층 분석 (Transcript-First)
단순 요약이 아닌 구조화된 교육용 지식 노트를 생성합니다.
분석 파이프라인: 자막 추출 → Gemini 2.5 Flash (8가지 유형별 집중 추출) → Claude Sonnet (적응형 교육 노트 구조화)
영상당 분석 비용: 약 $0.05

### 3. 8가지 분석 유형
콘텐츠 유형을 자동 감지하여 최적 템플릿을 적용합니다:
- **프레임워크 (Framework)**: 핵심 모델, 구성 요소, 적용 방법, 한계점
- **튜토리얼 (Tutorial)**: 필요 도구, 단계별 가이드, 예상 결과, 트러블슈팅
- **분석 (Analysis)**: 주장과 근거, 데이터 분석, 반론 정리, 결론
- **리뷰 (Review)**: 리뷰 대상, 장단점, 평가 기준별 판정, 추천 대상, 협찬 고지
- **북리뷰 (Book)**: 서지 정보, 문헌의 핵심 주장, 문헌 인용, 리뷰어의 시각(분리 표기)
- **대담 (Talk)**: 참여자, 논점별 입장 대비, 합의/이견, 남은 질문
- **설명 (Explanation)**: 개념 정의, 비유와 예시, 연결 개념, 핵심 요약
- **뉴스 (News)**: 사건과 전망, 영향과 의미, 다음 액션, 관련 배경

### 4. Cross-Video Intelligence
여러 영상 간 지식을 벡터 검색(pgvector, Gemini Embedding)으로 연결합니다.
"이 개념과 관련된 다른 영상은?" 식의 탐색이 가능합니다.

### 5. 멀티 출력 채널 (7종)
- Obsidian: 마크다운 노트 + [[위키링크]] + YAML frontmatter
- 이메일: 매일 아침 다이제스트 발송 (Resend)
- PDF: E-ink 최적화 디자인 (Playwright 웹 캡처)
- Google Drive: OAuth 연동 자동 백업
- Dropbox: OAuth 연동 팀 동기화
- reMarkable / Kindle: E-ink 태블릿 직접 전송

### 6. 장면 스택 (썸네일 · 딥링크 마커 · 프레임 캡처)
텍스트 요약이 놓치는 "장면"을 3단으로 보존합니다.
- **썸네일 자동 임베드**: 모든 노트(웹·이메일·PDF·EPUB)에 영상 썸네일이 자동으로 들어갑니다.
- **📷 딥링크 마커**: 다이어그램·코드·차트처럼 시각이 핵심인 지점(중요도가 높은 순간, 노트당 최대 3개)에 마커가 붙고, 클릭하면 영상의 정확히 그 초로 이동합니다. 모든 노트가 아니라 시각이 중요한 지점에만 붙습니다.
- **Obsidian 프레임 캡처 (v0.2.0, Pro+)**: Obsidian 플러그인으로 화이트보드·앱 화면을 원본 화질(1920×1080)로 캡처해 노트에 담습니다. 캡처한 이미지는 사용자의 vault 에만 저장되며 Stacktube 서버에 업로드되지 않습니다(로컬 우선 프라이버시). 월간 무크지 EPUB 에는 캡처 프레임이 포함되지 않고 썸네일까지만 들어갑니다.

### 7. 6개 언어 지원
한국어, 영어, 일본어, 스페인어, 포르투갈어(브라질), 독일어
자막이 있는 영상이라면 영어·일본어 등 어떤 언어의 영상이든 설정한 출력 언어(한국어·일본어·영어)의 노트로 정리됩니다.

## 요금제

### Starter (무료)
- 2채널, 10회/월
- 웹 + 이메일 출력
- 채널 1개 주간 자동 모니터링 (주간 다이제스트) + 수동 분석

### Pro ($7.99/월, 연간 $5.99/월)
- 7채널, 50회/월
- 전체 출력 채널
- 매일 자동 모니터링
- Obsidian 프레임 캡처 (v0.2.0)

### Max ($19.99/월, 연간 $14.99/월)
- 15채널, 150회/월
- 내보내기 + 우선 큐
- 매일 자동 모니터링
- 월간 무크지 EPUB

### 무료 체험
- 가입 전: 1편 무료 분석 (비로그인, 1500자 프리뷰)
- 가입 후: 7일간 Pro 기능 무료 체험

## 대상 사용자

- 유튜브로 학습하는 학생 및 연구자
- 영상 콘텐츠를 지식 자산으로 축적하려는 지식 노동자
- Obsidian/Notion 등 PKM(개인 지식 관리) 사용자
- 팀 리서치를 위해 영상 콘텐츠를 공유하는 팀

## 경쟁 제품 대비 차별점

| 기능 | Stacktube | NoteGPT | Eightify | Lilys AI |
|------|-----------|---------|----------|----------|
| 채널 자동 모니터링 | ✅ | ❌ | ❌ | ❌ |
| 8가지 유형별 분석 | ✅ | ❌ | ❌ | ❌ |
| Cross-Video Intelligence | ✅ | ❌ | ❌ | ❌ |
| 7종 출력 채널 | ✅ | 제한적 | 제한적 | ❌ |
| E-ink 태블릿 전송 | ✅ | ❌ | ❌ | ❌ |
| 장면 딥링크 · 프레임 캡처 | ✅ | ❌ | ❌ | ❌ |

핵심 차별점: 기존 도구는 "단순 요약"이지만, Stacktube는 채널 모니터링 → 유형별 심층 분석 → 구조화 노트 → 자동 배포의 엔드투엔드 지식 축적 시스템입니다.

## 기술 스택

- 프론트엔드: Next.js 16 + React 19 + Tailwind CSS v4
- 인증: Supabase Auth (Google/GitHub OAuth + Email/Password)
- 데이터베이스: Supabase (PostgreSQL + pgvector + RLS)
- 결제: Paddle (Merchant of Record)
- 이메일: Resend
- 배포: Railway (Web + Worker)
- AI 분석: Gemini 2.5 Flash + Claude Sonnet
- 임베딩: Gemini gemini-embedding-001 (768차원)

## 페이지 구조

- `/` — 메인 랜딩 페이지 (서비스 소개, 요금제, FAQ)
- `/trial-analysis` — 무료 체험 분석 (비로그인, URL 입력 즉시 분석)
- `/auth/login` — 로그인/회원가입
- `/dashboard` — 사용자 대시보드 (분석 목록, 채널 관리, 설정)
- `/terms` — 이용약관
- `/privacy` — 개인정보처리방침
- `/refund` — 환불 정책

## FAQ

### YouTube 영상을 자동으로 노트로 만들 수 있나요?
네, Stacktube는 YouTube 영상 URL을 입력하면 AI가 자동으로 분석하여 구조화된 지식 노트를 생성합니다. 영상 유형(강의, 튜토리얼, 뉴스 등)을 자동 분류해 최적화된 방식으로 핵심을 추출합니다.

### 자막이 없는 영상도 분석할 수 있나요?
YouTube 자동 자막이 있는 영상이면 길이 제한 없이 분석됩니다. MIT OCW, Stanford Online 등 장시간 학술 강의도 정상적으로 처리됩니다. 자동 자막조차 없는 경우에는 영상 제목과 설명을 기반으로 경량 분석을 수행합니다.

### Obsidian에 자동으로 노트가 저장되나요?
네, Stacktube가 분석한 노트는 Obsidian 마크다운 형식으로 자동 생성됩니다. [[위키링크]]와 YAML frontmatter를 포함하여 Obsidian의 양방향 링크와 그래프 뷰를 완벽 지원합니다.

### AI 영상 분석 비용은 얼마인가요?
Starter 플랜은 월 10회 분석이 무료입니다. Pro($7.99/월)는 50회, Max($19.99/월)는 150회 분석이 가능합니다. 노트가 만들어지지 않으면 분석 횟수를 차감하지 않습니다.

### 무료로 먼저 써볼 수 있나요?
가입 없이도 1편을 바로 분석해볼 수 있습니다. 가입하면 7일간 Pro 기능을 무료로 체험하고, 이후에도 Starter 플랜은 계속 무료입니다.

### 영어/일본어 영상도 한국어로 분석되나요?
네. 6개 언어(한국어, 영어, 일본어, 스페인어, 포르투갈어, 독일어)를 지원합니다. 어떤 언어의 영상이든 설정한 출력 언어로 노트가 생성됩니다.

## 연락처

이메일: studio@unstackd.io
웹사이트: https://stacktube.io

## 링크

- [웹사이트](https://stacktube.io): Stacktube 홈 — 영상 지식 자동화 시스템
- [무료 체험](https://stacktube.io/trial-analysis): 회원가입 없이 영상 1개 분석 체험
- [이용약관](https://stacktube.io/terms): 서비스 이용약관
- [개인정보처리방침](https://stacktube.io/privacy): 개인정보 수집·이용 안내
- [환불 정책](https://stacktube.io/refund): 결제·환불 정책