Saltar al contenido principal
Esta página explica estrategias fundamentales para optimizar el SEO de tu sitio de documentación.

​
Conceptos básicos de contenido

Facilita que los motores de búsqueda exploren tu redacción y estructura.
  • Encabezados y subtítulos: Usa encabezados secuenciales y con sentido para estructurar tu contenido. Cada página tiene un H1 generado a partir de la propiedad title: en el frontmatter.
  • Párrafos breves y viñetas: Divide bloques grandes de texto en secciones fáciles de leer. Usa viñetas y listas numeradas cuando corresponda.
  • Enlaces internos: Enlaza contenido relacionado usando texto de anclaje descriptivo. Por ejemplo, “Más información sobre limitación de tasa” en lugar de “Haz clic aquí”.

​
Conceptos básicos de SEO técnico

Una vez que tu contenido esté optimizado, asegúrate de que tu documentación rinda bien desde el punto de vista técnico. Estas prácticas básicas de SEO técnico ayudan a que tu documentación sea más fácil de encontrar:
  • Metatags y descripciones: Redacta títulos optimizados para SEO (50–60 caracteres) y descripciones (150–160 caracteres) para cada página. La mayoría de los metatags se generan automáticamente.
  • Texto alternativo para imágenes: Incluye texto alternativo descriptivo en las imágenes con palabras clave relevantes. Por ejemplo, “flujo de autenticación de API con OAuth 2.0” en lugar de solo “diagrama”. Esto mejora el SEO y la accesibilidad.
  • Sitemaps: Asegúrate de que tu sitemap esté actualizado. Mintlify genera automáticamente un sitemap. No obstante, puedes crear uno manualmente si prefieres un formato personalizado. Una vez creado, los motores de búsqueda lo indexan con el tiempo, pero puedes enviar tu sitemap directamente a Google Search Console para acelerar el proceso.

​
Rendimiento de la página

Usa herramientas como Google PageSpeed Insights para identificar oportunidades de mejora técnica de SEO. Ejemplos de optimizaciones más avanzadas:
  • Optimiza los recursos para mayor velocidad: Comprime imágenes con formatos como WebP o AVIF y asegúrate de que tus páginas carguen rápido (idealmente en menos de 3 segundos).
  • Datos estructurados (schema markup): Añade marcado de esquema (p. ej., HowTo, FAQ) a tus páginas para ayudar a los motores de búsqueda a comprender y posicionar mejor tu contenido.

​
Investigación de palabras clave

Para aumentar el tráfico orgánico, dedica tiempo a entender qué palabras clave ayudan a los usuarios a llegar a tu documentación.
  • Investigación de palabras clave: Usa herramientas gratuitas como Google Keyword Planner o Keywords Everywhere para identificar frases comunes o palabras clave de cola larga.
  • Integra palabras clave de forma natural: Incorpora palabras clave de manera natural en títulos, subtítulos y a lo largo del cuerpo del texto. No las sobrecargues. Tu documentación debe estar escrita para tus usuarios, no para los motores de búsqueda.
⌘I