Yt Search

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:

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

# 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
• Source: duncan-buildroom/profit-room-skills
• License: MIT

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