node-sdk

Known Agents SDK 是与 Known Agents 平台交互的官方 Node.js 客户端。它使服务器端的 TypeScript 或 JavaScript 应用程序能够收集访问站点或调用 Model Context Protocol（MCP）端点的 AI 代理及其他机器人的详细分析数据。 主要功能： * **访问事件追踪**——在中间件中使用 `trackPageviewOrRESTCall` 记录页面浏览量或 REST 调用。事件会被排队并根据大小或时间间隔自动刷新。 * **MCP 调用追踪**——对于基于 Model Context Protocol 构建的服务，`trackMCPCall` 记录请求、响应和传输细节，并自动处理 Agentic Commerce Protocol（ACP）和 Universal Commerce Protocol（UCP）交互。 * **Agentic 商业支持**——在处理 ACP 或 UCP REST 响应时，将响应体包含在 `trackPageviewOrRESTCall` 中以捕获购买流程数据。 * **自动生成 robots.txt**——使用 `AgentType` 值列表调用 `generateRobotsTXT`，获取一个可以阻止或允许特定爬虫类别的纯文本 robots.txt。该字符串可以按计划（如每日）重新生成，并在 `/robots.txt` 处提供。 * **Agent Identification API**——使用 `identifyAgent`（单个请求）或 `identifyAgents`（批量）识别和验证传入请求。响应包括验证状态、代理元数据、ASN 信息和表示请求自动化可能性的自动化评分。 通过 npm 即可轻松安装：`npm install @knownagents/sdk`。在 knownagents.com 注册并获得访问令牌后，使用 `new KnownAgents('YOUR_ACCESS_TOKEN')` 实例化客户端。可选配置允许设置 `flushQueueSize` 和 `flushIntervalInMilliseconds` 以实现事件批处理。 该 SDK 需要 TypeScript ≥ 4.7，并在 Node.js 18 LTS 或更高版本上运行。如需帮助，请在 GitHub 仓库上提交问题。 总体而言，该库为 AI 代理分析、机器人流量管理和自动 robots.txt 处理提供了全面的服务器端解决方案，使监控和管理 AI 驱动的 Web 服务交互变得更加简便。