YouTube MCP

一个自动从 YouTube 视频中截取屏幕截图的工具。支持 YouTube Shorts 和 YouTube 视频。

功能

YouTube Shorts

• 每 n 秒截取一次屏幕截图

• 最多 60 张照片（如果视频长度为 60 秒或更长）

• 精确剪切视频区域并保存到tmp/

• 实时查看屏幕截图

• 将所有或选定的图像以 ZIP 文件形式下载到本地（可在 Mac 和 Windows 上打开）

YouTube 视频

• 每 n 秒截取一次屏幕截图

• 最多 60 张照片（如果视频长度为 60 秒或更长）

• 精确剪切视频区域并保存到tmp/

• 实时查看屏幕截图

• 将所有或选定的图像以 ZIP 文件形式下载到本地（可在 Mac 和 Windows 上打开）

TikTok

• 目前正在筹备中

• 请使用 YouTube 或 YouTube Shorts 网址

技术堆栈

• Node.js 18

• 表达

• 剧作家

• Firebase 函数（第二代）

• Firebase 托管

• Firebase 存储

• TypeScript

• 引导 CSS

项目配置

API列表

截取屏幕截图

• 端点： /screenshot

• 方法：POST

• 参数：

  { "url": "YouTube URL", "interval": 1 // 間隔（秒） }

• 回复：

  { "success": true, "screenshots": [ { "imageUrl": "署名付きURL", "time": "タイムスタンプ", "filename": "ファイル名" } ], "interval": 1 }

获取截图列表

• 端点： /screenshots

• 方法：GET

• 回复：

  [ { "filename": "ファイル名", "imageUrl": "署名付きURL", "time": "タイムスタンプ" } ]

ZIP 下载

• 端点： /download-zip

• 方法：POST

• 参数：

  { "filenames": ["ファイル名1", "ファイル名2"] }

• 响应：ZIP 文件

GCP 架构

使用的服务

1. Firebase 函数（第二代）

   • 运行时：Node.js 18

   • 区域：us-central1

   • 内存：1GiB

   • CPU：1

   • 超时：540秒

   • 最大实例数：100

   • 并发：80

   • 端点： https://api-ub7zp5pjra-uc.a.run.app

2. Firebase 存储

   • 存储桶：mcp-5e4b5.firebasestorage.app

   • 安全规则：仅限经过身份验证的用户访问

3. Firebase 托管

   • 域名： https://mcp-5e4b5.web.app

IAM 权限设置

用户权限

• t@bonginkan.ai

  • roles/owner （项目所有者）

  • roles/run.admin （Cloud Run 管理员）

服务帐户权限

1. 云函数

   • 33501462786-compute@developer.gserviceaccount.com

     • roles/run.admin

     • roles/run.developer

     • roles/run.invoker

     • roles/cloudfunctions.developer

     • roles/storage.admin

2. Firebase 管理员

   • firebase-adminsdk-fbsvc@mcp-5e4b5.iam.gserviceaccount.com

     • roles/firebase.sdkAdminServiceAgent

     • roles/firebaseauth.admin

     • roles/iam.serviceAccountTokenCreator

     • roles/storage.admin

3. 云构建

   • 33501462786@cloudbuild.gserviceaccount.com

     • roles/run.admin

     • roles/cloudfunctions.developer

     • roles/storage.admin

     • roles/artifactregistry.admin

     • roles/eventarc.admin

实现细节

截图功能

• 使用 Playwright 控制无头浏览器

• 视口尺寸：1280x720

• 使用临时目录存储屏幕截图

• 上传到 Firebase 存储后，删除临时文件。

• 签名 URL 有效期为 15 分钟

错误处理

• 捕获每个 API 端点的错误

• 以 JSON 格式返回错误消息。

• 处理 404 端点

• 500 错误的适当错误响应

CORS 设置

• 允许的来源：

  • https://mcp-5e4b5.web.app

  • http://localhost:3001

• 允许的方法：GET、POST

• 凭证：有效

安全功能

• Firebase 存储安全规则

• 设置签名 URL 的过期时间（15 分钟）

• 正确删除临时文件

最新修订（2024-03-28）

错误修复

1. 改进的 CORS 配置

   • 明确指定允许的来源

   • 启用凭证

2. 改进的错误处理

   • 404 错误的 JSON 响应

   • 500 错误的详细错误消息

3. Firebase 存储支持

   • 明确指定存储桶名称

   • 将签名 URL 的过期时间设置为 15 分钟

4. Cloud Functions Gen 2 优化

   • 优化内存设置（1GiB）

   • 调整超时设置（540秒）

   • 设置并发执行数（80）

改进的功能

1. 截图功能

   • 优化 Playwright 设置

   • 无头浏览器视口设置

   • 改进的临时文件管理

   • 改进了对 YouTube Shorts 的支持

   • 实时显示功能实现

2. 改进的 API 响应

   • 日语错误信息

   • 标准化响应格式

   • 时间戳格式的标准化

   • 实现流式响应

3. 增强安全性

   • Firebase 存储安全规则更新

   • 确保临时文件被删除

   • 适当限制错误信息

4. 前端改进

   • 优化实时显示

   • 图片URL修正

   • 改进的错误处理

   • 用户界面改进

设置

1. 克隆存储库

2. 安装依赖项

3. 安装 Firebase CLI

4. 登录 Firebase

5. 初始化项目

6. 部署

设置本地开发环境

1. 安装依赖项

2. 设置服务帐户密钥

• 从 Firebase 控制台下载您的服务帐号密钥

• 保存为functions/service-account.json

3. 设置环境变量

4. 启动模拟器

仿真器端口设置

模拟器使用以下端口：

• 功能： http://127.0.0.1:5001

• 模拟器界面： http://127.0.0.1: 4001

API 测试

1. 健康检查

2. 截取屏幕截图

3. 获取截图列表

4. ZIP 下载

笔记

• 使用模拟器时，您将访问实际的 Firebase 存储。

• 服务帐户密钥包含在.gitignore中，并且未提交到存储库

• 您可以在模拟器 UI 中检查函数的执行状态和日志。

笔记

• Node.js 18 将于 2025 年 4 月 30 日弃用

• 屏幕截图保存到临时目录并在处理后删除。

• 如果视频长度超过 60 秒，则只会保存前 60 张图像。

• Firebase Storage 的安全规则设置为仅允许经过身份验证的用户访问。

• 签名 URL 的有效期仅为 15 分钟

重要的

保存屏幕截图和压缩文件的规范

1. 保存屏幕截图

   • 所有屏幕截图都临时保存在/tmp/screenshots/目录中。

   • 文件名的格式为screenshot_[タイムスタンプ]_[連番].png

   • 处理完成后，临时文件将被保留，并在您截取新屏幕截图时被覆盖。

2. 创建 ZIP 文件

   • 选定的屏幕截图将直接从/tmp/screenshots/加载

   • 下载后，将在/tmp/screenshots/中创建一个临时 ZIP 文件，然后删除该文件。

   • ZIP 文件名的格式为screenshots_[タイムスタンプ].zip

3. 管理临时文件

   • 应定期清理临时文件

   • 我们建议在拍摄新截图之前删除旧截图。

执照

MIT 许可证