FingerprintJS logo

Current NPM version Discord server BotD documentation

## BotD BotD is an open source library that we created to make it easy for every developer to detect basic bots in their web apps. It is available under a permissive MIT license and will always be free for developers and commercial use. ## 🚧 Maintenance Status We keep the open-source BotD package healthy with timely critical fixes and regressions addressed as fast as possible. That said, the near-term roadmap is stability-only, so new features are unlikely to land soon. Please plan accordingly if you depend on upcoming enhancements. For more demanding applications we created a professional API-based bot detection software that is called [Fingerprint Pro Bot Detection](https://fingerprint.com/products/bot-detection/). [⚡ View Our Demo](https://fingerprintjs.github.io/BotD) ## Quick start ### CDN ```html ``` [Run this code](https://stackblitz.com/edit/botd-v2-cdn?devtoolsheight=100&file=index.html) ### NPM ```bash npm i @fingerprintjs/botd # or yarn add @fingerprintjs/botd ``` ```js import { load } from '@fingerprintjs/botd' // Initialize an agent at application startup, once per page/app. const botdPromise = load() // Get detection results when you need them. botdPromise .then((botd) => botd.detect()) .then((result) => console.log(result)) .catch((error) => console.error(error)) ``` [Run this code](https://stackblitz.com/edit/botd-v2-npm?devtoolsheight=100&file=index.js) 📕 [Full documentation](docs/api.md) ## 🤖 Upgrade to Fingerprint Bot Detection to detect sophisticated bots with confidence. [Fingerprint Bot Detection API](https://fingerprint.com/try/bot-detection/) is a professional bot detection API service that processes all information server-side and transmits it securely to your servers. Fingerprint Bot Detection API provides both browser and server-side APIs that make the process of bot detection fast and secure. When using the Bot Detection, use the browser JavaScript SDK to detect browser automation tools and server-side Automation Intelligence API to detect more bot bot types, such as AI agents, AI assistants, and AI/LLM crawlers. The commercial product combines vast amounts of auxiliary data that bots expose (network properties, browser overrides) to be able to reliably deduplicate real users from automated software, resulting in the detection of popular AI tools, browser automation tools, their derivatives and plugins. A big advantage of the paid product is that it's able to distinguish good bots from bad ones that allow you to block malicious traffic without blocking search engine crawlers, monitoring workers, etc.

image

Full product comparison:
Open Source Library Bot Detection API

Core Features

100% open sourceyesno
AI Agent Detection
OpenAI, Manus, AWS AgentCore		–✓
AI Assistant Detection
ChatGPT, Anthropic, Google Gemini		–✓
Web Bot Auth support
Detect verified, signed, and spoofed identities		–✓
Search Engine detection
Google, Bing, DuckDuckGo		–✓
Anti Detect Browser detection
AdsPower, Dolphin Anty, Kameleo		–✓
Browser Automation Tools detectionpartialfull

Detectable automation tools & frameworks

Headless Browsers (Chrome, Firefox)✓✓
seleniumHQ/selenium
umbrella project encapsulating a variety of tools and libraries enabling web browser automation		✓✓
microsoft/playwright
Node.js library to automate Chromium, Firefox and WebKit with a single API		✓✓
ariya/phantomjs
headless WebKit scriptable with JavaScript		✓✓
segmentio/nightmare
high-level browser automation library		✓✓
electron/electron
framework lets you write cross-platform desktop applications using JavaScript, HTML and CSS		✓✓
laurentj/slimerjs
scriptable browser		✓✓

Detectable stealth plugins

berstend/puppeteer-extra/packages/puppeteer-extra-plugin-stealth
plugin for puppeteer-extra to prevent detection.		-✓
microlinkhq/browserless
efficient driver for controlling headless browsers built on top of puppeteer developed for scenarios where performance matters		-✓
ultrafunkamsterdam/undetected-chromedriver
optimized Selenium Chromedriver patch which does not trigger anti-bot services		-✓
MeiK2333/pyppeteer_stealth
stealth plugin for pyppeteer		-✓

Additional Features

Requires JavaScript
Requires a JavaScript library to detect bots		yesno
Server-side accuracy increase
based on additional server-side data, such as TLS crypto support, ipv4/v6 data and others		–✓
Query API
build flexible workflows		–✓

Operations

Data securityYour infrastructureEncrypted at rest
StorageYour infrastructureUnlimited up to 1 yr
RegionsYour infrastructureHosting in US, EU and Mumbai
ComplianceYour infrastructureGDPR, CCPA compliant1
SLANo SLA99.9% Uptime
SupportGitHub communitySupport team via email, chat, and call-back within 1 business day
1. Fingerprint Pro is GDPR and CCPA compliant as the data processor. You still need to be compliant as the data controller and use the bot detection for fraud prevention under legitimate interest or ask for user consent. Bot detection API result example: ```js { "bot": "bad", "bot_type": "headless_chrome", "bot_info": { "category": "browser_automation", "provider": "chromium/chromium", "name": "ChromeHeadless", "identity": "unknown", "confidence": "medium" } } ``` 🍿 [Live demo](https://demo.fingerprint.com/playground) 📕 [Fingerprint Bot Detection API Docs]([https://docs.fingerprint.com](https://docs.fingerprint.com/docs/bot-detection/overview)) ## Contributing See the [Contribution guidelines](contributing.md) to learn how to contribute to the project or run the project locally. Please read it carefully before making a pull request. ## Other open-source products by Fingerprint on GitHub! - [FingerprintJS -- browser fingerprinting library that queries browser attributes and computes a hashed visitor identifier from them](https://github.com/fingerprintjs/fingerprintjs) - [Fingerprint Android -- Android identification and fingerprinting in native apps](https://github.com/fingerprintjs/fingerprintjs-android) - [Fingerprint iOS -- iOS identification and fingerprinting in native apps](https://github.com/fingerprintjs/fingerprintjs-ios) ### License [MIT](LICENSE)

© 2026 FingerprintJS, Inc