Ghost Publishing Pro 是一套面向专业 Ghost 站点运营者的 headless 自动化技能,深度整合 Ghost Admin API,提供从单篇文章发布到整站迁移的完整工作流体系。
核心用法
- 一键发布+邮件推送:单条 API 调用同时完成文章上线与 newsletter 发送,
email_segment字段必须在首次发布时携带,错过无法补发 - 安全更新机制:强制先 fetch 获取
updated_at时间戳,再执行 PUT 更新,避免 409 冲突错误 - 批量操作管控:所有批量写入(批量标签、摘要更新、迁移导入)需用户显式确认作用范围与影响数量
- 多平台迁移:内置 Squarespace/WordPress XML、Substack CSV 迁移方案,支持 DOCX 转书籍排版、YouTube 嵌入、音频卡片等富媒体处理
显著优点
- 纯 API 驱动,无需浏览器或仪表盘切换,适合 AI 工作流集成
- 17 条生产级工作流,涵盖 SEO 修复(GSC 索引提交)、邮件性能分析(开信率/点击率/CTO)、站点健康审计(缺失特征图/摘要/标签扫描)
- 最小权限原则:专用 integration key 而非 owner 凭据,JWT 5 分钟过期,令牌不落盘
- 跨平台依赖极简:仅 Node.js 内置模块 + curl,迁移场景才需可选 npm 包
潜在局限
- Ghost 平台级限制:站点设置、代码注入、重定向规则、员工管理返回 403,integration token 无法操作,技能明确不覆盖(非 skill gap)
- 图片上传强制使用 Python requests(multipart),curl 在 macOS zsh 下静默失败
- 标签写入端点需要 owner-level 权限,普通 integration token 会 403
- 邮件发送为一次性操作,API 无法触发已发布文章的 newsletter 重发
适合人群
- Ghost Pro newsletter 运营者、独立博客作者
- 需要批量内容迁移(Squarespace/WordPress/Substack)的站点管理员
- 追求 headless 自动化、将 Ghost 集成到 AI/CLI 工作流的技术用户
常规风险
- 批量写入不可逆,无自动回滚机制,依赖用户前置确认
- 凭据文件需严格限制文件权限,避免共享目录暴露
- 自定义主题开发时易踩坑:必须使用
{{{content}}}(三花括号),双花括号会转义 HTML 导致内容渲染为空