mcpField
Y
youtube-research

youtube-research

github.com/crawlora-org生产力140 次安装2 天前更新
代码仓库

关于 youtube-research

youtube-research 是通过 Crawlora API 研究公开 YouTube 视频和频道的 skill，适合分析人员与内容研究者。它可获取标准化字幕、评论、元数据、频道上传内容、播放列表和搜索结果，用于基于证据的总结与比较。

主要功能

  1. 01获取带时间戳的视频字幕
  2. 02读取视频元数据和评论
  3. 03列出频道视频、Shorts 和播放列表
  4. 04按关键词搜索 YouTube 视频
  5. 05支持基于字幕的主题研究

适用场景

  1. 01根据字幕总结视频
  2. 02分析评论情绪与常见主题
  3. 03制作频道近期上传内容摘要
  4. 04依据带时间戳的字幕比较视频

安装

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

$npx skills add https://github.com/crawlora-org/crawlora-skills --skill youtube-research

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

附带文件reference/endpoints.mdscripts/crawlora.sh

详细介绍

YouTube 研究

通过 Crawlora API 解析 YouTube 视频和频道，并以规范化 JSON 获取字幕、评论、播放列表和搜索结果——无需 yt-dlp、浏览器或抓取。

何时使用此技能

  • 用户粘贴 YouTube URL，并想获取字幕、摘要或统计数据。
  • “获取此视频的评论”／“大家都在说什么？”
  • “列出此频道最近的视频／短视频／播放列表。”
  • “在 YouTube 上搜索…… ”或“有哪些关于……的视频？”
  • 构建基于字幕的摘要、情感分析或研究流程。
  • 基于带时间戳的字幕证据，对有限数量的视频进行比较。

设置（一次性）

  • 在 https://crawlora.net 获取免费的 Crawlora API 密钥（每月 2,000 个积分，无需银行卡）。
  • 运行辅助脚本前，在环境中设置 CRAWLORA_API_KEY。
  • 辅助脚本会从环境中读取 CRAWLORA_API_KEY，并向 https://api.crawlora.net/api/v1 发送请求。密钥缺失或无效时会返回 401。

工作原理

  1. 解析 ID。 YouTube 观看页面 URL https://www.youtube.com/watch?v=<ID> （或 https://youtu.be/<ID>）中包含视频 ID；频道 URL 中包含 频道 ID。调用前先提取 ID。
  2. 字幕： /youtube/transcript/{id}（如果需要特定语言，先使用 /youtube/transcript/{id}/languages）。
  3. 元数据／评论： /youtube/video/{id}、/youtube/comments/{id}。
  4. 频道： /youtube/channel/{id}/videos、/channel/{id}/shorts、 /channel/{id}/playlists、/youtube/profile/{id}。
  5. 发现内容： 使用 /youtube/search?q=... 按关键词查找视频。

完整端点列表、方法和参数：reference/endpoints.md。

基于字幕的主题研究

撰写主题简报时，先搜索，再按视频 ID 去重，并选择能反映所需日期、语言和视频类型的有限样本。获取字幕前，先查明可用的字幕语言。提取证据时请求包含时间戳的 JSON；每个主题或论断都应关联到实际字幕片段和视频 URL。字幕或翻译可能会误听语音，不能单独用于核实事实论断。报告无法获取字幕的情况，并将搜索排名、观看次数和评论样本与需求分开处理。

如需更全面地了解不同视频或频道的主题和形式覆盖情况，请在已安装时使用 youtube-content-gap-analysis。

scripts/crawlora.sh /youtube/search q="home energy storage" type=video sort_by=relevance
scripts/crawlora.sh /youtube/transcript/dQw4w9WgXcQ/languages
scripts/crawlora.sh /youtube/transcript/dQw4w9WgXcQ format=json timestamps=true

调用 API

# Transcript for a video id (GET):
scripts/crawlora.sh /youtube/transcript/dQw4w9WgXcQ | jq '.'

# Video metadata + comments:
scripts/crawlora.sh /youtube/video/dQw4w9WgXcQ | jq '.data'
scripts/crawlora.sh /youtube/comments/dQw4w9WgXcQ | jq '.data'

# Search:
scripts/crawlora.sh /youtube/search q="web scraping tutorial" | jq '.'

所有请求都使用 scripts/crawlora.sh；它会避免将 API 密钥暴露在命令行参数中。

端点参考

请参阅 reference/endpoints.md，了解此技能使用的所有 YouTube 端点（方法、路径、参数和说明）。

示例

  • 总结视频： 从 URL 提取 ID → /youtube/transcript/{id} → 拼接字幕片段 → 生成摘要。
  • 评论情感分析： /youtube/comments/{id} → 按情感对评论分类， 并提炼常见主题。
  • 频道摘要： /youtube/channel/{id}/videos → 列出最近发布的视频及其 观看次数和发布日期。

备注与限制

  • 积分／成功后付费： 仅对 2xx 响应计费；免费套餐每月提供 2,000 个积分。 在 https://crawlora.net 获取密钥。
  • 仅限公开数据——公开的 YouTube 页面；请遵守 YouTube 的条款。
  • 安全性： 密钥仅存储在 CRAWLORA_API_KEY 中——切勿硬编码、放入查询参数或提交到代码库。
  • 并非所有视频都有字幕；如果字幕请求返回空结果，请检查 /youtube/transcript/{id}/languages。

评论

支持 Markdown