Webflow Integration

Spyglasses provides comprehensive AI SEO, bot detection, and AI referrer tracking for Webflow sites through our Cloudflare Workers integration. This approach is necessary because Webflow doesn't provide direct access to request logs or middleware capabilities that Spyglasses requires for effective bot detection and analytics.

Why Cloudflare Workers?

Webflow is a powerful website builder, but it has certain limitations when it comes to server-side integrations:

Webflow Limitations

No Server Access: Webflow doesn't provide access to server-side code or middleware
No Request Logs: You can't intercept or analyze incoming HTTP requests
Limited Custom Code: Only client-side JavaScript is supported
No Bot Detection: No way to identify bots before they load your pages

Cloudflare Workers Solution

Cloudflare Workers sit in front of your Webflow site, providing:

✅ Full Request Access: Analyze every request before it reaches Webflow
✅ Edge Processing: Lightning-fast bot detection at 300+ global locations
✅ Complete Analytics: Track bots, AI referrers, and human visitors
✅ Selective Blocking: Block harmful bots while allowing legitimate crawlers
✅ Zero Webflow Changes: Your Webflow site remains completely unchanged

How It Works

graph LR
    A[Visitor] --> B[Cloudflare Worker<br/>Spyglasses Detection]
    B --> C{Is Bot/AI?}
    C -->|Block| D[403 Forbidden]
    C -->|Allow| E[Your Webflow Site]
    B --> F[Spyglasses Analytics]

Visitor makes request to your domain
Cloudflare Worker intercepts the request before it reaches Webflow
Spyglasses analyzes the request for bots and AI referrers
Legitimate traffic is forwarded to your Webflow site
Analytics data is sent to your Spyglasses dashboard

Prerequisites

To use Spyglasses with Webflow, you need:

Webflow site (any plan)
Cloudflare account (free plan works)
Domain on Cloudflare (your custom domain must use Cloudflare DNS)

Setup Process

Step 1: Move Your Domain to Cloudflare

If your domain isn't already on Cloudflare:

Sign up for a free Cloudflare account
Add your domain to Cloudflare
Update your domain's nameservers to Cloudflare's
Ensure your site is working through Cloudflare

Step 2: Configure Webflow

In your Webflow project settings:

Go to Publishing → Custom Domain
Add your domain (the one now on Cloudflare)
Verify the domain is properly connected

Step 3: Deploy Spyglasses Worker

🚀 Easiest Option: Use Our Template

We've created a ready-to-deploy template that requires no coding and no file editing:

✅ Everything is configured in the Cloudflare dashboard - no technical skills needed!

Alternative: Manual Setup

Follow our complete Cloudflare Workers Integration Guide with these Webflow-specific settings:

# wrangler.toml
name = "webflow-spyglasses-worker"
main = "src/index.ts"
compatibility_date = "2024-12-30"
compatibility_flags = ["nodejs_compat"]
 
[vars]
ORIGIN_URL = "https://your-site.webflow.io"
SPYGLASSES_DEBUG = "false"

Step 4: Configure Cloudflare Routes

In your Cloudflare dashboard:

Go to Workers & Pages → Overview
Click Add Route
Set route pattern: *your-domain.com/*
Select your Spyglasses Worker
Save the route

Webflow-Specific Considerations

E-commerce Sites

For Webflow e-commerce sites, consider these exclusions:

const config: SpyglassesWorkerConfig = {
  excludePaths: [
    '/checkout',
    '/account',
    '/cart',
    '/order-confirmation',
  ],
  platformType: 'webflow-ecommerce',
};

Form Submissions

Webflow forms will work normally since the Worker forwards all legitimate traffic:

✅ Contact forms continue working
✅ Newsletter signups unaffected
✅ E-commerce checkout process unchanged
✅ All Webflow integrations remain functional

Benefits for Webflow Sites

AI SEO Insights

Track AI Platform Visits: See when your content appears in ChatGPT, Claude, or Perplexity
Content Performance: Understand which pages AI platforms find most valuable
SEO Optimization: Optimize content for both humans and AI