mcpField
V
video-summarizer

video-summarizer

github.com/maystudios生产力2767 次安装11 周前更新
代码仓库

关于 video-summarizer

使用 Gemini API 分析 MP4 文件,并在每个视频旁保存 Markdown 摘要的技能。支持递归处理目录、自定义提示词,以及跳过已有摘要的视频。

主要功能

  1. 01通过 Gemini API 分析 MP4
  2. 02递归处理目录
  3. 03以内联文本或文件指定提示词
  4. 04在视频旁生成 Markdown 摘要
  5. 05跳过已有摘要的视频

适用场景

  1. 01汇总目录中的视频录制
  2. 02提取提及的项目或行动事项
  3. 03制作带时间戳的视频大纲

安装

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

$npx skills add https://github.com/maystudios/claude-skills --skill video-summarizer

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

附带文件README.mdscripts/summarize_videos.py

详细介绍

视频摘要

通过 Gemini API 分析目录中的 MP4 文件,并在每个视频旁边写入一个 .md 摘要文件。

前提条件

  • 必须设置 GEMINI_API_KEY 环境变量
  • 已安装 google-genai:py -m pip install google-genai
  • Python 可通过 py(Windows)或 python3 运行

工作流

1. 确定提示词

检查用户是否提供了自定义提示词或特定的提取说明。

  • 没有自定义提示词 -> 使用默认格式(包含标题、摘要、要点和收获的结构化摘要)
  • 用户提供了自定义说明 -> 通过 --prompt 或 --prompt-file 传入

自定义提示词会完全替代默认提示词。自定义提示词示例:

  • “提取所有提到的工具、它们的价格,以及每个工具的一句话介绍”
  • “列出视频中提到的每项待办事项和截止日期”
  • “创建带时间戳的文字稿大纲”
2. 运行脚本
# Default summary — all videos in current directory (recursive)
py scripts/summarize_videos.py

# Default summary — specific directory
py scripts/summarize_videos.py "C:/path/to/videos"

# Custom prompt (inline) — replaces default summary format
py scripts/summarize_videos.py --prompt "Extract all product names and prices mentioned"

# Custom prompt (from file) — replaces default summary format
py scripts/summarize_videos.py --prompt-file my-prompt.txt

# Both directory and custom prompt
py scripts/summarize_videos.py "C:/path/to/videos" --prompt "List all key decisions made"
3. Claude 应如何处理用户参数

用户调用此技能时:

  1. 如果用户指定了自定义提示词或提取目标(例如“提取所有提到的工具”、“着重总结定价”或“列出待办事项”),通过 --prompt "..." 传入。
  2. 如果用户提供了提示词文件路径,通过 --prompt-file path/to/file.txt 传入。
  3. 如果用户没有提供具体说明,则不使用 --prompt 运行,以采用默认格式。
  4. 如果用户指定了目录,将其作为第一个位置参数传入。
4. 默认输出格式(未提供自定义提示词时)
# [Video Title]

## Summary
[2-3 sentence description]

## Key Points
- point 1
- point 2
- ...

## Core Content & Takeaways
[Central message and key insight]

---
*Auto-generated with Gemini API*

备注

  • 摘要语言与视频语言一致
  • 处理后会自动从 Gemini 存储中删除文件(限时 48 小时)
  • 再次运行时会跳过已生成摘要的视频
  • 脚本路径:scripts/summarize_videos.py
  • 模型:gemini-3-flash-preview

评论

支持 Markdown