Prismic Automation

Prismic Automation

技能概述

通过 Claude Code 直接管理和自动化 Prismatic 无头 CMS 操作，支持文档查询、内容搜索、自定义类型检查和仓库引用管理。

适用场景

1. 自动化内容管理

无需手动登录 Prismic 控制台，直接通过对话界面查询文档、搜索内容、更新内容版本。适合需要频繁检查内容状态或批量操作文档的内容管理员和开发者。

2. 多语言内容检索

通过 Prismic Automation 可以轻松查询不同语言版本的内容，支持按语言过滤文档。适合管理多语言网站或需要处理本地化内容的团队。

3. 内容模型检查和调试

快速查看 Prismic 仓库中定义的所有自定义类型（Custom Types），了解文档结构，帮助开发者排查内容显示问题或验证 API 返回的字段。

核心功能

1. 灵活的文档查询

支持使用 Prismic 谓词语法进行复杂查询，可按文档类型、标签、自定义字段等多种条件过滤。提供分页支持，每页最多可获取 100 个文档，适合大规模内容检索。

2. 全文搜索功能

在所有文档的所有文本字段中进行全文搜索，不区分大小写，支持词根匹配。适合快速查找包含特定关键词的内容，无需了解复杂的查询语法。

3. 仓库引用管理

获取和管理 Prismic 仓库的引用（Refs），包括主引用和发布版本引用。引用是内容查询的关键，每个内容操作都需要有效的引用令牌。

常见问题

Prismic Automation 需要什么配置？

使用前需要在 Claude Code 配置中添加 Composio MCP 服务器地址 https://rube.app/mcp，然后连接您的 Prismic 账户。首次使用内容查询功能时，需要先调用获取仓库信息的 API 来获取引用令牌。

为什么查询文档总是失败？

最常见的原因是缺少 ref 参数。Prismic API 要求所有内容查询都必须包含有效的引用令牌（通常是主引用）。在使用 PRISMIC_CONTENT_API_QUERY_DOCUMENTS 等工具前，请先调用 PRISMIC_REPOSITORY_API_GET_REFS 或 PRISMIC_REPOSITORY_API_GET_INFO 获取当前可用的引用。

谓词查询语法怎么写？

Prismic 使用双方括号的谓词语法，例如 [[at(document.type, "blog_post")]] 查询特定类型的文档。多个条件可以组合使用：[[at(document.type, "blog")][at(document.tags, ["featured"])]] 同时过滤类型和标签。完整的谓词语法可以参考 Prismic 官方文档。