Toute la documentation

Démarrer

  1. 01Pour commencer
  2. 02Installation
  3. 03Suivi

Fonctionnalités

  1. 04Le tableau de bord
  2. 05Objectifs
  3. 06Liens courts
  4. 07Sources et agents IA
  5. 08Rapports par e-mail
  6. 09Vérification planifiée
  7. 10Interrogez votre IA

Référence

  1. 11Configuration
  2. 12API HTTP

Plateformes

  1. 13Serveur autonome
  2. 14PHP
  3. 15WordPress
  4. 16Drupal
  5. 17Craft CMS
  6. 18Python
  7. 19Rails
  8. 20Ruby
  9. 21Go
  10. 22Java
  11. 23.NET
  12. 24Elixir
  13. 25Rust

Confiance

  1. 26Confidentialité

Fonctionnalités

Sources et agents IA

Runlight compte les personnes qui arrivent depuis ChatGPT et Claude, et il voit les agents IA qui lisent vos pages sans exécuter de JavaScript.

L’IA apparaît dans votre trafic de deux façons, et Runlight compte les deux.

Les personnes venues d’une IA

Quand quelqu’un clique sur un lien dans une réponse de ChatGPT, Claude, Perplexity, Gemini, Copilot, Meta AI, Grok, DeepSeek, Mistral, You.com ou Phind, la visite reçoit cette source et le canal IA. Elle compte dans les visiteurs et les conversions comme n’importe quelle autre visite, et vous pouvez filtrer dessus.

Les agents qui lisent vos pages

Une IA qui répond à une question récupère souvent votre page elle-même. Les agents n’exécutent pas de JavaScript, donc le traceur ne les voit jamais. Pour les compter depuis votre serveur, passez chaque requête de page à rl.observe(request).

proxy.ts

import { rl } from "@/lib/runlight";

export async function proxy(request: Request) {
  void rl.observe(request);
  return (await rl.linkDomainResponse(request)) ?? undefined;
}

Ce fichier vaut pour Next.js 16 et plus récent. Sur Next.js 15, nommez-le middleware.ts et renommez la fonction en middleware. À partir de Next.js 15.5, ajoutez aussi export const config = { runtime: "nodejs" }; pour que votre pilote de base de données puisse se charger. Avant Next.js 15.5, le middleware ne tourne que sur le runtime Edge, il lui faut donc un stockage qui y fonctionne, comme Turso en HTTP.

Dans Express, utilisez app.use(observer(rl)) de @runlight/sdk/node. Dans les autres langages, le middleware ou le filtre qui sert Runlight enregistre généralement aussi les agents, et la page de chaque langage, de PHP à Rust, montre comment. Un site WordPress, Drupal ou Craft les enregistre avec son extension, et tout autre site peut les signaler à partir du journal d’accès de son serveur web.

observe enregistre les requêtes GET de pages venant d’agents connus et ignore tout le reste, y compris les images, les scripts et les styles. Il ne lève jamais d’exception, vous pouvez donc l’appeler sans risque sur chaque requête. Si vous n’attendez pas son résultat, il ne ralentit pas la réponse.

Le bloc Agents IA range ce qu’il voit en deux groupes et montre quelles pages chaque agent a lues. Le premier groupe récupère une page parce qu’une personne vient de poser une question (ChatGPT-User, Claude-User, Perplexity-User, MistralAI-User et l’agent de récupération de Meta). Le second groupe rassemble les crawlers qui collectent des pages à l’avance (GPTBot, ClaudeBot, PerplexityBot, OAI-SearchBot, Amazonbot, CCBot et d’autres). Runlight tient ces requêtes à l’écart des chiffres de visiteurs et de pages vues.