PageSpeed Insights: ai-catalog.json – ARD-Fehler manuell beheben

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

  1. Dateimanager öffnen.
  2. Zum WordPress-Hauptverzeichnis wechseln (üblicherweise httpdocs).
  3. Den Ordner .well-known öffnen. Falls er nicht existiert, erstellen.
  4. Darin eine Datei namens ai-catalog.json anlegen.
  5. 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 Unternehmensname
  • documentationUrl – vollständige Website-URL
  • logoUrl – 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.php

Wichtig: 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.json

Der 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.json erforderlich 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.