Repolode
kajisho5

kajisho5/ffmpeg-skill

为 Claude Code、Cursor、Codex 等编程智能体提供 42 个本地 FFmpeg 音视频编辑工具的 Agent Skill 与 MCP 服务。

可替代:DescriptCapCut

Star
2,021
Fork
165
未关闭 Issue
4
最近提交
前天

这是什么?

ffmpeg-skill 让编程智能体通过结构化的 Python 脚本在本地调用 ffmpeg 和 ffprobe 编辑音视频文件。42 个工具覆盖剪切与拼接、去除静音、按时长或画幅比例调整素材、烧录字幕、叠加图层、HDR 转 SDR、响度标准化、多机位音画同步,以及针对 TikTok、Reels、YouTube、X 等平台的导出预设。

每个工具接受带类型的参数而不是原始滤镜字符串,支持 --dry-run 和 --json 输出,并会对结果做探测检查。机器可读的契约描述了每个工具的输入与输出,同一套工具也通过 MCP 暴露。整个流程离线运行,无需 API 密钥,只依赖 Python 标准库,但需要本机已安装 ffmpeg 和 python3。

适合希望让智能体在本地素材上完成日常剪辑、又不想把文件上传到云端的开发者,也适合需要智能体在报告完成前自行检查输出结果的场景。

核心功能

  • 01尽可能使用无损流复制完成剪切、拼接和静音去除。
  • 02按目标时长和画幅比例调整素材,包括 9:16 裁切与模糊填充。
  • 03烧录字幕,支持卡拉 OK 式逐词高亮,并可按平台安全区换行。
  • 04按 EBU R128 标准进行响度标准化,并将 HDR 素材转换为 SDR。
  • 05所有工具可通过 MCP 调用,契约由 argparse 定义自动生成。

适用场景

  • 让智能体把长录像剪成适合 Reels 或 TikTok 的 60 秒竖版短视频。
  • 对文件夹内的素材批量做响度标准化,并导出播客或社交平台成片。
  • 在本地为素材加入烧录字幕和图层,无需上传到云端剪辑服务。
  • 搭建脚本化的视频处理流水线,每一步输出都用 ffprobe 检查后再继续。

快速上手

  1. 1

    为 Claude Code 安装该技能

    npx ffmpeg-skill
  2. 2

    检查 ffmpeg、ffprobe 及所需组件是否已安装

    npx ffmpeg-skill doctor
  3. 3

    读取机器可读的工具契约

    npx ffmpeg-skill contract --json | head -40

使用前须知

  • 需要您的 PATH 中已安装 ffmpeg 和 python3。
  • 安装器生成的副本不会自动更新,需重新运行安装命令才能刷新。
  • 部分工具(如 caption.py)需要 subtitles 滤镜等 FFmpeg 组件,基础版 Homebrew 构建可能缺少这些组件。

标签

常见问题

ffmpeg-skill 是什么?
为 Claude Code、Cursor、Codex 等编程智能体提供 42 个本地 FFmpeg 音视频编辑工具的 Agent Skill 与 MCP 服务。 ffmpeg-skill 让编程智能体通过结构化的 Python 脚本在本地调用 ffmpeg 和 ffprobe 编辑音视频文件。42 个工具覆盖剪切与拼接、去除静音、按时长或画幅比例调整素材、烧录字幕、叠加图层、HDR 转 SDR、响度标准化、多机位音画同步,以及针对 TikTok、Reels、YouTube、X 等平台的导出预设。
ffmpeg-skill 可以免费使用吗?用的什么许可证?
ffmpeg-skill 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
ffmpeg-skill 还在维护吗?
活跃维护中。ffmpeg-skill 最近一次提交是在 2026年10月17日。
ffmpeg-skill 适合用来做什么?
让智能体把长录像剪成适合 Reels 或 TikTok 的 60 秒竖版短视频。 对文件夹内的素材批量做响度标准化,并导出播客或社交平台成片。 在本地为素材加入烧录字幕和图层,无需上传到云端剪辑服务。 搭建脚本化的视频处理流水线,每一步输出都用 ffprobe 检查后再继续。
ffmpeg-skill 怎么安装和运行?
为 Claude Code 安装该技能: npx ffmpeg-skill 检查 ffmpeg、ffprobe 及所需组件是否已安装: npx ffmpeg-skill doctor 读取机器可读的工具契约: npx ffmpeg-skill contract --json | head -40
在哪里获取 ffmpeg-skill?
源代码和安装说明在 GitHub 上:https://github.com/kajisho5/ffmpeg-skill

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目