Skip to content
/ botd Public
forked from fingerprintjs/BotD

Bot detection library that runs in the browser. Identify JavaScript bots, browser spoofing, virtual machines and much more.

License

Notifications You must be signed in to change notification settings

makma/botd

 
 

Repository files navigation

FingerprintJS

Current NPM version Monthly downloads from NPM Monthly downloads from jsDelivr

Discord server

🌱 Botd

currently in beta - API may change

Botd is a browser library for JavaScript bot detection (detecting automation tools, browser spoofing and virtual machines).

Cloud Integrations

The end-user's browser scripts for bot detection are just one part of the bigger solution. In production, it's essential to handle automation tools even on the backend. In the botd-integrations repository you can find an explanation of integration flow together with sample middleware integration examples for various cloud providers like Cloudflare, Fastly, or Amazon.

Install from CDN

<script>
function initBotd() {
  // Initialize an agent at application startup.
  const botdPromise = Botd.load({
      token: "<token>",
      mode: "allData"
  });
  // Get the bot detection result when you need it.
  botdPromise
      .then(botd => botd.detect())
      .then(result => {
        console.log(result);
      });
}
</script>
<script async
        src="https://cdn.jsdelivr.net/npm/@fpjs-incubator/botd-agent@0/dist/botd.min.js"
        onload="initBotd()">
</script>

Run this code

Alternatively you can install from NPM to use with Webpack/Rollup/Browserify

npm i @fpjs-incubator/botd-agent
# or
yarn add @fpjs-incubator/botd-agent
import Botd from '@fpjs-incubator/botd-agent';

// Initialize an agent at application startup.
const botdPromise = Botd.load({
    token: "<token>",
    mode: "allData"
});

(async () => {
  // Get the bot detection result when you need it.
  const botd = await botdPromise
  const result = await botd.detect();
  console.log(result);
})();

Run this code

A free token is required to connect to our bot detection API.

To get your token, please ping us on Discord or email us at [email protected] (just type token in the email subject, no need to compose a body)
The free token is limited to 1M API calls per month while in beta.

Supported detection scenarios

Automation Tools & Frameworks
Chrome Headless
Playwright
PhantomJS
Browser spoofing
User Agent spoofing
OS spoofing
VM detection
VirtualBox
VmWare
Parallels
Search bots
Google Bot
Bing Bot
Many more tools and configurations are supported

© 2021 FingerprintJS, Inc

About

Bot detection library that runs in the browser. Identify JavaScript bots, browser spoofing, virtual machines and much more.

Resources

License

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • TypeScript 70.4%
  • HTML 13.1%
  • CSS 9.9%
  • JavaScript 6.6%