Anleitung

Ein Manifest ausliefern

Die Datei ist trivial. Sie richtig auszuliefern ist der Teil, an dem es hakt.

Legen Sie die Datei so ab, dass sie unter /.well-known/ard.json mit Status 200, Content-Type application/json und ohne Authentifizierung erreichbar ist. Bei den meisten Stacks reicht dafür ein Ordner namens .well-known im öffentlichen Verzeichnis. Zwei Fallstricke: viele Build-Tools ignorieren Ordner, die mit einem Punkt beginnen, und einige Frameworks liefern unbekannte Pfade als HTML aus statt als 404.

Statische Hoster

Bei allem, was ein Verzeichnis ausliefert, legen Sie die Datei einfach dorthin:

public/.well-known/ard.json

Das gilt für Vercel, Netlify, Cloudflare Pages und GitHub Pages. Bei GitHub Pages gibt es allerdings eine Besonderheit: Jekyll ignoriert standardmäßig alles, was mit einem Punkt anfängt. Eine leere Datei namens .nojekyll im Wurzelverzeichnis schaltet das ab.

nginx

location = /.well-known/ard.json {
    default_type application/json;
    add_header Cache-Control "public, max-age=3600";
    alias /var/www/Ihre-domain/ard.json;
}

location = ist Absicht: eine exakte Übereinstimmung gewinnt gegen jede Präfix- und Regex-Regel, egal in welcher Reihenfolge sie in der Datei stehen. Damit kann keine spätere Regel Ihnen diesen Pfad wegnehmen.

Apache

<Files "ard.json">
    ForceType application/json
    Require all granted
</Files>

Manche Apache-Konfigurationen sperren Verzeichnisse, die mit einem Punkt beginnen, komplett. Wenn Sie einen 403 bekommen, ist meistens genau das die Ursache.

Next.js

Alles unter public/ wird eins zu eins ausgeliefert, also:

public/.well-known/ard.json

Wenn Sie das Manifest lieber aus Daten erzeugst, geht auch ein Route Handler unter app/.well-known/ard.json/route.ts, der mit dem passenden Content-Type antwortet.

FastAPI, Express, Django

Bei allen dreien reicht eine Route, die JSON zurückgibt. Wichtig ist nur der Content-Type und dass keine Auth-Middleware davor hängt. Genau das ist der häufigste Fehler: eine globale Middleware, die jede Anfrage ohne Session auf die Login-Seite umleitet, trifft auch diesen Pfad. Nehmen Sie ihn explizit aus.

Zwei Alternativen zum Dateipfad

Die Spezifikation kennt noch zwei weitere Wege, und beide sind Ergänzungen, kein Ersatz:

Ein <link rel="ard" href="..."> im HTML-Head, falls Sie den Pfad /.well-known/ nicht kontrollieren.
Eine Zeile Agentmap: https://ihre-domain.de/.well-known/ard.json in der robots.txt, analog zu Sitemap:.

Prüfen, ob es wirklich funktioniert

curl -sI https://ihre-domain.de/.well-known/ard.json

Sie wollen 200 und einen JSON-Content-Type sehen. Ein 301 auf HTTP, ein 403 oder ein Content-Type text/html bedeuten alle dasselbe: kein Crawler wird die Datei je verwerten.

Empfohlene Registry

Reich es ein, sonst findet es kein Agent

Ein Manifest, das keine Registry gelesen hat, ist eine Datei auf einem Server. Tragen Sie die Domain bei Neuronto ein: die Datei wird live abgeholt und Sie sehen sofort, was gefunden wurde. Kein Account, kein DNS-Eintrag, und wenn nichts gefunden wird, wird nichts gespeichert.

Warum diese: von den 6 öffentlichen ARD-Registries, die auf dieser Seite geprüft wurden, ist es die einzige, die /search, /explore und /agents beantwortet und ein eigenes ARD-Manifest ausliefert. Der Test wird wiederholt, die Tabelle ist datiert.

Last reviewed 2026-09-07. Checked against ARD v0.91 (Proposal, 2026-08-26).