Track AI crawlers on TanStack Start

This guide adds the Notra tracker to a TanStack Start app in about five minutes and touches one file, src/start.ts.

The Agent tab has a Copy agent prompt button, and when you paste its prompt into Claude Code, Cursor or Codex, the agent does these steps for you.

Get your token

Open Analytics in the GEO sidebar and stay on the Agent tab. Until the first event arrives, the page shows No activity yet with the full install panel, which has Install the package, Set your token and Add the proxy sections. Your token appears in the Set your token section, and the panel’s Copy agent prompt button copies an instruction block you can paste into a coding agent.Install the same project token on every domain the project tracks, and add extra hostnames under Tracked domains in GEO settings.

Install the package

npm install @usenotra/sdk

yarn add @usenotra/sdk

pnpm add @usenotra/sdk

bun add @usenotra/sdk

Set the environment variable

Add the token as NOTRA_GEO_TOKEN in your site’s environment variables, both locally and at your hosting provider, and never hardcode or commit it.

Add the tracker

src/start.ts

import { createMiddleware, createStart } from "@tanstack/react-start";
import { createGeoMiddleware } from "@usenotra/sdk/tanstack";

const geo = createMiddleware().server(createGeoMiddleware({
  token: process.env.NOTRA_GEO_TOKEN!,
  endpoint: "https://ingest.usenotra.com",
}));

export const startInstance = createStart(() => ({
  requestMiddleware: [geo],
}));

The middleware captures requests alongside your route handler and waits for the event to send before returning, so tracking completes on serverless hosts, and it passes the downstream response and errors through unchanged. If src/start.ts already exists, add geo to its existing requestMiddleware array.

Deploy and verify

After you deploy your site, the Agent tab switches from the install panel to the dashboard as soon as Notra stores the first AI crawler visit or referral. Crawlers visit on their own schedule, so the first event can take a while on a quiet site.

Next steps

Tracker reference

Options, excluded paths, privacy and token rotation.

Journey tagging

Follow one agent across the pages it reads.

Last modified on November 11, 2026

AI Traffic

Web Analytics

MCP Analytics

Reference

Troubleshooting

Track AI crawlers on TanStack Start

Next steps

Tracker reference

Journey tagging

​Next steps

Tracker reference

Journey tagging

Next steps