Prismic Automation 用于在 Claude Code 中管理 Prismic 无头 CMS,基于 Composio 的 Prismic 工具集实现文档查询、内容搜索、自定义类型查看以及仓库 ref(内容版本引用)操作。
用途 该技能把 Prismic 的 Content API、Repository API 与 Types API 操作封装为可由智能体调用的工具,适合在开发或内容维护过程中直接通过自然语言提示检索仓库元数据、定位文档并读取内容模型,而无需切换到 Prismic 后台或手写 API 请求。
主要能力
- 仓库信息与 refs:通过 PRISMIC_REPOSITORY_API_GET_INFO 和 PRISMIC_REPOSITORY_API_GET_REFS 获取仓库元数据,包括可用 refs(内容版本)、自定义类型、语言、标签和书签;无需参数。
- 谓词查询文档:使用 PRISMIC_CONTENT_API_QUERY_DOCUMENTS,支持 ref(必填)、q 谓词(如 [[at(document.type, "page")]])、page 与 pageSize(1-100)、lang、orderings、fetch 字段裁剪和 fetchLinks 内联解析关联文档字段。
- 按类型获取文档:使用 PRISMIC_GET_DOCUMENTS_BY_TYPE,自动解析 master ref,支持 type(必填)、分页、语言、排序,以及超过第 50 页时使用的 after 游标分页。
- 全文搜索:使用 PRISMIC_CONTENT_API_GET_DOCUMENTS_WITH_FULLTEXT_SEARCH,对文档所有文本字段进行不区分大小写的词根匹配搜索,谓词如 [[fulltext(document, "machine learning")]],并支持分页、语言和排序。
- 按 ID 获取单篇文档:使用 PRISMIC_GET_DOCUMENT_BY_ID,需要 document_id 与 ref,可选 lang。
- 列出自定义类型:使用 PRISMIC_TYPES_API_GET_TYPES,支持 limit、page 和 sort(如按 name)查看仓库中定义的内容模型及其结构。
- 集成字段查询:PRISMIC_CONTENT_API_GET_DOCUMENTS_WITH_INTEGRATION_FIELDS 需要额外的 integrationFieldsRef 配合标准内容 ref 使用。
使用方式 先将 Composio MCP 服务器 https://rube.app/mcp 添加到配置,再按提示连接 Prismic 账户,智能体会给出认证链接。多数内容查询需要 ref 令牌,因此应先调用 PRISMIC_REPOSITORY_API_GET_REFS 或 PRISMIC_REPOSITORY_API_GET_INFO 获取 master ref,再执行文档查询。示例提示包括“获取我的 Prismic 仓库信息和当前 master ref”“查询所有已发布的英文博客文章并按日期降序排序”“获取全部 blog_post 文档,每页 20 条”“搜索所有 Prismic 文档中的 machine learning”“获取 Prismic 文档 Xx2KLhEAAJljVWaA”“列出仓库中所有自定义类型”等。
适用场景 适合在 Claude Code 工作流中检索 Prismic 内容、按内容模型批量拉取文档、进行全文查找、核对仓库语言与版本信息,以及为后续内容处理准备文档数据。
限制与注意事项 内容查询必须携带有效 ref,缺失会导致查询失败;谓词语法要求双中括号,多条件需在同一双中括号内依次书写,如 [[at(document.type, "blog")][at(document.tags, ["featured"])]];基于页码的分页在第 50 页之后可能失败,深度分页应使用 after 参数并传入上一结果集的最后文档 ID;pageSize 最大为 100,超过会被拒绝;语言过滤默认值为 *(全部语言),指定语言时应显式传入 lang(如 en-us、fr-fr);集成字段查询需要单独的 integrationFieldsRef。该技能的收费、支持平台及其他运行限制暂未提供。