Express

Install

npm install @snowseo/beacon

Set your site key

.env

SNOWSEO_BEACON_KEY=sb_live_...

Mount the middleware

import { createBeacon } from "@snowseo/beacon";
import { beaconExpress } from "@snowseo/beacon/node";

const beacon = createBeacon({
  siteUrl: "https://example.com",
  analytics: { key: process.env.SNOWSEO_BEACON_KEY! },
});

app.use(beaconExpress(beacon));

Mount it before your routes so every request passes through it.

Verify:

curl -A "GPTBot/1.2" https://example.com/

Behind a proxy

If Express sits behind nginx, a load balancer or Cloudflare, make sure the real client address reaches it - the SDK reads CF-Connecting-IP, X-Real-IP, True-Client-IP and X-Forwarded-For, in that order. Without a real address, crawlers cannot be verified against published IP ranges and every hit shows as Unverified.

Response status

Markdown hits carry the real statusCode; HTML hits usually do not. That is deliberate rather than an oversight - the middleware sees the response before your route has run, so its 200 is a default, and reporting it would log every 404 as a success. Supply ctx.statusCode only where you have the genuine post-route status.

Overview

Install

Self-hosting

Reference

Troubleshooting

Behind a proxy

Response status

​Behind a proxy

​Response status

Behind a proxy

Response status