SEO y Sitemap

Índice · Antes: proyecto web · Clases nativas

SEO prepara etiquetas para buscadores y redes. Un sitemap enumera URLs que un buscador puede visitar; no mejora por sí solo la calidad o autorización de una página.

SEO::title("Productos")
SEO::description("Catálogo")
SEO::keywords(["joss", "productos"])
SEO::canonical("https://example.com/products")
SEO::og("image", "https://example.com/cover.png")
$tags = SEO::render()

También existe SEO::meta($name, $content). La salida escapa atributos HTML y agrega una Twitter card predeterminada.

Generación Dinámica de Sitemap (/sitemap.xml)

/sitemap.xml se genera en vivo en cada petición con una hermosa interfaz interactiva XSL (/sitemap.xsl). No escribe archivos físicos en disco.

1. Entradas Estáticas Manuales

Sitemap::add("/docs", "2026-07-15", "weekly", 0.8)

// O con mapas/arrays asociativos:
Sitemap::add({
    "url": "/contacto",
    "changefreq": "monthly",
    "priority": 0.6
})

2. Proveedores dinámicos

Sitemap::provider acepta una closure o función que retorna una lista de entradas de sitemap, agregando dinámicamente registros desde la base de datos:

Sitemap::provider(func() {
    return [
        {"url": "/blog/mi-post", "changefreq": "daily", "priority": 0.9}
    ]
})

3. Exclusiones de Rutas

Sitemap::exclude([
    "/api/*",
    "/admin/*",
    "/checkout/*"
])

La URL base usa el request actual, después APP_URL y finalmente http://localhost. Detrás de un proxy configura correctamente Host y X-Forwarded-Proto.

SEO::twitter no está registrado. SEO::render ya agrega una card predeterminada; usa SEO::meta("twitter:...", valor) para metadata adicional.

IndexNow (Indexación Instantánea)

IndexNow permite notificar en tiempo real a los motores de búsqueda (Bing, Yandex, Seznam, Naver) sobre cambios o nuevas páginas sin esperar a que un crawler recorra el sitemap.

// Generar la clave con CLI: joss indexnow generate
// O enviar URLs a IndexNow directamente:
IndexNow::submit("/blog/mi-nuevo-articulo")

// Notificar múltiples URLs por lote:
IndexNow::submit([
    "/blog/post-1",
    "/blog/post-2"
])

Al arrancar el servidor (joss server start, joss program start, etc.), el runtime detecta INDEXNOW_KEY en .env y el servidor HTTP de Joss responde automáticamente de forma interna en GET /{key}.txt con la clave en texto plano, validando la propiedad de tu dominio de forma instantánea. No necesitas crear archivos físicos en disco ni definir rutas en routes.joss.