# Yt Search

> Search YouTube and return structured video results with metadata. Use this skill whenever the user wants to search YouTube, find videos on a topic, research what's trending on YouTube, compare YouTube videos, or look up YouTube creators/channels. Triggers on phrases like "search YouTube for", "find videos about", "what videos are there on", "YouTube results for", or any request involving YouTube…

- **Type:** Skill
- **Install:** `agentstack add skill-duncan-buildroom-profit-room-skills-yt-search`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [duncan-buildroom](https://agentstack.voostack.com/s/duncan-buildroom)
- **Installs:** 0
- **Category:** [Content & Media](https://agentstack.voostack.com/c/content-and-media)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [duncan-buildroom](https://github.com/duncan-buildroom)
- **Source:** https://github.com/duncan-buildroom/profit-room-skills/tree/main/skills/yt-search

## Install

```sh
agentstack add skill-duncan-buildroom-profit-room-skills-yt-search
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# YouTube Search

Search YouTube using yt-dlp and return structured, formatted results with engagement metrics.

## Requirements
- `yt-dlp` on PATH (`pip install yt-dlp`). If it's not installed, I'll tell you the one command to add it.

## How to use

Run the search script:

```bash
python3 ~/.claude/skills/yt-search/scripts/search.py  [--count N] [--months N] [--no-date-filter]
```

### Parameters
- `` — search terms (required)
- `--count N` — number of results to return (default: 20)
- `--months N` — only show videos from the last N months (default: 6)
- `--no-date-filter` — include videos of any age

### Examples

```bash
# Basic search (top 20, last 6 months)
python3 ~/.claude/skills/yt-search/scripts/search.py claude code tutorial

# Fewer results, shorter window
python3 ~/.claude/skills/yt-search/scripts/search.py obsidian workflow --count 5 --months 3

# All time, no date filter
python3 ~/.claude/skills/yt-search/scripts/search.py AI agents --count 10 --no-date-filter
```

## Output format

Each result includes:
- Title
- Channel name and subscriber count
- View count
- Duration
- Upload date
- Engagement ratio (views / subscribers) — higher means the video outperformed the channel's base
- Direct URL

Results are separated by dividers for easy scanning. Status messages go to stderr; formatted results go to stdout.

## Notes

- yt-dlp must be installed (`pip install yt-dlp`)
- The script fetches 2x the requested count to compensate for date filtering
- Subscriber counts come from yt-dlp metadata and may occasionally be unavailable (shown as N/A)

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [duncan-buildroom](https://github.com/duncan-buildroom)
- **Source:** [duncan-buildroom/profit-room-skills](https://github.com/duncan-buildroom/profit-room-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-duncan-buildroom-profit-room-skills-yt-search
- Seller: https://agentstack.voostack.com/s/duncan-buildroom
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.