everfound-tracker

See which AI agents actually read your site — GPTBot, ClaudeBot, Perplexity, and friends — plus the human visitors AI assistants send you. Reports to your Everfound dashboard.

Install

npm install everfound-tracker

Use (Vercel, any framework)

Create middleware.ts in your project root:

import { everfound } from "everfound-tracker";

export default everfound({ key: "your-site-key" });
export const config = { matcher: "/((?!_next/|.*\\.(?:js|css|png|jpg|svg|ico|woff2?)$).*)" };

Your site key is in the Everfound dashboard under AI agents on your site → Install the tracker. It's safe to commit — it only authorizes reporting traffic for your own site.

Already have a middleware.ts? Call the tracker from it instead:

import { everfound } from "everfound-tracker";

const track = everfound({ key: "your-site-key" });

export default function middleware(request: Request, context: { waitUntil(p: Promise<unknown>): void }) {
  track(request, context);
  // ...your existing middleware logic
}

How it works

• Fires only on AI/bot user agents and on human visits referred from AI surfaces (ChatGPT, Perplexity, Gemini, Copilot, …) — ordinary traffic never leaves your infrastructure.
• Fire-and-forget: never blocks, never throws, never breaks a request.
• The Everfound server does the authoritative classification and crawler-IP verification. New AI agents are added server-side — you don't need to update this package to track them.
• The client IP is forwarded on bot hits only (to verify crawlers against their operators' published IP ranges) and never on human referral clicks.

License

MIT © Digital Bar LLC