YouTube 视频读取工具 - 公开视频元数据 API

什么是 YouTube 视频读取工具

YouTube 视频读取工具会把公开 YouTube URL 或视频 ID 转换为标准化元数据行。适合 Agent 验证视频引用、为后续摘要准备来源，或收集创作者研究信号。

配置

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

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

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

参数

提供以下任一项：

• url（可选）：公开的 YouTube watch、Shorts、embed、live、youtu.be 或 youtube-nocookie URL
• id（可选）：11 位 YouTube 视频 ID

示例

# 运行前请把 VIDEO_ID_HERE 替换成真实公开 YouTube 视频 ID。
vernclaw-cli invoke read.youtube.video --url "https://www.youtube.com/watch?v=VIDEO_ID_HERE"
vernclaw-cli invoke read.youtube.video --id VIDEO_ID_HERE

输出

CLI 默认返回紧凑 JSON：

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

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

• 标题和标准观看 URL
• 频道信息
• 发布时间和时长
• 可用时返回公开视频观看数、点赞数和评论数
• 默认输出省略 provider/source 元信息和上游 raw payload

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

限制

只支持公开视频。当前版本不包含 transcript、评论、字幕、私有视频或已登录 YouTube 账号数据。

故障排查

• CONNECTOR_UNAVAILABLE：请稍后重试；若问题持续，请联系支持团队。
• 视频 ID 或 URL 无效：请提供公开 watch、Shorts、embed、live、youtu.be、youtube-nocookie URL，或 11 位 YouTube video ID。