PageSpeed Insights: ai-catalog.json automatisch erstellen
Status: Aktiv im Einsatz
Typ: PHP-Snippet (einmalige Ausführung)
Zweck: ARD-Prüfung in PageSpeed Insights bestehen
Getestet: Reinprofi, Rauminspo, kuntner.cc,
Neurologie Winkler (November 2026)
Hintergrund
PageSpeed Insights prüft inzwischen auch das sogenannte Agentic Resource Discovery (ARD). Dabei wird unter /.well-known/ai-catalog.json nach einem JSON-Katalog gesucht.
Der Katalog dient dazu, Ressourcen und Schnittstellen für autonome KI-Agenten auffindbar zu machen. Gewöhnliche Unternehmenswebsites bieten solche Schnittstellen in der Regel nicht an.
Für die erfolgreiche Lighthouse-Prüfung genügt in unseren bisherigen Tests ein minimales JSON mit leerem entries-Array. Firmenname, Logo und Website-Adresse sind dafür nicht erforderlich.
Wichtig: Die ARD-Prüfung befindet sich noch in der Entwicklung. Ein gültiger Katalog ist kein nachgewiesener SEO-Rankingfaktor und ersetzt keine strukturierten Daten nach Schema.org.
Unsere Lösung
Ein universelles PHP-Snippet erstellt einmalig eine echte ai-catalog.json im Verzeichnis .well-known.
Das Snippet funktioniert ohne individuelle Anpassungen und kann nach erfolgreicher Erstellung wieder entfernt werden.
Die Datei wird anschließend direkt vom Webserver ausgeliefert. WordPress und PHP müssen bei späteren Aufrufen nicht gestartet werden.
PHP-Snippet
/**
* image² – ARD-Katalog automatisch erstellen
*
* Erstellt einmalig:
* /.well-known/ai-catalog.json
*
* Keine individuellen Einstellungen erforderlich.
* Vorhandene Dateien werden nicht überschrieben.
*/
add_action('admin_init', function () {
// Nur Administratoren.
if (!current_user_can('manage_options')) {
return;
}
// Zielpfad im WordPress-Hauptverzeichnis.
$directory = ABSPATH . '.well-known';
$file = $directory . '/ai-catalog.json';
// Vorhandene Datei nicht verändern.
if (file_exists($file)) {
return;
}
// Verzeichnis erstellen, falls erforderlich.
if (!is_dir($directory) && !wp_mkdir_p($directory)) {
error_log('image² ARD: Verzeichnis konnte nicht erstellt werden.');
return;
}
// Minimaler ARD-Katalog.
$catalog = [
'specVersion' => '1.0',
'entries' => []
];
$json = wp_json_encode(
$catalog,
JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES
);
if ($json === false) {
return;
}
// Datei erstellen, niemals überschreiben.
$handle = @fopen($file, 'x');
if ($handle === false) {
error_log('image² ARD: Datei konnte nicht erstellt werden.');
return;
}
$content = $json . "\n";
$written = fwrite($handle, $content);
fclose($handle);
if ($written !== strlen($content)) {
@unlink($file);
error_log('image² ARD: Datei konnte nicht vollständig geschrieben werden.');
}
});Ergebnis
Das Snippet erstellt folgende Datei:
{
"specVersion": "1.0",
"entries": []
}Das leere entries-Array bedeutet, dass keine
speziellen Ressourcen für KI-Agenten eingetragen sind.
Anwendung – Reihenfolge beachten!
- PHP-Snippet in WordPress hinzufügen und aktivieren.
Die Ausführung im Adminbereich muss erlaubt sein. - Unbedingt das WordPress-Dashboard neu laden!
Erst dadurch wird der Hookadmin_initausgeführt
und die Datei erstellt. - Die öffentliche URL aufrufen:
https://DOMAIN/.well-known/ai-catalog.json - Kontrollieren, ob der JSON-Inhalt tatsächlich
angezeigt wird. - Erst jetzt das Snippet deaktivieren oder löschen.
- PageSpeed Insights erneut ausführen und die ARD-Prüfung
kontrollieren.
Achtung: Das bloße Aktivieren des Snippets garantiert noch nicht, dass die Datei erstellt wurde. Das Snippet darf erst entfernt werden, wenn die JSON-Datei unter ihrer öffentlichen URL erreichbar ist. Die erzeugte Datei bleibt nach dem Entfernen des Snippets dauerhaft auf dem Server bestehen.
Wichtig: All 404 to Homepage deaktivieren!
Achtung: Das Plugin All 404 to Homepage kann die ARD-Prüfung verhindern und sollte deaktiviert werden.
Das Plugin leitet nicht gefundene URLs auf die Startseite um. Dadurch kann Lighthouse statt einer erwarteten JSON- oder 404-Antwort eine HTML-Seite erhalten.
Typische Fehlermeldung:
Malformed JSON in manifest:
SyntaxError: Unexpected token '<',
"<!doctype "... is not valid JSONDieser Fehler wurde bei mehreren Seiten beobachtet. Nach dem Deaktivieren des Plugins verschwand der Fehler.
Agenturregel: All 404 to Homepage nicht als dauerhafte Lösung für 404-Fehler einsetzen. Fehlende Seiten sollten korrekt mit HTTP 404 antworten. Für tatsächlich verschobene Inhalte gezielte 301-Weiterleitungen einrichten.
Fehlerbehebung
Die Datei liefert eine 404-Seite
Erster Schritt: Prüfen, ob das Dashboard nach Aktivierung des Snippets tatsächlich neu geladen wurde.
- Snippet aktivieren und eine Admin-Seite neu laden.
- Die JSON-URL erneut aufrufen.
- Falls weiterhin 404 erscheint, Schreibrechte prüfen.
- Prüfen, ob die Datei tatsächlich erstellt wurde.
- Bei abweichender WordPress-Verzeichnisstruktur prüfen,
obABSPATHdem öffentlichen Document Root
entspricht.
Technische Hinweise
- Das Snippet überschreibt keine vorhandene
ai-catalog.json. - Ein vorhandenes
.well-known-Verzeichnis bleibt erhalten. - Andere Dateien und Verzeichnisse, insbesondere
acme-challengefür SSL-Zertifikate, werden nicht verändert. - Es sind keine Rewrite-Regeln notwendig.
- Die Datei bleibt unabhängig von WordPress-Updates und dem späteren Entfernen des Snippets bestehen.
- Die ARD-Spezifikation kann sich ändern. Bei künftigen Lighthouse-Änderungen die Anforderungen erneut prüfen.
Fazit
Das universelle image²-Snippet erstellt mit minimalem Aufwand einen gültigen ARD-Katalog für gewöhnliche WordPress-Websites.
Individuelle Unternehmensdaten sind nicht notwendig, deshalb eignet sich das Snippet als zusätzlicher Schritt bei der Website-Wartung.