Gesamte Doku

Start

  1. 01Erste Schritte
  2. 02Installation
  3. 03Tracking

Funktionen

  1. 04Das Dashboard
  2. 05Ziele
  3. 06Kurzlinks
  4. 07KI-Quellen und Agenten
  5. 08E-Mail-Berichte
  6. 09Stündlicher Check
  7. 10Frag deine KI

Referenz

  1. 11Konfiguration
  2. 12HTTP-API

Plattformen

  1. 13Eigenständiger Server
  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

Vertrauen

  1. 26Datenschutz

Funktionen

KI-Quellen und Agenten

Runlight zählt die Leute, die von ChatGPT und Claude kommen, und sieht die KI-Agenten, die deine Seiten lesen, ohne JavaScript auszuführen.

KI taucht auf zwei Arten in deinem Traffic auf, und Runlight zählt beide.

Leute, die von einer KI kamen

Wenn jemand in einer Antwort von ChatGPT, Claude, Perplexity, Gemini, Copilot, Meta AI, Grok, DeepSeek, Mistral, You.com oder Phind auf einen Link klickt, bekommt der Besuch diese Quelle und den Kanal KI. Er zählt wie jeder andere Besuch zu Besuchern und Conversions, und du kannst danach filtern.

Agenten, die deine Seiten lesen

Eine KI, die eine Frage beantwortet, ruft deine Seite oft selbst ab. Agenten führen kein JavaScript aus, daher sieht der Tracker sie nie. Um sie von deinem Server aus zu zählen, gib jede Seitenanfrage an rl.observe(request) weiter.

proxy.ts

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

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

Diese Datei gilt für Next.js 16 und neuer. Unter Next.js 15 nennst du sie middleware.ts und benennst die Funktion in middleware um. Ab Next.js 15.5 fügst du außerdem export const config = { runtime: "nodejs" }; hinzu, damit dein Datenbanktreiber laden kann. Vor Next.js 15.5 läuft Middleware nur in der Edge-Runtime und braucht daher einen Store, der dort funktioniert, etwa Turso über HTTP.

In Express nutzt du app.use(observer(rl)) aus @runlight/sdk/node. In den anderen Sprachen zeichnet die Middleware oder der Filter, der Runlight ausliefert, meist auch die Agenten auf, und die Seite jeder Sprache, von PHP bis Rust, zeigt, wie. Eine WordPress-, Drupal- oder Craft-Website zeichnet sie mit ihrem Plugin auf, und jede andere Website kann sie aus dem Zugriffslog ihres Webservers melden.

observe zeichnet GET-Anfragen bekannter Agenten nach Seiten auf und ignoriert alles andere, auch Bilder, Skripte und Styles. Es wirft nie einen Fehler, du kannst es also gefahrlos bei jeder Anfrage aufrufen. Wenn du nicht darauf wartest, verlangsamt es die Antwort nicht.

Die Box KI-Agenten sortiert, was sie sieht, in zwei Gruppen und zeigt, welche Seiten jeder Agent gelesen hat. Die erste Gruppe ruft eine Seite ab, weil eine Person gerade jetzt etwas gefragt hat (ChatGPT-User, Claude-User, Perplexity-User, MistralAI-User und der Fetcher von Meta). Die zweite Gruppe sind Crawler, die Seiten vorab sammeln (GPTBot, ClaudeBot, PerplexityBot, OAI-SearchBot, Amazonbot, CCBot und andere). Runlight hält diese Abrufe aus den Zahlen für Besucher und Seitenaufrufe heraus.