Documento RSS

Para construir un canal de contenido, es necesario crear un fichero basado en XML. Este fichero, que tendrá extensión .rss, se publicará en uno de los directorios del sitio web desde el que se oferta.

Estructura

Un documento RSS tiene el siguiente aspecto:

<?xml version="1.0" encoding="UTF-8" ?>
<rss version="2.0">
<channel>
    <title>RSS Title</title>
    <description>This is an example of an RSS feed</description>
    <link>http://www.example.com/main.html</link>
    <copyright>2020 Example.com All rights reserved</copyright>
    <lastBuildDate>Mon, 6 September 2010 00:01:00 +0000</lastBuildDate>
    <pubDate>Sun, 6 September 2009 16:20:00 +0000</pubDate>
    <ttl>1800</ttl>

    <item>
        <title>Example entry</title>
        <description>Here is some text containing an interesting description.</description>
        <link>http://www.example.com/blog/post/1</link>
        <guid isPermaLink="false">7bd204c6-1655-4c27-aeee-53f933c5395f</guid>
        <pubDate>Sun, 6 September 2009 16:20:00 +0000</pubDate>
    </item>
</channel>
</rss>

Los elementos básicos que forman parte de un documento RSS son los siguientes:

Cabecera del documento.
Canal o canales.
Secciones.

Cabecera

La cabecera es la primera linea del documento, que consiste en una declaración XML.

<?xml version="1.0" encoding="UTF-8" ?>

Para la codificación, se utilizará preferentemente UTF-8.

Canal

A continuación, aparece la etiqueta <rss>. La declaración RSS que indica que es un documento RSS y la versión empleada.

<rss version="2.0">

El elemento <rss> es el elemento raíz de un documento RSS.

Dentro de ella, aparece un canal (etiqueta <channel>), que se encarga de describir el feed RSS propiamente dicho. Tiene 3 elementos hijos obligatorios:

Elemento	Descripción
`<title>`	Título del canal.
`<description>`	Descripción del canal.
`<link>`	Enlace del canal.

También hay varios elementos opcionales. Algunos de ellos son:

Elemento	Descripción
`<language>`	Define el idioma del canal.
`<category>`	Define una o más categorías a las que pertenece la fuente.
`<copyright>`	Indica quién posee los derechos de autor.

El canal es el que determina el sitio web asociado a la fuente web a la que hace referencia el fichero.

No existe ninguna restricción respecto a la cantidad de canales de contenidos que se pueden ofrecer desde un sitio web.

Secciones

Un canal está formado por secciones o artículos. Cada una de las secciones es una referencia a la web que contiene uno de los servicios que se van a ofrecer. En un canal pueden incluirse tantas secciones como se quiera, lo que hace que un canal de contenido pueda tener un tamaño enorme si contiene un gran número de enlaces independientes.

Una sección se define con el elemento <item> y tiene 3 elementos hijos obligatorios:

Elemento	Descripción
`<title>`	Título del artículo.
`<description>`	Descripción del artículo.
`<link>`	Enlace del artículo.

También hay varios elementos opcionales. Algunos de ellos son:

Elemento	Descripción
`<author>`	Define el autor o autora del artículo.
`<category>`	Define una o más categorías a las que pertenece la fuente-
`<guid>`	Define un identificador único para el elemento-

Ejemplo

El canal RSS del Boletín Oficial del Estado (BOE) permite obtener las últimas publicaciones. Una versión muy acortada (solo con 2 ítems) de lo que podemos encontrar es la siguiente:

<?xml version="1.0" encoding="ISO-8859-1"?>
<rss version="2.0">
  <channel>
    <title>BOE - Boletín Oficial del Estado</title>
    <link>http://www.boe.es/diario_boe/</link>
    <description>Leyes, disposiciones, actos, textos legales y anuncios publicados en la edición de hoy</description>
    <language>es-es</language>
    <pubDate>Sat, 26 Nov 2022 00:00:00 +0100</pubDate>
    <lastBuildDate>Sat, 26 Nov 2022 00:00:00 +0100</lastBuildDate>
    <webMaster>webmaster@boe.es</webMaster>
    <item>
      <title>Sumario</title>
      <link>http://www.boe.es/boe/dias/2022/11/26/</link>
      <description>Sumario del diario núm. 284, correspondiente al sábado 26 de noviembre de 2022. - Referencia: BOE-S-2022-284 - KBytes: 496</description>
      <category>Sumario</category>
      <guid isPermaLink="true">http://www.boe.es/boe/dias/2022/11/26/</guid>
      <pubDate>Sat, 26 Nov 2022 00:00:00 +0100</pubDate>
    </item>
    <item>
      <title>Ley 24/2022, de 25 de noviembre, para el reconocimiento efectivo del tiempo de prestación del servicio social de la mujer en el acceso a la pensión de jubilación parcial.</title>
      <link>http://www.boe.es/diario_boe/txt.php?id=BOE-A-2022-19621</link>
      <description>I. Disposiciones generales - JEFATURA DEL ESTADO - Seguridad Social. Pensiones - Referencia: BOE-A-2022-19621 - KBytes: 207 - Páginas: 4</description>
      <category>I. Disposiciones generales</category>
      <category>JEFATURA DEL ESTADO</category>
      <guid isPermaLink="true">http://www.boe.es/boe/dias/2022/11/26/pdfs/BOE-A-2022-19621.pdf</guid>
      <pubDate>Sat, 26 Nov 2022 00:00:00 +0100</pubDate>
    </item>
  </channel>
</rss>

Probar en el navegador

Documento RSS

Al tratarse de un documento XML, en el navegadaor es posible contraer y expandir los elementos para ver el documento más cómodamente.

El elemento raíz es rss. Tiene un único hijo, <channel>, que define el canal de noticias. Como hijos de este elemento hay varios elementos <item>, uno por cada noticia publicada en el canal.

Los hijos del elemento <item> son:

Un título (<title>)
Un vínculo (<link>)
Una descripción (<descripción>)
Una o más categorías (<category>)
Un elemento GUID (<guid>)
Una fecha de publicación (<pubDate>).

El primer elemento <item> es Sumario, como se puede ver en el título, la descripción y la categoría.

<?xml version="1.0" encoding="ISO-8859-1"?>
<rss version="2.0">
  <channel>
    <title>BOE - Boletín Oficial del Estado</title>
    <link>http://www.boe.es/diario_boe/</link>
    <description>Leyes, disposiciones, actos, textos legales y anuncios publicados en la edición de hoy</description>
    <language>es-es</language>
    <pubDate>Sat, 26 Nov 2022 00:00:00 +0100</pubDate>
    <lastBuildDate>Sat, 26 Nov 2022 00:00:00 +0100</lastBuildDate>
    <webMaster>webmaster@boe.es</webMaster>
    <item>
      <title>Sumario</title>
      <link>http://www.boe.es/boe/dias/2022/11/26/</link>
      <description>Sumario del diario núm. 284, correspondiente al sábado 26 de noviembre de 2022. - Referencia: BOE-S-2022-284 - KBytes: 496</description>
      <category>Sumario</category>
      <guid isPermaLink="true">http://www.boe.es/boe/dias/2022/11/26/</guid>
      <pubDate>Sat, 26 Nov 2022 00:00:00 +0100</pubDate>
    </item>
    <item>
      <title>Ley 24/2022, de 25 de noviembre, para el reconocimiento efectivo del tiempo de prestación del servicio social de la mujer en el acceso a la pensión de jubilación parcial.</title>
      <link>http://www.boe.es/diario_boe/txt.php?id=BOE-A-2022-19621</link>
      <description>I. Disposiciones generales - JEFATURA DEL ESTADO - Seguridad Social. Pensiones - Referencia: BOE-A-2022-19621 - KBytes: 207 - Páginas: 4</description>
      <category>I. Disposiciones generales</category>
      <category>JEFATURA DEL ESTADO</category>
      <guid isPermaLink="true">http://www.boe.es/boe/dias/2022/11/26/pdfs/BOE-A-2022-19621.pdf</guid>
      <pubDate>Sat, 26 Nov 2022 00:00:00 +0100</pubDate>
    </item>
  </channel>
</rss>

En este caso los elementos elemento <guid> y <link> coinciden. Si se accede a esa URL en el navegador, se encuentra, efectivamente, el sumario del BOE para el 26 de noviembre de 2022.

El resto de elementos <item> se corresponden con los artículos publicados ese día. Tienen dos elementos <category> y los elementos <link> y <guid> no son iguales.

<?xml version="1.0" encoding="ISO-8859-1"?>
<rss version="2.0">
  <channel>
    <title>BOE - Boletín Oficial del Estado</title>
    <link>http://www.boe.es/diario_boe/</link>
    <description>Leyes, disposiciones, actos, textos legales y anuncios publicados en la edición de hoy</description>
    <language>es-es</language>
    <pubDate>Sat, 26 Nov 2022 00:00:00 +0100</pubDate>
    <lastBuildDate>Sat, 26 Nov 2022 00:00:00 +0100</lastBuildDate>
    <webMaster>webmaster@boe.es</webMaster>
    <item>
      <title>Sumario</title>
      <link>http://www.boe.es/boe/dias/2022/11/26/</link>
      <description>Sumario del diario núm. 284, correspondiente al sábado 26 de noviembre de 2022. - Referencia: BOE-S-2022-284 - KBytes: 496</description>
      <category>Sumario</category>
      <guid isPermaLink="true">http://www.boe.es/boe/dias/2022/11/26/</guid>
      <pubDate>Sat, 26 Nov 2022 00:00:00 +0100</pubDate>
    </item>
    <item>
      <title>Ley 24/2022, de 25 de noviembre, para el reconocimiento efectivo del tiempo de prestación del servicio social de la mujer en el acceso a la pensión de jubilación parcial.</title>
      <link>http://www.boe.es/diario_boe/txt.php?id=BOE-A-2022-19621</link>
      <description>I. Disposiciones generales - JEFATURA DEL ESTADO - Seguridad Social. Pensiones - Referencia: BOE-A-2022-19621 - KBytes: 207 - Páginas: 4</description>
      <category>I. Disposiciones generales</category>
      <category>JEFATURA DEL ESTADO</category>
      <guid isPermaLink="true">http://www.boe.es/boe/dias/2022/11/26/pdfs/BOE-A-2022-19621.pdf</guid>
      <pubDate>Sat, 26 Nov 2022 00:00:00 +0100</pubDate>
    </item>
  </channel>
</rss>

Los dos elementos <category> son para, por un lado, indicar que es una disposición general, y por otro, indicar que se trata de la Jefatura del Estado.

El elemento <link> contiene un vínculo que lleva a una página con el contenido en HTML. El elemento <guid> lleva a la versión en PDF del mismo contenido.

Estructura​

Cabecera​

Canal​

Secciones​

Ejemplo​

Estructura

Cabecera

Canal

Secciones

Ejemplo