⚡

Prismic自动化技能Skill PrismicAutomation

这个技能用于自动化Prismic无头内容管理系统（CMS）的操作，通过Composio工具链实现高效内容管理。核心功能包括查询文档、全文搜索内容、检索自定义类型、管理仓库引用，适用于Web开发、内容发布和DevOps工作流。关键词：Prismic, CMS, 无头CMS, 内容管理, 自动化, API集成, DevOps工具, 软件开发。

DevOps 0 次安装 0 次浏览 更新于 3/12/2026

name: Prismic自动化 description: “通过Composio Prismic集成自动化Prismic无头CMS操作——查询文档、搜索内容、检索自定义类型和管理仓库引用。” requires: mcp: - rube

Prismic自动化

直接在Claude Code中管理您的Prismic无头CMS。按类型查询文档、全文搜索内容、检查自定义类型，并为内容版本控制处理仓库引用。

工具包文档: composio.dev/toolkits/prismic

设置

  1. 将Composio MCP服务器添加到您的配置中：
    https://rube.app/mcp
  2. 当提示时连接您的Prismic账户。代理将提供一个身份验证链接。
  3. 大多数内容查询需要一个ref令牌。始终先调用PRISMIC_REPOSITORY_API_GET_REFS或PRISMIC_REPOSITORY_API_GET_INFO来获取主引用。

核心工作流程

1. 获取仓库信息和引用

检索全面的仓库元数据，包括可用引用（内容版本）、自定义类型、语言、标签和书签。这通常是您的第一个API调用。

工具: PRISMIC_REPOSITORY_API_GET_INFO, PRISMIC_REPOSITORY_API_GET_REFS

无需参数——这些端点返回完整的仓库配置。refs字段至关重要，因为所有内容查询都需要引用。

示例提示: “获取我的Prismic仓库信息和当前主引用”

2. 使用谓词查询文档

使用Prismic的谓词查询语法获取文档，支持完整分页和过滤。

工具: PRISMIC_CONTENT_API_QUERY_DOCUMENTS

关键参数:

  • ref (必需) —— 内容发布引用ID（通常是主引用）
  • q —— 谓词查询，例如[[at(document.type, "page")]]
  • page (最小1) 和 pageSize (1-100) —— 分页
  • lang —— 语言代码，例如en-us（默认为*表示所有语言）
  • orderings —— 排序顺序，例如[my.article.date desc]
  • fetch —— 逗号分隔的要获取的字段，减少响应大小
  • fetchLinks —— 内联解析链接文档字段

示例提示: “查询Prismic中所有已发布的博客文章，按日期降序排序，使用英语”

3. 按类型获取文档

检索特定自定义类型的所有文档，自动解析主引用。

工具: PRISMIC_GET_DOCUMENTS_BY_TYPE

关键参数:

  • type (必需) —— 自定义类型API ID，例如blog_post, article, page
  • page (默认1) 和 pageSize (1-100, 默认20)
  • lang —— 语言代码过滤器
  • orderings —— 排序顺序，例如[my.article.date desc]
  • after —— 基于游标的分页，用于超出第50页的深度分页

示例提示: “获取Prismic中所有blog_post文档，每页20个”

4. 全文搜索

在所有文档的文本字段中搜索指定术语。不区分大小写，匹配根词。

工具: PRISMIC_CONTENT_API_GET_DOCUMENTS_WITH_FULLTEXT_SEARCH

关键参数:

  • q (必需) —— 全文谓词，例如[[fulltext(document, "机器学习")]]
  • page, pageSize, lang, orderings —— 与其他查询相同的分页/过滤参数

示例提示: “搜索所有Prismic文档中的’机器学习’”

5. 按ID获取单个文档

通过其唯一标识符检索特定文档。

工具: PRISMIC_GET_DOCUMENT_BY_ID

关键参数:

  • document_id (必需) —— 唯一文档标识符
  • ref (必需) —— 仓库中的内容引用
  • lang —— 可选语言过滤器

示例提示: “获取Prismic文档Xx2KLhEAAJljVWaA”

6. 列出自定义类型

发现仓库中定义的所有自定义类型（内容模型），包括其结构定义。

工具: PRISMIC_TYPES_API_GET_TYPES

关键参数:

  • limit —— 每页返回的最大类型数
  • page —— 页码（1起始）
  • sort —— 排序顺序，例如name

示例提示: “列出我的Prismic仓库中的所有自定义类型”

已知陷阱

  • 所有内容查询都需要引用: 在查询任何文档之前，您必须从PRISMIC_REPOSITORY_API_GET_REFS或PRISMIC_REPOSITORY_API_GET_INFO获取有效的ref（通常是主引用）。没有引用的查询将失败。
  • 谓词语法需要双括号: Prismic查询使用双方括号：[[at(document.type, "page")]]。对于多个谓词，组合它们：[[at(document.type, "blog")][at(document.tags, ["featured"])]]。
  • 深度分页限制: 标准基于页面的分页可能在超过第50页时失败。对于深度分页，使用after参数与先前结果集中的最后一个文档ID。
  • pageSize上限为100: 请求每页超过100个文档将被拒绝。使用分页迭代更大的结果集。
  • 语言过滤: 默认语言过滤器是*（所有语言）。如果您需要特定语言的文档，始终显式传递lang（例如en-us, fr-fr）。
  • 集成字段需要单独的引用: 当使用PRISMIC_CONTENT_API_GET_DOCUMENTS_WITH_INTEGRATION_FIELDS时，除了标准内容ref外，还需要一个integrationFieldsRef。

快速参考

工具标识 描述
PRISMIC_REPOSITORY_API_GET_INFO 获取仓库元数据、引用、类型、语言
PRISMIC_REPOSITORY_API_GET_REFS 列出所有引用（主引用 + 发布版本）
PRISMIC_TYPES_API_GET_TYPES 列出所有自定义类型 / 内容模型
PRISMIC_CONTENT_API_QUERY_DOCUMENTS 使用谓词和分页查询文档
PRISMIC_GET_DOCUMENTS_BY_TYPE 按自定义类型过滤获取文档
PRISMIC_GET_DOCUMENT_BY_ID 通过ID检索单个文档
PRISMIC_CONTENT_API_GET_DOCUMENTS_WITH_FULLTEXT_SEARCH 在所有文档中进行全文搜索
PRISMIC_CONTENT_API_GET_DOCUMENTS_WITH_PREDICATES 使用多个谓词条件过滤文档
PRISMIC_CONTENT_API_GET_DOCUMENTS_WITH_INTEGRATION_FIELDS 获取包含集成字段数据的文档
PRISMIC_GET_DOCUMENTS_ORDERED 获取按指定字段排序的文档

由Composio提供支持