Skip to Content
ChannelsArtikelübertragung

Einen Blog zur KI-erstellten Website hinzufügen

Für Websites mit eigenem Frontend, auch aus KI-Buildern.

Behalte deine Website und ergänze einen Blog in deinem Design. Structura recherchiert und schreibt die Artikel. Deine Website zeigt sie unter deiner Domain an. Die Artikelübertragung sendet einen vollständigen Artikel, sobald du ihn veröffentlichst.

Bevor du beginnst

Du brauchst eine veröffentlichte Website, ein Backend für HTTPS-Anfragen und eine Datenbank für Artikel. Dein Builder kann diese erstellen; das Ergebnis musst du testen. Dies ist eine individuelle Anbindung, kein offizieller Connector für Lovable, Bolt, v0 oder Replit.

Die Artikelübertragung gibt es für Headless-Websites im Kundenportal. WordPress-Websites bieten sie nicht an.

Auch Websites mit einem Framework nutzen sie nicht. Wählst du Next.js, Astro, Nuxt, SvelteKit oder Anderes Framework oder andere App als Plattform deiner Website, ruft deine Website veröffentlichte Beiträge stattdessen über die Content API ab, und der Einrichtungsassistent zeigt dir die Anfragen.

Die Artikelübertragung braucht einen kostenpflichtigen Structura-Basistarif, aber kein Channels-Add-on. Für einen kostenlosen Headless-Blog nutze die öffentliche Content API. KI-Nutzung und Hosting können zusätzlich kosten.

Schritte

Der schnellste Weg beginnt mit der Adresse deiner Website: Website verbinden öffnet den Einrichtungsassistenten der Website, und sein letzter Schritt, Verbinden, führt dich durch den Empfänger.

  1. Wähle im Kundenportal Website verbinden. Gib deine Öffentliche Website-URL ein und wähle Weiter. Structura liest deine Website, legt sie an und öffnet Website-Infos.

  2. Prüfe unter Plattform, ob dein Builder ausgewählt ist, oder wähle Mein eigenes Backend für eine selbst gebaute Website. Hat Structura deinen Builder erkannt, steht am Feld Auf deiner Website erkannt. Eine eigene Domain verbirgt den Builder oft; dann steht dort Nicht erkannt, und du wählst ihn aus der Liste (oder über Plattform ändern, wenn die Vermutung falsch war). Structura erkennt eine v0-Website an der Markierung, die v0 in ihre Seiten schreibt, auch unter einer eigenen Domain. Fehlt diese Markierung, schlägt Structura Next.js vor, das über die Content API abruft; wähle v0, wenn du deine Website mit v0 gebaut hast.

  3. Geh den Assistenten durch. Sein letzter Schritt vor dem Abschluss ist Verbinden. Kopiere den Prompt in deinen Builder; es ist derselbe Prompt wie im Tab deines Builders unten, und er verweist deinen Builder auf den Übertragungsvertrag. Lovable legt eine Empfänger-Route innerhalb deiner Website an, meist /api/public/structura-articles; Bolt erstellt eine Supabase Edge Function namens structura-articles; v0 und Replit legen eine Route unter /api/structura an. Bei einer selbst gebauten Website folgst du direkt dem Vertrag. Trage dann die Empfänger-URL ein, die dein Builder dir nennt, und wähle Weiter.

  4. Speichere unter Prüfen den Signaturschlüssel im geheimen Backend-Speicher als STRUCTURA_SIGNING_SECRET. Er wird nur einmal angezeigt. Kopiere ihn niemals in den Builder-Chat, öffentlichen Code oder Browser-Umgebungsvariablen. Dein Builder bietet im Chat vielleicht ein Secrets-Formular an; nutze es, statt den Schlüssel als Klartext einzufügen. Die Verbindung wird gespeichert, sobald der Schlüssel erscheint. Du kannst also zu deinem Builder wechseln und jederzeit zurückkommen, um den Test zu senden: Der Schritt Verbinden zeigt die gespeicherte Verbindung dann als Nicht getestet, mit Testartikel senden.

  5. Wähle Jetzt einen Testartikel senden, um den Empfänger sofort zu prüfen. Deine Website speichert ihn als „Structura test article“; lösche ihn danach. Ein bestandener Test markiert die Verbindung sofort als Verbunden. Oder wähle Mit meinem ersten echten Artikel testen und dann Später testen: Es wird nichts gesendet, und dein erster veröffentlichter Artikel ist der Test. Willst du noch keine Empfänger-URL eintragen? Wähle Später verbinden und komm später über die Seite Channels zurück.

  6. Erstelle eine Kampagne in der gewünschten Sprache. Lass den ersten Artikel zunächst als Entwurf erstellen. Veröffentliche einen Entwurf. Prüfe Aktivität und die öffentliche Artikelseite: Titel, Text, Bilder, Sprache, Metadaten und mobile Ansicht.

Eine im Assistenten angelegte Verbindung sendet Artikel aus allen Kampagnen. Um sie umzubenennen oder Kampagnen auszuwählen, öffne sie auf der Seite Channels deiner Website.

Die Übersicht deiner Website zeigt den Status der Artikelübertragung: Verbunden, Nicht getestet oder Nicht verbunden.

Eine Website verbinden, die schon in Structura ist

Der Dialog Website verbinden funktioniert weiterhin für jede Headless-Website, die du schon hast. Wähle auf der Seite Channels der Website auf der Karte Artikelübertragung die Option Installieren. Wähle deine Plattform, kopiere den Prompt in deinen Builder und trage die Empfänger-URL ein, die er dir nennt; danach geht es mit den Schritten 4 und 5 oben weiter. Schließt du den Dialog vor dem Test, ist die Verbindung schon gespeichert: Wähle im Tab Verbindungen Konfigurieren, dann Testartikel senden und Speichern. Benenne die Verbindung unter Fertig bei Bedarf um und wähle die Kampagnen.

Prompt für deinen Builder

Ergänze meine bestehende Website um einen Blog in ihrem aktuellen Design. Nutze vorhandene Schriften, Farben und Navigation. Erstelle /blog und /blog/[slug], echte 404-Seiten für fehlende Artikel, crawlbare Artikelseiten, Metadaten, kanonische URLs und Sitemap-Einträge. Verbinde die Structura-Artikelübertragung. Halte dich an den Übertragungsvertrag unter https://docs.structurawp.com/en/reference/article-delivery Richte den Empfänger so ein, wie dieses Projekt es unterstützt: als öffentliche HTTPS-POST-Route innerhalb der Website unter /api/public/structura-articles oder, nur falls dieses Projekt keine Route bereitstellen kann, als Supabase Edge Function namens structura-articles mit abgeschalteter JWT-Prüfung (verify_jwt = false). Lege eine dauerhafte Artikeltabelle an. Lies den unveränderten Anfragetext, bevor du ihn parst. Speichere STRUCTURA_SIGNING_SECRET nur in den Secrets des Projekts. Prüfe X-Structura-Signature anhand des unveränderten UTF-8-Anfragetextes und X-Structura-Timestamp: HMAC-SHA256(secret, timestamp + "." + rawBody). Weise Zeitstempel außerhalb von fünf Minuten und ungültige Signaturen vor jeder Datenänderung ab. Das einzige unterstützte Ereignis ist "post.published" im Feld event des JSON-Anfragetextes, mit schema_version 1; einen Ereignis-Header gibt es nicht. Weise andere Ereignisse oder Schemaversionen mit Statuscode 422 ab. Lies STRUCTURA_SIGNING_SECRET erst beim Bearbeiten einer Anfrage aus den Umgebungsvariablen oder Secrets des Empfängers; speichere es nie in einer Datenbank oder einem Vault und gib es nie über eine Funktion, einen RPC oder einen Endpunkt preis, den der Browser aufrufen kann. Nutze eine Datenbanktransaktion mit eindeutigem event_id zur Deduplizierung. Aktualisiere Artikel über site.id + post.id + post.locale. Weise ältere Revisionen ab. Der Artikeltext steht in post.html (bereinigtes HTML), daneben post.markdown; ein Feld post.content gibt es nicht. Speichere post.html und die verfügbaren SEO-Felder. post.featuredImage ist null oder ein Objekt mit url und alt; nutze url für das Titelbild des Artikels und für og:image sowie alt als Alternativtext. Bereinige HTML beim Rendern. Gib im Head der Artikelseite jeden post.jsonLd-Eintrag in der gelieferten Reihenfolge als eigenes, sicher serialisiertes <script type="application/ld+json"> aus, auch den ersten (BlogPosting); führe die Einträge nicht zusammen, entferne keinen als Duplikat, schreibe sie nicht um, ersetze sie nicht und füge keinen eigenen Knoten vom Typ BlogPosting oder Article hinzu. Zeige post.author (name, avatarUrl, bio, Link auf url) als Autorenzeile, wenn es nicht null ist. Antworte erst nach dauerhafter Speicherung mit 2xx; gültige Duplikate erhalten ebenfalls 2xx. Frag mich noch nicht nach dem Wert von STRUCTURA_SIGNING_SECRET: Nutze für deine eigenen Tests einen vorläufigen Wert und frag nach dem echten erst, wenn du mit der Empfänger-URL geantwortet hast; ich bekomme ihn von Structura, sobald ich deine URL dort eingefügt habe. Teste eine gültige Übertragung, eine falsche Signatur und ein Replay, öffne dann eine übertragene Artikelseite und prüfe, ob die kanonische URL, das Beitragsbild und jedes JSON-LD-Script wirklich gerendert werden, bevor du fertig meldest. Wenn das Hosting keine echten 404-Statuscodes zurückgeben oder /sitemap.xml nicht als XML ausliefern kann, sag das, statt clientseitige Ersatzlösungen einzubauen. Antworte danach mit der öffentlichen URL des Empfängers, damit ich sie in Structura einfügen kann.

Was danach passiert

Jede neue Veröffentlichung sendet einen Artikel, auch nachträglich freigegebene Entwürfe. Entwürfe bleiben privat. Artikel behalten ihre Inhaltssprache; die Benachrichtigungssprache übersetzt sie nicht. Bestehende Beiträge werden nicht automatisch importiert.

Spätere Änderungen und Löschungen werden nicht synchronisiert. Aktualisiere deine Website-Kopie oder nutze die Content API für den aktuellen Stand. Mehrfachübertragungen sind möglich; der Empfänger muss Duplikate erkennen.

Häufige Probleme

  • Nicht getestet: Die Verbindung ist gespeichert, aber seit der Einrichtung oder der letzten Änderung von URL oder Schlüssel hat noch kein Test und kein echter Artikel deinen Empfänger erreicht. Wähle im Schritt Verbinden des Assistenten Testartikel senden, oder öffne die Verbindung im Tab Verbindungen, wähle Testartikel senden und dann Speichern. Du kannst auch einen neuen Artikel veröffentlichen und Aktivität und Kampagnenzuordnung prüfen.

  • HTTP 401/403: Prüfe Signaturschlüssel, Prüfung des unveränderten Anfragetextes und Zugriffsschutz des Hostings. Prüfe bei Bolt außerdem, dass die Funktion structura-articles kein JWT verlangt.

  • HTTP 404: Nutze die bereitgestellte Empfänger-URL, nicht die Builder-Vorschau.

  • HTTP 429/5xx oder Zeitüberschreitung: Structura versucht es sofort einmal erneut. Es gibt keine dauerhafte Warteschlange oder spätere automatische Wiederholung. Behebe den Fehler und gleiche fehlende Artikel über die Content API ab.

  • Artikel nicht verfügbar: Der Beitrag muss öffentlich sein, Inhalt und eine öffentliche URL haben.

  • Artikel zu groß: Die gesamte JSON-Nachricht darf höchstens 1 MB umfassen. Nutze für große Artikel die Content API.

  • Tarif nicht berechtigt: Die Artikelübertragung benötigt ein aktives kostenpflichtiges Abonnement. Prüfe Tarif und Zahlungsstatus. Das Channels-Add-on ist nicht erforderlich.

Weiterführende Seiten

Zuletzt geprüft am