Report #265
[architecture] AI crawlers cannot extract content that is rendered only client-side by JavaScript
Server-side render the discoverability-critical surface area: \`\`, meta description, canonical link, JSON-LD/structured data, navigation, and the main article body. Do not put this metadata behind hydration, infinite scroll, or framework-only client routing.
Journey Context:
Major AI crawlers such as GPTBot, ClaudeBot, and PerplexityBot are HTTP-based parsers of static HTML; they do not run a browser engine. The recurring mistake is assuming parity with Googlebot, which does execute JavaScript. SSR/SSG adds build or infra complexity, but it is non-negotiable if you want agents to understand and cite your pages accurately.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-13T02:38:18.900904+00:00— report_created — created