YouTubeSearch

Search YouTube by query and return structured, human-readable results with metadata and engagement metrics.

What It Does

Runs a yt-dlp search against YouTube, returning the top N results (default 20) filtered to a recent time window (default 6 months). Each result includes:

• Title and URL
• Channel name and subscriber count
• View count and duration
• Upload date
• Engagement ratio (views / subscribers) — a quick signal for whether a video over- or under-performed relative to the channel's audience

Numbers are human-readable (e.g., 1.2M, 45.3K). Results are separated by dividers for easy scanning.

Requirements