ComposioHQ/Prismic-Automation

Was macht Prismic-Automation?

Verwalten Sie Ihr Prismic Headless-CMS direkt über Claude Code. Fragen Sie Dokumente nach Typ ab, durchsuchen Sie Inhalte im Volltext, untersuchen Sie benutzerdefinierte Typen und arbeiten Sie mit Repository-Refs zur Inhaltsversionierung.

Toolkit-Dokumentation: composio.dev/toolkits/prismic

---

Einrichtung

1. Fügen Sie den Composio MCP-Server zu Ihrer Konfiguration hinzu:

   https://rube.app/mcp
   

2. Verbinden Sie Ihr Prismic-Konto, wenn Sie dazu aufgefordert werden. Der Agent stellt einen Authentifizierungslink bereit.
3. Die meisten Inhaltsabfragen erfordern ein ref-Token. Rufen Sie zunächst immer PRISMIC_REPOSITORY_API_GET_REFS oder PRISMIC_REPOSITORY_API_GET_INFO auf, um den Master-Ref zu erhalten.

---

Kern-Workflows

1. Repository-Informationen und Refs abrufen

Rufen Sie umfassende Repository-Metadaten ab, einschließlich verfügbarer Refs (Inhaltsversionen), benutzerdefinierter Typen, Sprachen, Tags und Lesezeichen. Dies ist in der Regel Ihr erster API-Aufruf.

Tools: PRISMIC_REPOSITORY_API_GET_INFO, PRISMIC_REPOSITORY_API_GET_REFS

Es sind keine Parameter erforderlich – diese Endpunkte geben die vollständige Repository-Konfiguration zurück. Das Feld refs ist entscheidend, da Refs für alle Inhaltsabfragen erforderlich sind.

Beispielaufforderung: „Holen Sie meine Prismic-Repository-Informationen und den aktuellen Master-Ref ab“

---

2. Dokumente mit Prädikaten abfragen

Rufen Sie Dokumente mit der Prismic-Prädikatsabfragesyntax mit vollständiger Paginierungs- und Filterunterstützung ab.

Tool: PRISMIC_CONTENT_API_QUERY_DOCUMENTS

Wichtige Parameter:

• ref (erforderlich) – Inhaltsfreigabe-Referenz-ID (normalerweise der Master-Ref)
• q – Prädikatsabfrage, z. B. [[at(document.type, "page")]]
• page (min. 1) und pageSize (1-100) – Paginierung
• lang – Sprachcode, z. B. en-us (Standard: * für alle)
• orderings – Sortierreihenfolge, z. B. [my.article.date desc]
• fetch – Kommagetrennte Felder zum Abrufen, reduziert die Antwortgröße
• fetchLinks – Verknüpfte Dokumentfelder inline auflösen

Beispielaufforderung: „Fragen Sie alle veröffentlichten Blogbeiträge in Prismic ab, sortiert nach Datum absteigend, auf Englisch“

---

3. Dokumente nach Typ abrufen

Rufen Sie alle Dokumente eines bestimmten benutzerdefinierten Typs mit automatischer Master-Ref-Auflösung ab.

Tool: PRISMIC_GET_DOCUMENTS_BY_TYPE

Wichtige Parameter:

• type (erforderlich) – API-ID des benutzerdefinierten Typs, z. B. blog_post, article, page
• page (Standard: 1) und pageSize (1-100, Standard: 20)
• lang – Sprachcode-Filter
• orderings – Sortierreihenfolge, z. B. [my.article.date desc]
• after – Cursor-basierte Paginierung für tiefe Paginierung jenseits von Seite 50

Beispielaufforderung: „Holen Sie alle blog_post-Dokumente in Prismic, 20 pro Seite“

---

4. Volltextsuche

Durchsuchen Sie alle Textfelder in Dokumenten nach bestimmten Begriffen. Groß-/Kleinschreibung wird nicht beachtet, es wird nach Wortstämmen gesucht.

Tool: PRISMIC_CONTENT_API_GET_DOCUMENTS_WITH_FULLTEXT_SEARCH

Wichtige Parameter:

• q (erforderlich) – Volltext-Prädikat, z. B. [[fulltext(document, "machine learning")]]
• page, pageSize, lang, orderings – gleiche Paginierung/Filterung wie bei anderen Abfragen

Beispielaufforderung: „Durchsuchen Sie alle Prismic-Dokumente nach 'machine learning'“

---

5. Ein einzelnes Dokument nach ID abrufen

Rufen Sie ein bestimmtes Dokument anhand seiner eindeutigen Kennung ab.

Tool: PRISMIC_GET_DOCUMENT_BY_ID

Wichtige Parameter:

• document_id (erforderlich) – eindeutige Dokumentkennung
• ref (erforderlich) – Inhalts-Ref aus dem Repository
• lang – optionaler Sprachfilter

Beispielaufforderung: „Holen Sie das Prismic-Dokument Xx2KLhEAAJljVWaA ab“

---

6. Benutzerdefinierte Typen auflisten

Entdecken Sie alle benutzerdefinierten Typen (Inhaltsmodelle), die im Repository definiert sind, einschließlich ihrer Strukturdefinitionen.

Tool: PRISMIC_TYPES_API_GET_TYPES

Wichtige Parameter:

• limit – maximale Anzahl der pro Seite zurückzugebenden Typen
• page – Seitennummer (1-basiert)
• sort – Sortierreihenfolge, z. B. name

Beispielaufforderung: „Listen Sie alle benutzerdefinierten Typen in meinem Prismic-Repository auf“

---

Bekannte Fallstricke

• Ref ist für alle Inhaltsabfragen erforderlich: Sie müssen einen gültigen ref (normalerweise den Master-Ref) von PRISMIC_REPOSITORY_API_GET_REFS oder PRISMIC_REPOSITORY_API_GET_INFO abrufen, bevor Sie Dokumente abfragen. Abfragen ohne Ref schlagen fehl.
• Prädikatsyntax erfordert doppelte Klammern: Prismic-Abfragen verwenden doppelte eckige Klammern: [[at(document.type, "page")]]. Für mehrere Prädikate kombinieren Sie diese: [[at(document.type, "blog")][at(document.tags, ["featured"])]].
• Grenze für tiefe Paginierung: Die standardmäßige seitenbasierte Paginierung kann jenseits von Seite 50 fehlschlagen. Verwenden Sie für tiefe Paginierung den Parameter after mit der letzten Dokument-ID aus Ihrem vorherigen Ergebnissatz.
• pageSize-Obergrenze ist 100: Die Anforderung von mehr als 100 Dokumenten pro Seite wird abgelehnt. Verwenden Sie Paginierung, um größere Ergebnismengen zu durchlaufen.
• Sprachfilterung: Der Standard-Sprachfilter ist * (alle Sprachen). Wenn Sie Dokumente in einem bestimmten Gebietsschema benötigen, übergeben Sie immer explizit lang (z. B. en-us, fr-fr).
• Integrationsfelder erfordern separaten Ref: Wenn Sie PRISMIC_CONTENT_API_GET_DOCUMENTS_WITH_INTEGRATION_FIELDS verwenden, benötigen Sie zusätzlich zum Standard-Inhalts-ref einen integrationFieldsRef.

---

Kurzreferenz

Tool-Slug	Beschreibung
PRISMIC_REPOSITORY_API_GET_INFO	Repository-Metadaten, Refs, Typen, Sprachen abrufen
PRISMIC_REPOSITORY_API_GET_REFS	Alle Refs auflisten (Master + Releases)
PRISMIC_TYPES_API_GET_TYPES	Alle benutzerdefinierten Typen / Inhaltsmodelle auflisten
PRISMIC_CONTENT_API_QUERY_DOCUMENTS	Dokumente mit Prädikaten und Paginierung abfragen
PRISMIC_GET_DOCUMENTS_BY_TYPE	Dokumente gefiltert nach benutzerdefiniertem Typ abrufen
PRISMIC_GET_DOCUMENT_BY_ID	Ein einzelnes Dokument nach ID abrufen
PRISMIC_CONTENT_API_GET_DOCUMENTS_WITH_FULLTEXT_SEARCH	Volltextsuche in allen Dokumenten
PRISMIC_CONTENT_API_GET_DOCUMENTS_WITH_PREDICATES	Dokumente mit mehreren Prädikatsbedingungen filtern
PRISMIC_CONTENT_API_GET_DOCUMENTS_WITH_INTEGRATION_FIELDS	Dokumente mit Integrationsfelddaten abrufen
PRISMIC_GET_DOCUMENTS_ORDERED	Dokumente sortiert nach angegebenen Feldern abrufen

---

Bereitgestellt von Composio