AI crawler detection and structured data for Node.js and Python

Score your content from the command line

0.5.0 added audit and lint: a 7-dimension content-citability score (see the scoring methodology) for a live URL or a local build directory, with an opt-in CI gate.

npx ai-visibility audit https://yoursite.com
npx ai-visibility audit --dir ./out --fail-under 60   # CI gate, exits non-zero below 60
npx ai-visibility lint                                # shorthand: audit --dir . --fail-under 50

Zero-dependency, edge-safe subpaths

Importing from the package's root pulls in its full dependency graph (cheerio, chalk, commander). Subpath imports scope that down — this site imports ai-visibility/detector directly in its own edge proxy for exactly this reason.

The Python package also ships with zero required dependencies. Framework extras (pip install ai-visibility[django]) add only the framework itself as a dependency — see the Python developers page for details.

Framework support

ai-visibilitydetects crawlers from request headers and serves optimized HTML at request time — none of that exists in a client-only bundle. The question that decides what a framework can actually do isn't whether it has components — it's whether it has a server:

A client-rendered SPA with no server has a real AI-visibility gap this package can only partly close — the fix is SSR, prerendering, or a thin server layer in front of the static files, not a missing feature here. Full working recipes for all six rows: /docs/recipes.

A real example

Detect a crawler and record the visit without blocking the response. This site's own proxy runs a variant of exactly this — routed through an internal API endpoint instead of calling the database directly, so the code that runs on every page request stays free of any DB dependency, but the detect-and-log shape below is the same:

import { NextRequest, NextResponse, type NextFetchEvent } from "next/server";
import { detectBot } from "ai-visibility/detector";

export function proxy(req: NextRequest, event: NextFetchEvent) {
  const bot = detectBot(req.headers.get("user-agent") ?? "");
  if (bot) {
    event.waitUntil(logCrawlerVisit(bot, req.nextUrl.pathname));
  }
  return NextResponse.next();
}

The equivalent on Django — same detection, same registry:

# settings.py
MIDDLEWARE = [
    "ai_visibility.middleware.django.AIVisibilityMiddleware",
    # ...the rest of your middleware
]

AI_VISIBILITY = {
    "optimize": True,
    "inject_schemas": True,
    "log_visits": True,
}

Full Flask and FastAPI examples: the Python developers page.