@xpmetric/ai-crawl

Server-side bot & AI crawler tracking for XPmetric.

Most bots fetch raw HTML and never run your analytics script. This package detects known crawlers in your server middleware and reports hits to XPmetric.

Install

npm install @xpmetric/ai-crawl

Next.js middleware

import { NextResponse, type NextFetchEvent, type NextRequest } from "next/server";
import { trackCrawlerRequest } from "@xpmetric/ai-crawl";

export function middleware(request: NextRequest, event: NextFetchEvent) {
  trackCrawlerRequest(request, event, {
    siteToken: "YOUR_SITE_TOKEN",
  });
  return NextResponse.next();
}

export const config = {
  matcher: ["/((?!api|_next/static|_next/image|favicon.ico).*)"],
};

Express

import express from "express";
import { createExpressCrawlerMiddleware } from "@xpmetric/ai-crawl";

const app = express();
app.use(
  createExpressCrawlerMiddleware({
    siteToken: "YOUR_SITE_TOKEN",
  })
);

Cloudflare Workers

import { withCrawlerTracking } from "@xpmetric/ai-crawl";

export default {
  fetch: withCrawlerTracking(
    async (request) => fetch(request),
    { siteToken: "YOUR_SITE_TOKEN" }
  ),
};

License

MIT