Spyglasses – AI Traffic Analytics

Important: This plugin requires a free account with Spyglasses. Sign up at spyglasses.io to get your API key. By using this plugin, you agree to our Terms of Service and Privacy Policy.

Spyglasses provides advanced detection for AI agents, bots, and AI referrer traffic that interacts with your WordPress site.

Key Features

• AI Agent Detection: Automatically detect traffic from AI browsing assistants
• AI Referrer Tracking: Identify human visitors who clicked links from AI-generated content
• Real-time Monitoring: Track and monitor AI-related traffic to your site
• Bot Blocking: Selectively block specific AI agents or entire categories of bots
• AI Model Trainer Protection: Prevent AI systems from scraping your content for model training
• Dashboard Insights: View detailed analytics on AI traffic via the Spyglasses dashboard
• Central Management: Configure all blocking settings from your Spyglasses dashboard
• Lightweight: Minimal impact on site performance and user experience
• Easy Setup: Simple configuration with just an API key
• Auto-Updating Patterns: Automatically syncs with latest AI detection patterns daily
• Smart Filtering: Automatically excludes WordPress internal processes to prevent log pollution
• Cache-Friendly: Fully compatible with all major caching plugins including LiteSpeed Cache, WP Super Cache, W3TC, WP Rocket, and more
• Reliable Fallbacks: Local pattern storage ensures detection continues working even during API outages

How It Works

Spyglasses uses pattern recognition to identify:

1. AI agents and bots visiting your site through user-agent detection
2. Human visitors from AI platforms through referrer detection

When AI-related traffic is detected, information about the visit is securely sent to the Spyglasses collector for analysis and reporting. You can also choose to block specific types of bots from accessing your site through your Spyglasses dashboard.

Privacy & Transparency

Spyglasses only collects information about AI-related traffic, not about your regular human visitors. All code is open source and available for review on GitHub.

External Services

This plugin connects to external Spyglasses API services to provide AI traffic detection and analytics functionality. A Spyglasses account is required for the plugin to work.

Spyglasses Pattern API

What it does: Downloads the latest AI agent detection patterns to keep your site’s bot detection up-to-date.

API Endpoint: https://www.spyglasses.io/api/patterns

Data sent: Your API key for authentication

When: Daily automatic sync (if enabled) or manual sync from plugin settings

Purpose: Ensures your site can detect the newest AI agents and bots as they emerge

Spyglasses Collector API

What it does: Receives and processes data about AI agent and other bot visits to your website for analytics and reporting.

API Endpoint: https://www.spyglasses.io/api/collect

Data sent when an AI agent or bot is detected:
* IP Address of the AI agent/bot
* User Agent string of the AI agent/bot
* URL/web page that was visited
* HTTP request headers from the AI agent/bot
* Request method (GET, POST, etc.)
* Response status code and timing
* Referrer information (if available)
* Timestamp of the visit

When: Only when traffic matching AI agent or bot patterns is detected on your site

Purpose: Provides analytics dashboard showing AI traffic patterns, blocked requests, and detailed visitor logs

Important: No data about regular human visitors is collected or sent. Only traffic that matches known AI agent patterns triggers data collection.

Service Provider

Both services are provided by Orchestra AI, Inc.:

• Website: spyglasses.io
• Terms of Service: spyglasses.io/legal/terms
• Privacy Policy: spyglasses.io/legal/privacy-policy