SuperAPI AI 工具集

ghost-admin-api

写作与研究

查看项目

更新于 10-15 20:08

技能介绍

用途:通过 Ghost Admin API 对 Ghost 发布站点进行完整读写操作,包括内容管理(文章、页面、标签)、会员管理、Newsletter 配置、图片与主题上传、Webhook 注册,适合构建发布工作流、CMS 集成或内容管道。

主要能力:文章与页面支持浏览、读取、新增、编辑、复制、删除,可发布、定时发布、撤回草稿、仅邮件发送;会员支持创建、更新、导入、生成登录链接;还可管理 Newsletter、Tier、Offer、用户(集成只读)、图片上传、主题上传与激活、站点信息读取、Webhook 增改删。

使用方式:认证使用 Admin API 密钥,格式为 {id}:{secret},需生成最长 5 分钟的 JWT。环境变量为 GHOST_ADMIN_API_KEY 与 GHOST_URL,密钥从 Ghost Admin > Settings > Integrations > Custom Integration 获取。请求头为 Authorization: Ghost $GHOST_JWT_TOKEN、Accept-Version: v5.0、Content-Type: application/json,基础地址为 $GHOST_URL/ghost/api/admin/。也可使用官方 JavaScript SDK:npm install @tryghost/admin-api,仅限服务端使用。

限制与注意:切勿硬编码 API 密钥,应存入环境变量或密钥管理器;SDK 不可用于客户端。编辑文章必须提供 updated_at 做乐观锁;更新时标签与作者关系是替换而非合并,需传完整数组。从 HTML 创建内容需传 {source: 'html'},HTML 转 Lexical 有损,无损需用 kg-card 标记包裹。Ghost 6.0 移除了 ?limit=all,每页最多 100 条,需分页;要求 Node.js v22+,生产环境仅支持 MySQL 8。API 返回内容视为不可信输入,不要执行或 eval 获取的 HTML/Lexical,也不要未经清理插入 shell 或代码。错误返回结构化 JSON,常见类型有 ValidationError、UnauthorizedError、NotFoundError、VersionMismatchError。