search-youtube — Claude Code skill: YouTube search and transcripts
search-youtube finds YouTube videos, pulls transcripts and metadata, downloads audio and walks a channel's uploads through a single CLI the agent calls on its own.
no license ★ 276 updated 2026-10-29
/plugin marketplace add gupsammy/Claudest
/plugin install claude-research@ClaudestWhat search-youtube does
Give it a query or a link and it hands back text the agent can use: search hits, cleaned subtitles, video metadata, audio files, channel listings. The work happens in one Python CLI, yt_research.py, with the subcommands search, transcript, metadata, audio and channel.
JSON is the default output; -f text prints something a person can read. Transcripts land on stdout, or under ~/youtube-research/<topic>/ when you pass --save -t <topic>. Every subcommand except search also takes --batch urls.txt — one link per line, lines starting with # or ; are skipped.
Ask for research instead of a single operation and it splits the topic into several query angles, fans them out to parallel Task agents, then scans the channels behind the strongest hits before pulling transcripts. It shells out to yt-dlp, so that binary has to be on the machine and reachable from Bash. Videos with no subtitles in the requested language end the command with exit code 4.
What it helps with
- find videos on a narrow topic and filter out clickbait by metadata
- get a transcript without fetching subtitles by hand
- extract the audio track as mp3 for later processing
- list what a channel published inside a date range
- process a file of URLs in one call
Example prompts for the agent
- Search YouTube for recent videos about
yt-dlpand show me the transcript of the most detailed one - Grab the subtitles from this link and save them under the
ragtopic - Research what people on YouTube say about MCP servers and write it up
How to install search-youtube
1Plugin marketplace
/plugin marketplace add gupsammy/Claudest/plugin install claude-research@ClaudestThis installs the whole claude-research plugin with all its skills
2Skills CLI (Vercel)
npx skills add gupsammy/Claudest --skill search-youtube -a claude-code3Manually: put the files in place
~/.claude/skills/search-youtube/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/search-youtube/
1Skills CLI (Vercel)
npx skills add gupsammy/Claudest --skill search-youtube -a codex2Manually: put the files in place
.agents/skills/search-youtube/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add gupsammy/Claudest --skill search-youtube -a cursor2Manually: put the files in place
.cursor/skills/search-youtube/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install gupsammy/Claudest plugins/claude-research/skills/search-youtube2Manually: put the files in place
.github/skills/search-youtube/SKILL.md1Skills CLI (Vercel)
npx skills add gupsammy/Claudest --skill search-youtube -a gemini-cli2Platform CLI
gemini skills install https://github.com/gupsammy/Claudest --path plugins/claude-research/skills/search-youtubeManually: put the files in place
.devin/skills/search-youtube/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about search-youtube
How do I install search-youtube in Claude Code?
Through the marketplace: run /plugin marketplace add gupsammy/Claudest, then /plugin install claude-research@Claudest. The other route is npx skills add gupsammy/Claudest --skill search-youtube -a claude-code.
What does search-youtube do?
It searches for videos, downloads and cleans up subtitles, reads metadata without pulling the file, saves audio as mp3, m4a, opus or wav, and scans channel tabs.
What happens when a video has no subtitles?
Manual subtitles are tried first, auto-generated ones after that. If neither exists in the language you asked for, the command exits with code 4.