logo

YouTube Shorts 列表采集

给一个 YouTube 账号名称和采集数量,返回该账号公开 Shorts 的内容、发布时间、时长与观看数据

概览

想了解一个 YouTube 账号最近发布了哪些 Shorts、内容主题如何变化、哪些作品获得更多观看?这个应用按账号名称整理公开 Shorts,每条包含标题、链接、发布时间、时长、观看量和认证信息,可作为账号研究与内容复盘的基础数据。

它省去逐条翻看频道页面的工作,并保留采集关键词与任务账号,方便确认内容来源。以 UlanziJapan 为例,可以直接形成该账号的 Shorts 内容底表。

数据说明

数据来自指定账号公开可访问的 YouTube Shorts 列表,按发布时间降序排列,并以内容编号去重。标准化发布时间和页面显示的相对发布时间可能同时存在,时间字段未提供明确时区。观看数和时长数值按原始字符串保留。部分内容可能缺少正文、发布时间、观看量或认证信息;已删除、受限、非公开或不可访问的内容不在结果中。

结果长什么样

每条记录代表账号发布的一条 Shorts:

内容编号内容标题账号名称观看数
Eqm8TLNgBmoUlanzi UA50 Air Tube LightUlanzi Japan707
ca9OIFNiUU8Chasing Light with Ulanzi Camera Backpackulanzi1204

结果另有内容链接、发布时间、展示时长、内容状态等字段。

应用场景

  • 做选题复盘时,结合「内容标题」与「内容正文」归纳高频主题,观察账号持续投入的内容方向。
  • 看发布节奏时,按「发布时间」排序并参考「相对发布时间」,识别集中更新或停更时段。
  • 比较内容表现时,把「观看数」与「展示时长」放在一起看,再通过「内容链接」回看作品,判断哪些主题更容易获得观看。

适用边界

单次任务采集一个 YouTube 账号,最多返回 1000 条公开 Shorts;已删除、受限或不可访问的内容可能无法返回。

  • 适合用于
  • 需要获取指定 YouTube 账号公开 Shorts 列表时
  • 需要分析账号短视频主题、发布时间、时长或观看表现时
  • 不要用于
  • 需要获取普通长视频列表时——应使用 YouTube 常规视频列表类 App
  • 需要采集非 YouTube 平台短视频时——应使用对应平台的数据获取 App

失败处理

作者声明的失败与重试处理方式,接入时建议一并写进系统提示词。

  1. 1暂时性服务失败或超时可以使用相同输入重试
  2. 2部分成功时会返回已经获得的 Shorts,缺失内容可稍后重新提交
  3. 3鉴权失败属不可重试错误,需先检查执行环境中的凭证配置

输入参数

调用本 App 需要传入的参数,与 manifest.json 的 input.schema 同源。

字段名业务名称类型必填默认值枚举 / 约束示例说明
account_name账号名称stringUlanziJapan要采集 Shorts 列表的 YouTube 账号名称,例如 UlanziJapan。请填写账号名称,不要填写频道链接或视频链接
crawl_num采集数量integer1–10001希望获取的 Shorts 数量,范围为 1–1000。数量越大,任务耗时和费用通常越高

输出数据

单条记录的字段结构,与 manifest.json 的 output.schema 同源。

字段名业务名称类型示例说明
content_id内容编号stringShorts 内容的稳定唯一编号
content_url内容链接stringShorts 内容的公开访问链接
content_title内容标题stringShorts 展示标题
content_text内容正文stringShorts 关联的文字内容
account_name账号名称string发布该 Shorts 的账号名称
account_display_id展示账号string账号在 YouTube 页面展示的标识
account_id账号编号string账号在 YouTube 内的编号
biz_id业务账号string结果记录关联的账号业务标识
article_type内容类型string内容类型,例如 short 或 video
publish_time发布时间stringShorts 的标准化发布时间,接口未声明时区
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,去重、增量、关联以它为准。

output.schema
{
  "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 配置
{
  "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)。

价格

受理一次 Shorts 列表采集任务

每提交一次任务计费一次,与返回条数无关。

¥0.001/
返回一条 Shorts 记录

按实际成功返回的数据条数计费,任务失败不计费。每 30 条为一个计费单位,不足 30 条按 30 条计。

¥0.015/ 30 条

多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。

立即体验

填写参数直接运行,结果来自真实调用。

示例
参数按 input.schema 校验后提交
请先填写必填参数
¥0.015 / 30 条起