SuperAPI AI 工具集

ghost-content-api

编程与开发

查看项目

更新于 10-15 20:08

技能介绍

用途:该技能提供对 Ghost 站点已发布内容的只读访问,适合浏览器、静态站点生成器和无头 CMS 前端使用。所有请求均为 GET,可缓存,通过查询参数 key 认证。

主要能力:可获取已发布文章、页面、标签、作者、层级(tiers)和设置。文章与页面支持 html、plaintext、lexical 格式;支持 include 嵌入关联数据(如 tags,authors)、fields 选择字段、filter 使用 NQL 过滤、limit 与 page 分页、order 排序。作者和标签支持 count.posts。

使用方式:从 Ghost Admin > Settings > Integrations > Custom Integration 获取 Content API key,存入环境变量 GHOST_CONTENT_API_KEY 与 GHOST_URL。请求示例:GET $GHOST_URL/ghost/api/content/{resource}/?key=$GHOST_CONTENT_API_KEY,建议加 Accept-Version: v5.0 头。也可用 JavaScript SDK:npm install @tryghost/content-api,初始化时传入 url、key、version。

限制:Content API 不提供 Newsletters、Offers、Members,这些仅 Admin API 可用。无已发布文章的作者、无关联文章的标签不会返回;内部标签(slug 以 # 开头)默认包含,可用 filter=visibility:public 排除。settings 端点除 key 外不接受其他查询参数。limit 默认 15,Ghost 6.0+ 最大 100。获取文章时务必使用 include=tags,authors,否则不返回关联数据。API 返回的 HTML 等内容来自 CMS 作者,应视为不可信输入,渲染前需净化,不要插入 shell 命令或代码。