youtubesearch

用途：按查询词搜索 YouTube 视频，返回结构化的可读结果，便于快速浏览和筛选近期视频。主要能力：默认返回前 20 条、最近 6 个月内结果；每条包含标题与 URL、频道名称与订阅数、播放量、时长、上传日期，以及互动比率（播放量/订阅数）。数值以 1.2M、45.3K 等易读格式呈现，结果以分隔线区隔。互动比率可用于判断表现：>1.0x 表示播放量超过频道订阅数，0.3x–1.0x 为成熟频道常见区间，<0.3x 表示触达低于平均；比较同一主题的视频时尤其有用。使用方式：先确保 yt-dlp、jq、bc 已安装并在 PATH 中，然后运行脚本 bash ~/.claude/skills/YouTubeSearch/scripts/yt-search.sh "<search query>" [--count N] [--months N]。位置参数为必填搜索词，--count 默认 20，--months 默认 6。示例：搜索“kubernetes security best practices”取最近 6 个月前 20 条；加 --count 5 --months 1 缩小范围；--months 24 扩大时间窗。适用场景：查找视频、按时间过滤、挑选值得观看的内容或对比同主题表现。限制：无结果时可扩大查询或增加 --months；结果慢是因每条需获取元数据，可减少 --count；部分结果订阅数显示 N/A 属正常，其他字段仍会填充。yt-dlp 有时无法从搜索结果解析频道订阅数。安装以外的系统要求、依赖版本与许可信息暂未提供。