AI-Me

AI-Me vs Schema.org: Why Both Matter

Schema.org is excellent. AI-Me is complementary, not a replacement. Here's why the distinction matters.

Different scope

Schema.org is a rich vocabulary embedded as JSON-LD across individual pages. It describes entities — products, people, events, organizations — and is consumed primarily by search engines, knowledge graphs, and SEO tools.

AI-Me is a single JSON document at a predictable well-known endpoint. It describes a site as a whole — its canonical pages, offerings, and primary calls-to-action — in a strict, validatable shape designed for AI agents. One request. Full picture.

Different consumers

Schema.org is for:

  • • Search engine crawlers (Google, Bing)
  • • Knowledge graph builders
  • • Rich snippet generators
  • • SEO tools

AI-Me is for:

  • • AI agents and assistants
  • • LLM-powered applications
  • • Automated discovery pipelines
  • • Agent orchestration platforms

Different trade-offs

Discovery: one fetch vs. crawling

Schema.org data is scattered across pages — an agent must crawl multiple pages and aggregate JSON-LD to build a complete picture. An AI-Me discovery manifest is a single document at a known URL. One HTTP request gives agents everything they need.

Shape: strict vs. flexible

Schema.org is deliberately flexible — there are many valid ways to express the same information, which makes it powerful but harder to parse deterministically. AI-Me defines one strict shape with a formal JSON Schema. This makes validation trivial and comparison across sites deterministic.

Purpose: depth vs. discovery

Schema.org excels at rich, detailed, per-entity descriptions. AI-Me focuses on just enough information for an agent to understand who you are, what you do, and what action to take next — then follow links for depth.

Use them together

The best approach is to use both. Keep your schema.org markup for search engines, and add an AI-Me discovery manifest for AI agents. Link them via the related.schema_org field in your manifest: 

"related": {
  "schema_org": "https://example.com/schema.jsonld"
}

This way, AI-Me acts as the discovery layer and schema.org provides depth. Agents use AI-Me for quick orientation and can follow the related links for richer data when needed. Search engines continue to use your schema.org markup as before.

In short: schema.org for search engines, AI-Me for agents. Both are worth having.