Об этом проекте

Known Agents SDK — официальный клиент Node.js для взаимодействия с платформой Known Agents. Он позволяет серверным приложениям на TypeScript или JavaScript собирать детальную аналитику о AI‑агентах и других ботах, посещающих сайт или вызывающих конечные точки Model Context Protocol (MCP). Ключевые возможности: * **Отслеживание событий посещения** – Используйте `trackPageviewOrRESTCall` в middleware для записи просмотров страниц или REST‑вызовов. События помещаются в очередь и автоматически сбрасываются по размеру или интервалу времени. * **Отслеживание вызовов MCP** – Для сервисов, построенных на Model Context Protocol, `trackMCPCall` фиксирует запрос, ответ и детали транспорта, автоматически обрабатывая взаимодействия Agentic Commerce Protocol (ACP) и Universal Commerce Protocol (UCP). * **Поддержка агентной коммерции** – При обработке ответов ACP или UCP REST включайте тело ответа в `trackPageviewOrRESTCall` для захвата данных о потоке покупок. * **Автоматическая генерация robots.txt** – Вызов `generateRobotsTXT` со списком значений `AgentType` возвращает обычный текст robots.txt, блокирующий или разрешающий определённые категории краулеров. Строку можно regenerировать по расписанию (например, ежедневно) и обслуживать по пути `/robots.txt`. * **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 или новее. Для поддержки откройте issue в репозитории GitHub. В целом, библиотека предоставляет комплексное сервер‑side решение для аналитики AI‑агентов, управления трафиком ботов и автоматизированной обработки robots.txt, упрощая мониторинг и контроль AI‑ориентированных взаимодействий с вашими веб‑сервисами.