用途：按关键词搜索 YouTube，返回结构化、便于阅读的视频结果，并附带元数据与互动指标。
主要能力：运行 yt-dlp 搜索，返回前 N 条结果（默认 20），并限定在最近时间窗口内（默认 6 个月）。每条结果包含标题与 URL、频道名与订阅数、播放量与时长、上传日期，以及互动比（播放量/订阅数），用于快速判断视频相对该频道受众是超常还是低于平均表现。数字以 1.2M、45.3K 等人类可读格式显示，结果用分隔线隔开便于浏览。
使用方式：需已安装 yt-dlp、jq 并在 PATH 中，bc 为 macOS/Linux 自带。运行脚本：bash ~/.claude/skills/YouTubeSearch/scripts/yt-search.sh "<search query>" [--count N] [--months N]。位置参数为必填搜索词；--count 默认 20；--months 默认 6。示例：bash ~/.claude/skills/YouTubeSearch/scripts/yt-search.sh "kubernetes security best practices"；bash ~/.claude/skills/YouTubeSearch/scripts/yt-search.sh "rust async tutorial" --count 5 --months 1；bash ~/.claude/skills/YouTubeSearch/scripts/yt-search.sh "home lab setup" --months 24。
互动比解读：大于 1.0x 表示播放量超过频道订阅数，是话题引发共鸣或算法助推的强信号；0.3x 到 1.0x 为成熟频道常见区间；低于 0.3x 表示触达低于平均。该指标最适合比较同一话题下的视频。
适用场景：用户要求搜索 YouTube 或查找视频时，运行脚本并展示结果；若用户需要分析，可用互动比和播放量突出值得观看的内容。
限制与注意事项：订阅数显示 N/A 属正常，yt-dlp 有时无法从搜索结果获取频道元数据。无结果时可放宽查询或增大 --months；速度慢因每条结果都需抓取元数据，可减少 --count。API 的 order=date 仍会应用相关性排序，近期上传可能被降权，可用日期与相关性两次查询合并作为变通。配额按项目按天计算，搜索开销大（每次查询 100 单位），突发使用会导致项目当天被锁定。regionCode 参数会改变结果，默认使用查看者 IP 地理位置。转录 API 与搜索 API 分离，转录可用性因视频而异，部分视频没有且 API 不报错。频道 ID、频道用户名与 @handle 是三种不同标识，解析需显式调用频道列表。上传者禁止嵌入的视频仍可能出现在搜索结果中，下游嵌入工具会无警告失败，需检查 status.embeddable。