structured-datalisted
Install: claude install-skill sharabarinillia/SEO-GEO-Vercel-Playbook-Skill
# Structured data (JSON-LD)
Structured data tells machines what a page is about: which business, which service, which
answer. It drives rich results where Google still shows them, and it helps search engines and AI
assistants read facts without guessing. Google says it is not required for its AI features, but
it costs little when it is generated from the same data as the page.
## Principles
1. **One `@graph` per page**, in one `<script type="application/ld+json">` block, generated at
build time with `JSON.stringify` (never by string concatenation).
2. **Stable `@id`s** link the nodes: `https://www.example.com/#org` for the business on every page,
`#website`, and `<page URL>#webpage` per page. Reference with `{ "@id": "…" }`.
3. **Every page's graph is self-contained**: if a node is referenced, it is defined on that page
(repeat the Organization node; it's small).
4. **Facts only, and the same facts as the page.** Markup that claims what the page doesn't show
(reviews, prices, hours) breaks Google's guidelines and gets repeated by AI assistants.
5. **`dateModified` comes from the same source as the sitemap's `lastmod`**, the date the visible
content last changed.
6. **Absolute URLs, ISO 8601 dates** (`2026-11-05` or `2026-11-05T09:30:00+01:00`).
## Steps
1. **Pick the types.** Organization or a LocalBusiness subtype (one business, everywhere); WebSite;
WebPage (or AboutPage, ContactPage, CollectionPage) per page; BreadcrumbList on inner pages;
then th