SuperAPI AI 工具集

youtube-search

编程与开发

查看项目

更新于 10-16 00:20

技能介绍

用途:按关键词搜索 YouTube,输出结构化视频元数据,包括标题、URL、频道、观看量、时长和上传日期。使用 yt-dlp 抓取,无需 API 密钥或 OAuth。

主要能力:通过 ytsearch 搜索并返回结果;以 --dump-json 输出 JSON 元数据,用 --flat-playlist 仅列出而不下载;可用 jq 提取和格式化字段,如 title、url、channel、view_count、duration_string、upload_date、description、like_count、comment_count;支持客户端排序(按观看量或上传日期)、按时长或时效过滤、限定频道搜索,以及仅提取 URL 以供其他工具使用。

使用方式:先安装依赖 uv tool install yt-dlp,并用 yt-dlp --version 验证。基本命令形如 yt-dlp "ytsearch10:查询词" --dump-json --flat-playlist --no-warnings 2>/dev/null,再通过 jq 提取字段。ytsearch 后的数字控制返回结果数,推荐获取 15-20 条后在客户端筛选排序。

适用场景:快速发现视频、整理搜索结果表格、筛选特定时长或近期视频、把视频 URL 传给其他工具处理。

限制:yt-dlp 不支持服务端排序,需额外抓取后本地排序;高频或大量抓取可能触发 YouTube 限流;部分字段可能为 null,需处理;仅使用公开数据,不含年龄限制或私密视频;搜索排序由 YouTube 算法决定,结果可能不符预期。缺失的收费、价格等信息暂未提供。