SuperAPI AI 工具集

calendly

办公与效率

查看项目

更新于 10-16 07:24

技能介绍

用途:通过 calendly CLI 管理 Calendly 连接状态并读取排期数据,用于查看事件、事件类型等调度信息。

主要能力:核心命令包括 calendly status(查看连接状态)、calendly disconnect(断开连接)、calendly authorize-url(获取授权链接)、calendly me(获取当前用户与组织 URI)、calendly list-events(列出事件,支持 --user-uri、--status、--min-start-time、--max-start-time、--count、--page-token)、calendly event-types(列出事件类型,支持 --user-uri、--active、--count、--page-token),以及 calendly request 发起原始 GET 请求(--method、--path、--query、--json-body)。

输出约定:每条命令返回带顶层 ok 的 JSON。disconnect 解析 action 与 removed;status 解析连接状态及返回的授权 URL 或恢复信息;me 解析当前用户 URI 与组织 URI;list-events 与 event-types 解析返回集合及分页 token。定时事件附带 event_starts_at / event_ends_at(UTC 与用户本地时间),读取输出附带 retrieved_at。

使用方式:先运行 calendly status;未连接时运行 calendly authorize-url,将返回的 connect_url 以 Markdown 链接 Connect Calendly 形式分享;授权后运行 calendly me 验证。凭证由 CLI 通过共享连接器助手自动解析与刷新,不直接读取配置文件,也不应打印访问或刷新令牌。

限制与规则:任何 API 调用前需 status 显示已连接;需要用户 URI 或组织 URI 时先用 me;令牌过期自动刷新,若仍失败需重新检查状态并重新链接;执行破坏性或用户可见的变更(包括可能取消事件或删除订阅的原始请求)前需确认;摘要中优先使用 event_starts_at.user_local 与 event_ends_at.user_local。