YouTube 搜索工具 - 面向 Agent 的公开视频发现 API

什么是 YouTube 搜索工具

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

配置

Vernclaw 用户只需要在连接器设置中启用该连接器，然后用 Vernclaw API Key 登录 CLI：

vernclaw-cli status
vernclaw-cli login --api-key YOUR_VERNCLAW_API_KEY

连接器访问由 Vernclaw 统一托管，个人用户无需单独配置服务凭据。

参数

• 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、评论、私有或未列公开视频访问。

故障排查

• CONNECTOR_UNAVAILABLE：请稍后重试；若问题持续，请联系支持团队。
• 结果为空：检查查询词、区域、语言和发布时间窗口。连接器只返回官方 YouTube Data API 可访问的公开视频。