mcpField
R
ra-video-download

ra-video-download

github.com/pluviobyte创意与媒体1.7k172 次安装5 周前更新
代码仓库

关于 ra-video-download

ra-video-download 是用于下载视频源媒体的技能，面向需要在工作区获取参考素材的内容制作流程。它运行下载脚本、验证媒体可播放性，并按规则保存来源信息和文件。

主要功能

  1. 01下载视频或仅提取音频
  2. 02按站点选择下载方式
  3. 03检查媒体流与时长
  4. 04保存来源信息并避免覆盖

适用场景

  1. 01获取短视频作为制作参考
  2. 02下载获准用于项目的原始素材
  3. 03验证下载文件并记录媒体信息

安装

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

$npx skills add https://github.com/pluviobyte/rnskill --skill ra-video-download

安装后在 Claude Code 中输入/ra-video-download确认已加载。

附带文件agents/openai.yamlscripts/download_media.py

详细介绍

视频下载

仅下载源媒体。不要转录、改写、编辑或发布。

存储规则

  • 默认将源 URL、源标题、源元数据和下载的参考媒体保存在 01-内容生产/视频工作台/.internal/ 中。
  • 仅当调用者明确指定了制作项目，且媒体已获准作为制作输入时，才使用 01-内容生产/视频工作台/制作中/<日期-主题>/原始素材/。
  • 切勿在交接材料、完成的脚本、最终归档或公开文档中放入源信息。
  • 切勿覆盖现有文件。让下载器添加稳定后缀，或停止操作。

工作流

  1. 确认 URL 指向源媒体，且下载符合用户的请求。
  2. 运行捆绑的下载器。它按以下顺序尝试：
    • 抖音：TikHub 媒体 URL，然后使用浏览器 Cookie 的 yt-dlp，最后使用普通 yt-dlp。
    • 其他受支持的网站：普通 yt-dlp；必要时可选用浏览器 Cookie。
  3. 检查返回的本地路径和媒体探测结果。仅 HTTP 请求成功并不代表交付成功。
  4. 确认媒体包含可播放的音频或视频流，且时长非零。报告本地路径、时长、尺寸和所选下载方式。
  5. 如果所有方式都失败，保留简明的失败日志，并说明缺少的前置条件。不要声称已下载视频。

命令

为获得最佳的抖音下载效果，请使用能够导入 tikhub 的 Python 解释器。在此工作区中，优先使用 /opt/homebrew/bin/python3（若可用）。

/opt/homebrew/bin/python3 scripts/download_media.py '<url>'

可用选项：

# Explicit production input directory
/opt/homebrew/bin/python3 scripts/download_media.py '<url>' --output-dir '01-内容生产/视频工作台/制作中/<日期-主题>/原始素材/<项目>'

# Extract audio only
/opt/homebrew/bin/python3 scripts/download_media.py '<url>' --audio-only

# Use an authenticated browser profile for a protected public page
/opt/homebrew/bin/python3 scripts/download_media.py '<url>' --cookies-from-browser chrome

根据此 SKILL.md 的位置解析 scripts/download_media.py；不要假设当前目录就是 skill 目录。

安全与失败处理

  • 仅对请求的公开媒体使用浏览器 Cookie。不要打印、复制或持久化原始 Cookie。
  • 从环境变量或工作区根目录的 .env 中读取 TIKHUB_API_KEY；切勿打印该密钥。
  • 不要绕过私密账号的访问控制、付费墙、DRM，或已删除/私密媒体的限制。
  • 将 TikHub 和浏览器 Cookie 视为获取媒体的备用方式，而非证明拥有媒体复用权的依据。
  • 下载后保持原始源文件不变。
  • 如果 ffprobe 失败，即使文件扩展名为 .mp4，也应拒绝该文件。

交接

返回简明结果，包含：

  • 本地媒体路径
  • 源元数据路径
  • 使用的方法（tikhub、yt-dlp-cookie 或 yt-dlp）
  • 时长、分辨率和编解码器
  • 任何限制，例如水印、缺少音频或身份验证失败

仅在收到请求时再转交后续处理：源语音提取使用 ra-逐字稿提取skill，编辑使用 video-use，制作使用 ra-video-production-director。

评论

支持 Markdown