YouTube 关键词列表采集

给一个 YouTube 搜索关键词和采集数量，返回按发布时间倒序的视频、频道、播放量与时长信息

概览

围绕品牌、产品或话题做内容研究时，YouTube 搜索结果常散落在不同视频和频道中。给出一个关键词后，这个 App 会整理内容标题、链接、频道、发布时间、时长与观看次数，便于直接筛选和比较。

它把一次搜索变成可分析的内容样本，既能看谁在讨论目标话题，也能观察近期内容与观看表现，适合作为品牌声量、竞品内容和选题研究的基础资料。

数据说明

数据来自 YouTube 关键词搜索结果，按「发布时间」降序返回，并以「内容编号」去重。标题、摘要、频道、时长和观看次数保留采集时看到的值；「观看次数」是数字字符串。时间值沿用来源表示，文档未声明时区。只覆盖搜索时公开可见且能被检索到的内容，私密、已删除或未进入搜索结果的内容不在其中。

结果长什么样

每条记录代表一个关键词搜索到的 YouTube 内容：

内容编号	内容标题	频道名称	发布时间	观看次数
uEe6Ilc4q3g	Shokz OpenFit Pro Review	Tech Buzz Ireland	2026-08-28T09:47:45	197
aBcDeFgHiJ1	Shokz OpenRun Pro 2 Review	Audio Review Lab	2026-08-26T13:20:00	12840

结果另有内容链接、内容摘要、频道账号、认证状态、时长与封面图片等信息。

应用场景

观察品牌声量时，按「发布时间」排列结果，结合「频道名称」查看近期创作者。
研究竞品内容时，对比「内容标题」「内容摘要」与「观看次数」，找出更受关注的主题。
初筛达人时，结合「频道账号」「频道认证」与「内容链接」，整理候选频道。

适用边界

每次任务仅支持 1 个关键词，最多汇总 100000 条公开搜索结果；实际数量受采集数量和可用结果影响。

适合用于
需要按品牌、产品或话题批量获取 YouTube 搜索结果时
需要比较视频发布时间、频道和观看量，形成内容研究底表时

不要用于
需要视频语音转写或字幕正文时——应使用语音转写类 App
需要评论、点赞等互动明细时——本 App 只返回搜索结果中的视频与频道信息

失败处理

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

1返回空结果时，先缩短或改写搜索关键词后重新提交
2限流、服务暂不可用或请求超时可稍后重试；鉴权失败需先检查执行环境中的凭证配置
3任务部分成功时保留已完成的搜索结果；任务失败或过期后可原样重新提交

输入参数

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

字段名	业务名称	类型	必填	默认值	枚举 / 约束	示例	说明
keyword	搜索关键词	string	是	—	—	Shokz	要在 YouTube 搜索的品牌、产品或话题，一次任务只支持一个关键词，长度为 1–512 个字符
crawl_count	采集数量	integer	是	—	1–600	1	期望采集的搜索结果数量，范围为 1–600；数量越大，任务耗时和费用越高

输出数据

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

字段名	业务名称	类型	示例	说明
content_id	内容编号	string	—	YouTube 内容唯一标识
content_url	内容链接	string	—	YouTube 内容页面链接
content_title	内容标题	string	—	视频或短内容的展示标题
content_text	内容摘要	string	—	搜索结果中展示的内容摘要
content_type	内容类型	string	—	内容类型，如 video
keyword	命中关键词	string	—	本条结果对应的搜索关键词
keyword_type	关键词类型	string	—	结果中记录的关键词匹配类型
channel_id	频道编号	string	—	发布频道的 YouTube 标识
channel_handle	频道账号	string	—	频道展示账号或 Handle
channel_name	频道名称	string	—	发布频道的展示名称
is_channel_verified	频道认证	boolean	—	频道是否带有认证标识
is_verified_artist	艺人认证	boolean	—	频道是否为认证艺人频道
is_collaboration	合作内容	boolean	—	内容是否标记为合作创作
publish_time	发布时间	string	—	标准化后的内容发布时间；文档未声明时区
publish_time_text	发布时间原文	string	—	搜索结果展示的相对发布时间文本
duration_text	时长文本	string	—	内容展示时长，如 10:09
duration_milliseconds	时长毫秒数	string	—	内容时长的毫秒数字符串
view_count	观看次数	string	—	观看次数的数字字符串
view_count_text	观看次数原文	string	—	搜索结果展示的观看次数文本
cover_images	封面图片	string	—	封面图片列表的 JSON 字符串
channel_thumbnails	频道头像	string	—	频道头像列表的 JSON 字符串
content_badges	内容标记	string	—	搜索结果中的内容标记列表字符串
crawl_time	采集时间	string	—	该条结果的采集时间；文档未声明时区
no_data	是否无数据	boolean	—	该关键词任务项是否没有可用结果

记录 Schema

输出按记录逐条返回。记录主键为 content_id，去重、增量、关联以它为准。

output.schema

{
  "type": "object",
  "properties": {
    "content_id": {
      "type": "string",
      "title": "内容编号",
      "description": "YouTube 内容唯一标识"
    },
    "content_url": {
      "type": "string",
      "title": "内容链接",
      "description": "YouTube 内容页面链接"
    },
    "content_title": {
      "type": "string",
      "title": "内容标题",
      "description": "视频或短内容的展示标题"
    },
    "content_text": {
      "type": "string",
      "title": "内容摘要",
      "description": "搜索结果中展示的内容摘要"
    },
    "content_type": {
      "type": "string",
      "title": "内容类型",
      "description": "内容类型，如 video"
    },
    "keyword": {
      "type": "string",
      "title": "命中关键词",
      "description": "本条结果对应的搜索关键词"
    },
    "keyword_type": {
      "type": "string",
      "title": "关键词类型",
      "description": "结果中记录的关键词匹配类型"
    },
    "channel_id": {
      "type": "string",
      "title": "频道编号",
      "description": "发布频道的 YouTube 标识"
    },
    "channel_handle": {
      "type": "string",
      "title": "频道账号",
      "description": "频道展示账号或 Handle"
    },
    "channel_name": {
      "type": "string",
      "title": "频道名称",
      "description": "发布频道的展示名称"
    },
    "is_channel_verified": {
      "type": "boolean",
      "title": "频道认证",
      "description": "频道是否带有认证标识"
    },
    "is_verified_artist": {
      "type": "boolean",
      "title": "艺人认证",
      "description": "频道是否为认证艺人频道"
    },
    "is_collaboration": {
      "type": "boolean",
      "title": "合作内容",
      "description": "内容是否标记为合作创作"
    },
    "publish_time": {
      "type": "string",
      "title": "发布时间",
      "description": "标准化后的内容发布时间；文档未声明时区"
    },
    "publish_time_text": {
      "type": "string",
      "title": "发布时间原文",
      "description": "搜索结果展示的相对发布时间文本"
    },
    "duration_text": {
      "type": "string",
      "title": "时长文本",
      "description": "内容展示时长，如 10:09"
    },
    "duration_milliseconds": {
      "type": "string",
      "title": "时长毫秒数",
      "description": "内容时长的毫秒数字符串"
    },
    "view_count": {
      "type": "string",
      "title": "观看次数",
      "description": "观看次数的数字字符串"
    },
    "view_count_text": {
      "type": "string",
      "title": "观看次数原文",
      "description": "搜索结果展示的观看次数文本"
    },
    "cover_images": {
      "type": "string",
      "title": "封面图片",
      "description": "封面图片列表的 JSON 字符串"
    },
    "channel_thumbnails": {
      "type": "string",
      "title": "频道头像",
      "description": "频道头像列表的 JSON 字符串"
    },
    "content_badges": {
      "type": "string",
      "title": "内容标记",
      "description": "搜索结果中的内容标记列表字符串"
    },
    "crawl_time": {
      "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-keyword-list": {
      "type": "http",
      "url": "https://mcp-v2.bazhuayu.com?pin=mona_kk/youtube-keyword-list",
      "headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
    }
  }
}

查看我的 API Keys →

让 AI 自己完成配置

不想手动改配置？复制安装提示词，粘贴到任意 AI 客户端对话框，由它按自身方式完成接入（提示词会让 AI 向你索要 API Key，避免凭证留在对话记录或共享配置里）。

如需在同一个 MCP 连接里指定多个 App，前往 MCP 连接页（已为你指定本 App）。

价格

提交一次关键词采集

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

¥0.001/ 次

返回一条搜索结果

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

¥0.015/ 20 条

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

查看余额

立即体验

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

示例

参数按 input.schema 校验后提交

搜索关键词keyword*要在 YouTube 搜索的品牌、产品或话题，一次任务只支持一个关键词，长度为 1–512 个字符

采集数量crawl_count*期望采集的搜索结果数量，范围为 1–600；数量越大，任务耗时和费用越高

请先填写必填参数

¥0.015 / 20 条起