Qualsi AI Tracker

AI Traffic Analysis Tool for Modern Websites

Overview

Qualsi AI Tracker is a lightweight middleware for Node.js applications that detects and logs AI bot traffic to your website. It identifies known AI crawlers like GPTBot, Claude, Perplexity, and others, helping you understand how AI systems interact with your content.

Installation

npm install qualsi-ai-tracker

or

yarn add qualsi-ai-tracker

Usage

Express.js

const express = require('express');
const { initialize } = require('qualsi-ai-tracker');

const app = express();

// Initialize with API key and automatically register middleware
initialize('your-api-key-here', app);

// Or register manually
// const { aiTrackerMiddleware } = require('qualsi-ai-tracker');
// app.use(aiTrackerMiddleware);

app.get('/', (req, res) => {
  res.send('Hello World!');
});

app.listen(3000, () => {
  console.log('Server running on port 3000');
});

NestJS

// main.ts
import { NestFactory } from '@nestjs/core';
import { AppModule } from './app.module';
import { initialize } from 'qualsi-ai-tracker';

async function bootstrap() {
  const app = await NestFactory.create(AppModule);
  
  // Initialize the AI tracker middleware
  initialize('your-api-key-here', app.getHttpAdapter().getInstance());
  
  await app.listen(3000);
}
bootstrap();

Features

• Detects known AI crawlers (GPTBot, Claude, Perplexity, etc.)
• Identifies suspicious traffic patterns
• Logs bot activity to a central service
• Lightweight with minimal dependencies
• TypeScript support

License

ISC