> ## Documentation Index
> Fetch the complete documentation index at: https://adminroletesting-mintlify-d32b5473.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Guía de GEO: optimiza la documentación para búsquedas con IA

> Optimiza tu documentación para motores de respuesta de IA como ChatGPT, Perplexity y Google AI Overviews con técnicas de Generative Engine Optimization.

Las herramientas impulsadas por IA como ChatGPT, Perplexity y Google AI Overviews responden cada vez más a las preguntas de los usuarios directamente, citando fuentes en lugar de listar enlaces. Cuando un desarrollador pregunta "¿cómo me autentico con \[tu producto]?", una página de documentación bien optimizada es citada en la respuesta. Una página mal estructurada es ignorada, incluso si tiene un buen posicionamiento en la búsqueda tradicional.

Generative Engine Optimization (GEO) es la práctica de estructurar el contenido para que los sistemas de IA puedan comprenderlo, confiar en él y citarlo con precisión.

<div id="how-geo-differs-from-seo">
  ## Cómo difiere GEO del SEO
</div>

El SEO tradicional optimiza para motores de búsqueda que clasifican y enlazan páginas. GEO optimiza para sistemas de IA que leen, resumen y citan páginas en respuestas generadas.

Las mecánicas difieren de maneras importantes:

|                        | SEO                                               | GEO                                            |
| ---------------------- | ------------------------------------------------- | ---------------------------------------------- |
| Objetivo               | Posicionarse en los resultados de búsqueda        | Ser citado en respuestas generadas por IA      |
| Señales clave          | Backlinks, palabras clave, autoridad de la página | Precisión del contenido, estructura, concisión |
| Acción del usuario     | Hacer clic en un enlace                           | Leer una respuesta generada por IA             |
| Preferencia de formato | Cualquier contenido bien estructurado             | Contenido escaneable que responda preguntas    |

La buena noticia: los fundamentos se superponen ampliamente. El contenido preciso, bien estructurado y que responde preguntas directamente funciona bien en ambos. GEO se trata menos de trucos y más de claridad en la redacción.

<div id="how-ai-systems-decide-what-to-cite">
  ## Cómo los sistemas de IA deciden qué citar
</div>

Los motores de respuestas con IA evalúan el contenido basándose en algunos factores clave:

**Concisión.** Los sistemas de IA priorizan el contenido que responde la pregunta de inmediato. Una página que oculta la respuesta después de tres párrafos de contexto tiene menos probabilidades de ser citada que una que comienza con la respuesta.

**Precisión y señales de confianza.** Los sistemas de IA favorecen el contenido de fuentes autorizadas que parece fiable en cuanto a los hechos. Para la documentación, esto significa precisión técnica, versionado consistente y contenido que coincide con lo que el producto realmente hace.

**Claridad estructural.** El contenido organizado lógicamente, con encabezados significativos, listas y bloques de código, es más fácil de analizar y extraer correctamente para los sistemas de IA.

**Especificidad.** El contenido vago y de alto nivel ("esta función es flexible y potente") es menos citable que el contenido específico y detallado ("este endpoint devuelve un código de estado 429 cuando se excede el límite de velocidad de 100 solicitudes por minuto").

<div id="write-content-ai-systems-can-cite">
  ## Escribe contenido que los sistemas de IA puedan citar
</div>

<div id="lead-with-the-answer">
  ### Comienza con la respuesta
</div>

Estructura cada sección para que la información más importante aparezca primero. Los usuarios que hacen preguntas a herramientas de IA quieren respuestas directas, no preámbulos, ni contexto, ni advertencias antes del punto principal.

````mdx theme={null}
<!-- Comienza con la respuesta -->
## How to authenticate API requests

Include your API key in the Authorization header of every request:

```bash
curl -H "Authorization: Bearer YOUR_API_KEY" https://api.example.com/endpoint
```

<!-- Oculta la respuesta -->
## Authentication

Authentication is an important part of using our API. Before you can make any requests, you'll need to understand how our authentication system works. Our API uses bearer tokens...
````

<div id="use-headings-that-match-questions">
  ### Usa encabezados que coincidan con las preguntas
</div>

Escribe los encabezados H2 y H3 como las preguntas que hacen los usuarios, no como etiquetas de temas. Los sistemas de IA comparan las consultas de los usuarios con el texto de los encabezados al decidir qué contenido mostrar.

```mdx theme={null}
<!-- Encabezado que coincide con la consulta -->
## How do I rotate my API keys?

<!-- Etiqueta de tema — más débil -->
## API key management
```

<div id="be-specific-with-numbers-limits-and-examples">
  ### Sé específico con números, límites y ejemplos
</div>

Las descripciones vagas no se citan. Los detalles específicos y precisos sí. Los sistemas de IA pueden citar "límite de velocidad: 100 solicitudes por minuto por API key" con precisión. "Nuestra API tiene límites de velocidad" no le da a la IA nada útil que citar.

Para cada opción de configuración, parámetro o comportamiento:

* Indica el valor exacto o el rango
* Describe qué sucede en el límite
* Muestra un ejemplo de código concreto

<div id="keep-a-consistent-terminology">
  ### Mantén una terminología consistente
</div>

Los sistemas de IA construyen contexto a lo largo de una página. Si llamas a lo mismo "API key", "access token" y "API token" indistintamente, el resumen de la IA puede usar el término incorrecto o confundirse sobre si son la misma cosa. Una terminología consistente —un nombre por concepto, usado en todo momento— ayuda a los sistemas de IA a representar tu contenido con precisión.

<div id="format-for-ai-parsing">
  ## Formatea para el análisis de IA
</div>

<div id="use-sequential-non-skipping-heading-hierarchy">
  ### Usa una jerarquía de encabezados secuencial y sin saltos
</div>

No saltes de H2 a H4. Los sistemas de IA usan la jerarquía de encabezados para entender cómo se relacionan los temas. Una estructura plana y consistente es más fácil de analizar correctamente.

<div id="label-all-code-blocks">
  ### Etiqueta todos los bloques de código
</div>

Siempre declara el lenguaje de programación en los bloques de código. Esto ayuda a los sistemas de IA a entender lo que están leyendo y a mostrar el ejemplo correcto para el contexto del usuario.

````mdx theme={null}
```python
import requests
response = requests.get(url, headers={"Authorization": f"Bearer {api_key}"})
```
````

<div id="write-alt-text-for-images-and-diagrams">
  ### Escribe texto alternativo para imágenes y diagramas
</div>

Los sistemas de IA no pueden ver imágenes. Si un diagrama es la explicación principal de un concepto, añade una descripción de texto que transmita la misma información. El texto alternativo que describe lo que muestra un diagrama —no solo "diagrama de arquitectura"— le da a los sistemas de IA algo con qué trabajar.

<div id="use-specific-references-instead-of-pronouns">
  ### Usa referencias específicas en lugar de pronombres
</div>

Escribe "la API key" en lugar de "ella" o "este valor". Los sistemas de IA extraen contenido y pierden el contexto circundante. Las referencias con sustantivos específicos se mantienen precisas cuando se extraen; los pronombres se vuelven ambiguos.

<div id="mintlify-configuration-for-geo">
  ## Configuración de Mintlify para GEO
</div>

<div id="add-descriptive-page-metadata">
  ### Añade metadatos de página descriptivos
</div>

Los títulos y descripciones de las páginas son algunas de las señales más importantes que los sistemas de IA usan para entender el tema de una página. Escríbelos como si respondieras a la pregunta "¿qué ayuda a hacer esta página a los usuarios?"

```mdx theme={null}
---
title: "How to authenticate API requests"
description: "Add your API key to the Authorization header to authenticate requests. Includes examples in JavaScript, Python, and cURL."
---
```

<div id="control-indexing-settings">
  ### Controla la configuración de indexación
</div>

Por defecto, Mintlify indexa las páginas incluidas en la navegación de tu `docs.json`. Para incluir páginas ocultas en el contexto del asistente de IA y la búsqueda:

```json docs.json theme={null}
{
  "seo": {
    "indexing": "all"
  }
}
```

<div id="llmstxt">
  ### LLMs.txt
</div>

Mintlify genera automáticamente un archivo `llms.txt` para tu documentación. LLMs.txt funciona de manera similar a `sitemap.xml` para la búsqueda tradicional: proporciona a los sistemas de IA un índice estructurado de tu documentación. No se requiere configuración.

Puedes ver tu LLMs.txt añadiendo `/llms.txt` a la URL de tu documentación.

<div id="allow-ai-agents-in-robotstxt">
  ### Permitir agentes de IA en robots.txt
</div>

Tu archivo `robots.txt` controla qué bots pueden rastrear tu sitio. Si bloquea agentes de usuario de IA, herramientas como ChatGPT, Claude y Perplexity no pueden leer tu documentación ni citarla en sus respuestas.

El `robots.txt` generado automáticamente por Mintlify permite todos los rastreadores por defecto e incluye [directivas Content-Signal](/es/optimize/seo#content-signal-directives) que habilitan tu documentación para el entrenamiento de IA, la indexación en búsquedas y la generación de respuestas con IA. Si usas un [archivo robots.txt personalizado](/es/optimize/seo#custom-sitemaps-and-robotstxt-files), asegúrate de que no bloquee a los agentes de IA. Los agentes de usuario de IA más comunes incluyen:

* `GPTBot`, `OAI-SearchBot`, `ChatGPT-User` (OpenAI)
* `ClaudeBot`, `Claude-User` (Anthropic)
* `PerplexityBot` (Perplexity)
* `Google-Extended` (Gemini)

Un `robots.txt` que bloquea todos los rastreadores también bloquea los agentes de IA:

```txt Bad — blocks all AI agents theme={null}
User-agent: *
Disallow: /
```

Para bloquear rastreadores específicos mientras permites agentes de IA, apunta solo a los bots que deseas restringir:

```txt Good — allows AI agents theme={null}
User-agent: BadBot
Disallow: /

User-agent: *
Disallow: /private/
```

Ejecuta [`mint score`](/es/cli/commands#mint-score) para verificar si el `robots.txt` de tu sitio permite agentes de IA. La verificación `robotsTxtAllowsAI` se aprueba cuando ningún agente de usuario de IA está bloqueado.

<div id="test-how-ai-tools-represent-your-docs">
  ## Prueba cómo las herramientas de IA representan tu documentación
</div>

Prueba regularmente si las herramientas de IA están citando tu documentación con precisión.

Haz preguntas específicas sobre tu producto en ChatGPT, Perplexity y Claude:

* "¿Cómo autentico las solicitudes a la API usando \[tu producto]?"
* "¿Qué sucede cuando excedo el límite de velocidad en \[tu producto]?"
* "Muéstrame cómo manejar errores en la API de \[tu producto]."

Verifica en las respuestas:

* Si tu documentación es citada en absoluto
* Si el contenido citado es preciso
* Si los ejemplos de código son correctos
* Si la IA está recomendando el enfoque correcto

Cuando las herramientas de IA dan respuestas incorrectas sobre tu producto, a menudo indica que tu documentación es ambigua, incompleta o contradictoria, en lugar de que la IA esté rota.

<div id="frequently-asked-questions">
  ## Preguntas frecuentes
</div>

<AccordionGroup>
  <Accordion title="¿Reemplaza GEO al SEO?">
    No. La búsqueda tradicional todavía genera tráfico significativo, y muchos usuarios prefieren hacer clic en la documentación en lugar de leer resúmenes generados por IA. GEO y SEO son complementarios: la documentación bien estructurada, precisa y que responde preguntas directamente funciona bien en ambos. Las prácticas se refuerzan mutuamente.
  </Accordion>

  <Accordion title="¿Cuánto tiempo tardan en aparecer las mejoras de GEO?">
    Más rápido que el SEO en muchos casos. Los sistemas de IA como Perplexity y ChatGPT rastrean e indexan contenido con más frecuencia que los motores de búsqueda tradicionales. Las mejoras en la claridad y estructura del contenido pueden aparecer en respuestas generadas por IA en días o semanas. Dicho esto, los sistemas de IA también tienen en cuenta la autoridad del dominio y las señales de enlaces que tardan más en construirse.
  </Accordion>

  <Accordion title="¿Necesito hacer algo especial para Google AI Overviews específicamente?">
    Google AI Overviews usa las mismas señales que Google Search con peso adicional en el contenido que responde directamente a la consulta específica. Las páginas que ya se posicionan bien en Google Search para una consulta tienen más probabilidades de aparecer en AI Overviews para la misma consulta. Las principales prácticas de GEO —comenzar con la respuesta, detalles específicos, estructura clara— también se aplican aquí.
  </Accordion>

  <Accordion title="¿Debería escribir de manera diferente para IA versus lectores humanos?">
    No. El contenido que es claro y directo para los humanos es claro y directo para los sistemas de IA. Optimizar específicamente para IA a expensas de la legibilidad humana es contraproducente y tiende a producir contenido que no es agradable de leer ni bien citado. Escribe para tus usuarios primero; GEO surge naturalmente de una buena redacción técnica.
  </Accordion>

  <Accordion title="¿Qué es llms.txt y necesito configurarlo?">
    LLMs.txt es una convención —similar a robots.txt— para proporcionar a los sistemas de IA un índice estructurado de tu documentación. Mintlify lo genera automáticamente. No necesitas configurarlo. Puedes ver tu archivo LLMs.txt en `https://your-docs-domain.com/llms.txt`.
  </Accordion>
</AccordionGroup>