Cómo usar las etiquetas meta HTML de Nonli

Q: Cómo usar las etiquetas meta HTML de Nonli

Referencia completa de las etiquetas meta HTML de Nonli: atributos aceptados, formatos de valor, valores alternativos, ranuras de imagen, metadatos de artículo y versiones de vídeo.

Las etiquetas meta HTML de Nonli permiten a un medio sustituir o enriquecer la información recogida de la página de un artículo. Esta referencia enumera todas las etiquetas nli:* que admite el scraper orgánico, el atributo HTML exacto que acepta cada una y qué ocurre cuando la etiqueta no está presente.

Usa el atributo indicado en la tabla. La compatibilidad no es uniforme a propósito: la mayoría de las sustituciones de Open Graph y de artículo solo aceptan property, nli:tag solo acepta name y los campos genéricos más recientes aceptan ambos.

1. Inicio rápido#

Coloca las etiquetas en el <head> de la página. Usa valores no vacíos, zonas horarias explícitas y URLs HTTPS públicas y absolutas para los archivos multimedia.

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. Inventario completo de campos#

«Primera coincidencia» significa que solo se conserva un valor; no emitas el mismo campo semántico con name y con property a la vez. «Sin valor alternativo» significa que el destino queda vacío cuando falta la etiqueta.

Etiqueta	Atributo aceptado	Cardinalidad	Formato del valor	Significado asignado	Precedencia o comportamiento de fusión	Valor alternativo si falta	Disponibilidad
`nli:title`	`property`	Escalar	Texto plano no vacío	Título Open Graph	Sustituye los valores configurados y `og:title`	XPath de título configurado y, después, `og:title`	Disponible
`nli:description`	`property`	Escalar	Texto plano no vacío	Descripción Open Graph	Sustituye los valores configurados y `og:description`	XPath de descripción configurado y, después, `og:description`	Disponible
`nli:image`	`property`	Repetible	URL de imagen HTTPS pública y absoluta	Colección principal de imágenes Open Graph	La lista completa de `nli:image` sustituye las imágenes ordinarias del artículo	XPath de imagen configurado y, después, `og:image`, `og:image:url` y `og:image:secure_url`	Disponible
`nli:image:alt`	`property`	Escalar	Texto plano no vacío	Texto alternativo de la imagen principal	Sustituye `og:image:alt`	`og:image:alt`	Disponible
`nli:type`	`property`	Escalar	Tipo de objeto Open Graph, por ejemplo `article`	Tipo de contenido Open Graph	Sustituye `og:type`	`og:type`	Disponible
`nli:url`	`name` o `property`	Escalar, primera coincidencia	URL canónica HTTPS absoluta	URL canónica orgánica	Tiene prioridad sobre el enlace canónico	`<link rel="canonical">`	Disponible
`nli:content_tier`	`property`	Escalar	Texto de nivel definido por el medio, por ejemplo `free` o `premium`	Nivel de contenido del artículo	Sustituye el valor `article:*` correspondiente	`article:content_tier` con `property` y, después, con `name`	Disponible
`nli:location`	`property`	Repetible	Nombre o identificador de lugar no vacío	Colección de ubicaciones del artículo	La lista `nli:location` sustituye la lista `article:*` correspondiente	`article:location` con `property` y, después, con `name`	Disponible
`nli:opinion`	`property`	Escalar	Marcador de opinión definido por el medio	Valor de opinión del artículo	Sustituye el valor `article:*` correspondiente	`article:opinion` con `property` y, después, con `name`	Disponible
`nli:author`	`property`	Repetible	Nombre del autor o URL absoluta del perfil	Colección de autores del artículo	La lista `nli:author` sustituye la lista `article:*` correspondiente	`article:author` con `property` y, después, con `name`	Disponible
`nli:published_time`	`property`	Escalar	Fecha y hora ISO 8601 con zona horaria	Hora de publicación del artículo	Sustituye las fechas configuradas y las fechas ordinarias del artículo	XPath de fecha configurado y, después, `article:published_time` y `og:article:published_time`	Disponible
`nli:modified_time`	`property`	Escalar	Fecha y hora ISO 8601 con zona horaria	Hora de actualización del artículo	Sustituye el valor `article:*` correspondiente	`article:modified_time` con `property` y, después, con `name`	Disponible
`nli:section`	`property`	Escalar	Nombre de sección no vacío	Sección del artículo	Sustituye el valor `article:*` correspondiente	`article:section` con `property` y, después, con `name`	Disponible
`nli:tag`	`name`	Repetible	Una etiqueta por elemento	Colección de etiquetas del artículo ya depuradas	Se fusiona con `article:tag` y con las etiquetas del XPath configurado; no las sustituye	Las demás fuentes de etiquetas siguen disponibles	Disponible
`nli:image1`	`name` o `property`	Escalar, primera coincidencia	URL de imagen HTTPS pública y absoluta	Ranura 1 de imagen orgánica personalizada	Independiente de la colección de imágenes principal	Sin valor alternativo	Disponible
`nli:image2`	`name` o `property`	Escalar, primera coincidencia	URL de imagen HTTPS pública y absoluta	Ranura 2 de imagen orgánica personalizada	Independiente de la colección de imágenes principal	Sin valor alternativo	Disponible
`nli:image3`	`name` o `property`	Escalar, primera coincidencia	URL de imagen HTTPS pública y absoluta	Ranura 3 de imagen orgánica personalizada	Independiente de la colección de imágenes principal	Sin valor alternativo	Disponible
`nli:image4`	`name` o `property`	Escalar, primera coincidencia	URL de imagen HTTPS pública y absoluta	Ranura 4 de imagen orgánica personalizada	Independiente de la colección de imágenes principal	Sin valor alternativo	Disponible
`nli:image5`	`name` o `property`	Escalar, primera coincidencia	URL de imagen HTTPS pública y absoluta	Ranura 5 de imagen orgánica personalizada	Independiente de la colección de imágenes principal	Sin valor alternativo	Disponible
`nli:image6`	`name` o `property`	Escalar, primera coincidencia	URL de imagen HTTPS pública y absoluta	Ranura 6 de imagen orgánica personalizada	Independiente de la colección de imágenes principal	Sin valor alternativo	Disponible
`nli:video`	`name` o `property`	Escalar, primera coincidencia	URL de vídeo HTTPS pública, absoluta y directa	Vídeo orgánico estándar o heredado	Un valor válido sustituye la primera URL de vídeo de Schema.org detectada	Primer `VideoObject` de Schema.org válido; se aplica el comportamiento actual de detección e importación de miniaturas	Disponible; la asociación de varias versiones está prevista en API #4640
`nli:video:image`	`name` o `property`	Escalar, primera coincidencia	URL de imagen HTTPS pública y absoluta	Miniatura de la versión estándar	Debe afectar solo a la versión `nli:video` correspondiente	Detección actual de miniaturas del vídeo estándar	Prevista en API #4640; no se admite por ahora
`nli:short`	`name` o `property`	Escalar, primera coincidencia	URL de vídeo HTTPS pública, absoluta y directa	Versión vertical o corta	Crea una versión independiente de `nli:video`	Sin versión corta	Prevista en API #4640; no se admite por ahora
`nli:short:image`	`name` o `property`	Escalar, primera coincidencia	URL de imagen HTTPS pública y absoluta	Miniatura de la versión corta	Debe afectar solo a la versión `nli:short` correspondiente	Detección actual de miniaturas del vídeo corto	Prevista en API #4640; no se admite por ahora

3. Sustituir, repetir o fusionar#

3.1. Sustituciones escalares#

Un campo escalar conserva un único valor. Cuando hay un escalar nli:* compatible, tiene prioridad sobre su valor alternativo indicado. Emite el campo una sola vez. En los campos que aceptan ambos atributos, usar los dos genera un resultado ambiguo de primera coincidencia que depende del orden del documento.

3.2. Sustituciones repetibles#

Repite nli:image, nli:location o nli:author una vez por valor. Si se encuentra al menos un valor específico de Nonli, esa lista sustituye la lista correspondiente de Open Graph o de article:*.

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. Etiquetas fusionadas#

nli:tag es la excepción deliberada. Repítela con name; Nonli fusiona sus valores con article:tag y con cualquier extractor de etiquetas configurado, y después depura la lista combinada.

html

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

4. Fechas y URLs#

Las fechas deben ser fechas y horas ISO 8601 válidas con una zona horaria explícita. Estos ejemplos representan instantes precisos:

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">

No uses un valor con solo la fecha, como 2026-08-25, ni una hora sin zona, como 2026-08-25T09:30:00. Una fecha no válida puede hacer que el scraping falle en lugar de activar el valor alternativo.

Para imágenes y vídeos, usa URLs HTTPS directas y absolutas que devuelvan el archivo multimedia de forma pública. Las URLs relativas, las páginas de reproductor HTML, las sesiones de navegador, las URLs firmadas que caducan y las URLs que requieren cookies no son entradas de integración seguras.

5. Imágenes principales, ranuras personalizadas y miniaturas de vídeo#

Estas familias de imágenes son independientes:

nli:image es la colección repetible de imágenes principales del artículo;
nli:image1 a nli:image6 son seis ranuras personalizadas independientes que usa la selección de imágenes de los bots;
nli:video:image está prevista como miniatura únicamente del vídeo estándar;
nli:short:image está prevista como miniatura únicamente del vídeo corto.

Una imagen personalizada numerada no se une a nli:image ni la sustituye. La miniatura de una versión nunca debe convertirse en la imagen del artículo ni en la miniatura de la otra versión.

6. Versiones de vídeo estándar y corta#

A fecha de 25 de agosto de 2026, solo nli:video está disponible. El trabajo de API y de dominio del que se hace seguimiento en nonli/api#4640 sigue abierto, así que nli:short, nli:video:image y nli:short:image todavía no deben usarse como entradas en producción.

La sintaxis completa de destino que aparece a continuación sirve para planificar la implementación. Solo será válida cuando API #4640 esté desplegada y supere sus pruebas de compatibilidad HTML:

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">

Una vez desplegada, cada vídeo podrá aparecer solo. Una miniatura sin su vídeo correspondiente se ignorará y no creará ninguna versión. Si una versión no tiene una miniatura propia, conservará el comportamiento actual de detección e importación de esa versión y no tomará prestada la imagen de la otra.

7. Valores vacíos y no válidos#

No emitas un elemento meta cuando se desconoce su valor.
Los valores vacíos de nli:video y de nli:image1…nli:image6 se ignoran.
En las demás sustituciones, un elemento vacío puede contar como presente y anular su valor alternativo; usa solo contenido no vacío.
Una URL nli:video no válida no sustituye un vídeo de Schema.org válido.
Un nli:url relativo puede resolverse a partir de la página rastreada, pero los medios deben emitir una única URL canónica HTTPS absoluta y estable.
Si conviven las versiones con name y con property del mismo campo genérico, gana el primer elemento coincidente; emite solo una.

8. ¿HTML o MRSS?#

Usa estas etiquetas cuando Nonli rastree la página HTML de un artículo. Si tu CMS exporta un feed con recursos de vídeo, consulta mejor la guía del feed MRSS de vídeo. Explica cómo agrupar las versiones estándar y corta, cada una con su propia miniatura, en un único elemento del feed.

¿Te fue útil este artículo?