[Tutorial] - Sitemap Plano en Astro: El truco para Google Search Console

Contenido generado mediante asistencia de IA basándose en notas y experiencias reales del autor.

¿Alguna vez has notado que Google Search Console tarda una eternidad en “descubrir” las URLs de tu sitemap en Astro? El culpable suele ser el formato por defecto: un sitemap-index.xml que apunta a otros archivos. A Google le encanta la simplicidad, y un sitemap plano es la solución.

¿Por dónde empezamos?

Astro tiene una integración fantástica llamada @astrojs/sitemap. Es potente, pero por defecto intenta ser “organizada” creando un índice. Para sitios pequeños o medianos, esto es añadir un paso extra innecesario para los bots de Google.

Queremos pasar de esto:

• sitemap-index.xml -> sitemap-0.xml

A esto:

• sitemap.xml (con todo el contenido)

¿Qué nos detuvo? (El desafío técnico)

La integración oficial no tiene un flag de “hazlo plano” (al menos no uno que funcione siempre como queremos). Si intentamos manipularlo durante la generación, podemos romper la lógica interna de Astro. La solución más robusta es dejar que Astro haga su trabajo y luego, justo antes de terminar, darle nuestro toque personal.

¿Cómo lo solucionamos?

Creamos un script de “limpieza” que corre justo después del build. Este script busca el archivo real de URLs (sitemap-0.xml), lo renombra al estándar sitemap.xml y borra el índice que ya no necesitamos.

Paso 1: El Script ⭐

Crea un archivo en scripts/flat-sitemap.js:

// scripts/flat-sitemap.js
import fs from 'fs';
import path from 'path';

const distDir = path.join(process.cwd(), 'dist');
const sitemap0Path = path.join(distDir, 'sitemap-0.xml');
const sitemapIndexPath = path.join(distDir, 'sitemap-index.xml');
const finalSitemapPath = path.join(distDir, 'sitemap.xml');

if (fs.existsSync(sitemap0Path)) {
  fs.renameSync(sitemap0Path, finalSitemapPath);
  console.log('✅ sitemap-0.xml renombrado a sitemap.xml');
  if (fs.existsSync(sitemapIndexPath)) {
    fs.unlinkSync(sitemapIndexPath);
    console.log('🗑️ sitemap-index.xml eliminado');
  }
}

Paso 2: Automatización en package.json

Solo tenemos que decirle a nuestro comando de build que ejecute este script al terminar:

"scripts": {
  "build": "astro build && node scripts/flat-sitemap.js"
}

Paso 3: Avisar a los Robots

No olvides actualizar tu public/robots.txt para que apunte al nuevo archivo:

Sitemap: https://tu-dominio.com/sitemap.xml

¿Qué descubrimos al final?

Al implementar esto, Google Search Console suele pasar del estado “No se pudo obtener” a “Correcto” casi de inmediato (aunque a veces tarda horas en actualizarse). Es un pequeño ajuste técnico que hace que tu SEO sea mucho más predecible y eficiente.

Por cierto, este artículo está hecho con asistencia de IA pero basado en una experiencia que tuve con mi blog, hace mucho tiempo que GSC no me detectaba las nuevas entradas y después de implementar lo hizo.