Nonli HTML-Meta-Tags verwenden

Q: Nonli HTML-Meta-Tags verwenden

Vollständige Referenz zu den Nonli HTML-Meta-Tags: akzeptierte Attribute, Wertformate, Fallbacks, Bild-Slots, Artikel-Metadaten und Video-Renditions.

Mit den Nonli HTML-Meta-Tags kann ein Verlag die von einer Artikelseite erfassten Informationen überschreiben oder anreichern. Diese Referenz listet jedes nli:*-Tag auf, das der Organic-Scraper unterstützt, das exakte HTML-Attribut, das es akzeptiert, und was passiert, wenn das Tag fehlt.

Verwenden Sie das in der Tabelle angegebene Attribut. Die Unterstützung ist bewusst nicht einheitlich: Die meisten Open-Graph- und Artikel-Überschreibungen akzeptieren nur property, nli:tag akzeptiert nur name, und neuere generische Felder akzeptieren beides.

1. Schnellstart#

Platzieren Sie die Tags im <head> der Seite. Verwenden Sie nicht leere Werte, explizite Zeitzonen und absolute öffentliche HTTPS-URLs für Medien.

html

1<meta property="nli:title" content="City council approves the 2027 budget">
2<meta property="nli:description" content="The council approved the budget after a three-hour debate.">
3<meta property="nli:type" content="article">
4<meta name="nli:url" content="https://news.example.com/politics/city-budget-2027">
5
6<meta property="nli:image" content="https://media.example.com/city-budget-wide.jpg">
7<meta property="nli:image:alt" content="Councillors voting in the city chamber">
8
9<meta property="nli:author" content="Alex Morgan">
10<meta property="nli:published_time" content="2026-08-25T09:30:00+02:00">
11<meta property="nli:modified_time" content="2026-08-25T10:15:00+02:00">
12<meta property="nli:section" content="Politics">
13<meta name="nli:tag" content="city council">
14<meta name="nli:tag" content="budget">
15
16<meta name="nli:video" content="https://media.example.com/city-budget-16x9.mp4">

2. Vollständiges Feldinventar#

„Erster Treffer“ bedeutet, dass nur ein Wert übernommen wird; geben Sie dasselbe semantische Feld nicht sowohl mit name als auch mit property aus. „Kein Fallback“ bedeutet, dass das Ziel leer bleibt, wenn das Tag fehlt.

Tag	Akzeptiertes Attribut	Kardinalität	Wertformat	Zugeordnete Bedeutung	Vorrang oder Zusammenführung	Fallback bei Fehlen	Verfügbarkeit
`nli:title`	`property`	Skalar	Nicht leerer Klartext	Open-Graph-Titel	Ersetzt konfigurierte Werte und `og:title`	Konfiguriertes Titel-XPath, dann `og:title`	Verfügbar
`nli:description`	`property`	Skalar	Nicht leerer Klartext	Open-Graph-Beschreibung	Ersetzt konfigurierte Werte und `og:description`	Konfiguriertes Beschreibungs-XPath, dann `og:description`	Verfügbar
`nli:image`	`property`	Wiederholbar	Absolute öffentliche HTTPS-Bild-URL	Haupt-Bildsammlung von Open Graph	Die vollständige `nli:image`-Liste ersetzt die gewöhnlichen Artikelbilder	Konfiguriertes Bild-XPath, dann `og:image`, `og:image:url`, dann `og:image:secure_url`	Verfügbar
`nli:image:alt`	`property`	Skalar	Nicht leerer Klartext	Alternativtext des Hauptbilds	Ersetzt `og:image:alt`	`og:image:alt`	Verfügbar
`nli:type`	`property`	Skalar	Open-Graph-Objekttyp, zum Beispiel `article`	Open-Graph-Inhaltstyp	Ersetzt `og:type`	`og:type`	Verfügbar
`nli:url`	`name` oder `property`	Skalar, erster Treffer	Absolute kanonische HTTPS-URL	Kanonische Organic-URL	Hat Vorrang vor dem Canonical-Link	`<link rel="canonical">`	Verfügbar
`nli:content_tier`	`property`	Skalar	Vom Verlag definierter Stufentext, zum Beispiel `free` oder `premium`	Inhaltsstufe des Artikels	Ersetzt den entsprechenden `article:*`-Wert	`article:content_tier` mit `property`, dann `name`	Verfügbar
`nli:location`	`property`	Wiederholbar	Nicht leerer Ortsname oder Bezeichner	Ortssammlung des Artikels	Die `nli:location`-Liste ersetzt die entsprechende `article:*`-Liste	`article:location` mit `property`, dann `name`	Verfügbar
`nli:opinion`	`property`	Skalar	Vom Verlag definierte Meinungsmarkierung	Meinungswert des Artikels	Ersetzt den entsprechenden `article:*`-Wert	`article:opinion` mit `property`, dann `name`	Verfügbar
`nli:author`	`property`	Wiederholbar	Autorenname oder absolute Profil-URL	Autorensammlung des Artikels	Die `nli:author`-Liste ersetzt die entsprechende `article:*`-Liste	`article:author` mit `property`, dann `name`	Verfügbar
`nli:published_time`	`property`	Skalar	ISO-8601-Datum mit Uhrzeit und Zeitzone	Veröffentlichungszeit des Artikels	Ersetzt konfigurierte und gewöhnliche Artikeldaten	Konfiguriertes Datums-XPath, dann `article:published_time`, dann `og:article:published_time`	Verfügbar
`nli:modified_time`	`property`	Skalar	ISO-8601-Datum mit Uhrzeit und Zeitzone	Aktualisierungszeit des Artikels	Ersetzt den entsprechenden `article:*`-Wert	`article:modified_time` mit `property`, dann `name`	Verfügbar
`nli:section`	`property`	Skalar	Nicht leerer Rubrikname	Rubrik des Artikels	Ersetzt den entsprechenden `article:*`-Wert	`article:section` mit `property`, dann `name`	Verfügbar
`nli:tag`	`name`	Wiederholbar	Ein Tag pro Element	Bereinigte Tag-Sammlung des Artikels	Wird mit `article:tag` und konfigurierten XPath-Tags zusammengeführt; ersetzt sie nicht	Andere Tag-Quellen bleiben verfügbar	Verfügbar
`nli:image1`	`name` oder `property`	Skalar, erster Treffer	Absolute öffentliche HTTPS-Bild-URL	Benutzerdefinierter Organic-Bild-Slot 1	Unabhängig von der Haupt-Bildsammlung	Kein Fallback	Verfügbar
`nli:image2`	`name` oder `property`	Skalar, erster Treffer	Absolute öffentliche HTTPS-Bild-URL	Benutzerdefinierter Organic-Bild-Slot 2	Unabhängig von der Haupt-Bildsammlung	Kein Fallback	Verfügbar
`nli:image3`	`name` oder `property`	Skalar, erster Treffer	Absolute öffentliche HTTPS-Bild-URL	Benutzerdefinierter Organic-Bild-Slot 3	Unabhängig von der Haupt-Bildsammlung	Kein Fallback	Verfügbar
`nli:image4`	`name` oder `property`	Skalar, erster Treffer	Absolute öffentliche HTTPS-Bild-URL	Benutzerdefinierter Organic-Bild-Slot 4	Unabhängig von der Haupt-Bildsammlung	Kein Fallback	Verfügbar
`nli:image5`	`name` oder `property`	Skalar, erster Treffer	Absolute öffentliche HTTPS-Bild-URL	Benutzerdefinierter Organic-Bild-Slot 5	Unabhängig von der Haupt-Bildsammlung	Kein Fallback	Verfügbar
`nli:image6`	`name` oder `property`	Skalar, erster Treffer	Absolute öffentliche HTTPS-Bild-URL	Benutzerdefinierter Organic-Bild-Slot 6	Unabhängig von der Haupt-Bildsammlung	Kein Fallback	Verfügbar
`nli:video`	`name` oder `property`	Skalar, erster Treffer	Direkte absolute öffentliche HTTPS-Video-URL	Standard- oder Legacy-Organic-Video	Ein gültiger Wert ersetzt die erste gefundene Schema.org-Video-URL	Erstes gültiges Schema.org-`VideoObject`; die bestehende Erkennung und der Import von Vorschaubildern gelten weiterhin	Verfügbar; die Zuordnung mehrerer Renditions ist in API #4640 geplant
`nli:video:image`	`name` oder `property`	Skalar, erster Treffer	Absolute öffentliche HTTPS-Bild-URL	Vorschaubild der Standard-Rendition	Darf nur die passende `nli:video`-Rendition betreffen	Bestehende Erkennung von Vorschaubildern für Standardvideos	In API #4640 geplant; derzeit nicht unterstützt
`nli:short`	`name` oder `property`	Skalar, erster Treffer	Direkte absolute öffentliche HTTPS-Video-URL	Vertikale oder kurze Rendition	Erzeugt eine von `nli:video` unabhängige Rendition	Keine Short-Rendition	In API #4640 geplant; derzeit nicht unterstützt
`nli:short:image`	`name` oder `property`	Skalar, erster Treffer	Absolute öffentliche HTTPS-Bild-URL	Vorschaubild der Short-Rendition	Darf nur die passende `nli:short`-Rendition betreffen	Bestehende Erkennung von Vorschaubildern für Kurzvideos	In API #4640 geplant; derzeit nicht unterstützt

3. Überschreiben, wiederholen oder zusammenführen#

3.1. Skalare Überschreibungen#

Ein skalares Feld behält einen Wert. Ist ein unterstütztes skalares nli:*-Tag vorhanden, hat es Vorrang vor seinem aufgeführten Fallback. Geben Sie das Feld nur einmal aus. Bei Feldern, die beide Attribute akzeptieren, führt die Verwendung beider zu einem mehrdeutigen Ergebnis des ersten Treffers, das von der Reihenfolge im Dokument abhängt.

3.2. Wiederholbare Ersetzungen#

Wiederholen Sie nli:image, nli:location oder nli:author einmal pro Wert. Wird mindestens ein Nonli-spezifischer Wert gefunden, ersetzt diese Liste die entsprechende Open-Graph- oder article:*-Liste.

html

1<meta property="nli:image" content="https://media.example.com/story-wide.jpg">
2<meta property="nli:image" content="https://media.example.com/story-square.jpg">
3<meta property="nli:author" content="Alex Morgan">
4<meta property="nli:author" content="Sam Lee">
5<meta property="nli:location" content="Paris">
6<meta property="nli:location" content="Brussels">

3.3. Zusammengeführte Tags#

nli:tag ist die bewusste Ausnahme. Wiederholen Sie es mit name; Nonli führt seine Werte mit article:tag und jedem konfigurierten Tag-Extraktor zusammen und bereinigt dann die kombinierte Liste.

html

1<meta property="article:tag" content="Europe">
2<meta name="nli:tag" content="European Union">
3<meta name="nli:tag" content="elections">

4. Daten und URLs#

Daten müssen gültige ISO-8601-Datumsangaben mit Uhrzeit und expliziter Zeitzone sein. Diese Beispiele stellen genaue Zeitpunkte dar:

html

1<meta property="nli:published_time" content="2026-08-25T09:30:00+02:00">
2<meta property="nli:modified_time" content="2026-08-25T08:15:00Z">

Verwenden Sie keinen Wert nur mit Datum wie 2026-08-25 und keine Uhrzeit ohne Zone wie 2026-08-25T09:30:00. Ein ungültiges Datum kann dazu führen, dass das Scraping fehlschlägt, statt den Fallback zu aktivieren.

Verwenden Sie für Bilder und Videos direkte, absolute HTTPS-URLs, die die Mediendatei öffentlich ausliefern. Relative URLs, HTML-Playerseiten, Browsersitzungen, ablaufende signierte URLs und URLs, die Cookies erfordern, sind unsichere Eingaben für die Integration.

5. Hauptbilder, benutzerdefinierte Slots und Video-Vorschaubilder#

Diese Bildfamilien sind unabhängig voneinander:

nli:image ist die wiederholbare Sammlung der Hauptbilder des Artikels;
nli:image1 bis nli:image6 sind sechs getrennte benutzerdefinierte Slots, die bei der Bildauswahl von Bots verwendet werden;
nli:video:image ist als Vorschaubild nur des Standardvideos geplant;
nli:short:image ist als Vorschaubild nur des Kurzvideos geplant.

Ein nummeriertes benutzerdefiniertes Bild schließt sich nli:image nicht an und ersetzt es nicht. Das Vorschaubild einer Rendition darf nie zum Artikelbild oder zum Vorschaubild der anderen Rendition werden.

6. Standard- und Short-Video-Renditions#

Stand 25. August 2026 ist nur nli:video verfügbar. Die durch nonli/api#4640 nachverfolgten API-/Domänenarbeiten sind noch offen, daher dürfen nli:short, nli:video:image und nli:short:image noch nicht als Produktiveingaben verwendet werden.

Die vollständige Zielsyntax unten dient der Implementierungsplanung. Sie wird erst gültig, nachdem API #4640 bereitgestellt wurde und ihre HTML-Kompatibilitätstests bestanden sind:

html

1<!-- Available today; becomes the standard rendition in the multi-rendition contract -->
2<meta name="nli:video" content="https://media.example.com/report-16x9.mp4">
3
4<!-- Planned in API #4640; not currently supported -->
5<meta name="nli:video:image" content="https://media.example.com/report-16x9.jpg">
6<meta name="nli:short" content="https://media.example.com/report-9x16.mp4">
7<meta name="nli:short:image" content="https://media.example.com/report-9x16.jpg">

Nach der Bereitstellung kann jedes Video auch allein auftreten. Ein Vorschaubild ohne das passende Video wird ignoriert und erzeugt keine Rendition. Hat eine Rendition kein eigenes Vorschaubild, behält sie das bestehende Erkennungs-/Importverhalten dieser Rendition bei und übernimmt nicht das Bild der anderen Rendition.

7. Leere und ungültige Werte#

Geben Sie kein Meta-Element aus, wenn sein Wert unbekannt ist.
Leere Werte von nli:video und nli:image1 … nli:image6 werden ignoriert.
Bei anderen Überschreibungen kann ein leeres Element als vorhanden gelten und seinen Fallback unterdrücken; verwenden Sie nur nicht leere Inhalte.
Eine ungültige nli:video-URL ersetzt kein gültiges Schema.org-Video.
Eine relative nli:url kann gegen die gescrapte Seite aufgelöst werden, Verlage sollten aber eine stabile absolute kanonische HTTPS-URL ausgeben.
Wenn name- und property-Versionen desselben generischen Felds nebeneinander existieren, gewinnt das erste passende Element; geben Sie nur eines aus.

8. HTML oder MRSS?#

Verwenden Sie diese Tags, wenn Nonli eine HTML-Artikelseite scrapt. Wenn Ihr CMS einen Feed mit Videodateien exportiert, nutzen Sie stattdessen die Anleitung zum Video-MRSS-Feed. Sie erklärt, wie Sie Standard- und Short-Renditions mit ihren eigenen Vorschaubildern in einem Feed-Eintrag gruppieren.

War dieser Artikel hilfreich?