概览
想知道某个 YouTube 账号到底什么来头——它叫什么、在哪、有多少粉丝、还挂着哪些社媒?给它一个账号或频道名,它会在后台跑一次采集任务,把该账号的公开资料整理成一条结构化的记录返回,可以直接进表格做红人盘点、竞品摸底或渠道摸底。
相比人工点开频道页一块块抄,它把名称、粉丝数、国家、关联链接这些散落在主页各处的信息一次收齐,是取数当时的快照,适合当作社媒资产盘点的底表。
数据说明
资料取自 YouTube 公开频道信息,按上游已开放的公开资料返回,同一个账号只出一条记录。粉丝数、观看数、内容数是取数当时的快照值,不含涨粉曲线与历史变化;关联链接是频道自行填写的社媒与官网,以文本形式给出。只覆盖公开可见的资料,私信、互动、收益等非公开数据不在其中。
结果长什么样
每条记录是一个 YouTube 账号的公开资料:
| 账号名称 | 粉丝数 | 国家地区 | 主页链接 |
|---|---|---|---|
| Drive Thru Media | 1410 | 澳大利亚 | https://www.youtube.com/@drivethrumedia_official |
| Ulanzi Japan | 188413 | 日本 | https://www.youtube.com/@UlanziJapan |
另有所属账号ID、业务ID、所在地、加入时间、观看数、内容数、联系邮箱、关联链接、数据更新时间与采集时间等信息。
应用场景
- 做红人筛选时,按「粉丝数」排优先级、结合「国家地区」锁定目标市场,快速缩出一份候选清单。
- 做渠道摸底时,把「关联链接」解析出 TikTok、Instagram、官网等外链,看一个账号在哪些平台有布局。
- 做竞品监测时,隔段时间跑同一批账号,比对「粉丝数」「观看数」的变化判断增长势头。
- 做账号归档时,用「账号ID」「业务ID」给每个频道打稳定标签,避免同一账号因改名而重复录入。
适用边界
每次提交一个 YouTube 账号,返回该账号的一条公开资料记录;仅含上游已开放的公开资料,不含私密数据。
- 适合用于
- 需要获取某个 YouTube 账号或频道的公开资料(名称、粉丝数、国家、关联社媒)时
- 做红人/KOL 盘点、竞品频道摸底,需要拿到频道基础数据时
- 不要用于
- 需要视频级数据(分视频播放量、评论)时——本接口只返回账号级资料
- 需要私信或互动类等非公开数据时——仅覆盖公开资料
失败处理
作者声明的失败与重试处理方式,接入时建议一并写进系统提示词。
- 1返回空记录通常是账号名拼写错误或上游未找到,核对 handle 后重试
- 2鉴权失败属不可重试错误,需先在执行环境配置上游 API Key
- 3任务状态长时间处于处理中可原样重新提交
输入参数
调用本 App 需要传入的参数,与 manifest.json 的 input.schema 同源。
| 字段名 | 业务名称 | 类型 | 必填 | 默认值 | 枚举 / 约束 | 示例 | 说明 |
|---|---|---|---|---|---|---|---|
| account | YouTube 账号 | string | 是 | — | — | UlanziJapan | 要采集的 YouTube 账号或频道名称(handle、@handle 或频道链接均可,长度不超过 512 字符),一次提交一个;多个账号请分次调用。 |
输出数据
单条记录的字段结构,与 manifest.json 的 output.schema 同源。
| 字段名 | 业务名称 | 类型 | 示例 | 说明 |
|---|---|---|---|---|
| account_id | 账号ID | string | — | YouTube 频道唯一标识,以 UC 开头 |
| account_name | 账号名称 | string | — | 频道展示名称 |
| biz_id | 业务ID | string | — | 账号 @handle 标识 |
| account_home_url | 主页链接 | string | — | YouTube 频道主页地址 |
| keyword | 采集关键词 | string | — | 提交时填写的账号或频道名称 |
| country | 国家地区 | string | — | 账号所属国家/地区 |
| location | 所在地 | string | — | 账号资料中填写的所在地 |
| joined_date | 加入时间 | string | — | 频道创建时间 |
| fans_count | 粉丝数 | string | — | 频道粉丝总数 |
| fan_nums_origin | 原始粉丝数 | string | — | 上游原始口径统计的粉丝数 |
| views_num | 观看数 | string | — | 频道视频总观看次数 |
| publish_content_count | 内容数 | string | — | 已发布内容条数 |
| 联系邮箱 | string | — | 账号公开的联系邮箱 | |
| links | 关联链接 | string | — | 关联的社媒与官网链接,以文本形式给出 |
| clean_update_time | 数据更新时间 | string | — | 数据最近一次更新时间 |
| crawl_time | 采集时间 | string | — | 本次采集发生的时间 |
记录 Schema
输出按记录逐条返回。记录主键为 account_id,去重、增量、关联以它为准。
{
"type": "object",
"properties": {
"account_id": {
"type": "string",
"title": "账号ID",
"description": "YouTube 频道唯一标识,以 UC 开头"
},
"account_name": {
"type": "string",
"title": "账号名称",
"description": "频道展示名称"
},
"biz_id": {
"type": "string",
"title": "业务ID",
"description": "账号 @handle 标识"
},
"account_home_url": {
"type": "string",
"title": "主页链接",
"description": "YouTube 频道主页地址"
},
"keyword": {
"type": "string",
"title": "采集关键词",
"description": "提交时填写的账号或频道名称"
},
"country": {
"type": "string",
"title": "国家地区",
"description": "账号所属国家/地区"
},
"location": {
"type": "string",
"title": "所在地",
"description": "账号资料中填写的所在地"
},
"joined_date": {
"type": "string",
"title": "加入时间",
"description": "频道创建时间"
},
"fans_count": {
"type": "string",
"title": "粉丝数",
"description": "频道粉丝总数"
},
"fan_nums_origin": {
"type": "string",
"title": "原始粉丝数",
"description": "上游原始口径统计的粉丝数"
},
"views_num": {
"type": "string",
"title": "观看数",
"description": "频道视频总观看次数"
},
"publish_content_count": {
"type": "string",
"title": "内容数",
"description": "已发布内容条数"
},
"email": {
"type": "string",
"title": "联系邮箱",
"description": "账号公开的联系邮箱"
},
"links": {
"type": "string",
"title": "关联链接",
"description": "关联的社媒与官网链接,以文本形式给出"
},
"clean_update_time": {
"type": "string",
"title": "数据更新时间",
"description": "数据最近一次更新时间"
},
"crawl_time": {
"type": "string",
"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-account-info": {
"type": "http",
"url": "https://mcp-v2.bazhuayu.com?pin=mona_kk/youtube-account-info",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}让 AI 自己完成配置
不想手动改配置?复制安装提示词,粘贴到任意 AI 客户端对话框,由它按自身方式完成接入(提示词会让 AI 向你索要 API Key,避免凭证留在对话记录或共享配置里)。
如需在同一个 MCP 连接里指定多个 App,前往 MCP 连接页(已为你指定本 App)。
价格
每提交一次任务计费一次,与返回条数无关。
按实际成功返回的数据条数计费,任务失败不计费。
多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。
立即体验
填写参数直接运行,结果来自真实调用。