Quand Mintlify sert du Markdown
- Le chemin se termine par
.md. Par exemple,/analytics/traffic.mdrenvoie toujours du Markdown. - L’en-tête
Acceptpréfère le Markdown. Mintlify classe les types de médias de l’en-tête par valeur de qualité et compare le premier type Markdown (text/markdown,text/x-markdownoutext/plain) avec le premier type HTML (text/htmlouapplication/xhtml+xml). Si un type Markdown est présent et qu’aucun type HTML n’est présent ou que le Markdown a un rang supérieur, la réponse est en Markdown. - Le user agent est un agent IA connu et ne demande pas de HTML. Si le user agent contient l’un des identifiants suivants et que l’en-tête
Acceptne place pas le HTML au-dessus du Markdown, la réponse est en Markdown même si la requête ne mentionne jamais le Markdown.
Claude-User, ChatGPT-User, OAI-SearchBot, PerplexityBot, Perplexity-User, Google-Agent, MistralAI-User, DuckAssistBot et cohere-ai. La correspondance est une recherche de sous-chaîne insensible à la casse.
La négociation ne s’applique qu’aux pages de documentation. Les ressources statiques, llms.txt, skill.md, les flux RSS, les exports PDF, les endpoints MCP, les pages de connexion et les routes internes /_mintlify/ ne sont jamais négociés.
Les réponses HTML et Markdown sont mises en cache comme des variantes distinctes, indexées sur les en-têtes Accept et User-Agent, de sorte qu’un navigateur ne reçoit jamais une réponse Markdown mise en cache.
Comment une requête devient une vue
Chaque vue contient le chemin de la requête, le référent, l’adresse IP et le user agent. Les horodatages sont enregistrés en UTC.
Comment les vues sont catégorisées
human. Consultez la liste complète des user agents pour chaque identifiant de chaque catégorie.
Le trafic propre à Mintlify, comme la revalidation de cache et la vérification des liens, est exclu avant le décompte.
Comment le tableau de bord comptabilise les humains et les agents
- Humans correspond aux pages HTML vues dans la catégorie humain.
- Agents correspond à toutes les vues de la catégorie Réponses IA, plus les vues Markdown de la catégorie humain.
La classification fait confiance au user agent qu’un client envoie. Un agent qui s’identifie avec un user agent de navigateur standard et récupère du HTML compte comme une vue humaine. Une personne qui ouvre directement une URL
.md compte comme une vue agent.Liste complète des user agents
chatgpt correspond à ChatGPT-User et à tout autre user agent contenant ce texte.
Réponses IA
ChatGPT-User, chatgpt, Claude-User, claude-code, Cursor, Opencode, WarpBot, Perplexity-User, Google-Agent, GoogleAgent, Google-NotebookLM, Google-Read-Aloud, MistralAI-User, Copilot, Amzn-User, DuckAssistBot, xAI-SearchBot, Grok-DeepSearch, Meta-ExternalFetcher, Kimi-User, Qwen-User, Amazon-Bedrock-AgentCore-Browser, Shap-User
Index de recherche
OAI-SearchBot, Claude-SearchBot, PerplexityBot, Google-InspectionTool, Googlebot, MistralAI-Index, Bingbot, msnbot, Amzn-SearchBot, meta-webindexer, Kimi-SearchBot, TikTokSpider, Baiduspider, YouBot, Petalbot, YisouSpider, Sogou web spider, Coveobot, amazon-kendra, Algolia Crawler, ref-tools-crawler, ShapBot, AteveSearchSourceUrlDiscovery, YandexBot, YandexMobileBot, YandexAccessibilityBot, YandexRenderResourcesBot, YandexImages, YandexNews, YandexWebmaster, Yeti/, 360Spider, SeznamBot, Exabot
Entraînement
GPTBot, ClaudeBot, GoogleOther, Google-Extended, Google-CloudVertexBot, Applebot-Extended, Applebot, Amazonbot, Meta-ExternalAgent, KimiBot, Bytespider, ERNIEBot, QwenBot, ChatGLM-Spider, DeepSeekBot, Deepseek, cohere-ai, cohere-training-data-crawler, AI2Bot, AI2Bot-Dolma, CCBot, PanguBot, ClueWeb-Crawler
Autres IA
OAI-AdsBot, GrokBot, xAI-Bot, xAI-Grok, xAI-Web-Crawler, Grok, meta-externalads, facebookexternalhit, FacebookBot, Facebookbot, Doubaobot, YiyanBot, TongyiBot, AliyunBot, diffbot, FirecrawlAgent, SemrushBot-OCOB, SERankingBacklinksBot, Omgili, Omgilibot, webzio-extended, ImagesiftBot, VelenPublicWebCrawler, TurnitinBot, Timpibot, ICC-Crawler, DataForSeoBot, AwarioBot, AwarioSmartBot, AwarioRssBot, Kangaroo Bot, Sentibot, img2dataset, Meltwater, Seekr, peer39_crawler, Scrapy, Cotoyogi, aiHitBot, Factset_spyderbot, Barkrowler, HubSpot Crawler, AhrefsBot, SemrushBot, SiteAuditBot, AdsBot-Google, YaDirectFetcher, Google-Adwords, Screaming Frog, DotBot, MJ12bot, BLEXBot, serpstatbot, SEOkicks, trendictionbot, archive.org_bot, Decimal Bot, WebThreeCrawler, scopy-docs-crawler, quigon-manifest-fetcher, HeadlessChrome, PhantomJS
Trafic interne exclu
mintlify-revalidation ou Mintlify-LinkChecker proviennent de l’infrastructure propre à Mintlify et sont supprimées avant tout décompte.