> ## Documentation Index
> Fetch the complete documentation index at: https://omer-914cc1c6.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# SEO
> Buenas prácticas de SEO y configuración de metaetiquetas para mejorar la visibilidad en buscadores
Mintlify gestiona automáticamente muchas buenas prácticas de SEO, entre ellas:
* Generación de metaetiquetas
* Generación del sitemap y del archivo `robots.txt`
* Estructura HTML semántica
* Optimización para móviles
Puedes personalizar por completo las metaetiquetas de tu sitio añadiendo el campo `metatags` a tu `docs.json` o al frontmatter de una página.
## Metaetiquetas globales
Puedes configurar metaetiquetas predeterminadas añadiendo el campo `metadata` a tu `docs.json`.
```json theme={null}
"seo": {
"metatags": {
"og:image": "enlace a tu imagen de meta etiqueta por defecto"
}
}
```
## Metatags específicos de la página
Agrega tus metatags a la metadata de la página de la siguiente manera:
```mdx theme={null}
---
title: 'Título de tu página de ejemplo'
'og:image': 'enlace a la imagen de tu meta etiqueta'
---
```
Las etiquetas meta con dos puntos deben ir entre comillas cuando las incluyas en la metadata de la página.
## Referencia de metaetiquetas comunes
A continuación encontrarás una lista completa de metaetiquetas que puedes añadir a tu `docs.json`. Estas metaetiquetas ayudan a mejorar el SEO de tu sitio, el uso compartido en redes sociales y la compatibilidad con los navegadores.
Puedes previsualizar cómo se verán tus metaetiquetas en diferentes plataformas usando [metatags.io](https://metatags.io/).
```json expandable theme={null}
"seo": {
"metatags": {
"robots": "noindex",
"charset": "UTF-8",
"viewport": "width=device-width, initial-scale=1.0",
"description": "Descripción de la página",
"keywords": "palabra_clave1, palabra_clave2, palabra_clave3",
"author": "Nombre del Autor",
"robots": "index, follow",
"googlebot": "index, follow",
"google": "notranslate",
"google-site-verification": "verification_token",
"generator": "Mintlify",
"theme-color": "#000000",
"color-scheme": "light dark",
"canonical": "https://your-custom-domain-here.com",
"format-detection": "telephone=no",
"referrer": "origin",
"refresh": "30",
"rating": "general",
"revisit-after": "7 days",
"language": "en",
"copyright": "Copyright 2024",
"reply-to": "email@example.com",
"distribution": "global",
"coverage": "Mundial",
"category": "Tecnología",
"target": "all",
"HandheldFriendly": "True",
"MobileOptimized": "320",
"apple-mobile-web-app-capable": "yes",
"apple-mobile-web-app-status-bar-style": "black",
"apple-mobile-web-app-title": "Título de la App",
"application-name": "Nombre de la App",
"msapplication-TileColor": "#000000",
"msapplication-TileImage": "path/to/tile.png",
"msapplication-config": "path/to/browserconfig.xml",
"og:title": "Título de Open Graph",
"og:type": "website",
"og:url": "https://example.com",
"og:image": "https://example.com/image.jpg",
"og:description": "Descripción de Open Graph",
"og:site_name": "Nombre del Sitio",
"og:locale": "en_US",
"og:video": "https://example.com/video.mp4",
"og:audio": "https://example.com/audio.mp3",
"twitter:card": "summary",
"twitter:site": "@username",
"twitter:creator": "@username",
"twitter:title": "Título de Twitter",
"twitter:description": "Descripción de Twitter",
"twitter:image": "https://example.com/image.jpg",
"twitter:image:alt": "Descripción de la Imagen",
"twitter:player": "https://example.com/player",
"twitter:player:width": "480",
"twitter:player:height": "480",
"twitter:app:name:iphone": "Nombre de la App",
"twitter:app:id:iphone": "12345",
"twitter:app:url:iphone": "app://",
"article:published_time": "2024-01-01T00:00:00+00:00",
"article:modified_time": "2024-01-02T00:00:00+00:00",
"article:expiration_time": "2024-12-31T00:00:00+00:00",
"article:author": "Nombre del Autor",
"article:section": "Tecnología",
"article:tag": "etiqueta1, etiqueta2, etiqueta3",
"book:author": "Nombre del Autor",
"book:isbn": "1234567890",
"book:release_date": "2024-01-01",
"book:tag": "etiqueta1, etiqueta2, etiqueta3",
"profile:first_name": "John",
"profile:last_name": "Doe",
"profile:username": "johndoe",
"profile:gender": "male",
"music:duration": "205",
"music:album": "Nombre del Álbum",
"music:album:disc": "1",
"music:album:track": "1",
"music:musician": "Nombre del Artista",
"music:song": "Nombre de la Canción",
"music:song:disc": "1",
"music:song:track": "1",
"video:actor": "Nombre del Actor",
"video:actor:role": "Nombre del Papel",
"video:director": "Nombre del Director",
"video:writer": "Nombre del Guionista",
"video:duration": "120",
"video:release_date": "2024-01-01",
"video:tag": "etiqueta1, etiqueta2, etiqueta3",
"video:series": "Nombre de la Serie"
}
}
```
## Sitemaps y archivos robots.txt
Mintlify genera automáticamente un archivo `sitemap.xml` y un archivo `robots.txt`. Puedes ver tu sitemap añadiendo `/sitemap.xml` a la URL de tu sitio de documentación.
De forma predeterminada, solo se incluyen las páginas definidas en tu `docs.json`. Para incluir enlaces ocultos, añade `seo.indexing` a tu `docs.json`:
```json theme={null}
"seo": {
"indexing": all
}
```
### Sitemaps personalizados y archivos robots.txt
Para añadir un archivo `sitemap.xml` o `robots.txt` personalizado, crea un archivo `sitemap.xml` o `robots.txt` en la raíz de tu proyecto. Añadir un archivo personalizado reemplazará el archivo generado automáticamente con el mismo nombre. Si eliminas un archivo personalizado, se volverá a usar el archivo predeterminado.
## Desactivar la indexación
Si quieres impedir que los motores de búsqueda indexen una página, puedes incluir lo siguiente en el [frontmatter](es/pages) de tu página:
```
---
noindex: true
---
```
También puedes especificar `noindex` para todas las páginas de tu documentación configurando el campo `metadata.robots` en `"noindex"` en tu `docs.json`:
```json theme={null}
"seo": {
"metatags": {
"robots": "noindex"
}
}
```
## Mejores prácticas de SEO
* Usa títulos de página claros y descriptivos (50-60 caracteres)
* Redacta descripciones convincentes (150-160 caracteres)
* Incluye palabras clave relevantes
* Asegúrate de que cada título y descripción de página sean únicos
* Usa una jerarquía de encabezados adecuada (H1 → H2 → H3)
* Escribe primero para las personas y después para los motores de búsqueda
* Incluye palabras clave relevantes en encabezados y en el contenido
* Mantén las URL cortas, descriptivas y organizadas jerárquicamente
* Divide el contenido extenso con subtítulos y listas
* Enlaza a páginas relacionadas dentro de tu documentación
* Usa texto de anclaje descriptivo en lugar de "haz clic aquí"
* Crea clústeres temáticos enlazando conceptos relacionados
* Usa las funciones automáticas de referencias cruzadas
* Usa nombres de archivo descriptivos para las imágenes
* Incluye siempre texto alternativo por accesibilidad y SEO
* Optimiza el tamaño de los archivos de imagen para una carga más rápida
* Usa imágenes relevantes que respalden tu contenido