SuperAPI AI 工具集

clockify

数据与分析

查看项目

更新于 10-16 00:26

技能介绍

用途:该技能用于让 AI 代理与 Clockify 时间追踪工具的数据交互,Clockify 供团队和个人记录跨项目工时,跟踪生产力、出勤与计费工时,常见于自由职业者、代理机构和各类企业。官方 API 文档见 https://clockify.me/help/api。

主要能力:围绕时间条目(含运行中的计时器)、项目、任务、用户、工作区、报表、标签、客户等对象操作。内置动作包括列出时间条目、用户、标签、客户、任务、项目、工作区,获取时间条目、标签、客户、任务、项目、工作区及当前用户详情,以及创建时间条目、标签、客户、任务、项目,更新已有时间条目。

使用方式:先安装 CLI:npm install -g @membranehq/cli@latest。登录:membrane login --tenant --clientName=<agentType>,无头环境会打印授权 URL,完成后执行 membrane login complete <code>。建立连接:membrane connection ensure "https://clockify.me/" --json,用户在浏览器完成认证;若状态为 BUILDING,用 npx @membranehq/cli connection get <id> --wait --json 轮询至 READY。搜索动作:membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json。运行动作:membrane action run <actionId> --connectionId=CONNECTION_ID --json,传参用 --input '{"key": "value"}'。动作不覆盖时可经代理直接请求 Clockify API:membrane request CONNECTION_ID /path/to/endpoint,支持 -X/--method、-H/--header、-d/--data、--json、--rawData、--query、--pathParam 等选项。任意命令加 --json 可得机器可读输出。

适用场景:需要查询或创建 Clockify 工作区中的时间记录、项目、任务、客户、标签,或获取用户与工作区信息时。

限制:认证与凭据刷新由 Membrane 服务端处理,不应向用户索取 API 密钥或令牌;连接状态可能为 CLIENT_ACTION_REQUIRED、CONFIGURATION_ERROR 或 SETUP_FAILED,需按提示处理。资料未提供具体收费、价格与平台支持范围。