Skip to main content
skill CX Codex

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

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add gupsammy/Claudest
/plugin install claude-research@Claudest
Open on GitHub

What 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-dlp and show me the transcript of the most detailed one
  • Grab the subtitles from this link and save them under the rag topic
  • 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@Claudest

This installs the whole claude-research plugin with all its skills

2Skills CLI (Vercel)

npx skills add gupsammy/Claudest --skill search-youtube -a claude-code

3Manually: put the files in place

~/.claude/skills/search-youtube/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/search-youtube/

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.

Similar skills

All skills for Science and research →
Arcmira: YouTube Transcript Search arcmira Arcmira: YouTube Transcript Search is an MCP server for Claude Code that searches YouTube and podcast transcripts for quotes, mentions, ads, and speaker appearances. CX Codex +1 ★ 33repo stars youtube-search ZeroPointRepo youtube-search — a Claude Code skill that searches YouTube videos, channels and playlists through TranscriptAPI, then pulls transcripts for what it finds. Kick it off when research needs video sources, not just written ones. CX Codex +1 1,100installs youtube-full ZeroPointRepo youtube-full enables agents to search YouTube, retrieve timestamped video transcripts, and inspect channel metadata via TranscriptAPI. Built for developer assistants handling video research. CX Codex +1 2,400installs youtube-research manojbajaj95 youtube-research — a skill for Claude Code, Codex, Cursor and other agents that searches YouTube, pulls channel and video stats from the YouTube Data API v3, and breaks down transcripts for hooks and retention patterns. CX Codex +1 200installs YouTube Transcript + YouTube Search MCP tubeagentkit YouTube Transcript + YouTube Search MCP — a remote MCP server for YouTube video and channel search, transcripts, channel browsing, and playlists. Use it when an agent needs source material from YouTube. CX Codex +1 ★ 10repo stars youtube-content Teknium (teknium1), Hermes Agent youtube-content is a Claude Code skill that fetches YouTube transcripts and turns them into chapters, summaries, threads, or blog posts. CX Codex +1 546installs

From the same set47

The whole set →
push-pr push-pr is a Claude Code skill that pushes a branch and creates or updates its GitHub pull request. For large or mixed changes, it can propose splitting them into stacked PRs. CX Codex +1 ★ 276repo stars brainstorm brainstorm — an interview skill that turns the tables: the agent asks, you answer, and the session ends with a written spec or decision doc. CX Codex +1 ★ 276repo stars get-token-insights get-token-insights parses Claude Code conversation history, flags token waste, and generates an offline dashboard covering costs, hooks, and agent workflows. CX Codex +1 ★ 276repo stars extract-frames extract-frames detects shot boundaries in a video and saves the first or last frame of each shot. Use it to review an edit or collect frames from selected shots. CX Codex +1 ★ 276repo stars improve-skill improve-skill audits skill effectiveness, simulates user requests, and pinpoints missing capabilities in instructions. CX Codex +1 ★ 276repo stars performance-auditor The performance-auditor subagent inspects code for algorithmic, data-access, and resource bottlenecks. Use it after changes on hot paths or when you need to reason about how code scales. CX Codex ★ 276repo stars test-engineer test-engineer generates tests for critical business logic right after a feature or bug fix, skipping tests written purely to inflate coverage numbers. CX Codex ★ 276repo stars claude-memory-architecture claude-memory-architecture defines the technical architecture for the claude-memory plugin, detailing hook lifecycles, SQLite database operations, lock handling, and local vector indexing. CX Codex +1 ★ 276repo stars

Project sponsors

Companies that keep this analytics open