Schnelllösung: Für WordPress-Websites gibt es inzwischen ein universelles PHP-Snippet, das die Datei automatisch erstellt. Siehe „PageSpeed Insights: ai-catalog.json automatisch erstellen“.
Seit neueren Lighthouse-Versionen kann PageSpeed Insights eine fehlende oder fehlerhafte ai-catalog.json beanstanden. Die Datei gehört zum Bereich Agentic Resource Discovery (ARD) und soll KI-Agenten helfen, maschinenlesbare Ressourcen einer Website zu entdecken.
Für normale Unternehmenswebsites ohne eigene KI-Agenten oder entsprechende Schnittstellen genügt in der bisher getesteten Lighthouse-Version ein minimaler Katalog mit leerem entries-Array.
Fehlerbild
PageSpeed Insights meldet, dass die ARD-Katalogdatei nicht geladen oder validiert werden konnte. Die Meldung erscheint unabhängig von den üblichen Schema.org-Markups und betrifft nicht die klassische SEO-Auszeichnung.
Lösung: ai-catalog.json erstellen
- Dateimanager öffnen.
- Zum WordPress-Hauptverzeichnis wechseln (üblicherweise
httpdocs). - Den Ordner
.well-knownöffnen. Falls er nicht existiert, erstellen. - Darin eine Datei namens
ai-catalog.jsonanlegen. - Den folgenden JSON-Inhalt einfügen und die Unternehmensangaben anpassen.
JSON-Vorlage
{
"specVersion": "1.0",
"host": {
"displayName": "UNTERNEHMENSNAME",
"documentationUrl": "https://www.example.com/",
"logoUrl": "https://www.example.com/logo.png"
},
"entries": []
}Anzupassen:
displayName– offizieller UnternehmensnamedocumentationUrl– vollständige Website-URLlogoUrl– vollständige URL des Unternehmenslogos
Das leere entries-Array ist beabsichtigt. Es werden keine nicht vorhandenen KI-Agenten, MCP-Server oder anderen Ressourcen erfunden.
Dateistruktur
httpdocs/
.well-known/
acme-challenge/
ai-catalog.json
wp-admin/
wp-content/
wp-config.phpWichtig: Der vorhandene Ordner acme-challenge wird unter anderem für die Validierung von SSL-Zertifikaten verwendet und darf nicht verändert oder gelöscht werden.
Funktion prüfen
Nach dem Speichern die Datei direkt im Browser aufrufen:
https://www.example.com/.well-known/ai-catalog.jsonDer Browser muss den JSON-Inhalt anzeigen. Es darf keine Weiterleitung auf die Startseite erfolgen.
Anschließend PageSpeed Insights erneut ausführen und prüfen, ob die ARD-Meldung verschwunden ist.
Fehlerquellen
- 404-Weiterleitungen: Plugins wie „All 404 to Homepage“ können fehlende JSON-Dateien auf die Startseite umleiten. Lighthouse erhält dann HTML statt JSON.
- Falscher Speicherort: Die Datei muss direkt unter
/.well-known/liegen, nicht im WordPress-Uploadverzeichnis. - Ungültiges JSON: Auf korrekte Anführungszeichen, Kommas und Klammern achten. JSON erlaubt keine Kommentare.
- Cache: Nach Änderungen gegebenenfalls Server- und Website-Cache leeren.
- Veränderte Spezifikation: Bei künftigen Lighthouse-Versionen kann eine andere Struktur oder der Dateiname
ard.jsonerforderlich werden.
Hinweise
Die ARD-Datei ersetzt keine Schema.org-Markups. Sie ist auch keine Voraussetzung dafür, dass Google eine Website indexiert oder KI-Suchsysteme deren Inhalte verarbeiten können.
Ein erfolgreich bestandener Lighthouse-Test bestätigt zunächst nur, dass die geprüfte Datei akzeptiert wurde. Daraus ergibt sich kein nachgewiesener Vorteil für die Sichtbarkeit in KI-Suchsystemen.
Praxistest
Projekt: Reinprofi e.U. – reinprofi.com
Datum: 02.11.2026
Ergebnis: Die physische Datei /.well-known/ai-catalog.json mit minimalem Host-Objekt und leerem entries-Array wurde erfolgreich ausgeliefert und von PageSpeed Insights akzeptiert.
image²-Standard: Bei einer entsprechenden Lighthouse-Meldung zunächst diese Minimallösung verwenden, sofern die eingesetzte ARD-Version sie unterstützt. Keine zusätzlichen Plugins installieren und keine fiktiven Ressourcen eintragen.