feat: add YouTube video search via yt-dlp ytsearch

Users can now type search queries directly in the input field instead
of pasting URLs. Search triggers after 500ms debounce with results
displayed in a dropdown. Clicking a result starts the analysis.

- Add search_videos method to YouTubeExtractor using ytsearch
- Add /api/analysis/search endpoint with query and limit params
- Add SearchResults dropdown component with loading state
- Modify UrlInput to detect URLs vs search queries
- Add 9 unit tests for search functionality (215 total)

Author: nolancacheux

api/models/__init__.py

@@ -13,6 +13,7 @@
     PriorityLevel,
     ProgressEvent,
     RecommendationResponse,
+    SearchResult,
     SentimentSummary,
     SentimentType,
     TopicResponse,
@@ -30,6 +31,7 @@
     "ProgressEvent",
     "AnalysisHistoryItem",
     "ErrorResponse",
+    "SearchResult",
     "SentimentType",
     "PriorityLevel",
     "AnalysisStage",

api/models/schemas.py

@@ -125,6 +125,20 @@ class ErrorResponse(BaseModel):
     detail: str | None = None
 
 
+# Search Models
+
+
+class SearchResult(BaseModel):
+    """YouTube video search result."""
+
+    id: str
+    title: str
+    channel: str
+    thumbnail: str
+    duration: str | None = None
+    view_count: int | None = None
+
+
 # ABSA (Aspect-Based Sentiment Analysis) Models
 
 

api/routers/analysis.py

@@ -22,6 +22,7 @@
     PriorityLevel,
     ProgressEvent,
     RecommendationResponse,
+    SearchResult,
     SentimentSummary,
     SentimentType,
     TopicResponse,
@@ -735,3 +736,30 @@ async def delete_analysis(analysis_id: int, db: Session = Depends(get_db)):
     db.commit()
 
     return {"status": "deleted", "id": analysis_id}
+
+
+@router.get("/search", response_model=list[SearchResult])
+async def search_videos(q: str, limit: int = 5):
+    """Search YouTube videos by query."""
+    if not q or len(q.strip()) < 2:
+        raise HTTPException(status_code=400, detail="Query must be at least 2 characters")
+
+    if limit < 1 or limit > 10:
+        limit = 5
+
+    extractor = YouTubeExtractor()
+    try:
+        results = extractor.search_videos(q.strip(), limit)
+        return [
+            SearchResult(
+                id=r.id,
+                title=r.title,
+                channel=r.channel,
+                thumbnail=r.thumbnail,
+                duration=r.duration,
+                view_count=r.view_count,
+            )
+            for r in results
+        ]
+    except YouTubeExtractionError as e:
+        raise HTTPException(status_code=500, detail=str(e))

api/services/__init__.py

@@ -38,6 +38,7 @@
 from .youtube import (
     CommentData,
     CommentsDisabledError,
+    SearchResultData,
     VideoMetadata,
     VideoNotFoundError,
     YouTubeExtractionError,
@@ -51,6 +52,7 @@
     "VideoNotFoundError",
     "VideoMetadata",
     "CommentData",
+    "SearchResultData",
     "SentimentAnalyzer",
     "SentimentResult",
     "SentimentCategory",

api/services/youtube.py

@@ -27,6 +27,16 @@ class CommentData:
     parent_id: str | None = None
 
 
+@dataclass
+class SearchResultData:
+    id: str
+    title: str
+    channel: str
+    thumbnail: str
+    duration: str | None
+    view_count: int | None
+
+
 class YouTubeExtractionError(Exception):
     pass
 
@@ -171,3 +181,64 @@ def get_comments(self, url: str, max_comments: int = 100) -> list[CommentData]:
             raise YouTubeExtractionError("Timeout while fetching comments")
         except json.JSONDecodeError:
             raise YouTubeExtractionError("Failed to parse comments data")
+
+    def search_videos(self, query: str, max_results: int = 5) -> list[SearchResultData]:
+        """Search YouTube videos using yt-dlp's ytsearch feature."""
+        if not query.strip():
+            return []
+
+        try:
+            result = subprocess.run(
+                [
+                    "yt-dlp",
+                    f"ytsearch{max_results}:{query}",
+                    "--dump-json",
+                    "--no-download",
+                    "--no-warnings",
+                    "--flat-playlist",
+                ],
+                capture_output=True,
+                text=True,
+                timeout=30,
+            )
+
+            if result.returncode != 0:
+                raise YouTubeExtractionError(f"Search failed: {result.stderr}")
+
+            results = []
+            for line in result.stdout.strip().split("\n"):
+                if not line:
+                    continue
+                try:
+                    data = json.loads(line)
+                    video_id = data.get("id", "")
+                    duration_secs = data.get("duration")
+                    duration_str = None
+                    if duration_secs:
+                        minutes, seconds = divmod(int(duration_secs), 60)
+                        hours, minutes = divmod(minutes, 60)
+                        if hours > 0:
+                            duration_str = f"{hours}:{minutes:02d}:{seconds:02d}"
+                        else:
+                            duration_str = f"{minutes}:{seconds:02d}"
+
+                    results.append(
+                        SearchResultData(
+                            id=video_id,
+                            title=data.get("title", "Unknown"),
+                            channel=data.get("channel", data.get("uploader", "Unknown")),
+                            thumbnail=data.get(
+                                "thumbnail",
+                                f"https://i.ytimg.com/vi/{video_id}/hqdefault.jpg",
+                            ),
+                            duration=duration_str,
+                            view_count=data.get("view_count"),
+                        )
+                    )
+                except json.JSONDecodeError:
+                    continue
+
+            return results
+
+        except subprocess.TimeoutExpired:
+            raise YouTubeExtractionError("Timeout while searching videos")

src/components/search-results.tsx

@@ -0,0 +1,114 @@
+"use client";
+
+import type { SearchResult } from "@/types";
+import { cn } from "@/lib/utils";
+
+interface SearchResultsProps {
+  results: SearchResult[];
+  isLoading: boolean;
+  onSelect: (result: SearchResult) => void;
+  className?: string;
+}
+
+function formatViewCount(count: number | undefined): string {
+  if (count === undefined) return "";
+  if (count >= 1_000_000) {
+    return `${(count / 1_000_000).toFixed(1)}M views`;
+  }
+  if (count >= 1_000) {
+    return `${(count / 1_000).toFixed(1)}K views`;
+  }
+  return `${count} views`;
+}
+
+export function SearchResults({
+  results,
+  isLoading,
+  onSelect,
+  className,
+}: SearchResultsProps) {
+  if (isLoading) {
+    return (
+      <div
+        className={cn(
+          "absolute z-50 w-full mt-1 bg-background border rounded-lg shadow-lg overflow-hidden",
+          className
+        )}
+      >
+        <div className="flex items-center justify-center py-8">
+          <svg
+            className="animate-spin h-5 w-5 text-muted-foreground"
+            xmlns="http://www.w3.org/2000/svg"
+            fill="none"
+            viewBox="0 0 24 24"
+          >
+            <circle
+              className="opacity-25"
+              cx="12"
+              cy="12"
+              r="10"
+              stroke="currentColor"
+              strokeWidth="4"
+            />
+            <path
+              className="opacity-75"
+              fill="currentColor"
+              d="M4 12a8 8 0 018-8V0C5.373 0 0 5.373 0 12h4zm2 5.291A7.962 7.962 0 014 12H0c0 3.042 1.135 5.824 3 7.938l3-2.647z"
+            />
+          </svg>
+          <span className="ml-2 text-sm text-muted-foreground">Searching...</span>
+        </div>
+      </div>
+    );
+  }
+
+  if (results.length === 0) {
+    return null;
+  }
+
+  return (
+    <div
+      className={cn(
+        "absolute z-50 w-full mt-1 bg-background border rounded-lg shadow-lg overflow-hidden",
+        className
+      )}
+    >
+      <ul className="divide-y">
+        {results.map((result) => (
+          <li key={result.id}>
+            <button
+              type="button"
+              onClick={() => onSelect(result)}
+              className="w-full flex items-center gap-3 p-3 hover:bg-muted/50 transition-colors text-left"
+            >
+              <img
+                src={result.thumbnail}
+                alt={result.title}
+                className="w-24 h-14 object-cover rounded flex-shrink-0"
+                onError={(e) => {
+                  (e.target as HTMLImageElement).src = `https://i.ytimg.com/vi/${result.id}/hqdefault.jpg`;
+                }}
+              />
+              <div className="flex-1 min-w-0">
+                <p className="text-sm font-medium truncate">{result.title}</p>
+                <p className="text-xs text-muted-foreground truncate">{result.channel}</p>
+                <div className="flex items-center gap-2 mt-1">
+                  {result.duration && (
+                    <span className="text-xs text-muted-foreground bg-muted px-1.5 py-0.5 rounded">
+                      {result.duration}
+                    </span>
+                  )}
+                  {result.viewCount !== undefined && (
+                    <span className="text-xs text-muted-foreground">
+                      {formatViewCount(result.viewCount)}
+                    </span>
+                  )}
+                </div>
+              </div>
+            </button>
+          </li>
+        ))}
+      </ul>
+    </div>
+  );
+}