BotD: A TypeScript repository from rrsartpl

BotD

# Before

- 40% of your website traffic is from bots
- They're taking over accounts, scraping prices and ruining your website reputation

# After

+ BotD is a browser library for JavaScript bot detection
+ Easily add ability to detect automation tools
+ Requires adding only a few lines of JavaScript on your website

⚡ View Our Demo.

Quick start

CDN

<script>
    // Initialize an agent at application startup, once per page/app.
    const botdPromise = import('https://openfpcdn.io/botd/v1').then((Botd) => Botd.load())
    // Get detection results when you need them.
    botdPromise
        .then((botd) => botd.detect())
        .then((result) => console.log(result))
        .catch((error) => console.error(error))
</script>

Run this code

NPM

npm i @fingerprintjs/botd
# or
yarn add @fingerprintjs/botd

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

📕 Full documentation

🤖 Upgrade to Fingerprint Pro bot detection to detect sophisticated bots easily

Always free for developers, unlimited free trials available, no credit card needed.

Fingerprint Pro is a professional bot detection service that processes all information server-side and transmits it securely to your servers using server-to-server APIs.

The Pro combines vast amounts of auxiliary data that bots leak (cursor movements, network overrides, browser changes and more) to be able to reliably deduplicate real users from automated software, resulting in the detection of popular automation tools, their derivatives and plugins.

A big advantage of the Pro 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.

Full product comparison:

	Open Source	Pro
Core Features
100% open source	yes	no¹
Search engine detection works in all modern browsers - see our full list of browsers supported	–	✓
Automation web services detection	–	✓
Automation browser extensions detection	–	✓
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
Server-side accuracy increase based on additional server-side data, such as TLS crypto support, ipv4/v6 data and others	–	✓
Query API & realtime Webhooks build flexible workflows	–	✓
Operations
Data security	Your infrastructure	Encrypted at rest
Storage	Your infrastructure	Unlimited up to 1 yr
Regions	Your infrastructure	Hosting in US, EU and Mumbai
Compliance	Your infrastructure	GDPR, CCPA compliant²
SLA	No SLA	99.9% Uptime
Support	GitHub community	Support team via email, chat, and call-back within 1 business day

_{1. Pro uses the open source BotD library as well as proprietary technology for increased accuracy and result stability.}

_{2. 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.}

Pro result example:

{
    "bot": {
        "result": "bad"
        "type": "selenium"
    }
}

🍿 Live demo

⏱ How to upgrade from Open Source to Pro in 30 seconds

📕 Fingerprint Pro documentation

Migrating from v0

Supported browsers

The library supports all popular browsers. See more details and learn how to run the library in old browsers in the browser support guide.

Where to get support

Thanks to our series B funding, we are happy to provide technical support for our open-source BotD library. We recommend using GitHub Issues to submit bugs or Discussions to ask questions. Using issues and discussions publicly will help the open-source community and other users with similar issues. However, if you require private support, please email us at oss-support@fingerprint.com.

Contributing

See the contributing guidelines to learn how to start a playground, test and build.

Other products by Fingerprint

License

MIT

rrsartpl/BotD

BotD

Quick start

CDN

NPM

🤖 Upgrade to Fingerprint Pro bot detection to detect sophisticated bots easily

Core Features

Detectable automation tools & frameworks

Detectable stealth plugins