概览
按账号名或频道标识获取 YouTube 公开内容列表,并把视频信息与关联账号资料整理成可分析的记录。结果以内容编号为主键,适合持续采集后的去重、对比和归档。
除标题、链接和发布时间外,每条记录还保留观看数、视频时长、内容状态、共创标识、账号认证状态及采集来源。
数据说明
数据来自 YouTube 公开可见的账号、频道与内容页面,按接口定义默认以发布时间倒序返回,并按内容编号去重。发布时间、观看数、内容状态和账号资料均为采集时快照;接口文档未声明发布时间文本的时区,跨地区分析前应统一口径。观看数同时提供数值文本与页面展示文本,图片、徽章和链接列表保留上游原始文本。私密、受限、已删除或无法公开访问的内容不在结果中。
结果长什么样
每条记录代表一个去重后的 YouTube 公开内容:
| 内容编号 | 内容标题 | 账号名称 | 发布时间 | 观看数 | 视频时长 |
|---|---|---|---|---|---|
| 8L98e7c56sQ | NEW RELEASE! Ulanzi VF01 Waist Level Viewfinder | Ulanzi | 2025-10-31T09:44:43 | 18000 | 0:19 |
| ca9OIFNiUU8 | Short Film Camera Rig Setup | Ulanzi | 2026-07-28T14:06:33 | 707 | 0:37 |
此外还会返回内容链接、正文、封面、徽章、内容状态、共创信息、账号编号、认证状态、关键词、原始发布时间和采集时间等字段。
应用场景
- 做内容表现分析时,结合「发布时间」「观看数」「视频时长」比较不同内容的传播表现。
- 做账号内容盘点时,按「账号名称」「账号编号」聚合内容,并用认证字段补充账号背景。
- 做内容资产巡检时,比对「内容状态」「内容链接」「采集时间」,发现公开状态变化。
- 做共创内容筛选时,使用「是否共创」「共创信息」定位合作内容,再按内容编号关联内部台账。
适用边界
单次任务处理 1 个 YouTube 账号或频道标识,最多采集 1000 条公开内容记录。
- 适合用于
- 需要按账号名或频道标识获取 YouTube 公开内容列表时
- 需要整理视频标题、发布时间、观看数与关联账号资料时
- 不要用于
- 需要私密内容、账号后台数据或登录后可见信息时——本 App 仅覆盖公开数据
- 需要视频评论、字幕或音频转写时——本 App 不提供这些明细
失败处理
开发者声明的失败与重试处理方式,接入时建议一并写进系统提示词。
- 1返回空结果通常表示标识无匹配账号或账号没有可见公开内容,可核对账号名或频道标识后重试
- 2任务提交结果不明时不要连续重复提交,避免产生重复任务
- 3鉴权失败属不可重试错误,需先检查执行环境中的 API Key 配置
输入参数
调用本 App 需要传入的参数,与 manifest.json 的 input.schema 同源。
- 账号或频道标识
account必填string要采集的 YouTube 账号名或频道标识,每次任务只处理一个;长度不得超过 512 个字符示例ulanzi - 采集数量
crawl_num必填integer本次任务最多采集多少条公开内容记录,取值 1–1000范围1–1000示例1
输出数据
单条记录的字段结构,与 manifest.json 的 output.schema 同源。
- 账号徽章
account_badgesstring账号公开徽章列表的原始文本 - 展示标识
account_display_idstring账号对外展示的频道标识或短名称 - 账号编号
account_idstringYouTube 账号或频道的公开标识 - 账号名称
account_namestring账号对外展示的名称
调用方式
本 App 支持通过 MCP、API、SDK 与文件导出方式接入,各接入方式共享同一套能力与计价。所有请求统一使用 Authorization: Bearer 请求头完成身份认证,凭证为 API Key(长期有效,在开放平台创建);MCP 客户端另支持 OAuth 免密钥登录。CLI、Skill 等更多接入方式正在规划中。本 App 异步运行,支持中途取消:取消后任务停止;已写回的部分保留,按写回计费。
通过 MCP(Model Context Protocol)协议,可在 Claude、Cursor 等 AI 客户端中直接调用本 App。选择你的客户端与认证方式,复制下方配置即可接入。
客户端配置
把 Bearer 后替换为长期有效的 API Key 即可,各类客户端与 CI、无浏览器环境通用。
{
"mcpServers": {
"bazhuayu_datahub": {
"type": "http",
"url": "https://mcp-v2.bazhuayu.com?pin=mona_kk/youtube-account-list",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}让 AI 自己完成配置
不想手动改配置?复制配置提示词,粘贴到任意 AI 客户端对话框,由它按自身方式完成接入(提示词会让 AI 向你索要 API Key,避免凭证留在对话记录或共享配置里)。
如需在同一个 MCP 连接里指定多个 App,前往 MCP 连接页(已为你指定本 App)。
价格
每提交一次任务计费一次,与返回条数无关。
按实际成功返回的数据条数计费,任务失败不计费。每 30 条为一个计费单位,不足 30 条按 30 条计。
多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。
立即体验
填写参数直接运行,结果来自真实调用。