Zoom Recording Downloader

🚀 Zoom 會議錄製下載工具

這是一個用於下載 Zoom 會議錄製文件的 Python 工具，支持命令行和 MCP 服務器兩種使用方式，能有效幫助用戶獲取和管理 Zoom 會議錄製。

🚀 快速開始

本工具支持命令行和 MCP 服務器兩種使用方式，可根據需求靈活選擇。使用前需進行依賴安裝和環境配置。

✨ 主要特性

• 獲取會議錄製列表：能獲取指定日期範圍內的所有會議錄製列表。
• 批量下載：可批量下載會議錄製文件到本地。
• 自動創建目錄：自動按會議主題和時間創建目錄結構。
• 斷點續傳：支持斷點續傳，會檢測已下載文件大小。
• 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": {}
    }
  }
}

📚 詳細文檔

項目結構

zoom/
├── download_zoom_recordings.py  # 主下載腳本
├── zoom_utils.py                # 工具函數模塊
├── mcp_server.py                # MCP 服務器實現
├── requirements.txt             # Python 依賴
├── recordings.json              # 會議列表數據（自動生成）
├── downloads/                   # 下載目錄（自動創建）
└── README.md                    # 說明文檔

文件結構

下載的文件會自動按以下結構組織：

downloads/
└── 會議主題_20240101_143000/
    ├── file_1.mp4
    ├── file_2.mp4
    └── ...

🔧 技術細節

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。

📄 許可證

MIT License

⚠️ 重要提示

• 認證信息過期：認證信息可能定期失效，需要重新獲取。
• 請求頻率：工具內置了 1 秒的請求間隔，避免觸發 Zoom 的速率限制。
• 文件大小：大型錄制文件可能需要較長時間下載。
• 存儲空間：確保有足夠的磁盤空間存儲下載的文件。
• Cookies 格式參考：_zm_mtk_guid=xx; _zm_visitor_guid=xx; ..