Track AI crawlers on Netlify Edge Functions

This guide adds the Notra tracker to a Netlify Edge Functions app, which takes about five minutes and one file: netlify/edge-functions/geo.ts.

The Traffic page has a Copy agent prompt button. Paste it into Claude Code, Cursor or Codex and the agent will do these steps for you.

Get your token

Open Traffic in the GEO sidebar. Until the first event arrives, the page shows No activity yet with the full install panel of Install the package, Set your token and Add the proxy, and the token appears in the Set your token section. The panel also has a Copy agent prompt button that 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/geo

yarn add @usenotra/geo

pnpm add @usenotra/geo

bun add @usenotra/geo

The package has zero dependencies and no Node APIs in the core, so it runs on edge runtimes.

Set the environment variable

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

Add the tracker

netlify/edge-functions/geo.ts

import { createGeoHandler } from "@usenotra/geo/netlify";
import type { Context } from "@netlify/edge-functions";

const geo = createGeoHandler({
  token: Deno.env.get("NOTRA_GEO_TOKEN")!,
  endpoint: "https://ingest.usenotra.com",
});

export default (request: Request, context: Context) => {
  geo(request, context);
};

export const config = { path: "/*" };

Deploy and verify

Deploy your site, and the Traffic page switches from the install panel to the dashboard as soon as Notra stores the first AI crawler 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 October 8, 2026

AI traffic

Install the tracker

Reference

Troubleshooting

Track AI crawlers on Netlify Edge Functions

Next steps

Tracker reference

Journey tagging

​Next steps

Tracker reference

Journey tagging

Next steps