rendering.score est la part du contenu vérifié que la copie destinée aux agents IA contient sous forme de texte.
Fonctionnement
- Connectez votre site. Vous recevez une clé de site une seule fois. Elle ne peut que lire les copies de votre site.
- 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
refreshDaysjours (28 par défaut). - 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.
- 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
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
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.copyest 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.
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 :- 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.
<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 sousai-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 :
- Cloudflare Worker
- Autres CDN et serveurs
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.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.
wrangler.toml :cloudflare-worker.mjs :X-Querying-Rendering: HIT :
La liste des copies
Votre CDN litGET https://api.querying.ai/v1/ai-rendering/copies avec la clé de site dans X-Querying-Site-Key :
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 sonscoreà partir de la copie de recherche qu’il affiche avec cet agent utilisateur. - À ajouter si vous le souhaitez :
claude-searchbotetperplexitybot. - À 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 plusrefreshDays 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.