Installationsanleitung

Zwei Dinge gehen live: das Snippet (rendert die Hinweise) und das Manifest (deklariert sie, ausgeliefert von Ihrer Origin unter /.well-known/). Zehn Minuten, kein Build-Schritt.

1 · Script-Tag

Vor </body> auf jeder Seite einfügen. Das Snippet ist 12 KB groß, abhängigkeitsfrei und tut nichts, bevor es Ihr Manifest gelesen hat.

HTML

<script>window.AIDiscloseConfig = { manifestUrl: "/.well-known/ai-disclosure.json" };</script>
<script src="https://cdn.aidisclose.io/v0/aidisclose.js" defer></script>

Fixieren Sie in Produktion die Version und ergänzen Sie den veröffentlichten SRI-Hash.

2 · Google Tag Manager

In GTM ein neues Tag anlegen: Tag-Konfiguration → Benutzerdefiniertes HTML.
Den Script-Block aus Schritt 1 in das HTML-Feld einfügen.
Trigger → Alle Seiten (Seitenaufruf). Keinen verzögerten oder Scroll-Trigger verwenden: Artikel 50 verlangt Sichtbarkeit ab der ersten Interaktion oder Exposition.
Arbeitsbereich senden und veröffentlichen.
Mit der Prüfung verifizieren — C3 bestätigt die Erkennung des Snippets.

3 · WordPress

Das offizielle Plugin lädt das Snippet, schreibt das Manifest per Rewrite-Regel unter /.well-known/ und ergänzt einen „KI-Inhalt“-Schalter pro Beitrag und Medium, der data-ai-content ausgibt. Keine Code-Änderungen.

4 · Das Manifest hosten

ai-disclosure.json muss von Ihrer eigenen Origin ausgeliefert werden — /.well-known/ai-disclosure.json kann nicht auf unserer Domain für Ihre liegen. Drei unterstützte Wege:

A · Statische Datei

Das generierte Manifest herunterladen und direkt ausliefern.

nginx

location = /.well-known/ai-disclosure.json {
  alias /var/www/site/ai-disclosure.json;
  default_type application/json;
  add_header Cache-Control "max-age=3600";
}

Apache

Alias "/.well-known/ai-disclosure.json" "/var/www/site/ai-disclosure.json"
<Files "ai-disclosure.json">
  ForceType application/json
</Files>

Vercel / Netlify — Datei committen, fertig

# Vercel / Netlify — served as-is from the static dir:
public/.well-known/ai-disclosure.json

B · Reverse Proxy auf Ihr gehostetes Manifest

Der Pfad bleibt auf Ihrer Origin, während wir das Manifest im Dashboard editierbar halten: Proxien Sie den Well-known-Pfad auf Ihren Hosted-Manifest-Endpunkt (das Dashboard generiert diese Snippets vorausgefüllt mit Ihrem Site-Key).

nginx

location = /.well-known/ai-disclosure.json {
  proxy_pass https://api.aidisclose.io/v1/hosted-manifest/YOUR_SITE_KEY;
  proxy_set_header Host api.aidisclose.io;
  proxy_ssl_server_name on;
}

Cloudflare Worker

export default {
  async fetch(request) {
    const url = new URL(request.url);
    if (url.pathname === "/.well-known/ai-disclosure.json") {
      return fetch("https://api.aidisclose.io/v1/hosted-manifest/YOUR_SITE_KEY");
    }
    return fetch(request);
  }
};

C · Plattformen ohne Root-Dateizugriff

Manche Plattformen (z. B. Shopify) können keine Dateien an der Domain-Wurzel ausliefern. Nutzen Sie den seitenbasierten Link, den die Spezifikation erlaubt: <link rel="ai-disclosure" href="…">. Die Prüfung wertet Link-only-Discovery als L1 mit Vermerk — spezifikationskonform, da die Discovery-Regel sie als MAY führt.

5 · Verifizieren

Starten Sie die Prüfung. C1 validiert das Manifest, C3 erkennt das Snippet, C4–C6 bestätigen die sichtbaren Hinweise.

Prüfung starten