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) 상호작용을 자동으로 처리합니다. * **에이전틱 커머스 지원** – 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 기반 상호작용을 더 쉽게 모니터링하고 제어할 수 있게 합니다.