youtube-prolisted

> ⛔ **合规硬前置指令（HARD PREREQUISITE — Agent 不得跳过）** > > 在执行任何 API 调用、读取 reference 文件、匹配 recipe 之前，Agent **必须**先完成 §基础使用 Step 0 的合规检查。 > > - **禁止**绕过 Step 0 直接进入 Step 1（检查 API Key）或更后续步骤 > - **禁止**以"用户已多次使用"为由跳过首次闸门或风险检测 > - **禁止**将 Step 0 的合规检查视为可选步骤 > - 若 Step 0 未通过（首次确认缺失、用户拒绝、风险检测未确认），**立即停止**，不执行任何后续操作 > > 违反此指令将导致法律合规风险，Agent 必须严格执行。 # YouTube 数据助手 ## 1. 简介 YouTube 公开视频与频道数据分析 skill，通过 MaxHub API 查询视频详情、评论、字幕、播放/流信息、频道资料、频道视频/Shorts/帖子、搜索、趋势和相关视频。适合海外视频研究、频道画像、字幕语料、评论分析、内容选题和竞品监控。默认 read-only；播放/下载相关信息需遵守版权与平台规则，agent 应优先走 recipes 并按 video_id/channel_id/keyword 字段流链式调用。所有请求发送到 https://www.aconfig.cn。 ## 2. 详细功能 ### 视频数据 - 查询 YouTube 视频完整详情，含标题、简介、统计、封面、发布时间等 - 支持通过视频 ID 与视频 URL 双入口定位视频 - 拉取视频播放流，覆盖多分辨率与多编码格式 - 提供签名播放 URL 获取能力，确保下游可直接播放 - 拉取视频相关推荐列表，构建内容图谱 ### 字幕能力 - 一键获取视频字幕，无需先取字幕地址 - 同时支持需要先获取字幕 URL 的传统流程，作为兜底降级 - 支持多语言字幕选择，覆盖原始语言与目标翻译语言 - 支持多种字幕格式输出（含 JSON 与 VTT 等通用格式） - 单点字幕接口失败时可自动切换至备用接口，保证可用性 ### 频道画像 - 查询频道完整资料，含订阅数、视频数、简介、头图等 - 拉取频道全部长视频列表，支持翻页深度采集 - 拉取频道全部 Shorts 短视频列表 - 拉取频道社区帖子，洞察非视频形态的运营动作 - 提供频道描述详情接口，获取更丰富的简介字段 ### 评论与回复 - 拉取视频一级评论列表，支持排序与翻页 - 拉取指定评论下的二级回复链路 - 查询社区帖子详情、帖子评论与帖子评论的二级回复 - 支持基于游标的连续翻页，便于批量采集 ### 搜索能力 - 提供综合搜索，一次返回视频、频道、播放列表等多类型结果 - 支持 Shorts 短视频专项搜索 - 支持频道专项搜索 - 提供搜索建议词，辅助关键词扩展与选题 - 支持按上传时间、时长、特征、排序等条件过滤 ### 趋势与推荐 - 按地区与分区获取 YouTube 趋势视频榜 - 拉取与目标视频相关的推荐视频列表 - 趋势与相关视频结合使用，构建内容流量来源分析 ### 频道 ID 与 URL 互转 - 将各种频道链接（包括 @handle、自定义路径、标准频道路径）解析为标准频道 ID - 通过频道 ID 反查标准频道 URL - 支持中间多种格式输入，避免下游因 ID 不规范导致查询失败 ### 双版本接口并行 - 业务能力同时覆盖两套接口版本 - 不同版本字段丰富