Ghost博客管理工具

技能简介

ecto 是一款面向 Ghost.io 平台的命令行管理工具，通过 Admin API 实现博客内容的全流程操作。支持文章、页面、标签的增删改查，提供 Markdown 自动转 HTML、JSON 格式输出、多站点切换等功能，适合需要批量处理或自动化脚本管理的场景。

能做什么

• 管理多站点配置，快速切换不同 Ghost 博客
• 创建、编辑、发布、定时发布文章和页面
• 批量操作草稿与已发布内容
• 上传图片并获取 CDN 链接
• 管理标签、Webhook 订阅及站点设置
• 从 Markdown 文件或标准输入直接创建内容

使用说明

安装步骤

1. 确保系统已安装 Node.js 16+ 环境
2. 执行全局安装：npm install -g @openclaw/ecto
3. 验证安装：ecto --version

首次配置

1. 在 Ghost 后台生成 Admin API Key
2. 添加站点凭证：ecto auth add myblog --url https://your-blog.ghost.io --key <admin-api-key>
3. 设为默认站点：ecto auth default myblog

常用操作

• 查看文章列表：ecto posts --status published --limit 10
• 从 Markdown 创建文章：ecto post create --title "标题" --markdown-file ./content.md --tag 技术 --status draft
• 管道输入创建：cat article.md | ecto post create --title "快速发布" --stdin-format markdown
• 定时发布：ecto post schedule my-post-slug --at "2025-03-15T08:00:00Z"
• 切换站点操作：ecto posts --site blog2 --json

输入与输出

见下方输入与输出表格。

风险提示

• Admin API Key 拥有写权限，需妥善保管避免泄露
• 删除操作默认有确认提示，加 --force 会直接执行不可逆删除
• 定时发布时间须为 ISO 8601 格式且为将来时间
• Ghost API 不支持列出已上传图片，需自行记录图片 ID
• 用户管理为只读模式，无法修改成员信息

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/visionik/ecto/SKILL.md
来源类型：开源项目文档