Zoom Recording Downloader

🚀 Zoom 会議録画ダウンロードツール

このツールは、Zoom 会議の録画ファイルをダウンロードするための Python ツールです。コマンドラインと MCP サーバーの両方の使用方法に対応しています。

✨ 主な機能

• 指定した日付範囲内のすべての会議録画リストを取得します。
• 会議録画ファイルを一括でローカルにダウンロードします。
• 会議のテーマと時間に基づいて自動的にディレクトリ構造を作成します。
• ダウンロードを途中から再開できる機能（ダウンロード済みのファイルサイズを検出）をサポートします。
• MCP サーバーモードをサポートし、Claude Code に統合できます。
• 環境変数とコマンドライン引数による設定をサポートします。

📦 インストール

pip install -r requirements.txt

📚 ドキュメント

環境設定

方法一：.env ファイルの使用（推奨）

.env ファイルを作成し、以下の設定を追加します。

ZOOM_AUTH=your_authorization_token
ZOOM_CSRFTOKEN=your_zoom_csrftoken
ZOOM_COOKIES=your_browser_cookies

方法二：コマンドライン引数

コマンドラインで認証情報を直接渡すこともできます。

認証情報の取得

1. Zoom ウェブ版（https://thoughtworks.zoom.us/recording/）にログインします。
2. ブラウザの開発者ツール（F12）を開きます。
3. Network タブに切り替えます。
4. ページを更新し、任意のリクエストをクリックします。
5. リクエストヘッダーから以下の値をコピーします。
   • Authorization の値
   • zoom-csrftoken の値
6. Application > Cookies からすべての Cookies をコピーします。

使用方法

コマンドラインモード

1. すべての録画をダウンロード

python download_zoom_recordings.py

2. 日付範囲を指定

python download_zoom_recordings.py -s "01/01/2024" -e "12/31/2024"

3. ダウンロードディレクトリを指定

python download_zoom_recordings.py -d /path/to/downloads

4. 認証情報を渡す

python download_zoom_recordings.py -a "your_auth_token" -t "your_csrftoken" -c "your_cookies"

完全な引数の説明

MCP サーバーモード

MCP サーバーの起動

python mcp_server.py

MCP サーバーは download_recordings ツールを公開し、Claude Code で使用できます。

Claude Code の設定

.mcp.json に以下を追加します。

{
  "mcpServers": {
    "zoom-download": {
      "command": "python",
      "args": ["/path/to/mcp_server.py"],
      "env": {}
    }
  }
}

ファイル構造

ダウンロードされたファイルは、以下の構造で自動的に整理されます。

downloads/
└── 会議テーマ_20240101_143000/
    ├── file_1.mp4
    ├── file_2.mp4
    └── ...

API リファレンス

ZoomRecordingDownloader クラス

主なメソッド：

• get_meeting_list() - 単一ページの会議リストを取得します。
• get_all_recordings() - すべての会議録画情報を取得します。
• save_recordings_to_json() - 録画情報を JSON ファイルに保存します。
• get_download_file_list() - 単一の会議のダウンロードファイルリストを取得します。
• download_file() - 単一のファイルをダウンロードします。
• download_meeting_recordings() - 単一の会議のすべての録画をダウンロードします。
• download_all() - すべての録画を一括でダウンロードします。

zoom_utils モジュール

純粋な関数ツールモジュールで、以下の機能を提供します。

• extract_filename_from_url() - URL からファイル名を抽出します。
• build_meeting_dir_name() - 会議ディレクトリ名を作成します。
• parse_cookies_string() - cookies 文字列を解析します。
• ensure_directory_exists() - ディレクトリが存在することを確認します。
• extract_recordings_from_response() - API レスポンスから録画リストを抽出します。
• extract_download_urls_from_response() - レスポンスからダウンロード URL を抽出します。

注意事項

1. 認証情報の有効期限：認証情報は定期的に失効する可能性があり、再取得が必要です。
2. リクエスト頻度：ツールには 1 秒のリクエスト間隔が組み込まれており、Zoom のレート制限を回避します。
3. ファイルサイズ：大きな録画ファイルのダウンロードには時間がかかる場合があります。
4. ストレージ容量：ダウンロードしたファイルを保存するのに十分なディスク容量があることを確認してください。
5. Cookies の形式：_zm_mtk_guid=xx; _zm_visitor_guid=xx; ..

📄 ライセンス

MIT License