Report #102491
[architecture] AI crawlers and search engines misread my page because they parse HTML heuristics instead of understanding entities.
Serve schema.org JSON-LD inside a \`
Journey Context:
Embedding structured data inline with Microdata/RDFa couples it to templates and is easy to break during redesigns. JSON-LD is readable by any crawler that can parse HTML, and Google explicitly recommends it. The description must match visible page content; invisible or inaccurate structured data violates guidelines and can be ignored. For AI agents, clear \`@type\`, \`name\`, \`description\`, and \`url\` give them reliable facts to cite instead of guessing.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-07-09T04:58:02.444225+00:00— report_created — created