Gibt es Plugins für Nuxt und TYPO3?

Auf der Seite Traffic-Tracking finden Sie neben der Server API auch Karten für Nuxt, TYPO3, WordPress und Next.js. Dieser Artikel erklärt, was es mit diesen Integrationen auf sich hat und wie Sie Ihren Traffic zuverlässig an KI Score melden.

Kurze Antwort

Ja. Für TYPO3 gibt es eine Extension, für Nuxt ein Modul. Die TYPO3-Extension sendet ab Version 2.0.0 den Tracking-Schlüssel Ihrer Website mit, sobald Sie Site-ID und Tracking-Secret in der Site Configuration eintragen. Für das Nuxt-Modul gilt nach unserem letzten Stand, dass die veröffentlichte Version den Tracking-Schlüssel nicht mitsendet. Ohne diesen Schlüssel nimmt KI Score keine Traffic-Meldungen an. Für Nuxt-Websites empfehlen wir deshalb die Server API. Für WordPress und Next.js gibt es kein Paket, aber Anleitungen mit kopierbarem Code.

Was die Integrationsseite zeigt

Die Integrationsseite erreichen Sie in der Sidebar über Einstellungen → Traffic-Tracking. Unter „Verfügbare Integrationen“ stehen fünf Karten:

• Nuxt (Extension): „Offizielles Modul mit automatischer Nitro-Middleware.“, für Nuxt 3 und 4
• TYPO3 (Extension): „Composer-Extension für alle Frontend-Requests.“, für TYPO3 12 und 13
• WordPress (Anleitung): „Kopierbares MU-Plugin für Frontend-Seiten mit PHP 8+.“
• Next.js (Anleitung): „Proxy für Next.js 16 mit Hintergrundversand.“
• Server API (Serverseitig): „Für jedes System mit Middleware oder Request-Hooks.“

Ein Klick auf eine Karte öffnet die Einrichtung als Fenster.

Die TYPO3-Extension einrichten

Die Extension erfasst die Frontend-Requests Ihrer TYPO3-Website, auch bei gecachten Seiten.

1. Installieren Sie die Extension mit composer require tpwd/typo3-kiscore. Sie brauchen mindestens Version 2.0.0.
2. Bearbeiten Sie im TYPO3-Backend die Site Configuration der gewünschten Website.
3. Tragen Sie Site-ID und Tracking-Secret von der Integrationsseite in die Felder Ki-Score Site ID und Ki-Score Tracking Secret ein. Ohne beide Werte sendet die Extension keine Daten.
4. Speichern Sie die Site Configuration.

Tipp: Statt das Secret direkt einzutragen, können Sie in der Serverumgebung KISCORE_TRACKING_SECRET auf den Wert setzen und im TYPO3-Feld %env(KISCORE_TRACKING_SECRET)% eintragen. So bleibt das Secret aus Ihrer versionierten Site-Konfiguration.

Warum der Tracking-Schlüssel entscheidend ist

Jede Website in KI Score hat einen eigenen, geheimen Tracking-Schlüssel. Er steht auf der Integrationsseite. Jede Traffic-Meldung an KI Score muss diesen Schlüssel im Header X-Kiscore-Tracking-Secret mitsenden. Fehlt er, lehnt KI Score die Meldung ab. Die Daten werden dann nicht gespeichert, und Traffic Overview bleibt leer.

Bei unserer letzten Prüfung sendete die veröffentlichte Version des Nuxt-Moduls diesen Header nicht. Mit dieser Version erscheinen deshalb auch nach einer korrekten Installation keine KI-Crawler oder KI-Verweise in Traffic Overview.

Hinweis: Haben Sie das Nuxt-Modul oder eine TYPO3-Extension vor Version 2.0.0 installiert und Traffic Overview zeigt keine Daten, ist der fehlende Tracking-Schlüssel eine naheliegende Ursache. Aktualisieren Sie die TYPO3-Extension, oder richten Sie für Nuxt die Server API ein.

Die Server API als sicherer Weg

Die Server API funktioniert mit jedem System, das Anfragen serverseitig verarbeitet, zum Beispiel über eine Middleware oder Request-Hooks. Das gilt auch für Websites, die mit Nuxt gebaut sind. Ihr Server liest dabei die Daten des echten Requests und sendet sie per HTTP POST an KI Score, zusammen mit dem Tracking-Schlüssel im Header.

So finden Sie die Angaben für die Server API:

1. Wählen Sie in der Sidebar die Website aus, deren Traffic Sie erfassen möchten.
2. Öffnen Sie Einstellungen → Traffic-Tracking.
3. Klicken Sie unter „Verfügbare Integrationen“ auf die Karte Server API.

Dort finden Sie Ihren Tracking-Endpoint und ein vorbereitetes cURL-Beispiel mit den Daten Ihrer Website. Wie Sie die Meldungen im Detail aufbauen, beschreibt der Artikel Traffic-Daten über die Server API senden.

Zeigt die Seite den Hinweis „Verbindungsdaten fehlen“, fehlen für die Website Site-ID, Tracking-Schlüssel oder API-Endpoint. Wenden Sie sich dann an den Support unter support@kiscore.ai.

Was es nicht gibt

• Kein WordPress-Paket: Für WordPress gibt es kein eigenes Plugin zum Installieren, sondern eine Anleitung mit einem MU-Plugin zum Kopieren. Es läuft auf Ihrem Server mit PHP 8 oder neuer.
• Kein Abgleich von Inhalten: Die Integrationen dienen nur der Traffic-Erfassung. Inhalte Ihres CMS werden nicht mit KI Score synchronisiert.
• Kein JavaScript-Snippet: Ein Tracking-Skript für den Browser bietet KI Score nicht. Die Erfassung läuft immer über Ihren Server.