mcpField
Y
youtube-research

youtube-research

github.com/postplusai营销与增长271.1k 次安装1 天前更新
代码仓库

关于 youtube-research

用于通过 PostPlus 研究公开 YouTube 频道、视频和评论样本的 Skill。它规范有限范围内的证据收集与报告，并区分公开代理信息和订阅者身份。

主要功能

  1. 01频道摘要与视频记录
  2. 02公开评论抽样
  3. 03按需下载视频记录
  4. 04限制后续研究轮次
  5. 05报告来源与不确定性

适用场景

  1. 01概述公开 YouTube 频道
  2. 02查看公开视频指标
  3. 03从评论中抽样受众表达

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/postplusai/postplus-skills --skill youtube-research

安装后在 Claude Code 中输入/youtube-research确认已加载。

详细介绍

YouTube 研究

通过 PostPlus 获取公开的 YouTube 频道摘要、受众评论样本、可下载的视频记录和公开视频指标时，使用此技能。

数据收集范围边界

已发布的数据集不会公开订阅者身份。请使用频道元数据和评论作为公开的参考依据，不要将评论作者描述为订阅者群体。

研究路径

使用 youtube-videos 获取公开视频记录，使用 youtube-channel-summary 获取频道信息，使用 youtube-comments 了解受众用语；仅在明确需要可下载记录时使用 youtube-video-download。PostPlus 负责处理执行细节。

证据质量

  1. 根据问题核对频道信息、视频记录和评论；评论作者并不代表订阅者群体。
  2. 如果已完成的一轮检索未找到结果，请调整频道或视频来源，或使用受支持的查询，不要把摘要片段当作评论。
  3. 在成功但结果不足时，最多再进行两轮变更后的后续检索，并确保不超出已批准的范围和预算；不要重复完全相同的请求，也不要隐瞒失败或待处理的操作。
  4. 在证据充足、达到次数上限，或继续检索无益时停止。报告有用的证据和不确定性；保留原始结果和来源链接。

公开视频指标是快照；请保留来源 URL 和日期，不要推断订阅者身份。 完整机器字段请查看 postplus research schema --route <route> --json；仅在处理时确有需要时查阅，不要在每次请求前都查看。

postplus research run youtube-channel-summary \
  --channel "@example" \
  --wait \
  --output ./result.json

遵循 CLI 提供的结构化结果和报告的后续操作；不要根据自由文本消息推断恢复方式。 如果用户已明确批准的范围和最高费用涵盖当前请求，请沿用该批准；否则，在确认报价前先征得批准。不要仅凭任务本身推断用户授权了支出。 通过返回的检查点或操作继续同一任务；切勿重新提交状态不明的任务、重复已用尽的恢复尝试，或通过切换提供方来绕过失败。

默认工作流

  1. 对于频道研究，收集频道摘要。
  2. 对于受众研究，收集少量评论样本。
  3. 对于广泛的公开视频发现，制定小规模公开视频计划，并运行 youtube-videos 路径。
  4. 如果运行仍在处理中，保留其结果文件，并使用 postplus research run --resume-from <result.json> 恢复。
  5. 将观察结果与推断分开，尤其是在陈述受众相关结论时。

运行仍在处理中时，告知用户研究将从已保存的检查点继续，并继续处理独立的简报或来源审查工作。

读取视频记录

从 output.items[] 读取 youtube-videos 记录：id、url、title、text（描述）、date、viewCount、likes、commentsCount、channelName、channelUrl、channelUsername、numberOfSubscribers 和 thumbnailUrl。字段均为可选：缺失的指标应标记为不可用，不要记为零。

duration 是时间字符串（HH:MM:SS），不是以秒为单位的数值字段。现有字幕会显示在 subtitles[] 中，包含 srt、language 和 type；请保留其时间戳和语言。没有字幕表示未获取到字幕。不要用描述替代文字稿，也不要暗示进行了新的语音转写。

hashtags 并非完整的视频标签。isPaidContent 表示付费访问，不代表赞助。赞助信息不可用；未验证时应视为未知。不要将频道的年龄限制解读为已验证的视频年龄限制。此元数据路径不提供下载 URL 和画质信息；仅在用户提出请求时使用单独的下载路径。

输出

返回频道元数据、公开视频记录、评论样本发现、来源 URL、已有指标字段，并清楚说明订阅者身份不可用。

失败模式

  • 如果请求包含非 YouTube 平台，则停止。
  • 如果没有可用的公开 YouTube URL、频道或查询，则停止。
  • 如果 PostPlus 无法解析频道句柄或 URL，则停止。
  • 如果出现 PostPlus 服务、身份验证、DNS、代理、网络或输出格式错误等硬错误，则停止。
  • 不要承诺提供私人受众身份或登录后的分析数据。

移交

基准研究结果可用于 benchmark-to-brief、media-analysis 或更广泛的跨平台综合分析。

公共命令边界

  • 根据用户输入，选择最匹配且范围最小的命令或工作流，并直接运行。

  • 就绪情况诊断：postplus doctor --skill youtube-research。

  • 仅在需要时，使用 postplus research run <route> --help 检查路由。

  • 运行 postplus research run <route> --<url/channel flags> --limit <n> --wait --output <result.json>。

  • 仅使用所选路由显示的语义标志。

  • 首轮操作应限定范围；检查首轮结果后再扩大范围。

  • 请求的任务会使用现有 PostPlus 点数，前提是已检查当前价格和余额。 仅估价的请求不会执行。若点数不足，则停止；不要充值、购买订阅或重复执行结果不确定的付费操作。

评论

支持 Markdown