SuperAPI AI 工具集

Contentful Automation

办公与效率

查看项目

更新于 10-16 06:26

技能介绍

Contentful Automation 是一个用于在 Claude Code 中管理 Contentful 无头 CMS 空间的自动化技能,由 Composio 提供支持。它让用户可以直接在终端中完成空间级别的管理操作,无需切换到 Contentful 网页界面。

用途 该技能面向需要管理 Contentful 空间元数据的用户,主要解决空间发现、信息查看和空间重命名等需求。它适合在开发或运维流程中快速审计组织内的 Contentful 空间,或对空间名称进行批量调整。

主要能力 技能提供三个核心工具:

  1. CONTENTFUL_LIST_SPACES:列出当前认证账户可访问的所有 Contentful 空间。支持 limit(1-1000,默认 100)、skip(分页跳过数量)和 order(排序字段,如 sys.createdAt 或 -sys.createdAt 降序)参数。
  2. CONTENTFUL_GET_SPACE:获取指定空间的详细元数据,包括当前的 sys.version,该版本号是执行更新操作所必需的。参数 space_id 为必填,需符合字母数字及 -_. 组成的 1-64 位格式。
  3. CONTENTFUL_UPDATE_SPACE:更新指定空间的名称。需要提供 space_id、新的 name(1-255 字符)以及当前 version(来自 sys.version,必须大于 0),用于乐观锁控制,防止并发修改冲突。

使用方式 首先需要将 Composio MCP 服务器添加到配置中,地址为 https://rube.app/mcp。连接 Contentful 账户时,代理会提供认证链接,用户需确保访问令牌具备空间管理权限。之后即可通过自然语言提示调用上述工具,例如“列出我所有的 Contentful 空间”“获取空间 abc123def 的详情”“将空间 abc123def 重命名为 'Production Content Hub'”。

适用场景

  • 空间清单审计:结合列表和详情工具,列出所有空间及其创建日期、当前版本等信息。
  • 空间重命名:在需要调整空间名称时,先获取最新版本号再执行更新。
  • 分页浏览大量空间:当空间数量较多时,通过递增 skip 参数遍历所有结果。

限制

  • 这些工具仅管理空间级别的元数据(名称),无法创建或修改空间内的条目、内容类型或资产。
  • 更新操作依赖最新的 sys.version,若在读取和写入之间空间被他人修改,更新将因版本冲突而失败,因此建议在更新前立即获取空间信息。
  • 令牌权限不足时,即使读取成功,更新也会失败,需确认令牌具有写入权限。
  • space_id 必须匹配 ^[a-zA-Z0-9-_.]{1,64}$ 格式,无效字符会被拒绝。
  • 分页时需注意 limit 和 skip 的配合,避免遗漏空间。