SuperAPI AI 工具集

ordinal-cli

通用与其它

查看项目

更新于 10-16 07:14

技能介绍

ordinal-cli 用于让智能体通过已安装的 ordinal 程序操作 Ordinal API,属于操作型技能而非仓库维护技能。

用途:读取或修改 Ordinal 工作区数据;把 API 任务翻译成 ordinal <resource> <action> 命令;发现已安装 CLI 支持的具体参数与动作。注意 CLI 未必暴露全部 API 端点,需以二进制自身为准。

命令发现顺序:ordinal --help、ordinal <resource> --help、ordinal <resource> <action> --help;官方文档为 https://docs.tryordinal.com/api/introduction。CLI 帮助与文档冲突时,以已安装二进制的帮助为准。

API 事实:基础 URL 为 https://app.tryordinal.com/api/v1;认证使用 Authorization: Bearer <api_key>;限速每密钥每分钟 100 次请求,超出返回 429;API 访问需 Pro 套餐;密钥在工作区设置中生成,每个密钥仅限单个工作区。

认证方式:--api-key、环境变量 ORDINAL_API_KEY,或 ordinal auth <api-key> 保存配置。

全局参数:--api-key/-k、--output/-o(json、table、csv)、--verbose/-v。智能体工作流建议使用 --output json,人工查看用 table,调试用 --verbose。

命令模式:多数为 ordinal <resource> list/get/create/update/delete。例外:post 额外支持 schedule、unschedule、archive、unarchive,当前文档未提供 post delete;idea 额外支持 archive、unarchive、add-to-calendar;部分资源(comment、approval、engagement、subscriber、inline-comment、slack-boost)通过 --post-id 归属父帖子;profile 有 list-scheduling 与 list-engagement;label 仅支持 create、list、delete。

分页:支持列表端点使用游标分页,参数有 --limit(1-100)、--cursor、--all。建议先用有界 limit,仅在需要全部数据时用 --all。

复杂 JSON:post 与 idea 创建支持多频道内容,使用 --body-json 或 --body-file。频道键:Posts 为 linkedIn、x、instagram、tikTok、youTubeShorts;Ideas 为 linkedIn、x、tikTok、youTubeShorts。资产使用 assets 对象数组,如 {"assets":[{"assetId":"<upload-asset-uuid>"}]},不使用旧式 assetIds。TikTok 与 YouTube Shorts 的 assets 必须恰好一个视频资产对象。

顶层资源包括 analytics、approval、comment、engagement、idea、inline-comment、instagram、invite、label、linkedin、linkedin-leads、post、profile、slack-boost、slack-webhook、subscriber、upload、user、webhook、workspace。

失败处理:使用 --verbose 重跑,确认认证与工作区范围、资源动作存在性、参数与 JSON 结构是否符合 OpenAPI,遵守限速并在 429 时退避。

限制:仅覆盖已安装 CLI 暴露的能力;缺失资源即表示当前版本不支持;不可臆造 JSON 结构或功能。