社交内容读取同步1 积分YouTube 视频视频元数据公开指标
YouTube 视频读取
通过 AIAPI Center 按 URL 或 ID 读取公开 YouTube 视频，并返回标准化元数据和指标。
它能做什么
当 Agent 需要检查一个 YouTube 引用时，直接复制观看页很难稳定解析。这个连接器通过 AIAPI Center 按 URL 或 ID 读取公开视频，并返回标题、频道、公开指标、时长和官方 API 来源限制说明。
输入参数
| 参数 | 格式 | 示例 | 必填 |
|---|---|---|---|
url | string | https://www.youtube.com/watch?v=abc123def45 | 否 |
id | string | abc123def45 | 否 |
输出结果
| 字段 | 类型 | 说明 |
|---|---|---|
title | string | 视频标题 |
channel | string | 发布频道标题 |
url | string | 标准 YouTube 观看 URL |
views | number | YouTube 返回的公开视频观看数 |
items | array | 单条标准化视频行，包含指标、时长、来源模式和限制说明 |
示例输出
输入
url: "https://www.youtube.com/watch?v=abc123def45"
输出
# YouTube 视频 - Title: AI Agent Workflows - Channel: Example Channel - URL: https://www.youtube.com/watch?v=abc123def45 - Views: 12,345
结果解读
该视频已通过官方 YouTube API 找到，并返回适合 Agent 工作流使用的标准化元数据行。
最近测试：2026-06-04
如何安装
通过 CLI
$ vernclaw-cli invoke read.youtube.video --url <value> --id <value>
通过网页
- 访问连接器目录并找到 YouTube 视频读取。
- 点击“安装连接器”，并按提示确认任何训练相关要求。
- 如果需要，请完成授权。
- 之后即可在 Chat 或 CLI 中使用该连接器。
鉴权与权限
| 是否需要 OAuth | 否 |
| 托管鉴权 | 已内置，无需自备 API Key |
| 自带 Key（BYOK） | v1 暂不支持 |
| 是否记录审计日志 | 每次请求都会记录输入、结果、成本和时间戳 |
| 训练确认 | 不需要 |
管理员可以在后台通过黑名单或白名单限制这个连接器。
限制与边界情况
- •必须提供 url 或 id 其中之一。
- •只支持公开 YouTube 视频。
- •v1 不返回 transcript 文本。
- •公开指标可能滞后于 YouTube 页面展示值。
常见用法
摘要前先标准化视频 URL
在交给下一步 Agent 前，先读取标题、频道、时长、指标和来源限制。
验证 YouTube 引用
确认引用视频公开可访问，并记录标准观看 URL。
常见问题
可以传 Shorts 链接吗？
可以。AIAPI Center 会标准化公开的 watch、Shorts、embed、live 和 youtu.be URL。
会读取评论或字幕吗？
不会。v1 只读取视频元数据和公开指标。