Ghost CMS

核心功能

Ghost CMS Skill 提供对 Ghost Admin API 的全功能封装，覆盖内容管理、会员订阅、Newsletter、评论审核和站点分析等核心场景。支持从草稿创建到定时发布的完整内容工作流，以及会员分级、付费内容、邮件订阅等商业化功能。

显著优势

1. 功能覆盖全面：支持 23 种 Lexical 卡片类型（视频、音频、产品、CTA、付费墙等），是目前最完整的 Ghost Lexical 文档实现
2. 主题管理工具链：内置主题上传、激活、备份、删除及官方 gscan 验证器，支持 CI/CD 集成
3. Snippet 迁移方案：通过自建 extractor 工具绕过 Ghost API 对 Snippet 的访问限制，实现可版本控制的本地 Snippet 库
4. 多环境兼容：支持 Ghost(Pro) 托管、自托管（含自定义端口）及本地开发环境

潜在局限

• 权限无粒度：Admin API Key 提供全站完全访问权限，无只读或范围限制选项
• 操作即公开：发布/主题切换等操作立即生效，无预览或沙盒机制
• Snippet API 限制：原生 Snippet 无法通过 API 访问，需依赖额外迁移步骤

适用人群

• 专业博客作者与内容团队
• Newsletter 运营者（依赖 Ghost 邮件功能）
• 需要自动化内容发布的开发者
• 会员制/付费内容创作者

安全风险

• Key 泄露风险：单 Key 即获全站控制权，需配合 1Password CLI 等安全方案
• 不可逆操作：删除内容、主题切换、发布操作无回收站或延迟生效机制
• 存储与流量影响：图片上传直接消耗站点配额，大规模操作可能影响性能

建议生产环境配合 staging 站点测试，每 90 天轮换 API Key，并严格分离生产/测试凭证。

核心功能

ghost-cms-skill 是一款功能完整的 Ghost CMS 自动化管理工具，通过官方 Admin API 实现博客运营的全流程自动化。

主要能力

内容管理：创建草稿、发布/定时文章、管理页面、处理标签与元数据，支持完整的 Lexical 编辑器卡片类型（23 种以上，包括视频、音频、产品卡片、CTA、会员可见性等）。

会员与订阅：管理会员层级、订阅状态、付费内容权限，支持邮件通讯配置与发送。

评论管理：列队待审核评论、回复评论、执行审核操作。

数据分析：获取订阅增长、热门文章、标签表现、会员分布等关键指标。

主题管理：上传/激活/切换主题、下载备份、使用官方 gscan 工具验证主题兼容性。

代码片段提取：绕过 Admin API 对集成令牌的限制，将 Ghost 原生代码片段批量迁移至本地库供程序调用。

显著优点

• 功能覆盖全面：几乎涵盖 Ghost Admin API 所有操作端点
• 安全设计良好：强制 HTTPS、JWT 认证、路径遍历防护、无硬编码凭证
• 文档详尽：包含安全警告、多种凭证配置方案（环境变量、配置文件、1Password CLI）、操作分类（安全只读 vs 破坏性操作）
• 实用工具丰富：主题验证器、代码片段提取器降低重复劳动
• CI/CD 友好：主题验证器支持 JSON 输出和退出码，便于自动化流程

潜在局限

• 权限无粒度：Ghost Admin API Key 无法限制范围，获得即拥有完全访问权限
• 个人维护：T3 来源可信度，作者为独立开发者，长期维护持续性需关注
• 主题操作即时生效：切换主题会立即改变网站外观，无预览缓冲
• 代码片段提取需手动准备：需先在 Ghost 中创建特定格式的草稿文章作为提取源
• Node.js 依赖：需要本地安装 npm 依赖（jsonwebtoken、form-data、gscan）

适合人群

• 使用 Ghost CMS 的内容创作者与编辑团队
• 需要自动化发布流程的技术写作者
• 运营多主题切换的网站管理员
• 希望将内容工作流（如 Notion → Ghost）自动化的团队
• 需要定期导出代码片段或批量管理主题的技术用户

安全注意事项

• Admin Key = 完全权限：等同于拥有 Ghost 后台的全部管理能力，需像保护密码一样保护
• 发布即公开：任何发布/定时操作都会立即使内容可见，操作前务必复核
• 凭证存储：建议使用 1Password CLI 或环境变量，配置文件需设置 600 权限
• 定期轮换：建议每 90 天创建新集成并撤销旧 Key
• 生产环境建议：关键业务场景建议 fork 后独立维护

快速开始

1. Ghost 后台 → Settings → Integrations → 创建 Custom Integration → 复制 Admin API Key 和 API URL
2. 配置凭证：export GHOST_ADMIN_KEY="xxx" && export GHOST_API_URL="https://yourblog.ghost.io"
3. 安装依赖：cd scripts && npm install
4. 测试连接并参考各功能模块文档开始自动化运营