Saltar al contenido principal

Introducción

Recupera y actualiza el mapa del sitio de tu proyecto para ayudar a los motores de búsqueda a descubrir e indexar páginas.

Más información sobre la interfaz de usuario del módulo https://doc.oneentry.cloud/docs/category/sitemap

🎯 ¿Qué hace este módulo?​

El módulo Sitemap te permite recuperar y (re)generar el mapa del sitio de tu proyecto OneEntry: una lista estructurada de todas las páginas utilizadas por los motores de búsqueda para indexar tu contenido de manera eficiente.

Un mapa del sitio indica a los motores de búsqueda qué páginas existen, ayudando a Google, Bing y otros rastreadores a descubrir e indexar tu contenido más rápido. La generación se activa explícitamente a través de updateSitemap(body); getSitemap() devuelve la lista de URLs del mapa del sitio generadas.

🚀 Inicio Rápido​

Inicializa el módulo desde defineOneEntry:


const { Sitemap } = defineOneEntry(
  "your-project-url", {
    "token": "your-app-token"
  }
);

Recupera la lista de URLs del mapa del sitio generadas:

// Returns an array of sitemap URL strings (string[]).
const sitemaps = await Sitemap.getSitemap();

sitemaps.forEach((url) => {
  console.log(url);
});

✨ Conceptos Clave​

¿Qué es un Mapa del Sitio?​

Un mapa del sitio es un archivo XML que lista las páginas de tu sitio web para que los motores de búsqueda puedan descubrirlas y rastrearlas de manera eficiente. Cada entrada puede llevar una URL, fecha de última modificación, frecuencia de cambio y prioridad.

Lectura vs. Actualización del Mapa del Sitio​

getSitemap() devuelve un array de cadenas de URL del mapa del sitio (string[]), por ejemplo:

[
  'https://your-project.oneentry-cloud.com/sitemap.xml',
  'https://your-project.oneentry-cloud.com/sitemap-en.xml'
]

Los campos por entrada url, lastmod, changefreq, priority son propiedades de entrada de ISitemapQuery (pasadas a updateSitemap()), no forman parte de la respuesta de getSitemap().

Valores de Frecuencia de Cambio​

Estos valores son parte de la entrada de updateSitemap() (changefreq):

ValorSignificado
alwaysLa página cambia cada vez que se accede
hourlyLa página cambia cada hora
dailyLa página cambia cada día
weeklyLa página cambia cada semana
monthlyLa página cambia cada mes
yearlyLa página cambia una vez al año
neverPágina archivada, no cambiará

📋 Lo Que Necesitas Saber​

Generando el mapa del sitio​

El mapa del sitio se genera cuando llamas a updateSitemap(body), donde body (un ISitemapQuery) proporciona las baseUrls por idioma utilizadas para construir las URLs. No se produce automáticamente; tú activas la generación explícitamente.

Recuperando el mapa del sitio​

Usa getSitemap() para recuperar la lista de URLs del mapa del sitio generadas (string[]).

Enviando a motores de búsqueda​

El módulo no envía directamente a los motores de búsqueda. Después de recuperar las URLs del mapa del sitio, envíalas a través de tus herramientas para webmasters de motores de búsqueda (Google Search Console, Bing Webmaster Tools, etc.) y mantén el mapa del sitio actualizado después de cambios importantes en el contenido.

📊 Tabla de Referencia Rápida​

MétodoDescripción
getSitemap()Obtener las URLs actuales del mapa del sitio
updateSitemap()Generar/actualizar el mapa del sitio

❓ Preguntas Comunes (FAQ)​

¿Cómo envío mi mapa del sitio a Google?​

Genera mapas del sitio con updateSitemap(body) (pasando tus baseUrls), recupera las URLs del mapa del sitio resultantes con getSitemap(), y luego envía una URL del mapa del sitio en Google Search Console bajo Mapas del Sitio.

¿Con qué frecuencia debo actualizar mi mapa del sitio?​

Actualiza tu mapa del sitio cada vez que agregues nuevas páginas, actualices significativamente el contenido existente o cambies la estructura de tu sitio. Para sitios de alto tráfico, considera actualizaciones automáticas activadas por cambios en el contenido.

¿Qué significa el campo de prioridad?​

La prioridad (0.0 a 1.0) es una indicación para los motores de búsqueda sobre la importancia relativa de las páginas en tu sitio. La página de inicio suele ser 1.0, las páginas de categoría 0.8, y las páginas de contenido individuales 0.6–0.7. Es parte de la entrada de updateSitemap() y no afecta directamente al ranking.

🎓 Mejores Prácticas​

  • Regenerar después de cambios en el contenido - Llama a updateSitemap() después de agregar o cambiar significativamente páginas.
  • Establecer una frecuencia de cambio precisa - No afirmes que las páginas cambian más a menudo de lo que realmente lo hacen.
  • Usar prioridades significativas - Página de inicio > Categorías > Productos > Publicaciones de blog.
  • Incluir todas las páginas importantes - No excluyas páginas que deseas que sean indexadas.
  • Enviar después de actualizaciones importantes - Notifica a los motores de búsqueda proactivamente a través de herramientas para webmasters.

🔗 Documentación Relacionada​