概览
想了解一个 YouTube 账号最近发布了哪些 Shorts、内容主题如何变化、哪些作品获得更多观看?这个应用按账号名称整理公开 Shorts,每条包含标题、链接、发布时间、时长、观看量和认证信息,可作为账号研究与内容复盘的基础数据。
它省去逐条翻看频道页面的工作,并保留采集关键词与任务账号,方便确认内容来源。以 UlanziJapan 为例,可以直接形成该账号的 Shorts 内容底表。
数据说明
数据来自指定账号公开可访问的 YouTube Shorts 列表,按发布时间降序排列,并以内容编号去重。标准化发布时间和页面显示的相对发布时间可能同时存在,时间字段未提供明确时区。观看数和时长数值按原始字符串保留。部分内容可能缺少正文、发布时间、观看量或认证信息;已删除、受限、非公开或不可访问的内容不在结果中。
结果长什么样
每条记录代表账号发布的一条 Shorts:
| 内容编号 | 内容标题 | 账号名称 | 观看数 |
|---|---|---|---|
| Eqm8TLNgBmo | Ulanzi UA50 Air Tube Light | Ulanzi Japan | 707 |
| ca9OIFNiUU8 | Chasing Light with Ulanzi Camera Backpack | ulanzi | 1204 |
结果另有内容链接、发布时间、展示时长、内容状态等字段。
应用场景
- 做选题复盘时,结合「内容标题」与「内容正文」归纳高频主题,观察账号持续投入的内容方向。
- 看发布节奏时,按「发布时间」排序并参考「相对发布时间」,识别集中更新或停更时段。
- 比较内容表现时,把「观看数」与「展示时长」放在一起看,再通过「内容链接」回看作品,判断哪些主题更容易获得观看。
适用边界
单次任务采集一个 YouTube 账号,最多返回 1000 条公开 Shorts;已删除、受限或不可访问的内容可能无法返回。
- 适合用于
- 需要获取指定 YouTube 账号公开 Shorts 列表时
- 需要分析账号短视频主题、发布时间、时长或观看表现时
- 不要用于
- 需要获取普通长视频列表时——应使用 YouTube 常规视频列表类 App
- 需要采集非 YouTube 平台短视频时——应使用对应平台的数据获取 App
失败处理
作者声明的失败与重试处理方式,接入时建议一并写进系统提示词。
- 1暂时性服务失败或超时可以使用相同输入重试
- 2部分成功时会返回已经获得的 Shorts,缺失内容可稍后重新提交
- 3鉴权失败属不可重试错误,需先检查执行环境中的凭证配置
输入参数
调用本 App 需要传入的参数,与 manifest.json 的 input.schema 同源。
| 字段名 | 业务名称 | 类型 | 必填 | 默认值 | 枚举 / 约束 | 示例 | 说明 |
|---|---|---|---|---|---|---|---|
| account_name | 账号名称 | string | 是 | — | — | UlanziJapan | 要采集 Shorts 列表的 YouTube 账号名称,例如 UlanziJapan。请填写账号名称,不要填写频道链接或视频链接 |
| crawl_num | 采集数量 | integer | 是 | — | 1–1000 | 1 | 希望获取的 Shorts 数量,范围为 1–1000。数量越大,任务耗时和费用通常越高 |
输出数据
单条记录的字段结构,与 manifest.json 的 output.schema 同源。
| 字段名 | 业务名称 | 类型 | 示例 | 说明 |
|---|---|---|---|---|
| content_id | 内容编号 | string | — | Shorts 内容的稳定唯一编号 |
| content_url | 内容链接 | string | — | Shorts 内容的公开访问链接 |
| content_title | 内容标题 | string | — | Shorts 展示标题 |
| content_text | 内容正文 | string | — | Shorts 关联的文字内容 |
| account_name | 账号名称 | string | — | 发布该 Shorts 的账号名称 |
| account_display_id | 展示账号 | string | — | 账号在 YouTube 页面展示的标识 |
| account_id | 账号编号 | string | — | 账号在 YouTube 内的编号 |
| biz_id | 业务账号 | string | — | 结果记录关联的账号业务标识 |
| article_type | 内容类型 | string | — | 内容类型,例如 short 或 video |
| publish_time | 发布时间 | string | — | Shorts 的标准化发布时间,接口未声明时区 |
| raw_publish_time | 相对发布时间 | string | — | 页面展示的相对发布时间文本,例如 1个月前 |
| crawl_time | 采集时间 | string | — | 该条内容被采集的时间,接口未声明时区 |
| raw_duration | 展示时长 | string | — | 页面展示的视频时长,例如 0:37 |
| video_duration | 时长数值 | string | — | 视频时长的原始数值,接口以字符串返回 |
| view_count | 观看数 | string | — | 视频观看次数的原始数值,接口以字符串返回 |
| view_count_text | 观看量文本 | string | — | 页面展示的观看次数文本 |
| content_status | 内容状态 | string | — | 结果记录中的内容处理状态 |
| is_collaboration | 是否合作 | boolean | — | 该 Shorts 是否标记为合作内容 |
| is_verified | 是否认证 | boolean | — | 发布账号是否经过 YouTube 认证 |
| is_verified_artist | 认证艺人 | boolean | — | 发布账号是否为 YouTube 认证艺人 |
| keyword | 采集关键词 | string | — | 采集任务关联的账号关键词 |
| keyword_type | 关键词类型 | string | — | 采集任务使用的关键词类型 |
| task_item | 任务账号 | string | — | 本条记录所属任务提交的账号名称 |
| no_data | 是否无数据 | boolean | — | 该任务项是否未获得内容数据 |
记录 Schema
输出按记录逐条返回。记录主键为 content_id,去重、增量、关联以它为准。
{
"type": "object",
"properties": {
"content_id": {
"type": "string",
"title": "内容编号",
"description": "Shorts 内容的稳定唯一编号"
},
"content_url": {
"type": "string",
"title": "内容链接",
"description": "Shorts 内容的公开访问链接"
},
"content_title": {
"type": "string",
"title": "内容标题",
"description": "Shorts 展示标题"
},
"content_text": {
"type": "string",
"title": "内容正文",
"description": "Shorts 关联的文字内容"
},
"account_name": {
"type": "string",
"title": "账号名称",
"description": "发布该 Shorts 的账号名称"
},
"account_display_id": {
"type": "string",
"title": "展示账号",
"description": "账号在 YouTube 页面展示的标识"
},
"account_id": {
"type": "string",
"title": "账号编号",
"description": "账号在 YouTube 内的编号"
},
"biz_id": {
"type": "string",
"title": "业务账号",
"description": "结果记录关联的账号业务标识"
},
"article_type": {
"type": "string",
"title": "内容类型",
"description": "内容类型,例如 short 或 video"
},
"publish_time": {
"type": "string",
"title": "发布时间",
"description": "Shorts 的标准化发布时间,接口未声明时区"
},
"raw_publish_time": {
"type": "string",
"title": "相对发布时间",
"description": "页面展示的相对发布时间文本,例如 1个月前"
},
"crawl_time": {
"type": "string",
"title": "采集时间",
"description": "该条内容被采集的时间,接口未声明时区"
},
"raw_duration": {
"type": "string",
"title": "展示时长",
"description": "页面展示的视频时长,例如 0:37"
},
"video_duration": {
"type": "string",
"title": "时长数值",
"description": "视频时长的原始数值,接口以字符串返回"
},
"view_count": {
"type": "string",
"title": "观看数",
"description": "视频观看次数的原始数值,接口以字符串返回"
},
"view_count_text": {
"type": "string",
"title": "观看量文本",
"description": "页面展示的观看次数文本"
},
"content_status": {
"type": "string",
"title": "内容状态",
"description": "结果记录中的内容处理状态"
},
"is_collaboration": {
"type": "boolean",
"title": "是否合作",
"description": "该 Shorts 是否标记为合作内容"
},
"is_verified": {
"type": "boolean",
"title": "是否认证",
"description": "发布账号是否经过 YouTube 认证"
},
"is_verified_artist": {
"type": "boolean",
"title": "认证艺人",
"description": "发布账号是否为 YouTube 认证艺人"
},
"keyword": {
"type": "string",
"title": "采集关键词",
"description": "采集任务关联的账号关键词"
},
"keyword_type": {
"type": "string",
"title": "关键词类型",
"description": "采集任务使用的关键词类型"
},
"task_item": {
"type": "string",
"title": "任务账号",
"description": "本条记录所属任务提交的账号名称"
},
"no_data": {
"type": "boolean",
"title": "是否无数据",
"description": "该任务项是否未获得内容数据"
}
},
"required": [],
"additionalProperties": false
}调用方式
本 App 支持通过 MCP、API、SDK 与文件导出方式接入,各接入方式共享同一套能力与计价。所有请求统一使用 Authorization: Bearer 请求头完成身份认证,凭证为 API Key(长期有效,在开放平台创建);MCP 客户端另支持 OAuth 免密钥登录。CLI、Skill 等更多接入方式正在规划中。
通过 MCP(Model Context Protocol)协议,可在 Claude、Cursor 等 AI 客户端中直接调用本 App。选择你的客户端与认证方式,复制下方配置即可接入。
客户端配置
把 Bearer 后替换为长期有效的 API Key 即可,各类客户端与 CI、无浏览器环境通用。
{
"mcpServers": {
"mona_kk__youtube-shorts-list": {
"type": "http",
"url": "https://mcp-v2.bazhuayu.com?pin=mona_kk/youtube-shorts-list",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}让 AI 自己完成配置
不想手动改配置?复制安装提示词,粘贴到任意 AI 客户端对话框,由它按自身方式完成接入(提示词会让 AI 向你索要 API Key,避免凭证留在对话记录或共享配置里)。
如需在同一个 MCP 连接里指定多个 App,前往 MCP 连接页(已为你指定本 App)。
价格
每提交一次任务计费一次,与返回条数无关。
按实际成功返回的数据条数计费,任务失败不计费。每 30 条为一个计费单位,不足 30 条按 30 条计。
多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。
立即体验
填写参数直接运行,结果来自真实调用。