Welcome

AgentShield is a comprehensive AI agent detection and protection suite designed to help you identify and manage automated traffic on your web applications. With enterprise-grade detection capabilities and flexible integration options, AgentShield provides the tools you need to protect your content and services.

Why AgentShield?

• Advanced AI Detection: State-of-the-art algorithms to identify AI agents, bots, and automated browsers
• Lightning Fast: Optimized for performance with minimal impact on your application
• Privacy First: GDPR compliant with configurable privacy settings
• Real-time Analytics: Monitor and analyze bot traffic patterns
• Flexible Actions: Block, redirect, log, or allow - you decide how to handle detected agents

Choose Your Integration

View Marketing Pixel documentation

No Code

Marketing Pixel

GTM-compatible pixel for marketing teams - no coding required

Client Side

Beacon

Lightweight tracking beacon for any website with WebWorker support

View Middleware documentation

Next.js

Middleware

Middleware for Next.js to detect and block AI agents

View Express documentation

Node.js

Express

Express middleware for detecting and blocking AI agents

Custom

API

API for detecting and blocking AI agents

View Marketing Pixel documentation

No Code

Marketing Pixel

GTM-compatible pixel for marketing teams - no coding required

Client Side

Beacon

Lightweight tracking beacon for any website with WebWorker support

View Middleware documentation

Next.js

Middleware

Middleware for Next.js to detect and block AI agents

View Express documentation

Node.js

Express

Express middleware for detecting and blocking AI agents

Custom

API

API for detecting and blocking AI agents

Quick Start

Get started with AgentShield in minutes:

# For JavaScript applications
npm install @kya-os/agentshield-beacon

# For Next.js applications
npm install @kya-os/agentshield-nextjs

# For Express applications
npm install @kya-os/agentshield-express

Then follow our Quick Start Guide to configure your first protection.

Key Features

Intelligent Detection

• Machine learning-based agent identification
• Behavioral pattern analysis
• Browser fingerprinting
• Request signature analysis

Performance Optimized

• < 5ms detection time
• WebWorker support for non-blocking execution
• Edge runtime compatible
• Automatic batching and compression

Developer Friendly

• TypeScript support with full type definitions
• Comprehensive API documentation
• Framework-specific integrations
• Extensive debugging tools

Analytics & Monitoring

• Real-time detection metrics
• Traffic pattern analysis
• Custom event tracking
• Integration with popular analytics platforms

Architecture Overview

AgentShield uses a multi-layered approach to detect and manage automated traffic:

1. Detection Layer: Analyzes requests using multiple signals
2. Decision Engine: Determines action based on confidence scores
3. Action Layer: Executes configured response (block, log, redirect)
4. Analytics Layer: Tracks and reports detection metrics

Next Steps

• Getting Started - Learn the core concepts and installation process
• Quick Start Guide - Get up and running in 5 minutes
• Public API Reference - Complete REST API documentation
• Examples - See real-world implementation examples

Support

• Email: hello@knowthat.ai
• Discord: Join our community
• Issues: GitHub Issues
• Blog: Latest updates and tutorials