社交内容读取同步2 积分YouTube 搜索视频研究社交监听
YouTube 搜索
通过 AIAPI Center 搜索公开 YouTube 视频，并返回标准化视频证据行。
它能做什么
YouTube 上的发布视频、教程、评测和创作者反应，经常比网页索引更早出现。这个连接器通过 AIAPI Center 搜索公开视频，并返回标题、URL、频道、发布时间、时长、公开指标和来源限制说明。
输入参数
| 参数 | 格式 | 示例 | 必填 |
|---|---|---|---|
query | string | AI agent workflows | 是 |
limit | number | 5 | 否 |
order | date | rating | relevance | title | viewCount | date | 否 |
region_code | string | US | 否 |
输出结果
| 字段 | 类型 | 说明 |
|---|---|---|
matchedVideos | number | 本次查询返回的公开视频数量 |
topTitle | string | 排名最高视频的标题 |
topUrl | string | 排名最高视频的标准 YouTube 观看 URL |
items | array | 标准化视频行，包含频道、指标、时长、来源模式和限制说明 |
示例输出
输入
query: "AI agent workflows" limit: 5 order: "date" region_code: "US"
输出
# YouTube 搜索结果 - Query: AI agent workflows - Matched Videos: 5 - Top Title: AI Agent Workflows - Top URL: https://www.youtube.com/watch?v=abc123def45
结果解读
共有 5 个公开视频匹配查询。首条结果包含来自官方 API 的标准化 YouTube 元数据和公开指标。
最近测试：2026-06-04
如何安装
通过 CLI
$ vernclaw-cli invoke search.youtube --query <value> --limit <value> --order <value> --region_code <value> --relevance_language <value> --published_after <value> --published_before <value>
通过网页
- 访问连接器目录并找到 YouTube 搜索。
- 点击“安装连接器”，并按提示确认任何训练相关要求。
- 如果需要，请完成授权。
- 之后即可在 Chat 或 CLI 中使用该连接器。
鉴权与权限
| 是否需要 OAuth | 否 |
| 托管鉴权 | 已内置，无需自备 API Key |
| 自带 Key（BYOK） | v1 暂不支持 |
| 是否记录审计日志 | 每次请求都会记录输入、结果、成本和时间戳 |
| 训练确认 | 不需要 |
管理员可以在后台通过黑名单或白名单限制这个连接器。
限制与边界情况
- •只返回 YouTube Data API 可访问的公开视频。
- •默认返回 5 条结果；最多 50 条。
- •v1 不返回 transcript 文本。
- •公开指标可能滞后于 YouTube 页面展示值。
常见用法
查找最新发布和教程视频
在撰写市场扫描或发布简报前，先搜索 YouTube 视频证据。
为创作者研究收集视频证据
返回 Agent 可引用、排序和总结的标准化视频行。
按新鲜度或热度监控话题
通过排序和区域过滤器聚焦最新或高观看量公开视频。
常见问题
会返回 transcript 吗？
不会。v1 只返回视频元数据和公开指标，不返回 transcript 文本。
支持哪些视频？
只支持官方 YouTube Data API 返回的公开 YouTube 视频。