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

# Guide GEO : optimisez la documentation pour la recherche IA

> Optimisez votre doc pour les moteurs de réponses IA comme ChatGPT, Perplexity et Google AI Overviews grâce aux techniques de Generative Engine Optimization.

Les outils alimentés par l'IA comme ChatGPT, Perplexity et Google AI Overviews répondent de plus en plus directement aux questions des utilisateurs, en citant des sources plutôt qu'en listant des liens. Lorsqu'un développeur demande "comment m'authentifier avec \[votre produit]", une page de documentation bien optimisée est citée dans la réponse. Une page mal structurée est ignorée, même si elle est bien classée dans la recherche traditionnelle.

Generative Engine Optimization (GEO) est la pratique qui consiste à structurer le contenu pour que les systèmes d'IA puissent le comprendre, lui faire confiance et le citer avec précision.

<div id="how-geo-differs-from-seo">
  ## En quoi GEO diffère du SEO
</div>

Le SEO traditionnel optimise pour les moteurs de recherche qui classent et renvoient vers des pages. GEO optimise pour les systèmes d'IA qui lisent, résument et citent des pages dans les réponses générées.

Les mécanismes diffèrent de manière importante :

|                         | SEO                                        | GEO                                           |
| ----------------------- | ------------------------------------------ | --------------------------------------------- |
| Objectif                | Se classer dans les résultats de recherche | Être cité dans les réponses générées par l'IA |
| Signaux clés            | Backlinks, mots-clés, autorité de la page  | Précision du contenu, structure, concision    |
| Action de l'utilisateur | Cliquer sur un lien                        | Lire une réponse générée par l'IA             |
| Préférence de format    | Tout contenu bien structuré                | Contenu scannable qui répond aux questions    |

La bonne nouvelle : les fondamentaux se recoupent largement. Un contenu précis, bien structuré et qui répond directement aux questions fonctionne bien dans les deux cas. GEO repose moins sur des astuces que sur la clarté de la rédaction.

<div id="how-ai-systems-decide-what-to-cite">
  ## Comment les systèmes d'IA décident quoi citer
</div>

Les moteurs de réponses IA évaluent le contenu en fonction de quelques facteurs clés :

**Concision.** Les systèmes d'IA priorisent le contenu qui répond immédiatement à la question. Une page qui enfouit la réponse après trois paragraphes de contexte a moins de chances d'être citée qu'une page qui commence par la réponse.

**Précision et signaux de confiance.** Les systèmes d'IA favorisent le contenu provenant de sources faisant autorité et qui semble fiable factuellement. Pour la documentation, cela signifie une précision technique, un versionnage cohérent et un contenu qui correspond à ce que le produit fait réellement.

**Clarté structurelle.** Un contenu organisé logiquement — avec des titres significatifs, des listes et des blocs de code — est plus facile à analyser et à extraire correctement pour les systèmes d'IA.

**Spécificité.** Un contenu vague et généraliste ("cette fonctionnalité est flexible et puissante") est moins citable qu'un contenu spécifique et détaillé ("cet endpoint renvoie un code de statut 429 lorsque la limite de débit de 100 requêtes par minute est dépassée").

<div id="write-content-ai-systems-can-cite">
  ## Rédigez du contenu que les systèmes d'IA peuvent citer
</div>

<div id="lead-with-the-answer">
  ### Commencez par la réponse
</div>

Structurez chaque section de sorte que l'information la plus importante apparaisse en premier. Les utilisateurs qui posent des questions aux outils d'IA veulent des réponses directes — pas de préambules, pas de contexte, pas de mises en garde avant le point principal.

````mdx theme={null}
<!-- Commence par la réponse -->
## 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
```

<!-- Enfouit la réponse -->
## 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">
  ### Utilisez des titres qui correspondent aux questions
</div>

Rédigez les titres H2 et H3 comme les questions que posent les utilisateurs, pas comme des étiquettes de sujets. Les systèmes d'IA font correspondre les requêtes des utilisateurs au texte des titres pour décider quel contenu afficher.

```mdx theme={null}
<!-- Titre correspondant à la requête -->
## How do I rotate my API keys?

<!-- Étiquette de sujet — plus faible -->
## API key management
```

<div id="be-specific-with-numbers-limits-and-examples">
  ### Soyez précis avec les nombres, les limites et les exemples
</div>

Les descriptions vagues ne sont pas citées. Les détails spécifiques et précis le sont. Les systèmes d'IA peuvent citer "limite de débit : 100 requêtes par minute par API key" avec précision. "Notre API a des limites de débit" ne donne rien d'utile à citer pour l'IA.

Pour chaque option de configuration, paramètre ou comportement :

* Indiquez la valeur exacte ou la plage
* Décrivez ce qui se passe à la limite
* Montrez un exemple de code concret

<div id="keep-a-consistent-terminology">
  ### Maintenez une terminologie cohérente
</div>

Les systèmes d'IA construisent le contexte à travers une page. Si vous appelez la même chose "API key", "access token" et "API token" de manière interchangeable, le résumé de l'IA peut utiliser le mauvais terme ou se tromper en pensant qu'il s'agit de choses différentes. Une terminologie cohérente — un nom par concept, utilisé partout — aide les systèmes d'IA à représenter votre contenu avec précision.

<div id="format-for-ai-parsing">
  ## Formatez pour l'analyse IA
</div>

<div id="use-sequential-non-skipping-heading-hierarchy">
  ### Utilisez une hiérarchie de titres séquentielle et sans sauts
</div>

Ne sautez pas de H2 à H4. Les systèmes d'IA utilisent la hiérarchie des titres pour comprendre comment les sujets sont liés. Une structure plate et cohérente est plus facile à analyser correctement.

<div id="label-all-code-blocks">
  ### Étiquetez tous les blocs de code
</div>

Déclarez toujours le langage de programmation dans les blocs de code. Cela aide les systèmes d'IA à comprendre ce qu'ils lisent et à afficher le bon exemple pour le contexte de l'utilisateur.

````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">
  ### Rédigez du texte alternatif pour les images et les diagrammes
</div>

Les systèmes d'IA ne peuvent pas voir les images. Si un diagramme est l'explication principale d'un concept, ajoutez une description textuelle qui transmet la même information. Un texte alternatif qui décrit ce que montre un diagramme — pas seulement "diagramme d'architecture" — donne aux systèmes d'IA quelque chose avec quoi travailler.

<div id="use-specific-references-instead-of-pronouns">
  ### Utilisez des références spécifiques au lieu de pronoms
</div>

Écrivez "la API key" au lieu de "elle" ou "cette valeur". Les systèmes d'IA extraient du contenu et perdent le contexte environnant. Les références avec des noms spécifiques restent précises lors de l'extraction ; les pronoms deviennent ambigus.

<div id="mintlify-configuration-for-geo">
  ## Configuration de Mintlify pour GEO
</div>

<div id="add-descriptive-page-metadata">
  ### Ajoutez des métadonnées de page descriptives
</div>

Les titres et descriptions de pages sont parmi les signaux les plus importants que les systèmes d'IA utilisent pour comprendre le sujet d'une page. Rédigez-les comme si vous répondiez à la question "qu'est-ce que cette page aide les utilisateurs à faire ?"

```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">
  ### Contrôlez les paramètres d'indexation
</div>

Par défaut, Mintlify indexe les pages incluses dans la navigation de votre `docs.json`. Pour inclure les pages masquées dans le contexte de l'assistant IA et la recherche :

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

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

Mintlify génère automatiquement un fichier `llms.txt` pour votre documentation. LLMs.txt fonctionne de manière similaire à `sitemap.xml` pour la recherche traditionnelle — il fournit aux systèmes d'IA un index structuré de votre documentation. Aucune configuration n'est requise.

Vous pouvez consulter votre LLMs.txt en ajoutant `/llms.txt` à l'URL de votre documentation.

<div id="allow-ai-agents-in-robotstxt">
  ### Autoriser les agents IA dans robots.txt
</div>

Votre fichier `robots.txt` contrôle quels robots peuvent explorer votre site. S'il bloque les agents utilisateurs IA, des outils comme ChatGPT, Claude et Perplexity ne peuvent pas lire votre documentation ni la citer dans leurs réponses.

Le `robots.txt` généré automatiquement par Mintlify autorise tous les robots d'exploration par défaut et inclut des [directives Content-Signal](/fr/optimize/seo#content-signal-directives) qui activent votre documentation pour l'entraînement des modèles d'IA, l'indexation pour la recherche et la génération de réponses par l'IA. Si vous utilisez un [fichier robots.txt personnalisé](/fr/optimize/seo#custom-sitemaps-and-robotstxt-files), assurez-vous qu'il ne bloque pas les agents IA. Les agents utilisateurs IA les plus courants incluent :

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

Un `robots.txt` qui bloque tous les robots d'exploration bloque également les agents IA :

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

Pour bloquer des robots spécifiques tout en autorisant les agents IA, ciblez uniquement les robots que vous souhaitez restreindre :

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

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

Exécutez [`mint score`](/fr/cli/commands#mint-score) pour vérifier si le `robots.txt` de votre site autorise les agents IA. La vérification `robotsTxtAllowsAI` est validée lorsqu'aucun agent utilisateur IA n'est bloqué.

<div id="test-how-ai-tools-represent-your-docs">
  ## Testez comment les outils d'IA représentent votre documentation
</div>

Testez régulièrement si les outils d'IA citent votre documentation avec précision.

Posez des questions spécifiques sur votre produit dans ChatGPT, Perplexity et Claude :

* "Comment authentifier les requêtes API avec \[votre produit] ?"
* "Que se passe-t-il quand je dépasse la limite de débit dans \[votre produit] ?"
* "Montrez-moi comment gérer les erreurs dans l'API de \[votre produit]."

Vérifiez dans les réponses :

* Si votre documentation est citée
* Si le contenu cité est précis
* Si les exemples de code sont corrects
* Si l'IA recommande la bonne approche

Lorsque les outils d'IA donnent de mauvaises réponses sur votre produit, cela signale souvent que votre documentation est ambiguë, incomplète ou contradictoire, plutôt que l'IA est défaillante.

<div id="frequently-asked-questions">
  ## Questions fréquemment posées
</div>

<AccordionGroup>
  <Accordion title="GEO remplace-t-il le SEO ?">
    Non. La recherche traditionnelle génère encore un trafic significatif, et de nombreux utilisateurs préfèrent cliquer vers la documentation plutôt que de lire des résumés générés par l'IA. GEO et SEO sont complémentaires — une documentation bien structurée, précise et qui répond directement aux questions fonctionne bien dans les deux cas. Les pratiques se renforcent mutuellement.
  </Accordion>

  <Accordion title="Combien de temps faut-il pour que les améliorations GEO apparaissent ?">
    Plus rapidement que le SEO dans de nombreux cas. Les systèmes d'IA comme Perplexity et ChatGPT explorent et indexent le contenu plus fréquemment que les moteurs de recherche traditionnels. Les améliorations de la clarté et de la structure du contenu peuvent apparaître dans les réponses générées par l'IA en quelques jours à quelques semaines. Cela dit, les systèmes d'IA prennent également en compte l'autorité du domaine et les signaux de liens qui prennent plus de temps à construire.
  </Accordion>

  <Accordion title="Dois-je faire quelque chose de spécial pour Google AI Overviews en particulier ?">
    Google AI Overviews utilise les mêmes signaux que Google Search avec un poids supplémentaire sur le contenu qui répond directement à la requête spécifique. Les pages qui sont déjà bien classées dans Google Search pour une requête ont plus de chances d'apparaître dans AI Overviews pour la même requête. Les principales pratiques GEO — commencer par la réponse, détails spécifiques, structure claire — s'appliquent ici aussi.
  </Accordion>

  <Accordion title="Dois-je écrire différemment pour l'IA par rapport aux lecteurs humains ?">
    Non. Un contenu clair et direct pour les humains est clair et direct pour les systèmes d'IA. Optimiser spécifiquement pour l'IA au détriment de la lisibilité humaine est contre-productif et tend à produire un contenu qui n'est ni agréable à lire ni bien cité. Écrivez d'abord pour vos utilisateurs ; GEO découle naturellement d'une bonne rédaction technique.
  </Accordion>

  <Accordion title="Qu'est-ce que llms.txt et dois-je le configurer ?">
    LLMs.txt est une convention — similaire à robots.txt — pour fournir aux systèmes d'IA un index structuré de votre documentation. Mintlify le génère automatiquement. Vous n'avez pas besoin de le configurer. Vous pouvez consulter votre fichier LLMs.txt à l'adresse `https://your-docs-domain.com/llms.txt`.
  </Accordion>
</AccordionGroup>