npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@seellm/cloudflare-worker

v0.1.9

Published

SeeLLM AI Traffic Monitor - Cloudflare Worker for site-wide AI detection. Ships TypeScript source consumed directly by wrangler.

Vulnerabilities

Powered byPowered by Snyk
  • 0High
  • 0Medium
  • 0Low

Links

Git

Maintainers

seellmseellm

Keywords

cloudflareworkeraimonitoringanalyticsseellmai-visibilitychatgptperplexityclaudebot-detection

Readme

@seellm/cloudflare-worker

AI Traffic Monitor for Cloudflare Workers. Detect and analyze AI crawlers visiting your site.

Features

  • AI Detection: Automatically detects ChatGPT, Claude, Perplexity, Gemini, and other AI crawlers
  • Zero Latency Impact: Detection runs at the edge, async event sending doesn't block responses
  • Response Status Tracking: See which pages AI finds (200) vs misses (404/500)
  • Rich Analytics: Track AI traffic by source, page, country, and more

Note: This package ships TypeScript source consumed directly by wrangler. No build step needed — just point your wrangler.toml at the entry file.

Quick Start

1. Install

npm install @seellm/cloudflare-worker

2. Generate Adapter Credentials

In the SeeLLM dashboard, open Site Monitor → Setup → Cloudflare Workers and click Generate Credentials. Copy the adapter ID, secret, and org ID (the secret is shown once).

3. Configure

Copy wrangler.toml to your project and update as needed:

name = "seellm-ai-monitor"
main = "node_modules/@seellm/cloudflare-worker/src/index.ts"
compatibility_date = "2024-12-01"

[vars]
SEELLM_ADAPTER_ID = "adapter_xxx"
SEELLM_ADAPTER_SECRET = "<paste secret>"
SEELLM_ORG_ID = "org_abc123"
SEELLM_API_URL = "https://api.seellm.link"
# Optional: pin a domain if the worker handles multiple hosts
# SEELLM_SITE_DOMAIN = "docs.example.com"

Legacy installs can still use API keys by running npx wrangler secret put SEELLM_API_KEY, but adapter credentials unlock health checks, policies, and better security.

4. Deploy

npx wrangler deploy

How It Works

The worker intercepts all requests to your site and:

  1. Detects AI traffic using:

    • User-Agent patterns (GPTBot, ClaudeBot, PerplexityBot, etc.)
    • ASN matching (known AI provider networks)
    • Referrer analysis (clicks from ChatGPT, Claude, etc.)

  2. Captures request/response data:

    • Request path and method
    • Response status (200, 404, 500, etc.)
    • Content type and size
    • Geographic location

  3. Sends events to SeeLLM (async, non-blocking):

    • Batched for efficiency
    • Uses waitUntil to not impact response time

AI Sources Detected

| Source | Detection Method | |--------|-----------------| | ChatGPT | User-Agent, ASN, Referrer | | Claude | User-Agent, ASN, Referrer | | Perplexity | User-Agent, ASN, Referrer | | Gemini | User-Agent, Referrer | | Bing Copilot | User-Agent, ASN, Referrer | | Google AI Overview | User-Agent, ASN | | Cursor | User-Agent, Referrer | | GitHub Copilot | User-Agent, Referrer | | Phind | User-Agent, Referrer | | Replit | User-Agent, Referrer | | Codeium | User-Agent, Referrer | | Mistral | User-Agent, Referrer | | HuggingChat | User-Agent, Referrer | | Applebot | User-Agent | | Amazonbot | User-Agent | | Meta AI (meta-externalagent) | User-Agent | | DuckDuckGo (DuckDuckBot) | User-Agent, Referrer | | Brave Search | User-Agent, Referrer | | Kagi | User-Agent, Referrer | | Poe | Referrer | | You.com | User-Agent, Referrer | | Cohere | User-Agent | | Grok (X.ai) | User-Agent, Referrer | | Seekr | User-Agent, Referrer | | Andi | User-Agent, Referrer | | Komo | User-Agent, Referrer | | Arc Search | User-Agent, Referrer |

Configuration Options

Environment Variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | SEELLM_ADAPTER_ID | Yes | - | Adapter ID from dashboard setup | | SEELLM_ADAPTER_SECRET | Yes | - | Adapter secret (shown once) | | SEELLM_ORG_ID | Yes | - | Your organization ID | | SEELLM_API_URL | No | https://api.seellm.link | API endpoint | | SEELLM_SITE_DOMAIN | No | auto-detected | Pin domain if worker handles multiple hosts |

Legacy: SEELLM_API_KEY via npx wrangler secret put still works but adapter credentials are recommended.

Dashboard

View your AI traffic analytics at seellm.com:

  • AI Traffic Overview: Total AI vs human visits
  • Page Analytics: Which pages AI visits most
  • Error Analysis: Pages AI tried but got 404/500 (content gaps!)
  • Source Breakdown: Traffic by AI platform

Privacy

  • No personally identifiable information (PII) is collected
  • IP addresses are not stored
  • Only request metadata is captured

Support

License

MIT