# YouTube Knowledge Base - Public Open Source Project
## Product Requirements Document (PRD)
This folder contains all documentation needed to build and launch the **YouTube Knowledge Base** as a public, open-source service that anyone can use from any Claude Code project.
---
## Document Index
| Document | Description |
|----------|-------------|
| [PRD.md](./PRD.md) | Main Product Requirements Document |
| [architecture/OVERVIEW.md](./architecture/OVERVIEW.md) | System architecture and design decisions |
| [architecture/DATABASE.md](./architecture/DATABASE.md) | Database schema and vector storage |
| [architecture/MCP-SERVER.md](./architecture/MCP-SERVER.md) | MCP server implementation details |
| [specs/API.md](./specs/API.md) | MCP tool specifications |
| [specs/PLUGIN.md](./specs/PLUGIN.md) | Claude Code plugin specification |
| [implementation/ROADMAP.md](./implementation/ROADMAP.md) | Development phases and timeline |
| [implementation/MIGRATION.md](./implementation/MIGRATION.md) | LanceDB to Supabase migration guide |
| [implementation/DEPLOYMENT.md](./implementation/DEPLOYMENT.md) | Deployment and hosting guide |
---
## Quick Start (For Contributors)
```bash
# Clone the repo
git clone https://github.com/unisone/youtube-kb.git
cd youtube-kb
# Install dependencies
pnpm install
# Set up environment
cp .env.example .env.local
# Add your SUPABASE_URL, SUPABASE_ANON_KEY, OPENAI_API_KEY
# Run locally
pnpm dev
# Test MCP server
npx @modelcontextprotocol/inspector
# Connect to http://localhost:3000/api/mcp
```
---
## Project Vision
> **Make YouTube educational content searchable and accessible to every developer, from any project, through a simple MCP integration.**
### What This Is
- A **semantic search engine** for YouTube educational content
- A **public MCP server** anyone can connect to
- A **Claude Code plugin** for easy installation
- An **open-source project** anyone can fork and self-host
### What This Is NOT
- A YouTube video hosting service
- A transcript storage service (we only store embeddings + metadata)
- A replacement for watching videos (we help you find them)
---
## Key Metrics (Success Criteria)
| Metric | Target | Measurement |
|--------|--------|-------------|
| Search latency | < 500ms | P95 response time |
| Plugin installs | 100+ first month | Claude marketplace stats |
| GitHub stars | 50+ first month | GitHub |
| Uptime | 99.5%+ | Monitoring |
| Domains covered | 10+ | Content audit |
---
## Tech Stack
| Layer | Technology | Rationale |
|-------|------------|-----------|
| Vector DB | Supabase pgvector | Free tier, hybrid search, open source |
| MCP Server | TypeScript + mcp-handler | Official SDK, Vercel optimized |
| Hosting | Vercel | Free tier, auto-scaling, StreamableHTTP |
| Embeddings | OpenAI text-embedding-3-small | Cost-effective, good quality |
| Plugin | Claude Code Plugin Format | Native integration |
---
## Timeline Overview
| Phase | Duration | Deliverable |
|-------|----------|-------------|
| Phase 1: Foundation | Week 1 | Supabase setup, data migration |
| Phase 2: MCP Server | Week 2 | Deployed MCP server on Vercel |
| Phase 3: Plugin | Week 3 | Claude Code plugin, documentation |
| Phase 4: Launch | Week 4 | Public release, marketplace submission |
---
## Contact
- **Author**: Alex Zaytsev
- **GitHub**: [github.com/unisone](https://github.com/unisone)
- **Project Repo**: [github.com/unisone/youtube-kb](https://github.com/unisone/youtube-kb)
