# fingerprintjs/BotD

Free bot detection library that runs in the browser. Detects automation tools and frameworks. No server required, runs 100% on the client. MIT license, no usage restrictions.

Repository: https://github.com/fingerprintjs/BotD
Canonical: https://ross.abutalabs.com/products/botd
Language: TypeScript
License: MIT
License Family: permissive
Topics: bots, bot-detection, automation, puppeteer, selenium, headless-chrome, playwright
Last push: 2026-08-11T06:30:36+00:00

## Health v2 (maintenance only)
Score: 72/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 97, release rhythm 23, longevity 100
- inputs: {"age_days": 2002, "days_push": 22, "days_rel": 302, "gap_med": null, "n_releases_24m": 1}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1456, forks 101 (observed 2026-08-28T04:04:46.819603+00:00)

## What it is
BotD is a free, MIT-licensed browser library that detects automation tools and frameworks such as Puppeteer, Selenium, Playwright, and headless Chrome. It runs entirely client-side with no server required, making it easy to add basic bot detection to any web app.

## Use cases
- detect bots visiting my website
- block headless chrome traffic
- detect puppeteer and selenium automation
- client-side bot detection without a server
- identify automated browser sessions
- detect playwright headless browsers
- add bot detection to a web app

## When to choose
- you need free, permissively licensed (MIT) bot detection
- you want detection to run 100% in the browser with no backend
- you need to catch common automation tools like Puppeteer, Selenium, or Playwright
- you want a lightweight npm or CDN drop-in for a web app

## When to avoid
- you need advanced, continuously updated bot detection against sophisticated evasion - consider a commercial API like Fingerprint Pro
- you need server-side or backend bot detection
- you expect frequent new features - the project is in stability-only maintenance mode

## Facets
- artifact type: library
- maturity: maintenance
- function: security, browser-extension, developer-tools
- domain: security, web-development
- platform: browser
- tags: bot-detection, anti-bot, client-side, headless-browser-detection, typescript, mit-license, automation, web-server, nodejs

## Member repositories
- fingerprintjs/BotD (main) score 72

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:46.819603+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:35:36.671723+00:00, confidence not recorded.
  - readme: https://github.com/fingerprintjs/BotD (fetched 2026-08-28T04:04:46.819603+00:00, sha a255f8e2caa9)
- Data as of 2026-08-30T08:39:29.467469+00:00.