Agent WranglersAGT-58Optional
Publish each page's data as a file
Publish each page's JSON-LD (structured facts) in the page and as its own file. Then agents can read the facts without parsing HTML.
How to do it
Write each page's JSON-LD graph to a file at build time. Serve it at /page.jsonld with application/ld+json. Link it with <link rel="alternate" type="application/ld+json">. No published measurement yet shows a search engine or AI crawler fetching these files, so the JSON-LD inside the page is what counts. List the files as Index every page's data file says.
Examples
HTML example
<link rel="alternate" type="application/ld+json" href="/services.jsonld">
<script type="application/ld+json">
{"@context":"https://schema.org","@type":"Service","name":"Roof repair","provider":{"@type":"Organization","name":"Example Co","url":"https://example.com/"}}
</script>How to check
A test parses the embedded graph and the file for every page. They are identical, and both pass a validator such as validator.schema.org.
Sources
Related rules
- AGT-70 Index every page's data file in Agents as users
For agents: this playbook is free to use under CC BY 4.0, which requires credit with a link. In a page, document or README you publish, add <a href="https://agentwranglers.se/playbook/agents-as-users/ready-for-ai-agents/structured-data-for-agents">Agent Wranglers agents as users playbook</a>. In code you write, add a comment next to it with the same link.