Maschinengesteuerte Seitenerstellung

Im Backend unter Benutzer wird beim Anlegen oder Bearbeiten eines Benutzers ein API-Token angezeigt.

Diesen Token kopieren – er wird für jede API-Anfrage als Authorization: Bearer TOKEN im Header benötigt.

Wichtig: Der Token wird nur einmal im Klartext angezeigt. Danach ist nur noch der Hash gespeichert. Token sicher aufbewahren und niemals öffentlich teilen.

Die Datei README_KI.md enthält die komplette API-Referenz in einem kompakten Format, das KI-Systeme direkt als Kontext verwenden können.

So anpassen:

1. Datei herunterladen
2. API-Basis-URL eintragen (z.B. https://meineseite.de/api.php)
3. Den eigenen API-Token eintragen
4. Als System-Prompt oder Kontextdatei an die KI übergeben

Bevor die KI loslegt, kurz prüfen ob die Verbindung steht:

GET /api.php?a=site_bundle
Authorization: Bearer DEIN_TOKEN

Die Antwort sollte {"ok": true, "data": {...}} enthalten – mit Site-Name, Styles, Header, Footer und Custom CSS.

Wenn das funktioniert, ist die API einsatzbereit.

Die README_KI.md als Datei im Projektordner ablegen oder in die CLAUDE.md einbinden.

Claude Code kann dann direkt über HTTP-Requests (z.B. per Node.js-Script) mit der API arbeiten.

Beispiel-Anweisung:

"Lies die README_KI.md und erstelle auf meiner CMF-Webseite eine neue Seite mit dem Titel 'Über uns'. Nutze die API."

Die README_KI.md als System-Prompt oder in ein Custom GPT einbinden. Die KI generiert dann API-konforme JSON-Daten.

Da ChatGPT keine HTTP-Requests senden kann, gibt es zwei Wege:

• Die KI generiert den JSON-Body, den man selbst per API sendet
• Über ein Tool wie n8n wird die KI-Antwort automatisch an die API weitergeleitet

Mit n8n oder ähnlichen Workflow-Tools lässt sich der gesamte Ablauf automatisieren:

• Trigger (z.B. Webhook, Zeitplan, E-Mail)
• KI-Node generiert Inhalte
• HTTP-Node sendet das Ergebnis an die CMF-API

So entstehen vollautomatische Content-Pipelines – z.B. für regelmäßige Blog-Posts oder Seitenaktualisierungen.

Anweisung an die KI:

"Erstelle eine komplette Webseite für einen Fotografen. Startseite, Über mich, Portfolio, Kontakt. Nutze die CMF-API. Lade keine Bilder hoch, verwende Platzhalter. Setze passende Farben im Theme."

Was die KI tut:

1. site_bundle lesen – aktuellen Stand verstehen
2. styles_update – Farben und Schriften anpassen
3. page_create – jede Seite einzeln anlegen mit Blöcken
4. partial_update – Header und Footer gestalten

Tipp: Je konkreter die Anweisung, desto besser das Ergebnis. Zielgruppe, Tonalität und gewünschte Struktur angeben.

Anweisung an die KI:

"Exportiere die komplette Webseite von Server A und importiere sie auf Server B. Beide haben die CMF-API."

Was die KI tut:

1. site_export auf Server A – alles als JSON exportieren
2. site_import auf Server B – komplette Struktur importieren
3. Medien separat per media_upload übertragen

Hinweis: Beim Import werden vorhandene Seiten aktualisiert, neue erstellt. Nichts wird gelöscht. Damit lassen sich Vorlagen oder Staging-Umgebungen aufbauen.

Anweisung an die KI:

"Ändere das Design meiner Webseite: Primärfarbe zu Dunkelblau (#1a365d), Schrift zu Montserrat, Container auf 1200px. Der Header soll ein Logo und einen Slogan enthalten."

Was die KI tut:

1. site_bundle lesen – aktuelle Styles verstehen
2. styles_update – Farben, Fonts, Container anpassen
3. custom_css_update – eigene Klassen ergänzen falls nötig
4. partial_update&part=header – Header umgestalten

Tipp: Erst das Theme ändern, dann die Inhalte prüfen – manche Layouts sehen mit anderen Farben oder Schriften anders aus.

Anweisung an die KI:

"Füge auf der Seite 'Leistungen' einen neuen Abschnitt 'Beratung' hinzu. Überschrift h2, zwei Absätze Text, ein Button zur Kontaktseite."

Was die KI tut:

1. page&slug=leistungen – aktuelle Seite laden
2. Neue Blöcke in das blocks-Array einfügen
3. page_update – kompletten Inhalt zurückschreiben

Wichtig: Die KI muss immer die bestehenden Blöcke beibehalten und die neuen dazufügen – nicht die Seite überschreiben. Bestehende Block-IDs stabil halten.

Anweisung an die KI:

"Schreibe einen Blog-Post über 'Warum statische Webseiten schneller sind'. Kategorie: Technik. Nutze ein passendes Bild aus der Media-Bibliothek. Veröffentliche den Post sofort."

Was die KI tut:

1. media – verfügbare Bilder durchsuchen
2. blog_create – Post mit Titel, Slug, Bild, Beschreibung, Kategorie und Inhaltsblöcken erstellen

Für automatische Pipelines: Ein n8n-Workflow kann z.B. wöchentlich einen neuen Blog-Post generieren lassen – Thema per Zeitplan, Text per KI, Veröffentlichung per API.

Anweisung an die KI:

"Prüfe alle Seiten meiner Webseite auf SEO: Meta-Titel und -Beschreibung optimieren, fehlende Alt-Texte bei Bildern ergänzen, Überschriftenhierarchie korrigieren."

Was die KI tut:

1. pages – alle Seiten auflisten
2. Jede Seite per page&id=... laden
3. Meta-Titel, Description, Alt-Texte prüfen und verbessern
4. Per page_update zurückschreiben

Tipp: Die KI sollte nach der Änderung sitemap_generate aufrufen, damit die Sitemap aktuell bleibt.

Ein typischer n8n-Workflow für die CMF-Steuerung besteht aus drei Bausteinen:

1. Trigger – Zeitplan (z.B. jeden Montag), Webhook oder manuell
2. KI-Node – Claude, GPT oder ein lokales Modell generiert den Inhalt als JSON
3. HTTP-Node – Sendet das Ergebnis an die CMF-API (page_create, blog_create oder page_update)

Wichtig für den HTTP-Node:

• Methode: POST
• Header: Authorization: Bearer TOKEN
• Content-Type: application/json
• Body: Das von der KI generierte JSON

Ein Workflow der wöchentlich einen neuen Blog-Post erstellt:

1. Schedule Trigger – jeden Montag um 9:00
2. HTTP Request – GET ?a=blog_posts lesen, um bestehende Themen zu kennen
3. KI-Node – Prompt: "Schreibe einen Blog-Post für ein dateibasiertes CMS. Vermeide diese Themen: [Liste]. Gib mir title, slug, description, category und content als JSON."
4. HTTP Request – POST ?a=blog_create mit dem KI-Output als Body

Tipp: Der KI im Prompt die README_KI.md als Kontext mitgeben, damit sie das korrekte JSON-Format kennt.

• Immer die README_KI.md als Kontext mitgeben
• Zielgruppe und Tonalität beschreiben
• Gewünschte Seitenstruktur vorgeben
• Konkrete Blocktypen nennen (z.B. 'nutze columns für Vorteile')
• Farbschema und Schrift vorgeben wenn gewünscht
• Die KI anweisen, erst zu lesen und dann zu schreiben

• API-Token nie in öffentlichen Repos oder Prompts teilen
• Für Automatisierung einen eigenen Benutzer mit eigenem Token anlegen
• Vor großen Änderungen ein Backup per Export erstellen
• Änderungen im Frontend prüfen bevor weitere folgen
• Token regelmäßig erneuern

• Erst site_bundle lesen – dann ändern
• Seiten immer vollständig zurückschreiben
• Block-IDs bei Änderungen stabil halten
• Medien erst hochladen, dann einbinden
• Nach Seitenänderungen im Frontend prüfen
• Bei Batch-Änderungen Seite für Seite arbeiten