Search YouTube for videos on any topic and return structured metadata (titles, views, authors, duration, URLs). Use when the user asks to research, find, or search for YouTube videos on a topic.
Search YouTube for videos on a topic and return structured metadata.
$ARGUMENTS, you MUST ask the user what topic they want to research before proceeding. Do NOT guess or assume a topic.cd /home/user/Sneha && source .venv/bin/activate && python .claude/skills/yt-research/scripts/yt_search.py --query "<TOPIC>" --max-results <N> --sort <relevance|date>
--query / -q: The search topic (REQUIRED - ask user if not provided)--max-results / -n: Number of videos to return (default: 10)--sort: Sort order
relevance (default): Most relevant resultsdate: Most recent uploads (use when user says "latest", "trending", "newest", or "recent")--query "X" -n 25 --sort date--query "X" (defaults are fine)--query "X" -n 25 --sort dateThe script outputs a JSON array to stdout. Parse it and present results as a formatted table with columns: #, Title, Author, Views, Duration, URL.
[
{
"title": "Video Title",
"url": "https://www.youtube.com/watch?v=...",
"author": "Channel Name",
"views": 123456,
"duration": "12:34",
"upload_date": "20250401"
}
]
Format views with commas (e.g., 123,456) and upload_date as readable dates (e.g., "Apr 1, 2025").