@aiedx/fetchlens-core

Shared bot detection engine and utilities for FetchLens middleware packages.

This package is used internally by:

• @aiedx/fetchlens-next -- Next.js middleware
• @aiedx/fetchlens-cloudflare -- Cloudflare Workers & Pages middleware

What's included

• 60+ bot signatures across 3 tiers: AI bots, search/SEO bots, scrapers
• Vulnerability scan URL patterns to block probes for .php, /wp-admin, .env, etc.
• Event helpers for sending detection payloads to the FetchLens API
• TypeScript types shared across all platform packages

Direct usage

Most users should install a platform-specific package instead. But if you're building a custom integration:

import { detectBot, isVulnScan, AI_BOT_SIGNATURES } from '@aiedx/fetchlens-core'

const bot = detectBot(request.headers.get('user-agent') ?? '')
if (bot) {
  console.log(`Detected: ${bot.name} (${bot.provider}) [${bot.category}]`)
}

if (isVulnScan(new URL(request.url).pathname)) {
  return new Response('Forbidden', { status: 403 })
}

License

Proprietary. Copyright (c) 2026 AIEDX Private Limited.