YouTube 搜索工具 - 公开视频发现

什么是 YouTube 搜索工具

YouTube 搜索工具用于帮助 Agent 查找公开视频，适合发布研究、创作者监控、教程发现和市场扫描。连接器通过 AIAPI Center 调用官方 YouTube Data API，并把每条视频结果标准化为适合自动化处理的数据行。

参数

• query（必填）：搜索查询
• limit（可选）：返回视频数量，最多 50
• order（可选）：date、rating、relevance、title 或 viewCount
• region_code（可选）：两位区域代码，例如 US
• relevance_language（可选）：语言提示，例如 en
• published_after / published_before（可选）：带时区的 ISO 8601 时间

示例

vernclaw-cli invoke search.youtube --query "AI agent workflows" --limit 5 --order date --region-code US

输出

CLI 默认返回紧凑 JSON：

{"status":200,"data":{}}

data 中包含标准化摘要和 items 视频行：

• 视频 ID 与标准 YouTube 观看 URL
• 标题、描述、频道和发布时间
• ISO 8601 时长
• 可用时返回公开指标
• 默认输出省略 provider/source 元信息和上游 raw payload

自动化场景应解析 JSON envelope 和 numeric status；--pretty 只用于人工查看。

限制

只支持官方 YouTube Data API 可返回的公开视频。当前版本不包含 transcript、评论、私有或未列公开视频访问。