# schema-org
## What is Schema.org JSON-LD?
**Schema.org JSON-LD** is machine-readable metadata embedded in a page as a `
```
The markup is embedded in `` or `` and has no visual effect — it is only visible to search engines and AI agents.
## Why does a site need Schema.org JSON-LD?
Schema.org solves a fundamental problem: HTML contains content but doesn't say **what it means**. Is a paragraph of text a review? A schedule? An instruction? Without markup, AI has to guess. With markup, it knows exactly.
**For [GEO](/glossary/geo) and [AEO](/glossary/aeo):**
AI assistants (ChatGPT, Perplexity, Google AI Overview) use structured data when generating answers. A page with `FAQPage` is cited as a ready-made answer — this is the primary tool of [AEO](/glossary/aeo). A page with `Product` and `aggregateRating` gets rich snippets.
**For AI agents:**
An agent extracts data from markup faster and more accurately than from raw HTML.
**Practical effects:**
- `FAQPage` → "Question and answer" rich snippet, citation in AI answers
- Recipe/article → rich snippet with image
- `Organization` → Knowledge Panel
- `SoftwareApplication` → rating in app search results
## How to implement Schema.org JSON-LD?
**Minimal set for most sites:**
```html
```
**FAQ page:**
```json
{
"@context": "https://schema.org",
"@type": "FAQPage",
"mainEntity": [
{
"@type": "Question",
"name": "What is agent-readiness?",
"acceptedAnswer": {
"@type": "Answer",
"text": "Agent-readiness is the degree to which a site..."
}
}
]
}
```
**Priority types for agent-readiness:**
| Type | When to use |
|---|---|
| `WebSite` | Homepage |
| `Organization` | About page |
| `SoftwareApplication` | Homepage for SaaS / apps |
| `FAQPage` | FAQ page |
| `Article` / `TechArticle` | Articles, documentation |
| `DefinedTerm` | Glossary pages |
| `Service` | Services / pricing page |
**For Astro (our approach):**
```astro
---
const schema = {
'@context': 'https://schema.org',
'@type': 'SoftwareApplication',
name: 'Agent Ready Scanner',
url: 'https://agentsready.io',
};
---
```
**Validation:** before deploying, check at [validator.schema.org](https://validator.schema.org/) — there should be 0 errors, ideally 0 warnings.
## How do we check Schema.org?
Our scanner performs `GET /` (the homepage) and verifies:
1. **Presence of JSON-LD blocks** — find all `