用途:在终端管理 Ghost CMS 站点内容,基于 Ghost Admin API(请求头 Accept-Version: v6.0,可能兼容 v5)。
主要能力:site 查看站点标题、URL、描述;posts 列出文章(默认 20 条,可按 --limit、--status published/draft/scheduled 过滤);create-post 创建文章(--title、--html、--status、--slug);pages 列出页面;tags 列出标签及文章数。
使用方式:在 Ghost Admin → Integrations 创建自定义集成获取 id:secret 格式密钥,然后设置环境变量: export GHOST_URL="https://your-ghost-site.com" export GHOST_ADMIN_KEY="your-id:your-secret" 常用命令如 ghost-cli site、ghost-cli posts --limit 50 --json、ghost-cli create-post --title "Hello World" --html "<p>Hello!</p>"。全局参数 --json、--dry-run、--quiet、--verbose 可放在子命令前后;--help 与 --dry-run 无需凭据。
限制:密钥必须为 id:secret 格式,普通 token 或 JWT 无效;CLI 每次请求内部生成 5 分钟有效的 HS256 JWT,系统时钟偏差会导致失败;正文须为原始 HTML,不自动转换 Markdown;不支持更新或删除文章/页面/标签,也不提供创建标签的子命令;Ghost Admin API 有速率限制,大量操作需错开请求。