名称： zoom-unofficial-community-skill
描述： Zoom API 集成，支持会议、日历、聊天和用户管理。当用户需要安排会议、查看 Zoom 日历、列出录制文件、发送 Zoom 聊天消息、管理联系人或使用任何 Zoom Workplace 功能时使用。支持服务器到服务器 OAuth 和 OAuth 应用。
使用 scripts/zoom.py 与 Zoom REST API 交互。
pip3 install requests PyJWT --break-system-packages
在技能的 .env 文件中设置以下变量（可从 .env.example 复制）：
ZOOM_ACCOUNT_ID — 账户 ID（来自 Zoom Marketplace 应用）ZOOM_CLIENT_ID — OAuth 客户端 IDZOOM_CLIENT_SECRET — OAuth 客户端密钥ZOOM_USER_EMAIL — 要代理的 Zoom 用户邮箱（S2S 应用必需；未设置时默认为 me）ZOOM_RTMS_CLIENT_ID — RTMS Marketplace 应用的客户端 ID（rtms-start/rtms-stop 命令必需；这是独立于 S2S OAuth 应用的另一个应用）在 https://marketplace.zoom.us/ 创建一个服务器到服务器 OAuth 应用以获取完整的 API 访问权限。
详细设置指南请参阅 references/AUTH.md。
# 列出即将召开的会议
python3 scripts/zoom.py meetings list
# 列出正在进行的会议（需要 Business+ 及以上套餐并启用 Dashboard）
python3 scripts/zoom.py meetings live
# 为进行中的会议启动 RTMS（需要 ZOOM_RTMS_CLIENT_ID）
python3 scripts/zoom.py meetings rtms-start <meeting_id>
# 为进行中的会议停止 RTMS
python3 scripts/zoom.py meetings rtms-stop <meeting_id>
# 获取会议详情
python3 scripts/zoom.py meetings get <meeting_id>
# 安排新会议
python3 scripts/zoom.py meetings create --topic "站会" --start "2026-01-28T10:00:00" --duration 30
# 使用选项安排会议
python3 scripts/zoom.py meetings create --topic "评审会" --start "2026-01-28T14:00:00" --duration 60 --agenda "迭代评审" --password "abc123"
# 删除会议
python3 scripts/zoom.py meetings delete <meeting_id>
# 更新会议
python3 scripts/zoom.py meetings update <meeting_id> --topic "新标题" --start "2026-01-29T10:00:00"
# 今日会议
python3 scripts/zoom.py meetings list --from today --to today
# 本周会议
python3 scripts/zoom.py meetings list --from today --days 7
# 列出云端录制文件
python3 scripts/zoom.py recordings list
# 按日期范围列出录制文件
python3 scripts/zoom.py recordings list --from "2026-01-01" --to "2026-01-31"
# 获取录制文件详情
python3 scripts/zoom.py recordings get <meeting_id>
# 下载录制文件（视频/音频）
python3 scripts/zoom.py recordings download <meeting_id>
python3 scripts/zoom.py recordings download <meeting_id> --output ~/Downloads
# 仅下载转录文件
python3 scripts/zoom.py recordings download-transcript <meeting_id>
python3 scripts/zoom.py recordings download-transcript <meeting_id> --output ~/Downloads
# 下载 AI Companion 总结为 Markdown 文件
python3 scripts/zoom.py recordings download-summary <meeting_uuid>
python3 scripts/zoom.py recordings download-summary <meeting_uuid> --output ~/Downloads
# 删除录制文件
python3 scripts/zoom.py recordings delete <meeting_id>
# 列出会议总结
python3 scripts/zoom.py summary list
python3 scripts/zoom.py summary list --from "2026-01-01" --to "2026-01-31"
# 获取特定会议的 AI 总结
python3 scripts/zoom.py summary get <meeting_id>
# 获取我的个人资料
python3 scripts/zoom.py users me
# 列出用户（管理员权限）
python3 scripts/zoom.py users list
# 列出聊天频道
python3 scripts/zoom.py chat channels
# 列出频道中的消息
python3 scripts/zoom.py chat messages <channel_id>
# 向频道发送消息
python3 scripts/zoom.py chat send <channel_id> "大家好！"
# 发送私信
python3 scripts/zoom.py chat dm <email> "嘿，有空吗？"
# 列出联系人
python3 scripts/zoom.py chat contacts
# 列出通话记录
python3 scripts/zoom.py phone calls --from "2026-01-01" --to "2026-01-31"
对于服务器到服务器 OAuth，请在 Zoom Marketplace 应用中启用以下权限范围。
只需添加你需要的范围——每个命令组需要特定的权限：
| 命令组 | 所需权限范围 |
|---|---|
users me / users list |
user:read:admin |
meetings list/get/create/update/delete |
meeting:read:admin, meeting:write:admin |
recordings list/get/delete |
recording:read:admin, recording:write:admin |
chat channels/messages/send/dm |
chat_channel:read:admin, chat_message:read:admin, chat_message:write:admin |
chat contacts |
contact:read:admin |
summary list/get |
meeting_summary:read:admin |
phone calls |
phone:read:admin（需要账户已启用 Zoom Phone） |
如果遇到权限范围错误，请访问 https://marketplace.zoom.us/ → 你的应用 → 权限范围，并添加错误信息中列出的缺失范围。
Zoom API 有速率限制（各端点不同，通常为每秒 30-100 次请求）。脚本会自动重试以处理 429 响应。