特工探测器

@doubleagent-so/agent-detector

将浏览器会话分类为人,bot或AI代理,完全在页面内.

网站 • 妇女 文档 • 妇女 无 • 妇女 更改日志 • 妇女 报告问题 • 妇女 麻省理工学院许可证

后面的探测引擎 双面代理。它将浏览器会话分类为 人类, (中文(简体) ), 机器人 或者说 AI 代理人 (Claude in Chrome, ChatGPT Atlas, 彗星, 浏览器使用, Playwright, 无头 Chrome...) 完全 在页面中。 没有依赖性,没有网络请求: 您决定如何处理判决.

文档 • 妇女 开始 • 妇女 如何运作 • 妇女 API 密码 • 妇女 扩展 • 妇女 信号 • 妇女 目录 • 妇女 捐款

需要原始引擎时直接使用. 对于一个有分析与广告集成和插件的即用脚本, 使用情况 @doubleagent-so/js。 。 。 .

安装

npm install @doubleagent-so/agent-detector

快开始

import { createEngine } from '@doubleagent-so/agent-detector';

const engine = createEngine(window, {
  profile: 'ecommerce',                 // optional; detected from the page when omitted
  onVerdict: (v) => console.log(v.class, v.probability),
});

const v = await engine.ready;           // after the async probes (WebGL, workers, client hints)
v.class;           // 'human' | 'bot' | 'agent'
v.probability;     // { human: 0.03, bot: 0.05, agent: 0.92 }
v.agent;           // { family: 'claude', id: 'anthropic.claude-in-chrome', verified: false, method: 'marker.claude_active' }
v.recommendation;  // 'allow' | 'tag' | 'challenge' | 'step_up' | 'rate_limit' | 'deny'
v.reasons;         // [{ code: 'marker.claude_active', weight: 6.2 }, …]

engine.score('checkout');   // re-score for a specific action
engine.stop();              // remove listeners and timers

引擎持续观察输入(指针,密钥,卷轴,计时)并每2 s重分. onVerdict 只有在 类别、推荐、代理、舞台或概率波段变化.

服务器侧助手没有 DOM 操作 :

import { matchUserAgent, CATALOG } from '@doubleagent-so/agent-detector';

matchUserAgent('Mozilla/5.0 … ChatGPT-User/1.0; +https://openai.com/bot')?.entry.id; // 'openai.chatgpt-user'

如何运作

探测和输入事件 信号,在封顶中,每个记录相比 组。 。 。 . 组合 加入他们 每张相片的前科和软马克思 超过人类,机器人和代理。 A 类 政策 将结果和动作映射到 a 建议。 每一个重量都生活在一个版本的物体中, DEFAULT_SIGNATURES细节 : 如何运作。 。 。 .

engine.payload() 是一个压缩 JSON 摘要,您可以发送到自己的后端。 以证据重新计分 客户端不能伪造 : 实例/服务器.ts。 。 。 .

试试看

git clone https://github.com/doubleagent-so/agent-detector && cd agent-detector && npm ci
npm run example     # live verdict at http://127.0.0.1:8123 — try a real browser, a headless one and an agent
npm run bench       # confusion matrix on labelled synthetic sessions

捐款

发现更多眼睛会更好 开始的好地方:

• 报告误读会话:一个真正的被标记为自动化的浏览器,或者一个作为人经过的代理. 打开错误的分类。 。 。 .
• 添加代理或机器人 及其操作员的文档. 请求一 或者说 自己加进去。 。 。 .
• 更难测试. 合成的痕迹 test/traces.ts 今天很容易,现实的 npm run bench 有意义的.
• 标有标签的问题 不错的第一期 财务报告和审定财务报表 需要帮助。 。 。 .

读取 捐款额 一:先是测试,假阳性是最差的bug,重量需要证据. 私下举报(警卫),不是在公共问题上.

支助

• 问题和错误 : 打开一个问题。 。 。 .
• 私人账户或账单问题: 支持@ doubleagent.so。从不在公共问题中贴出密钥或会话符号.
• 安全问题:按 警卫。 。 。 .

维护者 双面代理 • 妇女 捐款 • 妇女 行为守则 • 妇女 警卫 • 妇女 麻省理工学院许可证