contentful-api-contentful-skills

1. 基本信息

项目	内容
名称	contentful-api-contentful-skills
作者/维护者	Contentful Inc.（官方仓库）
来源链接	https://github.com/contentful/skills/tree/main/skills/contentful-api
许可证	MIT（数据来自 GitHub API）
GitHub Stars	36（数据来自 GitHub API；这是整个 7 技能合集仓库的数字，不代表本子技能自身热度）
Forks	2（数据来自 GitHub API）
最新版本	v2.4.1（据仓库发布记录，近一周内发布）
安装方式	Claude Code 插件市场一条命令，或通用 CLI `npx skills add`

2. 功能介绍与亮点

contentful-api 是 Contentful（知名 headless CMS 厂商）官方出品的语言无关 API 参考技能，把 CMA（内容增删改查与发布）、CDA（查询/分页/本地化/增量同步）、Preview API、Images API（URL 参数图片变换）、GraphQL API 五套接口的鉴权方式与调用规范整理成结构化参考，示例全部是不依赖框架的 curl 命令，可直接照抄验证。

它是 Contentful 官方 7 技能合集（另含 Next.js 集成、内容迁移、自定义 App 开发、个性化实验）中最基础的一个，由公司内部工程师维护，近一周内发布两个版本（v2.4.0、v2.4.1）。

3. 适用场景

所属分类：集成与工作流自动化

适合以下人群：

需要把 Contentful 集成进项目、但不熟悉其 REST/GraphQL API 细节的 Web 开发者
需要编写自定义脚本或后端逻辑调用 Contentful API（不局限于 Next.js）的开发者
需要快速对照 CDA/CMA/Preview/Images/GraphQL 适用场景的技术团队

4. 跨 Agent 兼容性

Claude Code：✅ 原生支持——插件市场一条命令安装
Codex：✅ 原生支持——官方文档列出通用 CLI 支持 OpenAI Codex
OpenClaw / Hermes Agent：未验证——官方文档未提及

5. 推荐理由

它把 Contentful 五套 API 的认证方式、HTTP 约定、查询语法整理成结构化参考，AI 助手照着 curl 示例就能写出正确请求，不用来回翻官方文档。安装即用、不含任何可执行脚本，对刚接触 Contentful 的中初级开发者几乎零学习成本。

6. 评分

维度	分数	说明
受欢迎程度	8	Contentful 是知名 headless CMS 厂商，本技能由其官方仓库出品并持续快速迭代（v2.4.0、v2.4.1 均在近一周内发布）
可用性	9	Claude Code 插件市场一条命令即可安装，也可用通用 CLI 装到 Codex 等平台；文档含完整 curl 示例；近一周内多次发版，维护活跃
安全性	9	见下方检查清单

安全检查清单：

检查项	结果
① shell 命令与权限范围	该子技能本身不含任何可执行脚本，只有 SKILL.md 与 Markdown 参考文档
② 运行时联网外发	文档中的 curl 示例需用户主动执行才会联网；配套 MCP 服务器需用户显式配置后才连接官方 mcp.contentful.com，无隐蔽外联
③ API key/凭据	使用时需用户自备 Contentful 平台生成的 token，凭据由用户在自己环境中管理，仓库不涉及凭据存储或回传
④ 可疑指令	未发现 prompt 注入、混淆代码或隐蔽外发迹象
⑤ 作者信誉	Contentful Inc. 官方仓库，提交与 PR 均来自公司内部工程师账号，记录清晰可查
⑥ License	MIT，版权声明明确
⑦ 最近维护	近一周内两次发版（v2.4.0、v2.4.1），活跃维护

7. 跟同类 Skills 相比的优势

项目	定位	与本技能的差异
Supabase 官方 Agent Skills（supabase/agent-skills）	面向 Supabase 一站式后端平台（数据库+认证+存储+边缘函数）的官方集成技能	覆盖整个后端平台而非单一 CMS；不涉及内容建模、内容分发 API、多语言本地化等 CMS 专属场景
MongoDB Schema Design（mongodb/agent-skills）	官方出品，聚焦 MongoDB 文档数据库的 schema 设计最佳实践	只解决数据建模一个环节，不提供 REST/GraphQL 内容分发、预览模式、图片处理等 CMS 全生命周期能力

8. 用户评价

该技能目前在第三方平台尚无具名用户评价。

9. 其他补充

该技能是 Contentful 官方 7 技能合集的一部分，其余技能覆盖 Next.js 集成、内容迁移、自定义 App 开发与个性化实验；基于开放的 agentskills.io 规范。

10. 安装使用方式

Claude Code 插件市场：

/plugin marketplace add contentful/skills
/plugin install contentful@contentful

安装后运行 /reload-plugins 激活，同时会注册 contentful-mcp 等 MCP 服务器。

通用 CLI（Codex、Gemini CLI、GitHub Copilot 等平台通用）：

npx skills add contentful/skills --skill contentful-api

Cursor：Cursor Directory 安装 Contentful 插件，或 Settings → Rules → Add Rule → Remote Rule (GitHub) 填入 contentful/skills。

首次使用前需在自己的 Contentful 账号生成对应 API Token，本技能不提供也不存储凭据。

11. 注意事项

完全不了解 Contentful 概念的用户建议先看合集中的 contentful-guide 打底
OpenClaw、Hermes Agent 兼容性未验证，需自行确认
只需 API 参考文档可仅单独安装 contentful-api，无需装完整插件与 MCP 服务器