# search-youtube

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.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 276 repo stars
- Author: Samarth Gupta
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/gupsammy/Claudest/tree/HEAD/plugins/claude-research/skills/search-youtube/SKILL.md
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/search-youtube

## What it 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.

## Install

### Claude Code (native platform)

1. **Plugin marketplace**
In the agent chat (not a shell):
```text
/plugin marketplace add gupsammy/Claudest
```
In the agent chat (not a shell):
```text
/plugin install claude-research@Claudest
```
This installs the whole claude-research plugin with all its skills

2. **Skills CLI (Vercel)**
```bash
npx skills add gupsammy/Claudest --skill search-youtube -a claude-code
```

3. **Manually: put the files in place**
- File: `~/.claude/skills/search-youtube/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/search-youtube/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add gupsammy/Claudest --skill search-youtube -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/search-youtube/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add gupsammy/Claudest --skill search-youtube -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/search-youtube/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install gupsammy/Claudest plugins/claude-research/skills/search-youtube
```

2. **Manually: put the files in place**
- File: `.github/skills/search-youtube/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add gupsammy/Claudest --skill search-youtube -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/gupsammy/Claudest --path plugins/claude-research/skills/search-youtube
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/search-youtube/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/gupsammy/Claudest/tree/HEAD/plugins/claude-research/skills/search-youtube/SKILL.md

## When to use it
- 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
- 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

## Similar
- [Arcmira: YouTube Transcript Search](https://affpapa.org/en/nevibecode/mcp/arcmira-youtube-transcript-search.md) — MCP server · ★ 33 repo stars
- [youtube-search](https://affpapa.org/en/nevibecode/skills/youtube-search.md) — skill · 1100 installs
- [youtube-full](https://affpapa.org/en/nevibecode/skills/zeropointrepo-youtube-full.md) — skill · 2400 installs
- [youtube-research](https://affpapa.org/en/nevibecode/skills/manojbajaj95-youtube-research.md) — skill · 200 installs
- [YouTube Transcript + YouTube Search MCP](https://affpapa.org/en/nevibecode/mcp/youtube-transcript-youtube-search-mcp.md) — MCP server · ★ 10 repo stars
- [youtube-content](https://affpapa.org/en/nevibecode/skills/youtube-content.md) — skill · 546 installs

From the same set: [gupsammy/claudest](https://affpapa.org/en/nevibecode/by/gupsammy/claudest.md) — 47 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
