Passer au contenu principal
Les agents IA lisent le HTML que votre serveur envoie. Ils n’exécutent aucun script : les prix, avis et caractéristiques qu’un script dessine ne leur parviennent jamais, et ils ne lisent le texte d’une image que dans son texte alternatif. AI Rendering rend chaque page que vous publiez telle qu’une personne la voit, retire les scripts et écrit le texte de chaque image dans son texte alternatif. Votre CDN télécharge ces copies et répond avec elles aux agents IA. Les personnes, les moteurs de recherche et toutes les autres requêtes atteignent votre site comme avant, et querying.ai n’est jamais sur le chemin d’une requête vers votre site. GEO Score repère ce que ChatGPT ne peut pas lire sur une page et ce qu’il faut corriger en priorité. Son rendering.score est la part du contenu vérifié que la copie destinée aux agents IA contient sous forme de texte.

Fonctionnement

  1. Connectez votre site. Vous recevez une clé de site une seule fois. Elle ne peut que lire les copies de votre site.
  2. Publiez des pages. Envoyez l’URL d’une page, ou indiquez le sitemap de votre site pour publier toutes les pages qu’il liste. querying.ai rend chaque page depuis le pays de votre site, conserve la copie et la rend à nouveau tous les refreshDays jours (28 par défaut).
  3. Synchronisez les copies. Toutes les 10 minutes, votre CDN lit la liste des copies avec la clé de site, télécharge les nouvelles copies et supprime celles qui ne sont plus listées.
  4. Répondez aux agents IA. Quand un agent IA envoie un GET, votre CDN répond avec la copie stockée. Une page sans copie, une copie expirée et toute erreur vont à votre serveur d’origine.

Connecter un site

Conservez la key : seule cette réponse la contient, et votre CDN l’envoie. POST /v1/ai-rendering/sites/{id}/key en délivre une nouvelle et arrête aussitôt l’ancienne. Modifiez-les ensuite avec PATCH /v1/ai-rendering/sites/{id}.

Publier une page

La page est en cours de rendu :
Un rendu prend environ 30 secondes. Suivez-le avec GET /v1/async/task/{taskId}, ou lisez le status de la page dans GET /v1/ai-rendering/sites/{id} :
  • ready : la copie figure dans votre liste de copies. copy est son fichier HTML.
  • rendering : la première copie est en cours de création.
  • failed : le premier rendu a échoué. La page est rendue à nouveau à refreshAt.
  • expired : la copie a expiré et a quitté la liste jusqu’au prochain rendu.
Un site contient jusqu’à 1 000 pages, y compris celles que publie son sitemap. Renvoyer une page publiée la rend tout de suite. Une page correspond à son chemin et à sa requête, sans paramètres de suivi comme utm_* et gclid. DELETE /v1/ai-rendering/sites/{id}/pages/{pageId} retire une page. Pour publier la copie d’un GEO Score sans nouveau rendu, envoyez son identifiant de tâche : { "taskId": "0b6c1f7e-…" }. Ce doit être un GEO Score terminé de votre compte, mesuré depuis le pays du site.

Publier depuis votre sitemap

Indiquez le sitemap de votre site : les pages nouvelles et modifiées atteignent les agents IA sans que personne n’envoie d’URL :
Indiquer un sitemap approuve la publication de toutes les pages qu’il liste. querying.ai le lit en quelques minutes, puis une fois par jour :
  • Une page listée pour la première fois est publiée et rendue en quelques heures, avec la clé d’API qui a indiqué le sitemap, et facturée comme une page que cette clé publie.
  • Une page dont le <lastmod> est plus récent que sa copie est rendue à nouveau. Un <lastmod> dans le futur est ignoré.
  • Une page qu’une lecture précédente listait et que celle-ci ne liste plus est retirée. Une page que vous avez publiée par l’API et que le sitemap n’a jamais listée reste.
Le sitemap est une URL https sur l’hôte du site : un <urlset> ou un <sitemapindex> d’au plus 20 sitemaps du même hôte, 10 Mo au total au maximum. Servez-le en XML : Content-Encoding: gzip fonctionne, un fichier .gz non. Les pages d’autres hôtes sont ignorées, et celles au-delà des 1 000 pages du site sont sautées. Une lecture qui ne peut pas récupérer le sitemap, ne trouve pas de sitemap ou aucune page du site ne change rien et recommence une heure plus tard. Une lecture qui retirerait plus de la moitié des pages que le sitemap listait n’en retire aucune et applique le reste : un déploiement cassé qui sert un sitemap presque vide laisse vos pages en place. Listez ces pages à nouveau, ou retirez-les par l’API. Le site indique comment s’est passée la dernière lecture :
sitemapError indique pourquoi la dernière lecture a échoué ou n’a retiré aucune page. Le sitemapListedAt d’une page est le moment où le sitemap l’a listée pour la dernière fois. Envoyez { "sitemapUrl": null } pour arrêter de lire le sitemap. Ses pages restent publiées comme des pages publiées par l’API, et un sitemap ultérieur ne les retire pas.

Configurer votre CDN

Enregistrez ceci sous ai-rendering.mjs à côté du code de votre CDN. syncCopies aligne un stockage sur votre liste de copies, et copyFor répond à partir de lui au GET d’un agent IA :
Le Worker conserve les copies dans Workers KV et les synchronise toutes les 10 minutes avec un cron trigger. Chaque copie expire dans KV en même temps que son fichier.
wrangler.toml :
cloudflare-worker.mjs :
Avec l’offre Workers Free, KV accepte 1 000 écritures par jour : la première synchronisation d’un grand site peut prendre plus d’une journée.
Une fois la synchronisation suivante faite, vérifiez une page publiée comme ChatGPT l’ouvrirait. La copie porte X-Querying-Rendering: HIT :

La liste des copies

Votre CDN lit GET https://api.querying.ai/v1/ai-rendering/copies avec la clé de site dans X-Querying-Site-Key :
Elle liste chaque page publiée dont la copie n’a pas expiré. copy se télécharge sans clé. renderedAt change quand la page est rendue à nouveau : ne téléchargez une copie que si son renderedAt est nouveau. Supprimez les copies stockées des pages que la liste ne contient plus. La liste et les téléchargements sont gratuits.

Agents

AGENTS dans le module choisit qui reçoit la copie, par un jeton présent n’importe où dans le User-Agent, sans tenir compte de la casse.
  • Par défaut : les agents qu’une personne envoie vers une page en posant une question (chatgpt-user, codex, claude-user, claude-code, perplexity-user, gemini-deep-research, duckassistbot, amzn-user, mistralai-user) et le robot de la recherche ChatGPT, oai-searchbot. GEO Score calcule son score à partir de la copie de recherche qu’il affiche avec cet agent utilisateur.
  • À ajouter si vous le souhaitez : claude-searchbot et perplexitybot.
  • À laisser de côté : les robots d’entraînement (GPTBot, ClaudeBot) et de recherche web (Googlebot, Bingbot). Googlebot exécute lui-même les scripts.

Respecter les règles des moteurs de recherche

Envoyer aux robots un contenu différent de celui des personnes, c’est du cloaking. Google ne considère pas comme du cloaking une page rendue pour les robots tant que le contenu est similaire (Dynamic rendering). OpenAI n’a publié aucune politique de cloaking : tenez donc la copie à la règle de Google.
  • La copie est la page dessinée par le navigateur d’une personne. querying.ai retire les scripts et n’ajoute que le texte des images, dans leur texte alternatif, la place du texte d’une image.
  • Elle est servie à la propre URL de la page.
  • Elle reste à jour. querying.ai la rend à nouveau tous les refreshDays, et le module cesse d’envoyer une copie expirée.
  • Si vous modifiez une copie, contentez-vous de retirer ou de corriger : rectifier un caractère mal lu, supprimer une fenêtre surgissante. N’ajoutez ni affirmations, ni prix, ni liens que les personnes ne voient pas.

Ce qu’est la copie

La copie est le HTML dessiné par le navigateur d’une personne après défilement jusqu’au bas de la page : le texte chargé par les scripts, la page de chaque cadre à sa place, tous les scripts retirés sauf les données structurées (JSON-LD), et le texte de chaque grande image ajouté à son texte alternatif. Les liens et les sources d’image restent absolus, si bien que la copie se lit comme la page. C’est la page lors de son dernier rendu : un changement de prix ou de stock atteint les agents au rendu suivant, au plus refreshDays plus tard ou environ un jour après un changement du <lastmod> de votre sitemap, plus le délai de synchronisation de votre CDN. Le texte des images est recopié tel qu’il a été lu : un caractère mal lu part tel quel.

Facturation

Un rendu coûte 5 crédits, plus 5 par image dont le texte est lu et 2 par image que votre compte a lue au cours des 90 derniers jours (le même fichier, lu de la même façon), dans la limite de 12 images. L’envoi réserve 65 crédits et la fin du rendu facture ce qu’il a utilisé. Un rendu échoué n’est pas facturé. Une actualisation coûte la même chose et s’exécute avec la clé d’API du dernier rendu de la page ; sans cette clé, elle est facturée au compte du site. Un compte sans crédits attend une heure avant que la page soit retentée. Une page que publie votre sitemap est rendue avec la clé d’API qui a indiqué le sitemap. Un site lance au plus 2 000 rendus par jour UTC. Connecter un site, publier la copie d’un GEO Score, la liste des copies et le téléchargement des copies sont gratuits. Votre CDN envoie les copies : le trafic des agents ne coûte rien chez querying.ai. Voir Crédits et limites.

Erreurs

Les points de terminaison figurent dans la référence de l’API.