@beacon-ai/vercel

中文文档
0.1.1发布于 2026/04/13MITTypeScriptES Module零依赖近 30 天下载 1829

追踪人工智能爬行者的活动 在你的Vercel主持的网站。 从灯塔的中线软件.

中文使用文档
文档目录7 节
  1. 安装
  2. 设置
  3. 它捕捉到的东西
  4. 它不捕捉到的东西
  5. 业绩
  6. 配置
  7. 许可证

@beacon-ai/vercel (韩语)

追踪人工智能爬行者的活动 在你的Vercel主持的网站。 Next.js 中间软件 灯塔。 。 。 .

看看哪些人工智能提供者在爬行你的网站,多久一次,以及他们访问哪些网页. Beacon识别出130+AI代理并按用途分类(训练,搜索,用户发起).

安装

npm install @beacon-ai/vercel

设置

添加到您的 middleware.ts数字 :

import { beaconLogger } from '@beacon-ai/vercel'

export default beaconLogger({
  apiKey: process.env.BEACON_API_KEY!,
  brandId: process.env.BEACON_BRAND_ID!,
})

或者将您现有的中间软件包起来 :

import { withBeacon } from '@beacon-ai/vercel'

const myMiddleware = clerkMiddleware(async (auth, request) => {
  // your auth, redirects, etc.
})

export default withBeacon(myMiddleware, {
  apiKey: process.env.BEACON_API_KEY!,
  brandId: process.env.BEACON_BRAND_ID!,
})

在您的Vercel仪表板中设置环境变量 :

变量说明
BEACON_API_KEY您的灯塔 API 密钥( 从您的灯塔仪表板)
BEACON_BRAND_ID你的品牌ID(UUID,从灯塔仪表板)

它捕捉到的东西

只请求元数据 。 永远不要要求或回应机构.

  • 时间戳
  • 主机名+路径
  • HTTP 方法
  • 用户代理
  • IP 地址
  • 参考文献

它不捕捉到的东西

  • 请求机构
  • 反应机构
  • 饼干
  • 认证信头
  • 查询参数值( 只有路径)

业绩

对反应延迟性的影响为零。 伐木是火和遗忘 批量的Aync交付。 如果灯塔端点无法通达,则会默默地抛出原木.

配置

beaconLogger({
  apiKey: '...',           // required
  brandId: '...',          // required — your brand ID (UUID)
  batchSize: 50,           // entries to buffer before sending (default: 50)
  flushInterval: 5000,     // ms before flushing buffer (default: 5000)
})

许可证

麻省理工学院

版本与发布记录

@beacon-ai/vercel 共发布 2 个版本,首次发布于 2026/04/13;过去 12 个月发布了 2 个版本。

版本发布日期距今
0.1.1latest2026/04/136 个月前
0.1.02026/04/136 个月前

关于 @beacon-ai/vercel 的常见问题

@beacon-ai/vercel 是什么?

追踪人工智能爬行者的活动 在你的Vercel主持的网站。 从灯塔的中线软件.

如何安装 @beacon-ai/vercel?

在项目目录运行 npm install @beacon-ai/vercel,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:next(>=14.0.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@beacon-ai/vercel 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@beacon-ai/vercel 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@beacon-ai/vercel 可以商用吗?

@beacon-ai/vercel 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@beacon-ai/vercel 的下载量有多少?

根据 npm 官方下载统计,@beacon-ai/vercel 在 2026/10/08 – 2026/11/06 这 30 天内被下载 1,829 次,日均约 61 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@beacon-ai/vercel 还在维护吗?

最新版本 0.1.1 发布于 2026/04/13(6 个月前);至今共发布 2 个版本,其中过去 12 个月发布了 2 个;首次发布于 2026/04/13。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。