SuperAPI AI 工具集

visitor-identification

前端与建站

查看项目

更新于 10-15 21:51

技能介绍

用途:识别访问网站的公司,并记录其阅读的页面与来源,数据写入 Cargo 模型,自动保持更新,无需人工触发。识别粒度为公司级,即把 IP 解析为组织,不识别具体个人,也不向任何人发送数据。

主要能力:由三部分组成。公司模型使用 Snitcher 的 fetchOrganisations,通过 Cargo 积分创建并为站点开通 Snitcher 工作区,把跟踪片段与工作区写入模型配置;会话模型使用 fetchSessions,读取同一部署中公司模型所开通工作区的 visitingCompanies.config._workspaceUuid;站点侧的同意门控从环境令牌接收片段,只保留公开 profile ID,在访客接受后才按自有审核设置加载 Snitcher,接受前不加载任何内容。

使用方式:在 CDK 项目内安装,cargo-ai cdk add cookbook/visitor-identification 会把模型写入 infra/visitor-identification/,并把流程与 site/ 文件写入 .claude/skills/visitor-identification/。若尚无项目,可执行 cargo-ai cdk init <dir> --cookbook visitor-identification && cd <dir> && npm install。网站需已声明(通常由 website-building 完成),该技能只做增量添加,不创建网站;已有 Snitcher 连接或访客模型时复用之而非重复创建。随后接入站点、渲染同意门控、在 defineApp 添加环境令牌并设置隐私 URL。可先运行 node --import tsx evals/contract.mjs,再从项目根执行 npm run check && cargo-ai cdk plan,确认差异后仅在明确同意时执行 cargo-ai cdk deploy。

限制与注意:每识别出一家公司会在其首次进入模型时计费一次,会话不额外计费,支出随流量增长且无内置上限,首次部署前须读取实时价格与信用余额并取得运营者同意。Snitcher 自身的 waitForConsent 在同意前仍会记录页面浏览量,因此门控做到同意前完全不加载;Global Privacy Control 视为拒绝。站点必须使用自有审核过的加载器,不能直接使用提供方片段,无法识别的片段会导致构建失败;表单、点击、下载、错误与录制采集保持关闭。跟踪仅在就绪站点的规范来源运行,Cargo URL、预览与草稿站点不加载。公司模型的 url 需保持稳定,更换 URL 会开通新工作区并清空历史。仓库中不得存放凭据、部署命令或客户数据。一天没有识别到公司即如实记为零,并非每个 IP 都能解析到组织。

适用场景:可为站点补充公司访客识别,作为账户评分中的近期访问信号,判断哪些访问公司属于所选市场,或作为以公司(而非个人)身份触达的理由。