Framework How-To Guide aiknowledgesignal.io

How to Meet Technical Performance Prerequisites

A crawler that times out, gets blocked at your firewall, or hits a cookie wall never reaches your content — five technical baselines decide whether your pages are even retrievable.

Why it matters

Allowing AI crawlers in robots.txt (Phase 1.1) is necessary but not sufficient. A crawler can still be turned away one layer down — silently blocked by your CDN or WAF, timed out by a slow page, served a broken mobile layout, or stopped by a cookie banner that covers the content on first paint. Each of these produces incomplete or empty crawls, and the AI system simply moves on.

These are infrastructure problems, not content problems, which makes them easy to miss — your analytics show human visitors fine while crawlers quietly fail. Five things decide whether your pages are physically retrievable.

What good looks like

The page responds fast, completely, and identically to a crawler as to a person:

Step by step

  1. Verify network-level access (CDN / WAF) The most common silent failure: your firewall blocks AI crawler user-agents or their IP ranges. Test the live site with curl --user-agent "GPTBot" -I https://yourdomain.com/ and confirm a 200, not a 403/503 or a challenge page. Treat that as a first pass only: WAFs verify real crawlers by IP range or reverse DNS, so a spoofed user-agent can be treated differently from the real bot. Confirm in server logs or CDN bot analytics that requests from the vendors’ published IP ranges get 200. A managed bot-detection ruleset you did not configure yourself is still an access control. Enumerate what your CDN blocks by default before assuming you are open. If your WAF has a bot-management rule, add explicit allow rules for the AI user-agents you permit in robots.txt.
  2. Hit the page-load target Measure with PageSpeed Insights or WebPageTest and fix Core Web Vitals. Aim for under ~3 seconds; optimise images, defer non-critical scripts, and cache aggressively. If crawlers overload you, answer with 429 or 503 plus Retry-After rather than blocking them.
  3. Confirm mobile responsiveness Google indexes the mobile version of your pages, and its AI features draw on that index. Test with a mobile user-agent and a narrow viewport; ensure text, tables, and headings reflow rather than overflow or hide.
  4. Remove blocking interstitials Cookie consent banners, newsletter modals, and age gates that cover the content on first paint reduce crawl quality. Render the content underneath them, or defer the overlay until after first paint, so the substance is present when the crawler reads the page.
  5. Stabilise hosting and the canonical tag Pages must respond reliably, without timeouts or 5xx errors, under normal and crawl load. Confirm every page declares a <link rel="canonical"> that matches the URL you actually want indexed and that you submit in the sitemap — inconsistent canonicals split or misdirect authority.

Worked examples

1 Diagnosing a silent WAF block

The site loads perfectly in a browser, but it's absent from AI answers. The firewall is challenging the crawler's user-agent before it ever sees a page.

# Compare a normal browser UA vs an AI crawler UA
curl -I -s -o /dev/null -w "%{http_code}\n" \
  --user-agent "Mozilla/5.0" https://yourdomain.com/        # → 200

curl -I -s -o /dev/null -w "%{http_code}\n" \
  --user-agent "GPTBot"     https://yourdomain.com/        # → 403  ← blocked

# Fix: add an allow rule for GPTBot/ClaudeBot/PerplexityBot
# in your WAF/bot-management config, then re-test until both return 200.
2 Before / after: the five baselines

The same page, audited against all five prerequisites.

Before WAF challenges GPTBot (403); 6.4s load; desktop-only layout; cookie wall covers the article on first paint; canonical points to a ?ref= tracking URL. Crawlers get nothing usable.
After AI user-agents allow-listed (200); 2.1s load; responsive; consent banner renders below the content; canonical matches the clean sitemap URL. The page is fully retrievable.

Common mistakes

MistakeFix
WAF/bot manager silently blocks AI user-agentsAllow-list the agents you permit in robots.txt; confirm with real crawler IPs in your logs, not only a spoofed curl.
Slow pages and poor Core Web VitalsOptimise images and scripts; target sub-3s and good LCP/INP.
Desktop-only layoutMake it responsive; Google indexes mobile-first.
Cookie/consent wall over content on first paintRender content underneath or defer the overlay until after first paint.
Canonical points to a tracking or duplicate URLSet canonical to the clean URL you submit in the sitemap.

Limits of this advice

Checklist

  • Spoofed curl --user-agent "GPTBot" -I <url> returns 200, and logs show real AI-crawler IPs receiving 200
  • Page load under ~3 seconds and good Core Web Vitals (PageSpeed Insights / WebPageTest)
  • Fully responsive under a mobile user-agent and narrow viewport
  • No interstitial covers core content on first paint
  • No timeouts or 5xx errors under normal load; overload answered with 429/503 + Retry-After
  • <link rel="canonical"> matches the submitted sitemap URL