webflow/webflow-skills

Bulk CMS Update (Massenaktualisierung von CMS-Elementen)

Erstellen oder aktualisieren Sie mehrere CMS-Elemente mit umfassender Validierung, detaillierter Genehmigung und Rollback-Funktion.

Wichtiger Hinweis

Verwenden Sie für alle Operationen AUSSCHLIESSLICH die Webflow MCP-Tools:

• Verwenden Sie das Webflow MCP data_sites_tool mit Aktion list_sites, um verfügbare Sites aufzulisten
• Verwenden Sie das Webflow MCP data_cms_tool mit Aktion get_collection_list, um CMS-Collections aufzulisten
• Verwenden Sie das Webflow MCP data_cms_tool mit Aktion get_collection_details, um Collection-Schemata abzurufen
• Verwenden Sie das Webflow MCP data_cms_tool mit Aktion list_collection_items, um vorhandene Elemente abzurufen
• Verwenden Sie das Webflow MCP data_cms_tool mit Aktion create_collection_items, um Elemente zu erstellen (Entwurf oder veröffentlicht)
• Verwenden Sie das Webflow MCP data_cms_tool mit Aktion update_collection_items, um Elemente zu aktualisieren (Entwurf oder veröffentlicht)
• Verwenden Sie das Webflow MCP data_cms_tool mit Aktion publish_collection_items, um Entwurfselemente zu veröffentlichen
• Verwenden Sie das Webflow MCP webflow_guide_tool, um Best Practices vor Beginn zu erhalten
• Verwenden Sie KEINE anderen Tools oder Methoden für Webflow-Operationen
• Alle Tool-Aufrufe müssen den erforderlichen Parameter context enthalten (15-25 Wörter, dritte Person)

Anweisungen

Phase 1: Site- & Collection-Auswahl

1. Site abrufen: Identifizieren Sie die Zielsite. Wenn der Benutzer keine Site-ID angibt, fragen Sie danach.
2. Collections auflisten: Verwenden Sie das Webflow MCP data_cms_tool mit Aktion get_collection_list, um verfügbare Collections anzuzeigen.
3. Benutzer zur Auswahl der Collection auffordern: Der Benutzer gibt an, mit welcher Collection gearbeitet werden soll.
4. Collection-Schema abrufen: Verwenden Sie das Webflow MCP data_cms_tool mit Aktion get_collection_details, um Folgendes abzurufen:
   • Alle Felddefinitionen mit Typen
   • Erforderliche vs. optionale Felder
   • Feldvalidierungen (maximale Länge, Muster usw.)
   • Ziele von Referenzfeldern

Phase 2: Datenerfassung & -analyse

5. Operationstyp erfragen: Klären Sie, was der Benutzer tun möchte:

   • Nur neue Elemente erstellen
   • Nur vorhandene Elemente aktualisieren
   • Sowohl erstellen als auch aktualisieren

6. Daten vom Benutzer empfangen: Akzeptieren Sie Daten in flexiblen Formaten:

   • Strukturiertes Format (JSON-ähnlich)
   • Beschreibungen in natürlicher Sprache
   • CSV-ähnliche Daten
   • Aufzählungslisten

7. Analysieren und normalisieren: Konvertieren Sie Benutzerdaten in ein strukturiertes Format.

8. Vorhandene Elemente abrufen (falls Aktualisierungen erforderlich): Verwenden Sie das Webflow MCP data_cms_tool mit Aktion list_collection_items, um aktuelle Daten zu erhalten.

   WICHTIG - Effiziente Elementsuche:

   • Verwenden Sie bei der Suche nach bestimmten Elementen anhand des Namens IMMER den Parameter name, um zu filtern (z. B. name: "Pikachu")
   • Verwenden Sie bei der Suche nach Slug den Parameter slug, um zu filtern
   • Rufen Sie NIEMALS zuerst alle Elemente ab und durchsuchen Sie dann die Ergebnisse – das verschwendet API-Aufrufe und Tokens
   • Rufen Sie die vollständige Liste nur ab, wenn Sie alle Elemente anzeigen müssen oder nicht wissen, welche bestimmten Elemente Sie anvisieren sollen

Phase 3: Validierung & Analyse

9. Alle Daten validieren:
   • Feldnamen: Überprüfen Sie, ob alle Feldnamen im Schema vorhanden sind.
   • Erforderliche Felder: Stellen Sie sicher, dass alle erforderlichen Felder angegeben sind.
   • Feldtypen: Überprüfen Sie, ob die Datentypen mit dem Schema übereinstimmen.
   • Einschränkungen: Überprüfen Sie maximale Längen, Muster, zulässige Werte.
   • Slugs: Stellen Sie sicher, dass Slugs eindeutig und gültig sind.
   • Referenzfelder: Überprüfen Sie, ob referenzierte Elemente existieren.
10. Konflikte erkennen:
    • Doppelte Slugs (innerhalb des Batches oder mit vorhandenen Elementen)
    • Fehlende erforderliche Felder
    • Ungültige Datentypen
    • Verletzungen von Einschränkungen
11. Auswirkungen analysieren:
    • Anzahl der Erstellungen vs. Aktualisierungen
    • Identifizieren, welche Felder sich ändern werden
    • Batch-Größe und Verarbeitungszeit berechnen

Phase 4: Vorschau & detaillierte Genehmigung

12. Detaillierte Vorschau generieren:
    • Jedes Element mit Validierungsstatus anzeigen
    • Warnungen bei Problemen anzeigen
    • Bei Aktualisierungen Diffs anzeigen (alt → neu)
    • Bei Erstellungen alle Feldwerte anzeigen
    • Jedes Element zur selektiven Genehmigung nummerieren
13. Optionen für detaillierte Genehmigung anzeigen:
    • Dem Benutzer erlauben, bestimmte Elemente zur Verarbeitung auszuwählen
    • Optionen: "Alle", "Keine", bestimmte Nummern, Nummernbereiche
    • Geschätzte Verarbeitungszeit anzeigen
14. Veröffentlichungsoptionen anbieten:
    • Sofort veröffentlichen (Endpunkte *_live verwenden)
    • Als Entwürfe erstellen (reguläre Endpunkte + manuelle Veröffentlichung verwenden)

Phase 5: Ausführung & Berichterstattung

15. Rollback-Daten speichern: Vor allen Änderungen Folgendes speichern:
    • Ursprüngliche Werte für alle aktualisierten Elemente
    • Zeitstempel
    • Vorgangsdetails
16. In Batches verarbeiten:
    • Maximal 50 Elemente pro Batch
    • Fortschrittsanzeige anzeigen
    • Ratenbegrenzungen elegant handhaben
17. Operationen ausführen: Je nach Benutzerwahl die entsprechenden Webflow MCP-Tools verwenden.
18. Fehler elegant behandeln:
    • Bei einzelnen Elementfehlern mit der Verarbeitung fortfahren
    • Erfolge und Fehler getrennt verfolgen
    • Detaillierte Fehlermeldungen anzeigen
19. Umfassenden Bericht erstellen:
    • Zusammenfassung (Anzahl Erfolge/Fehler)
    • Detaillierte Ergebnisse pro Element
    • Element-IDs für erstellte/aktualisierte Elemente
    • Fehlerdetails für fehlgeschlagene Elemente
20. Rollback-Option anbieten: Dem Benutzer erlauben, Änderungen bei Bedarf rückgängig zu machen.

Beispiele

Benutzeraufforderung:

Füge 2 Blogbeiträge über Webflow MCP hinzu und aktualisiere den ersten Blog, sodass dort „Top" statt „Best" steht.

Schritt 1: Site- & Collection-Auswahl

📋 Bulk CMS Update Einrichtung

Verfügbare Sites:
1. MCP Demo#1
2. MCP Demo#2
3. MCP Demo#3

Bitte wählen Sie eine Site (1-3):

Benutzer wählt: 1

Verfügbare Collections in MCP Demo#1:
└── Blogbeiträge (9 Elemente)
    Felder: name, slug, post-body, post-summary, main-image, thumbnail-image, featured, color

Mit der Collection „Blogbeiträge" fortfahren? (ja/nein)

Benutzer bestätigt: ja

Schritt 2: Datenerfassung

🔍 Collection-Schema: Blogbeiträge

Erforderliche Felder:
- name (PlainText, max. 256 Zeichen)
- slug (PlainText, max. 256 Zeichen, nur alphanumerisch)

Optionale Felder:
- post-body (RichText)
- post-summary (PlainText)
- main-image (Image)
- thumbnail-image (Image)
- featured (Switch, true/false)
- color (Color, Hex-Format)

Ich analysiere Ihre Anfrage:
- 2 neue Beiträge über Webflow MCP erstellen
- Ersten Beitrag aktualisieren: "Best" → "Top"

Generiere Elemente...

Schritt 3: Validierung & Vorschau

📋 Vorschau: Bulk CMS Update

Collection: Blogbeiträge
Operationen: 2 Elemente erstellen + 1 Element aktualisieren

---

### 🆕 Zu erstellende Elemente (2)

[1] ✓ NEUER BEITRAG
    name: "Webflow MCP: Die Zukunft der Webentwicklung"
    slug: "webflow-mcp-zukunft-webentwicklung"
    post-summary: "Entdecken Sie, wie Webflow MPC die..."
    post-body: "<h1>Die Zukunft ist da</h1><p>..."
    featured: true
    color: "#9B59B6"
    ✅ Alle Validierungen bestanden

[2] ✓ NEUER BEITRAG
    name: "Warum Webflow MCP Ihren Workflow im Jahr 2026 verändern wird"
    slug: "webflow-mcp-workflow-veraenderung-2026"
    post-summary: "Erfahren Sie, wie die Integration von Webflow MCP..."
    post-body: "<h1>Verändern Sie Ihren Workflow</h1><p>..."
    featured: true
    color: "#3498DB"
    ✅ Alle Validierungen bestanden

---

### ✏️ Zu aktualisierende Elemente (1)

[3] ✓ VORHANDENES AKTUALISIEREN
    Element-ID: 69615f84fc6ce1aa444d24d5
    Slug: warum-webflow-beste-wahl-2026-ai

    Änderungen:
      name: "Warum Webflow die beste Wahl für 2026 ist" → "Warum Webflow die Top-Wahl für 2026 ist"

    ✅ Alle Validierungen bestanden

---

**Zusammenfassung:**
- ✅ 2 Elemente werden erstellt
- ✅ 1 Element wird aktualisiert
- ⚠️ 0 Warnungen
- ❌ 0 Fehler

**Veröffentlichungsoptionen:**
1. Sofort veröffentlichen (empfohlen)
2. Als Entwürfe speichern

Welche Elemente möchten Sie verarbeiten?
- Geben Sie "Alle" ein, um alle 3 Elemente zu verarbeiten
- Geben Sie Nummern ein, um zu überspringen (z. B. "2", um Element 2 zu überspringen)
- Geben Sie "Keine" ein, um abzubrechen

Veröffentlichungsoption wählen (1/2): _
Elemente wählen: _

Benutzer wählt: 1, alle

⚠️ Sie sind dabei:
- 2 neue Blogbeiträge zu erstellen (live veröffentlicht)
- 1 vorhandenen Blogbeitrag zu aktualisieren (Änderungen live veröffentlicht)

Geben Sie "Bestätigen" ein, um fortzufahren.

Benutzer bestätigt: bestätigen

Schritt 4: Ausführung & Ergebnisse

🔄 Verarbeite Bulk-Update...

Erstelle Elemente: ██████████ 100% (2/2)
Aktualisiere Elemente: ██████████ 100% (1/1)

✅ Bulk CMS Update abgeschlossen!

---

### 🆕 Erstellte Elemente (2)

✓ [1] "Webflow MCP: Die Zukunft der Webentwicklung"
      ID: 6961640c66de07bed9aacf3e
      Slug: webflow-mcp-zukunft-webentwicklung
      Veröffentlicht: 9. Jan. 2026, 20:24 Uhr

✓ [2] "Warum Webflow MCP Ihren Workflow im Jahr 2026 verändern wird"
      ID: 6961640c66de07bed9aacf41
      Slug: webflow-mcp-workflow-veraenderung-2026
      Veröffentlicht: 9. Jan. 2026, 20:24 Uhr

---

### ✏️ Aktualisierte Elemente (1)

✓ [3] "Warum Webflow die Top-Wahl für 2026 ist"
      ID: 69615f84fc6ce1aa444d24d5
      Geändert: Titel aktualisiert
      Veröffentlicht: 9. Jan. 2026, 20:24 Uhr

---

**Zusammenfassung:**
- ✅ 2 Elemente erfolgreich erstellt
- ✅ 1 Element erfolgreich aktualisiert
- ❌ 0 Fehler
- ⏱️ Abgeschlossen in 3,2 Sekunden

**Gesamtanzahl Elemente:** 11 (vorher 9)

📋 Rollback verfügbar:
Letzte Aktualisierung: 3 Elemente gerade geändert
Geben Sie "Rückgängig" innerhalb von 5 Minuten ein, um alle Änderungen rückgängig zu machen.

Alternative: Mit Validierungswarnungen

📋 Vorschau: Bulk CMS Update

[1] ⚠️ NEUER BEITRAG
    name: "Testbeitrag"
    slug: "test"
    post-summary: "Hi"
    ⚠️ Warnung: post-summary zu kurz (< 20 Zeichen) – kann SEO beeinträchtigen
    ⚠️ Warnung: Slug zu allgemein – erwägen Sie einen aussagekräftigeren Slug
    ⚠️ Warnung: post-body fehlt – Inhalt wird leer sein
    ✅ Erforderliche Felder vorhanden (kann fortfahren)

[2] ❌ NEUER BEITRAG
    name: "Ein weiterer Beitrag!!!"
    slug: "ein weiterer beitrag"
    ❌ Fehler: Slug enthält Leerzeichen (muss alphanumerisch mit Bindestrichen sein)
    ❌ Fehler: name enthält nicht erlaubte Sonderzeichen
    🔴 Kann nicht fortfahren – beheben Sie zuerst die Fehler

---

**Zusammenfassung:**
- ✅ 1 Element kann erstellt werden (mit Warnungen)
- ❌ 1 Element hat Fehler (kann nicht erstellt werden)

Element 2 korrigieren oder überspringen? (korrigieren/überspringen)

Richtlinien

Phase 1: Kritische Anforderungen

Site- & Collection-Auswahl:

• Rufen Sie immer die tatsächliche Site-Liste mit data_sites_tool und Aktion list_sites ab
• Gehen Sie niemals von Site-IDs aus
• Zeigen Sie Collection-Namen und Elementanzahlen an
• Zeigen Sie das Feldschema an, bevor Sie Daten akzeptieren
• Bestätigen Sie die Collection-Auswahl mit dem Benutzer

Phase 2: Datenanalyse

Flexible Eingabeformate: Akzeptieren Sie Daten in mehreren Formaten:

1. Strukturiert (JSON-ähnlich):

CREATE:
- name: "Beitragstitel"
  slug: "beitrag-slug"
  featured: true

2. Natürliche Sprache:

"Füge einen Blogbeitrag namens 'Erste Schritte' mit Slug 'erste-schritte' hinzu"

3. CSV-ähnlich:

name,slug,featured
"Beitrag 1","beitrag-1",true
"Beitrag 2","beitrag-2",false

4. Aufzählungslisten:

- Beitrag 1: "Titel" (slug: titel-slug)
- Beitrag 2: "Ein anderer" (slug: ein-anderer-slug)

Analyseregeln:

• Seien Sie nachsichtig bei Formatvariationen
• Leiten Sie fehlende optionale Felder ab
• Fragen Sie bei Unklarheiten nach
• Gehen Sie niemals von Werten für erforderliche Felder aus

Effiziente Elementsuche: Verwenden Sie beim Abrufen vorhandener Elemente für Aktualisierungen Filterparameter, um API-Aufrufe zu minimieren:

# Gut – Nach Namen filtern, wenn der Elementname bekannt ist
data_cms_tool(action: "list_collection_items", collection_id, name: "Pikachu")

# Gut – Nach Slug filtern, wenn der Slug bekannt ist
data_cms_tool(action: "list_collection_items", collection_id, slug: "pikachu")

# Schlecht – Alle Elemente abrufen und dann Ergebnisse durchsuchen
data_cms_tool(action: "list_collection_items", collection_id)  # Gibt 100 Elemente zurück
# Dann manuell nach "Pikachu" in den Ergebnissen suchen...

• Verwenden Sie IMMER die Parameter name oder slug, wenn Sie nach bestimmten Elementen suchen
• Dies reduziert API-Aufrufe, Antwortgröße und Token-Nutzung
• Rufen Sie ungefilterte Listen nur ab, wenn Sie alle Elemente anzeigen oder das Ziel unbekannt ist

Phase 3: Validierungsregeln

Feldnamen-Validierung:

• Überprüfen Sie, ob alle Feldnamen im Schema vorhanden sind
• Groß-/Kleinschreibung beachten
• Korrekturen für Tippfehler vorschlagen
• Beispiel: "autor" → Meinten Sie "author"?

Erforderliche Felder:

• name und slug sind für Webflow CMS IMMER erforderlich
• Überprüfen Sie die für die Collection spezifischen erforderlichen Felder aus dem Schema
• Listen Sie alle fehlenden erforderlichen Felder deutlich auf
• Kann nicht fortfahren, wenn erforderliche Felder fehlen

Feldtyp-Validierung:

PlainText:

• Maximale Längenbeschränkungen prüfen
• Muster validieren, falls angegeben
• Kein HTML erlaubt

RichText:

• Muss gültiges HTML sein
• Auf nicht geschlossene Tags prüfen
• Allgemeine HTML-Elemente erlauben

Image/Datei:

• Datei-IDs oder URLs akzeptieren
• Existenz der Datei validieren (falls möglich)
• Optionaler Alternativtext

Switch (Boolean):

• Akzeptieren: true/false, ja/nein, 1/0
• In Boolean normalisieren

Farbe:

• Muss im Hex-Format (#RRGGBB) sein
• Hex-Zeichen validieren
• Beispiel: #FF5733 ✓, rot ✗

Referenzfelder:

• Müssen auf vorhandene Element-IDs verweisen
• Existenz referenzierter Elemente validieren
• Namen referenzierter Elemente zur Verdeutlichung anzeigen

Slug-Validierung:

• KRITISCH: Muss alphanumerisch mit Bindestrichen sein
• Keine Leerzeichen, Unterstriche oder Sonderzeichen
• Maximal 256 Zeichen
• Muss eindeutig sein (gegen vorhandene + Batch prüfen)
• Slugs aus Titeln automatisch vorschlagen, falls fehlend
• Beispiel:
  • ❌ "Mein Beitrag!" → ⚠️ Enthält Sonderzeichen
  • ✅ "mein-beitrag" → Gültig

Einschränkungsvalidierung:

• Maximale Länge: Warnen, wenn Grenze erreicht wird; Fehler, wenn überschritten
• Muster: Regex-Muster aus dem Schema testen
• Zulässige Werte: Gegen aufgezählte Optionen prüfen

Phase 4: Vorschau & Genehmigung

Vorschauformat:

Für Erstellungsoperationen:

[1] ✓ NEUER BEITRAG
    feld1: "Wert1"
    feld2: "Wert2"
    feld3: "Wert3"
    ✅ Alle Validierungen bestanden

Für Aktualisierungsoperationen:

[2] ✓ VORHANDENES AKTUALISIEREN
    Element-ID: xxx
    Slug: vorhandener-slug

    Änderungen:
      feld1: "alter Wert" → "neuer Wert"
      feld2: (keine Änderung)
      feld3: "alt" → "neu"

    ✅ Alle Validierungen bestanden

Für Elemente mit Warnungen:

[3] ⚠️ NEUER BEITRAG
    name: "Titel"
    ⚠️ Warnung: Optionales Feld 'post-body' fehlt
    ⚠️ Warnung: Slug könnte zu allgemein sein
    ✅ Kann fortfahren (nur Warnungen)

Für Elemente mit Fehlern:

[4] ❌ NEUER BEITRAG
    name: "Titel!!!"
    slug: "schlechter slug"
    ❌ Fehler: Slug enthält Leerzeichen
    ❌ Fehler: name hat Sonderzeichen
    🔴 Kann nicht fortfahren – muss Fehler beheben

Detaillierte Genehmigung:

• Jedes Element nummerieren: [1], [2], [3]...
• Selektive Verarbeitung erlauben
• Formate akzeptieren:
  • "Alle" – alles verarbeiten
  • "Keine" – Vorgang abbrechen
  • "1,3,5" – Elemente 1, 3 und 5 verarbeiten
  • "1-5" – Elemente 1 bis 5 verarbeiten
  • "2" – nur Element 2 überspringen, Rest verarbeiten

Veröffentlichungsoptionen:

• Sofortige Veröffentlichung: Endpunkte *_live verwenden (empfohlen)
• Entwurfsmodus: Reguläre Endpunkte verwenden

Phase 5: Ausführung

Batch-Verarbeitung:

• In Batches von maximal 50 Elementen verarbeiten
• Fortschrittsbalken nach jedem Batch anzeigen
• Bei Fehlern einzeln

Rollback-Fenster:

• 5 Minuten ab Abschluss des Vorgangs
• Ursprüngliche Werte im Kontext speichern
• Bei Rollback werden alle Werte auf die ursprünglichen zurückgesetzt

Fehlerbehebung

Häufige Fehler und Lösungen:

Fehler	Ursache	Lösung
Slug enthält Leerzeichen	Ungültiges Format	In Kleinbuchstaben mit Bindestrichen ändern
name zu lang	Überschreitet maximale Länge	Kürzen
Referenzierte ID nicht gefunden	Element existiert nicht	Gültige ID angeben
Ungültiges Farbformat	Falsches Hex-Format	#RRGGBB verwenden

Ratenbegrenzung:

• Webflow-API-Ratenlimit: ca. 60 Aufrufe/Minute
• Fügen Sie Verzögerungen zwischen Batches ein
• Bei Überschreitung der Begrenzung wiederholen

Validierungsfehler:

• Fehler klar mit Feldnamen und erwarteten Werten anzeigen
• Korrekturvorschläge anbieten
• Nie ohne Benutzerbestätigung fortfahren