YouTube MCP

YouTube MCP

YouTubeの動画から自動的にスクリーンショットを取得するツールです。YouTube ShortsとYouTube動画に対応しています。

機能

YouTube Shorts

• 指定したn秒ごとにスクリーンショットを撮影
• 最大60枚まで撮影（動画が60秒以上の場合）
• 動画エリアのみを正確に切り出してtmp/に保存
• リアルタイムでスクリーンショットを表示
• 全部もしくは選択した画像をZIPでローカルにDL（Mac、Windowsの双方で開ける）

YouTube動画

• 指定したn秒ごとにスクリーンショットを撮影
• 最大60枚まで撮影（動画が60秒以上の場合）
• 動画エリアのみを正確に切り出してtmp/に保存
• リアルタイムでスクリーンショットを表示
• 全部もしくは選択した画像をZIPでローカルにDL（Mac、Windowsの双方で開ける）

TikTok

• 現在対応準備中です
• YouTubeまたはYouTube ShortsのURLをご利用ください

技術スタック

• Node.js 18
• Express
• Playwright
• Firebase Functions (Gen 2)
• Firebase Hosting
• Firebase Storage
• TypeScript
• Bootstrap 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 Functions (Gen 2)
   • ランタイム: Node.js 18
   • リージョン: us-central1
   • メモリ: 1GiB
   • CPU: 1
   • タイムアウト: 540秒
   • 最大インスタンス数: 100
   • 同時実行数: 80
   • エンドポイント: https://api-ub7zp5pjra-uc.a.run.app
2. Firebase Storage
   • バケット: mcp-5e4b5.firebasestorage.app
   • セキュリティルール: 認証済みユーザーのみアクセス可能
3. Firebase Hosting
   • ドメイン: https://mcp-5e4b5.web.app

IAM権限設定

ユーザー権限

• t@bonginkan.ai
  • roles/owner (プロジェクト所有者)
  • roles/run.admin (Cloud Run管理者)

サービスアカウント権限

1. Cloud Functions
   • 33501462786-compute@developer.gserviceaccount.com
     • roles/run.admin
     • roles/run.developer
     • roles/run.invoker
     • roles/cloudfunctions.developer
     • roles/storage.admin
2. Firebase Admin
   • firebase-adminsdk-fbsvc@mcp-5e4b5.iam.gserviceaccount.com
     • roles/firebase.sdkAdminServiceAgent
     • roles/firebaseauth.admin
     • roles/iam.serviceAccountTokenCreator
     • roles/storage.admin
3. Cloud Build
   • 33501462786@cloudbuild.gserviceaccount.com
     • roles/run.admin
     • roles/cloudfunctions.developer
     • roles/storage.admin
     • roles/artifactregistry.admin
     • roles/eventarc.admin

実装の詳細

スクリーンショット機能

• Playwrightを使用してヘッドレスブラウザを制御
• ビューポートサイズ: 1280x720
• 一時ディレクトリを使用してスクリーンショットを一時保存
• Firebase Storageにアップロード後、一時ファイルを削除
• 署名付きURLは15分間有効

エラーハンドリング

• 各APIエンドポイントでエラーをキャッチ
• エラーメッセージをJSON形式で返却
• 404エンドポイントのハンドリング
• 500エラー時の適切なエラーレスポンス

CORS設定

• 許可オリジン:
  • https://mcp-5e4b5.web.app
  • http://localhost:3001
• 許可メソッド: GET, POST
• クレデンシャル: 有効

セキュリティ

• Firebase Storageのセキュリティルール
• 署名付きURLの有効期限設定（15分）
• 一時ファイルの適切な削除

最新の修正内容（2024-03-28）

バグ修正

1. CORS設定の改善
   • 許可オリジンの明示的な指定
   • クレデンシャルの有効化
2. エラーハンドリングの強化
   • 404エラーのJSON形式レスポンス
   • 500エラー時の詳細なエラーメッセージ
3. Firebase Storage対応
   • バケット名の明示的な指定
   • 署名付きURLの有効期限を15分に設定
4. Cloud Functions Gen 2の最適化
   • メモリ設定の最適化（1GiB）
   • タイムアウト設定の調整（540秒）
   • 同時実行数の設定（80）

機能改善

1. スクリーンショット機能
   • Playwrightの設定最適化
   • ヘッドレスブラウザのビューポート設定
   • 一時ファイル管理の改善
   • YouTube Shorts対応の改善
   • リアルタイム表示機能の実装
2. API応答の改善
   • エラーメッセージの日本語化
   • レスポンス形式の統一
   • タイムスタンプ形式の標準化
   • ストリーミングレスポンスの実装
3. セキュリティ強化
   • Firebase Storageのセキュリティルール更新
   • 一時ファイルの確実な削除
   • エラー情報の適切な制限
4. フロントエンド改善
   • リアルタイム表示の最適化
   • 画像URLの修正
   • エラーハンドリングの強化
   • ユーザーインターフェースの改善

セットアップ

1. リポジトリのクローン

2. 依存パッケージのインストール

3. Firebase CLIのインストール

4. Firebaseへのログイン

5. プロジェクトの初期化

6. デプロイ

ローカル開発環境のセットアップ

1. 依存パッケージのインストール

2. サービスアカウントキーの設定

• Firebase Consoleからサービスアカウントキーをダウンロード
• functions/service-account.jsonとして保存

3. 環境変数の設定

4. エミュレータの起動

エミュレータのポート設定

エミュレータは以下のポートを使用します：

• Functions: http://127.0.0.1:5001
• Emulator UI: http://127.0.0.1:4001

APIテスト

1. ヘルスチェック

2. スクリーンショット取得

3. スクリーンショット一覧取得

4. ZIPダウンロード

注意事項

• エミュレータ使用時は実際のFirebase Storageにアクセスします
• サービスアカウントキーは.gitignoreに含まれており、リポジトリにコミットされません
• エミュレータUIで関数の実行状況やログを確認できます

注意事項

• Node.js 18は2025年4月30日に非推奨となります
• スクリーンショットは一時ディレクトリに保存され、処理後に削除されます
• 動画の長さが60秒を超える場合、最初の60枚のみが保存されます
• Firebase Storageのセキュリティルールは認証済みユーザーのみアクセス可能に設定されています
• 署名付きURLは15分間のみ有効です

IMPORTANT

スクリーンショットの保存とZIP化の仕様

1. スクリーンショットの保存
   • すべてのスクリーンショットは/tmp/screenshots/ディレクトリに一時保存されます
   • ファイル名はscreenshot_[タイムスタンプ]_[連番].pngの形式です
   • 一時ファイルは処理完了後も保持され、新しいスクリーンショットを撮影する際に上書きされます
2. ZIPファイルの作成
   • 選択したスクリーンショットは/tmp/screenshots/から直接読み込まれます
   • ZIPファイルは一時的に/tmp/screenshots/に作成され、ダウンロード後に削除されます
   • ZIPファイル名はscreenshots_[タイムスタンプ].zipの形式です
3. 一時ファイルの管理
   • 一時ファイルは定期的にクリーンアップする必要があります
   • 新しいスクリーンショットを撮影する前に、古いファイルを削除することを推奨します

ライセンス

MIT License