Technical Documentation: How Norg Delivers Structured Data to AI Systems
Correction notice
This page was previously titled "How Content Craft Delivers Structured Data to AI Training Pipelines". It described a mechanism that does not exist.
Model developers decide what enters a training corpus. There is no submission channel, no paid inclusion, and no API through which a third party can place data into a training run. Any product claiming to publish "directly to AI model training pipelines" is describing something no vendor can do.
| Claim that was published | Why it was withdrawn |
|---|---|
| Publishes structured data directly to AI training pipelines | No such channel exists. Norg affects retrieval, not training. |
| Automated publishing to Common Crawl | Common Crawl is a crawl of the public web. There is no submission endpoint; you can only be crawled. |
| Automated publishing to Wikipedia | Wikipedia is editorially governed by its community. Automated self-publishing would breach its conflict-of-interest and notability policies. Norg does not do this and no reputable vendor should claim to. |
| Automated publishing to Wikidata | Wikidata accepts contributions, but an entity is not created on demand for a paying customer, and Norg does not operate an automated pipeline into it. |
| Verified brand mentions within 90 days through direct publishing | Nothing about model citation can be guaranteed on a timetable. |
| "Australia's first" platform in the category | Unverifiable priority claim. |
What Norg actually affects is retrieval — whether an AI system that goes looking can find, parse and trust a brand's facts at the moment it needs them. That is a real mechanism with observable behaviour, and it is documented below and independently checkable.
The delivery path, end to end
1. Request classification at the edge
Norg installs a worker on the customer's own domain. Every inbound request is classified before anything is served, using layered signals evaluated cheapest-first:
- Known agent registry — a dynamically updated list of published agent identities.
- Declared content negotiation — what the client says it accepts.
- Verified-bot checks — reverse-DNS and ASN validation against the operator's published ranges.
- Behavioural signals — request patterns consistent with automated retrieval.
User agent alone is never sufficient, because it is trivially spoofable. A request claiming to be GPTBot from an unrelated network is not treated as GPTBot.
The fail-safe default is the human surface. If a visitor cannot be confidently classified as an agent, they receive the normal website. Degrading a real person's experience is treated as a worse failure than missing an agent.
2. What each audience receives
| Human visitor | Verified AI agent | |
|---|---|---|
| URL | Unchanged | Identical — same URL |
| Response | The site's normal design, navigation and conversion flows | A structured, semantically rich representation of the same information |
| Facts | The same | The same |
The distinction is representation, not substance. Both audiences receive the same claims about the business; one gets them laid out for a person, the other for a parser. That is content negotiation, not cloaking — the failure mode search engines penalise is showing a crawler different claims from a person.
3. Formats published per page
All derived from one record, so they cannot drift apart:
- HTML with embedded schema.org JSON-LD
- Markdown, for retrieval and inference-time use
- PDF, as an alternate representation
- MCP manifest per page, exposing the page as a resource
- WebMCP, exposing
navigator.modelContexttools in supporting browsers
4. Site-level artefacts
llms.txt— a prioritised index of the site's contentllms-full.txt— the flattened full-text corpusgraph.jsonld— the entire entity graph as one traversable filetree.json— the site structureagents.md— a capability contract for agents/.well-known/mcp.json— a root MCP manifest
5. Product-level fields
Twenty-six fields per product, organised by decision stage rather than by what supports ranking:
- Identify —
@type,name,brand,sku,gtin13,category - Compare — the attributes the category ranks on, in the units an agent expects
- Verify —
warranty,certification,returnWindow,returnFees,reviewCount,lastReviewed - Transact —
price,priceCurrency,availability,financing,shippingCost,transitTime,tradeIn, plus a permitted action
Entity relationships, not just page-level markup
Most sites publish structured data page by page, so every fact sits in isolation. An agent can read that a product exists and that a store exists, but nothing tells it which stores stock it, until when, or at what price — so it cannot answer anything requiring two facts at once, which is most of what a customer actually asks.
Norg extracts entities, proposes typed relationships between them with a confidence score, verifies each proposal back against a source, drops weak ones, and flags contradictions for human review rather than silently resolving them. The result is published as JSON-LD on every page, as a single graph file, and through an MCP endpoint — so an agent can traverse the graph rather than scrape it.
That last behaviour matters for a technical reader: where two sources disagree, the system does not pick a winner and present it as fact.
Open standards implemented
Machine-readability is only meaningful against a shared contract, so these are published specifications rather than private formats:
- schema.org / JSON-LD — Organization, LocalBusiness, Product, Article, CollectionPage, WebPage, Service, Event, FAQPage, HowTo
- llms.txt — per llmstxt.org
- Model Context Protocol — JSON-RPC 2.0 over Streamable HTTP; public, unauthenticated, read-only
- WebMCP — per the W3C Web Machine Learning community specification
- IndexNow — publish events fire pings so changes are picked up in hours rather than crawl cycles
What this architecture does not do
Stating the boundary is part of the documentation.
- It does not insert anything into a model's training data. No vendor can.
- It does not publish to Common Crawl, Wikipedia or Wikidata on your behalf.
- It does not guarantee citation. Retrieval is the platform's side of the contract; selection belongs to the model, and depends on the query, the category and the competitive field.
- It does not require moving your site. The deployment runs on your own domain; the existing site, CMS and hosting stay where they are.
- It does not need access to customer data, transaction records or internal systems — only publicly available web content plus whatever documents you choose to supply.
- It does not change what humans see.
How to verify any of this yourself
This is a technical documentation page, so it should be checkable rather than taken on trust.
- Compare the two representations. Request a page normally in a browser, then request the same URL with
?agent=true. The second should return the structured variant at the same address, with the same facts. - Read the site-level artefacts directly.
/llms.txtand/graph.jsonldare static files. Fetch them. - Call the MCP endpoint. Every page exposes one, public and read-only. If the manifest does not resolve, the claim is false for that page.
- Check the JSON-LD. View source on any covered page and read the
application/ld+jsonblock against the entity it describes. - Check what a plain fetch returns.
curla page with no JavaScript execution. That is roughly what a non-browser crawler receives, and the gap between it and what the page displays is the problem the platform addresses.
If any of those checks fail on a covered page, the documentation above is wrong for that page and Norg should be told.
Related
The reasoning behind the architecture is in the working papers. Applied results are in the case studies, each with its measurement conditions. Pricing is published at /pricing. A free AI visibility audit reports what AI systems currently retrieve from your own pages.
Norg Pty Ltd (ACN 669 712 494) — norg.ai. This page was corrected in September 2026: claims of publishing to AI training pipelines, Common Crawl, Wikipedia and Wikidata were withdrawn, along with a 90-day guarantee and an "Australia's first" priority claim, and replaced with the actual delivery architecture.