BotD

浏览器里直接识别自动化脚本,无需服务器

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 评测安全 🍴 复刻 104 🐛 待处理 20 👀 关注 24
GitHub ↗
GitHub 星标 ★ 1500
维护状态 较活跃
是否开源 开源
定价模式 🏷️完全免费 MIT 许可证,完全免费开源

项目预览

BotD 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类评测安全
开发团队fingerprintjs
定价模式🏷️完全免费
价格说明MIT 许可证,完全免费开源
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议MIT
主要语言TypeScript
技术栈/模型automation,bot-detection,bots,headless-chrome,playwright,puppeteer,selenium
GitHub 星标★ 1500
上线时间2021-03-10 00:00:00
代码更新2026-11-12
仓库体积2.9 MB
本站数据更新2026-11-22
维护状态较活跃
收录时间2026-10-08
浏览次数4

项目介绍

BotD 是一个完全运行在浏览器端的免费机器人检测库,用 TypeScript 编写,采用 MIT 许可,无任何使用限制。它要解决的问题是:网站如何在不依赖服务器、不引入第三方风控服务的前提下,识别出访问者究竟是真人还是自动化工具。传统方案往往需要后端配合、采集设备指纹并上传分析,既增加成本也带来隐私与合规负担。BotD 把检测逻辑全部放在客户端,通过采集浏览器环境中的异常信号——例如 navigator.webdriver 标志、Headless Chrome 特征、Playwright/Puppeteer/Selenium 注入痕迹、权限与插件异常、字体与 WebGL 指纹等——综合判断当前会话是否由自动化框架驱动。开发者只需引入脚本并调用检测接口,即可拿到布尔结果与命中的具体信号,便于做验证码触发、内容保护或风控前置。它不依赖服务器、无需注册,适合前端直接集成,也能作为更复杂风控体系的第一道轻量防线。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-10-08 · 当前星标 ★ 1500

使用教程

难度:入门 约 10 分钟 部署方式:库/依赖 5 步

⚠ 该项目 README 未提供完整安装说明,以下步骤为通用流程,请以官方文档为准。

环境要求

  • 现代浏览器环境(BotD 完全运行在浏览器端)
  • 可通过 CDN 或 npm 引入脚本的 Web 前端项目
  • 使用 npm 安装时需要 Node.js 与包管理器
  • 无需任何后端服务或第三方风控服务

安装与启动步骤

  1. 1体验官方演示

    README 提供了在线 Demo 链接,可先在浏览器中打开体验 BotD 的检测效果,再决定是否接入自己的项目。

  2. 2CDN 方式引入

    README 的 Quick start 给出用 script 标签从 CDN 引入的方式,但节选内容被截断,需到官方仓库补全完整地址。

  3. 3npm 方式安装

    README 徽章显示包名为 @fingerprintjs/botd,可在项目中用 npm 安装后按文档引入使用。

    npm install @fingerprintjs/botd
  4. 4查阅 API 文档

    README 链接了 docs/api.md,接入前先阅读该文档,确认加载库与调用检测接口的正确写法。

  5. 5在页面中调用检测

    在你的前端代码里引入并加载 BotD,触发检测后把返回结果打印到控制台或按业务逻辑处理。

如何确认成功

在浏览器控制台能看到 BotD 返回的检测结果对象,或在官方 Demo 页面正常看到检测输出。

常见问题

Q:BotD 需要后端服务配合吗?

A:不需要。README 明确说明它是完全在客户端运行的库,检测逻辑都在浏览器中完成,不依赖服务器或第三方风控服务。

Q:可以用于商业项目吗?

A:可以。项目采用 MIT 宽松许可,README 声明对开发者和商业使用永久免费,无使用限制。

Q:支持哪些自动化工具的检测?

A:项目标签涵盖 headless-chrome、playwright、puppeteer、selenium 等自动化环境,属于基础机器人检测范畴。

Q:项目还会加新功能吗?

A:README 的维护状态说明显示近期路线图以稳定为主,只做关键修复,新功能短期内不太可能出现。

Q:检测能力不够强怎么办?

A:README 提到官方另有基于 API 的专业机器人检测产品 Fingerprint Pro Bot Detection,适合要求更高的场景。

注意事项

  • 本次 README 节选的 CDN 示例代码被截断,实际引入地址与用法请以官方仓库 README 为准。
  • BotD 只做基础机器人检测,README 提示更复杂的场景需要专业方案。
  • 项目处于仅维护状态,依赖后续新特性时请提前规划。

核心亮点

  • 纯客户端运行,零服务端依赖,接入成本极低
  • 覆盖 Puppeteer、Playwright、Selenium、Headless Chrome 等主流自动化框架特征
  • MIT 许可无使用限制,可商用可修改

不足之处

  • 客户端检测可被高级反检测手段绕过,强度有限
  • 纯前端方案无法做服务端交叉验证,易被篡改结果

适用场景

  • 网站注册/登录时判断是否为脚本批量操作
  • 内容平台防止爬虫批量抓取页面数据
  • 广告或活动页面识别虚假流量与自动化点击

替代项目

fingerprintjs、CreepJS

上一篇:synbad

下一篇:VerifAI

同类项目推荐

ChineseHarm-bench 开源

测一测你的模型对中文有害内容有多能扛

ChineseHarm-Bench: A Chinese Harmful Content Detection Benchmark

★ 72 2026-08-09
Tracely-ai 开源

把线上 agent 失败轨迹变成 CI 回归测试,退化就拦 PR

Trace-native CI/CD for AI agents: grade production traces, cluster failures, freeze ···

★ 850 2026-10-22
claw-swe-bench 开源

统一接口跑 SWE-bench,横向比出哪个 agent 框架更能修 bug

Unified adapter framework for evaluating agent harnesses (claws) on SWE-bench

★ 111 2026-10-13
Jailbreaker-CE 开源

本地跑越狱测试,快速发现聊天机器人安全漏洞

Jailbreaker is a local evaluation tool for testing chatbot and agent-style systems a···

★ 120 2026-09-14
iFixAi 开源

120秒快速审计AI Agent,确保它按预期干活

Independent Auditing of AI Agents. Run by human or the agent itself, to answer the m···

★ 46569 2026-08-10
awesome-ai-eval 开源

一站式收藏AI评估工具,快速选型不踩坑

Assessing the reliability, accuracy, and safety of large language models, RAG pipeli···

★ 127 2026-08-09
FDAbench 开源

给数据智能体打分,看谁更会分析异构数据

[KDD’26] Official repository for the paper “FDABench: A Benchmark for Data Agents ···

★ 84 2026-08-09
ResearchClawBench 开源

给AI科研智能体打分,从复现实验到发现新知识

ResearchClawBench: Evaluating AI Agents for Automated Research from Re-Discovery to ···

★ 282 2026-08-09
param 开源

参数化基准组合,一键测出训练推理平台真实性能

PArametrized Recommendation and Ai Model benchmark is a repository for development o···

★ 156 2026-10-31