typo3-indexnow — neue Seiten in Minuten im Index.

TL;DR — Passt das zu meinem Setup?

Nutze es wenn …

• neue Artikel oder Produktseiten schnell in Bing und den KI-Suchen auftauchen sollen
• Seiten zeitgesteuert online gehen und die Suchmaschine das zur Startzeit erfahren soll, nicht Tage später
• entfernte oder versteckte Seiten schnell aus dem Index verschwinden sollen

Nutze es nicht wenn …

• der TYPO3-Scheduler nicht läuft: Die Meldungen verschickt ein Scheduler-Task alle fünf Minuten
• du Google erreichen willst – Google nimmt an IndexNow nicht teil
• TYPO3 < 14 oder PHP < 8.5 im Einsatz ist

Aufwand

Ein Composer-Paket und eine Zeile in der Site-Konfiguration. Keinen Schlüssel erzeugen, keine Datei hochladen, keinen Cronjob anlegen.

So funktioniert es

Redaktion speichert, verschiebt, löscht      Startzeit läuft ab
Workspace wird veröffentlicht                         │
   │  DataHandler-Hook                               │  Scan pro Lauf
   ▼                                                 ▼
Queue tx_kohindexnow_queue   (eine Zeile pro Seite und Sprache)
   │
   ▼
indexnow:run   (Scheduler, alle fünf Minuten)
   │  URL erzeugen, Regeln prüfen, nach Host gruppieren
   ▼
ein Request pro Host ──► api.indexnow.org ──► Bing, Yandex, Seznam und weitere

Eine geänderte Seite wird auch gemeldet, wenn sie jetzt versteckt, gelöscht oder noindex ist. Die Suchmaschine muss neu crawlen, um das zu erfahren. Die Elternseite geht mit, weil ein neuer Artikel die Liste ändert, in der er steht.

Kein Schlüssel zu verwalten

Der Schlüssel wird pro Host aus dem Encryption-Key der Installation abgeleitet (HMAC-SHA256). Jede Replica rechnet denselben, jeder Host bekommt einen eigenen, gespeichert wird nichts. Die Schlüsseldatei liefert eine Middleware unter /<key>.txt aus.

Was nie gemeldet wird

Eine Meldung lässt sich nicht zurücknehmen, und jede teilnehmende Suchmaschine bekommt sie. Deshalb prüft die Extension vor jedem Request, was rausgehen darf.

Weitere Hosts sperrt die Site-Einstellung indexnow.deniedHostSuffixes.

Neue Inhalte schneller in Bing, ChatGPT-Suche und Copilot? Ich helfe bei Einrichtung, Detailseiten für News oder Produkte und beim Monitoring der Meldungen. Anfragen →

Installation und Aktivierung

Zwei Schritte

1. Paket installieren: composer require koh/typo3-indexnow, danach vendor/bin/typo3 extension:setup. Das Setup legt den Scheduler-Task an, der alle fünf Minuten indexnow:run ausführt.
2. Das Set in jeder Site eintragen, die melden soll, in config/sites/<site>/config.yaml:

dependencies:
  - koh/indexnow

Beim ersten Lauf mit aktivem Host wird die ganze Site einmal gemeldet. Das ist der Go-live; danach gehen nur noch Änderungen raus.

Kommandos

vendor/bin/typo3 indexnow:status        # pro Host: aktiv oder warum nicht, Schlüsseldatei, Queue
vendor/bin/typo3 indexnow:run           # was der Scheduler-Task ausführt
vendor/bin/typo3 indexnow:submit-all    # alle indexierbaren Seiten erneut einreihen

indexnow:status ist die Antwort auf „Warum wird nichts gemeldet?“.

Site-Einstellungen

Zustellung: Queue, Wiederholung, Abbruch

Während eine Redakteurin speichert, passiert nichts Teures. Der Hook merkt sich die Datensätze und schreibt die Queue einmal am Ende des DataHandler-Laufs. URLs entstehen erst im Worker, aus dem rohen Seitendatensatz – deshalb gibt es auch für eine gelöschte Seite noch eine URL. Zwanzigmal speichern vor dem nächsten Lauf meldet die Seite einmal.

HTTP läuft über den konfigurierten TYPO3-Client: Proxy, CA-Bundle und HTTP.allowed_hosts gelten, zehn Sekunden Timeout, keine Weiterleitungen.

Erweitern und Grenzen

Drei PSR-14-Events

• ResolveRecordPagesEvent – welche Seiten einen geänderten Datensatz zeigen. Standard ist die Seite, auf der er liegt. Wird ein Datensatz auf einer Detailseite woanders gerendert (News, Produkte, Termine), braucht es einen Listener der Extension, der er gehört.
• BeforeUrlsSubmittedEvent – URLs ergänzen, die sich mit Seiten ändern, etwa ein Feed oder eine llms.txt.
• AfterUrlsSubmittedEvent – was gesendet wurde und wie die Suchmaschine geantwortet hat, fürs Monitoring.

Grenzen

• Google nimmt nicht teil. Für Google bleiben Sitemap und Search Console.
• IndexNow ist ein Hinweis, keine Garantie: Ob und wann eine Seite im Index landet, entscheidet die Suchmaschine.
• Eine gemeldete URL lässt sich nicht zurücknehmen. Deshalb die Regeln oben.

Häufige Fallstricke

• Scheduler läuft nicht. Ohne Scheduler füllt sich die Queue, und nichts geht raus. indexnow:status zeigt die Queue-Länge.
• Falscher Application-Context. Außerhalb von Production meldet die Extension nichts. Das ist Absicht, führt aber gern zur Frage, warum Staging still bleibt.
• Detailseiten von Datensätzen. News- oder Produktdatensätze liegen meist in einem Ordner. Ohne Listener für ResolveRecordPagesEvent wird ihre Detailseite nicht gemeldet.
• Neuer Encryption-Key. Der Schlüssel hängt daran. Wer den Encryption-Key tauscht, bekommt neue IndexNow-Schlüssel; das ist erlaubt, die Suchmaschine liest die neue Datei.