Sobre el proyecto

Known Agents SDK es un cliente oficial de Node.js para interactuar con la plataforma Known Agents. Permite que las aplicaciones de servidor en TypeScript o JavaScript recopilen analíticas detalladas sobre agentes de IA y otros bots que visitan un sitio o llaman a endpoints del Model Context Protocol (MCP). Características principales: * **Rastreo de eventos de visita** – Utilice `trackPageviewOrRESTCall` en el middleware para registrar vistas de página o llamadas REST. Los eventos se encolan y se vacían automáticamente según el tamaño o el intervalo de tiempo. * **Rastreo de llamadas MCP** – Para servicios basados en el Model Context Protocol, `trackMCPCall` registra la solicitud, la respuesta y los detalles del transporte, manejando automáticamente las interacciones del Agentic Commerce Protocol (ACP) y el Universal Commerce Protocol (UCP). * **Soporte para comercio agentico** – Al manejar respuestas REST de ACP o UCP, incluya el cuerpo de la respuesta en `trackPageviewOrRESTCall` para capturar datos del flujo de compra. * **Generación automática de robots.txt** – Llame a `generateRobotsTXT` con una lista de valores de `AgentType` para obtener un archivo robots.txt en texto plano que bloquee o permita categorías específicas de rastreadores. La cadena puede regenerarse periódicamente (por ejemplo, diariamente) y servirse en `/robots.txt`. * **Agent Identification API** – Identifique y verifique las solicitudes entrantes utilizando `identifyAgent` (solicitud única) o `identifyAgents` (lote). La respuesta incluye el estado de verificación, metadatos del agente, información de ASN y una puntuación de automatización que indica la probabilidad de que la solicitud sea automatizada. La instalación es sencilla a través de npm: `npm install @knownagents/sdk`. Después de registrarse en knownagents.com y obtener un token de acceso, instancie el cliente con `new KnownAgents('YOUR_ACCESS_TOKEN')`. La configuración opcional le permite establecer `flushQueueSize` y `flushIntervalInMilliseconds` para el procesamiento por lotes de eventos. El SDK requiere TypeScript ≥ 4.7 y se ejecuta en Node.js 18 LTS o posterior. Para obtener ayuda, abra un problema en el repositorio de GitHub. En general, la librería proporciona una solución integral de servidor para analíticas de agentes de IA, gestión de tráfico de bots y manejo automatizado de robots.txt, facilitando el monitoreo y control de las interacciones impulsadas por IA con sus servicios web.