前言¶
YouTube 的数据获取有两条常见路：一是直接抓网页，二是走官方 API。前者要持续对抗页面结构和反爬策略，改版一次就可能失效；后者受限于配额和审核，而且评论线程、Shorts、推荐流这类数据官方接口未必直接给全。当需求落在「批量取视频信息、评论、频道作品列表、搜索」这一档时，很多人会再找一层聚合 API。下面介绍的 keyapi-youtube 就是这一类方案：把 YouTube 视频和频道分析统一到一个 REST API 上，再封装成一个可被 Agent 调用的 Skill。
这是什么¶
keyapi-youtube 是一个面向 Agent / IDE 的 Skill，由社区开发者 user_2e47cd26 维护，在 SkillHub 上的坐标是 @user_2e47cd26/keyapi-youtube-channel-analysis。它把 YouTube 视频与频道相关的查询整理成一组结构化调用，让 Agent 不用自己拼请求、处理字段，直接拿到结果。当前版本 1.1.2，分类为 data-analysis，需要 API Key（requires_api_key=true）。
一句话定位：用一个 KeyAPI REST 入口覆盖 YouTube 的分析类查询，适合做数据采集、频道体检、批量视频信息整理这类任务。
核心功能¶
下面这些能力都来自该 Skill 的官方简介，属于已核实范围。
视频侧：
- 视频基本信息
- 评论与二级评论（sub-comments）
- 流媒体信息（streams）
- 相关视频（related videos）
搜索侧：
- Shorts 搜索
- 视频搜索
- 热门视频（trending videos）
- 搜索建议（search suggestions）
频道侧：
- 频道描述
- 频道视频列表
- 频道 ID / URL 互转
- 频道搜索
- 过滤搜索（filtered search）
覆盖面比较集中，基本是「分析型」查询：拿信息、列作品、做检索和转换。它不负责上传、不负责直播推流控制，也不涉及评论写操作。
安装与启用¶
这里只写已核实到的事实。该 Skill 在 SkillHub 上标记 requires_api_key=true，即使用前需要提供 KeyAPI 的 API Key，否则调用不会通过。
关于具体安装命令、Skill 目录路径和配置文件字段，抓取到的资料里没有给出可核对的内容，官方页面为脚本渲染、正文未返回有效信息。因此本文不臆造安装步骤。请到官方页面确认安装方式：
https://api.skillhub.cn/user_2e47cd26/keyapi-youtube-channel-analysis
同一 Skill 的 SkillHub 页面地址：
https://www.skillhub.cn/skills/user_2e47cd26/keyapi-youtube-channel-analysis
如果后续补充了 SKILL.md 内容，安装章节应以 SKILL.md 的说明为准，不要照搬本文。
典型用法¶
由于官方正文没有返回可复现的调用示例，本文不虚构请求和返回结构。可用的验证方式是：先在官方页面拿到该 Skill 的说明与调用约定，再按下面的路径核对。
1、确认你手上有有效的 KeyAPI API Key。这是硬前提。
2、按官方说明在目标环境启用该 Skill。
3、先跑一个最小查询（例如单个视频的基本信息），确认返回结构符合预期。
4、再扩展到频道视频列表、评论等批量查询。
命令、接口名和参数请一律以 SKILL.md 为准，本文不提供未经核实的示例。
适用场景与注意¶
适合谁：需要批量拿 YouTube 视频/频道信息、做内容分析或检索，又希望少写胶水代码的开发者和 Agent 使用者。
需要注意的几点：
- API Key 是必需项，使用前先准备好，注意不要提交到公开仓库。
- 聚合类 API 的字段结构和官方接口不一定一致，字段语义要按该 Skill 的说明来读，不要默认它和 YouTube Data API 完全对齐。
- 批量查询要关注速率限制和配额，具体阈值看 KeyAPI 侧的说明。
- 数据时效性取决于上游更新，分析结果建议标注取数时间。
- 该 Skill 定位为「分析」，不含写操作。
评分方面，SkillHub 显示 100000（满分制）。下载次数在不同抓取批次中有差异（脚本抓取为 471，更早线索为 354），该数字会随时间变化，引用时建议以官方页面实时值为准。
结尾¶
keyapi-youtube 的价值在于把 YouTube 视频和频道的分析类查询收敛到一组结构化调用，省掉自建抓取和反复拼请求的成本。它适合做数据采集和频道体检，前提是接受它依赖 KeyAPI、并且只覆盖分析型能力。
官方地址：https://api.skillhub.cn/user_2e47cd26/keyapi-youtube-channel-analysis
SkillHub 页面：https://www.skillhub.cn/skills/user_2e47cd26/keyapi-youtube-channel-analysis
