核心用法
Vimeo Skill 是 Maton 平台提供的官方 API 集成工具，通过托管式 OAuth 2.0 认证机制，允许用户以程序化方式操作 Vimeo 平台的完整功能集。该技能采用网关代理架构，所有请求经由 https://gateway.maton.ai/vimeo/{resource} 转发至 Vimeo 官方 API，自动注入用户 OAuth 令牌，无需直接管理 Vimeo 凭据。
核心功能模块涵盖：用户管理（获取用户信息、动态流）、视频全生命周期操作（列表、搜索、更新、删除）、文件夹（Projects）管理、专辑（Showcases/Albums）创建与维护、评论系统、点赞与稍后观看列表、关注关系管理，以及频道和分类浏览。所有接口均支持分页查询，最大每页 100 条结果。
认证流程采用"连接-授权"分离模式：用户先在 ctrl.maton.ai 创建 Vimeo 类型连接，获取授权 URL 后完成浏览器端 OAuth 授权，后续 API 调用仅需 Maton API Key。支持多连接管理，可通过 Maton-Connection 头指定特定连接。
显著优点
1. 托管安全架构：OAuth 令牌由 Maton 平台加密存储，用户仅需保管单一 API Key，大幅降低凭据泄露风险
2. 完整功能覆盖：几乎映射 Vimeo API 全部端点，涵盖视频管理、社交互动、内容组织三大维度
3. 多语言示例：提供 Bash、Python、JavaScript 完整代码片段，降低集成门槛
4. 连接可管理性：支持创建、列出、删除连接，适合多账号场景（如代运营团队）
5. 错误信息透明：直接透传 Vimeo 原生错误，包含具体 scope 缺失等信息，便于调试
潜在缺点与局限性
- 上传功能受限：文档明确说明视频上传需 TUS 协议，本 skill 未覆盖，大文件上传需额外实现
- Rate Limit 不可控：Vimeo 的限速策略与账户类型挂钩（免费/Plus/Pro/Business），高频调用可能触发 429 错误
- 网关依赖风险：所有流量经由 Maton 网关中转，存在单点故障和额外延迟
- 账户功能差异：部分 API（如高级分析、自定义域名）可能需要付费 Vimeo 账户才可用
- OAuth 重授权：令牌过期后需重新走浏览器授权流程，无法实现完全自动化
适合人群
- 视频创作者需要批量管理作品、自动整理专辑
- 内容运营团队进行多账号视频分发和元数据维护
- 开发者构建基于 Vimeo 的视频 CMS 或工作流自动化
- 营销团队提取视频数据用于分析报告
常规风险
1. 权限过度授予：OAuth 授权时可能获取超出实际需要的 scope，建议定期审查 ctrl.maton.ai 中的连接权限
2. API Key 泄露：MATON_API_KEY 是平台级凭证，泄露将导致所有连接被滥用，应使用环境变量或密钥管理系统存储
3. 内容误操作：DELETE 操作不可逆，批量删除视频、文件夹前建议确认资源 ID
4. 隐私合规：获取用户关注列表、点赞数据时需注意 GDPR 等数据保护法规
5. 依赖服务可用性：Maton 网关或 Vimeo 服务中断将直接影响业务连续性