mcpField
C
contentful-api

contentful-api

github.com/contentfulDevelopment39391 installsUpdated 1d ago
Repository

About contentful-api

contentful-api is a language-agnostic guide to Contentful APIs using HTTP and curl. It helps developers manage content and retrieve published or preview content through reference material for REST, images, and GraphQL APIs.

Key features

  1. 01Content Management API reference
  2. 02Content Delivery and Preview guidance
  3. 03Content types, entries, assets, and environments
  4. 04Querying, localization, and synchronization
  5. 05Images and GraphQL API references

Use cases

  1. 01Create and publish a Contentful entry
  2. 02Define or update a content model
  3. 03Fetch localized published content
  4. 04Transform images with URL parameters

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/contentful/skills --skill contentful-api

After installing, type/contentful-apiin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

package.json
references/
authentication.md
http-conventions.md
references/content-delivery/
includes-links.md
localization.md
overview.md
querying.md
sync.md
references/content-management/
assets.md
bulk-actions.md
content-types.md
entries.md
environments.md
overview.md
references/content-preview/
overview.md
references/graphql/
overview.md
references/images/
overview.md

Details

From the project README

Contentful REST API Guide

Language-agnostic guide for Contentful APIs using HTTP/curl.

Shared References

  • Authentication — Token types, auth headers, API base URLs (US/EU)
  • HTTP Conventions — Version locking, rate limits, pagination, errors, locale structure

Content Management API (CMA)

Read/write API for managing content, content types, assets, and environments.

Start here: references/content-management/overview.md

  • entries.md — CRUD, publish/unpublish, versioning, query parameters
  • content-types.md — Define/update content models, field types, validations
  • assets.md — Upload, process, publish media files
  • environments.md — Create, clone, manage environments and aliases

Content Delivery API (CDA)

Read-only API for fetching published content.

Start here: references/content-delivery/overview.md

Content Preview API

Draft + published content via same CDA endpoints, different host/token.

Reference: references/content-preview/overview.md

Images API

On-the-fly image transformations via URL parameters. No authentication needed.

Reference: references/images/overview.md

GraphQL API

Query content via GraphQL with CDA tokens.

Reference: references/graphql/overview.md

Quick Reference

# CMA: Create a draft entry
curl -X POST https://api.contentful.com/spaces/{space_id}/environments/{env_id}/entries \
  -H "Authorization: Bearer {cma_token}" \
  -H "Content-Type: application/vnd.contentful.management.v1+json" \
  -H "X-Contentful-Content-Type: blogPost" \
  -d '{"fields":{"title":{"en-US":"Hello"}}}'
# Then publish: PUT .../entries/{id}/published with X-Contentful-Version header

# CDA: Fetch entries
curl "https://cdn.contentful.com/spaces/{space_id}/environments/{env_id}/entries?content_type=blogPost" \
  -H "Authorization: Bearer {cda_token}"

Comments

Markdown supported