Przejdź do treści
Biblioteka skilli
Marketing i treści · Budowanie i kod

structured-data

/structured-data

Projektuje i sprawdza dane JSON-LD schema.org dla stron jednym połączonym grafem, z kontrolą identyfikatorów i wymaganych pól.

Licencja
MIT
Ostatnia zmiana repozytorium
11.11.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
6
Skrypty
2
Komentarze HTML
0
Adresy URL w SKILL.md
5
Przestarzałość

Brak sygnałów. Repozytorium zmienione 11.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co sprawdzić przed instalacją
  • 2 skrypty w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.

Skrypty: scripts/jsonld-check.mjs, scripts/site-files.mjs

Co robi i kiedy

Projektuje i sprawdza dane JSON-LD schema.org dla stron jednym połączonym grafem, z kontrolą identyfikatorów i wymaganych pól.

Oryginalny opis (EN)

Designs, writes and validates JSON-LD structured data (schema.org) for websites. Builds one connected @graph per page (Organization or LocalBusiness, WebSite, WebPage, BreadcrumbList, Service, Product, Article, FAQPage, SoftwareApplication, Event) linked by stable @id values and generated at build time; scripts/jsonld-check.mjs checks every page of a build or live site for parse errors, unresolved @id references, required and recommended properties, absolute URLs and ISO dates. Use it when adding schema markup, chasing rich results, fixing Search Console structured-data errors, or making a bus

Jak działa

  1. Principles
  2. Steps
  3. What to expect from rich results
  4. Don'ts
Sekcje z nagłówków SKILL.md, w oryginale · 63 linii, 457 słów
Podgląd SKILL.md
---
name: structured-data
description: >
  Designs, writes and validates JSON-LD structured data (schema.org) for websites. Builds one
  connected @graph per page (Organization or LocalBusiness, WebSite, WebPage, BreadcrumbList,
  Service, Product, Article, FAQPage, SoftwareApplication, Event) linked by stable @id values and
  generated at build time; scripts/jsonld-check.mjs checks every page of a build or live site for
  parse errors, unresolved @id references, required and recommended properties, absolute URLs and
  ISO dates. Use it when adding schema markup, chasing rich results, fixing Search Console
  structured-data errors, or making a business's facts (address, services, opening hours,
  certifications) machine-readable for search engines and AI assistants.
license: MIT
compatibility: jsonld-check.mjs needs Node.js 18 or later.
metadata:
  author: Illia Sharabarin
  version: "1.0.0"
  updated: "2026-11-05"
---

# 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 the page's own node: Service, Product, Article, SoftwareApplication (free tools), Event,
   FAQPage (questions answered on the page), DefinedTermSet (glossaries, reference charts).
   Patterns: [references/graph-patterns.md](references/graph-patterns.md).
2. **Start from the template** [assets/graph-template.json](assets/graph-template.json) and fill
   it from the site's content data, not by hand per page.
3. **Generate it in the build** (a template partial, a Vite/Astro plugin, or `generateMetadata` in
   Next.js) and inject it into the `<head>`.
4. **Validate every page:**

   ```bash
   node <skill>/scripts/jsonld-check.mjs --dir dist          # build folder
   node <skill>/scripts/jsonld-check.mjs --sitemap https://www.example.com/sitemap.xml
   ```

   Errors (parse failures, unresolved `@id`s, missing required properties, relative URLs, bad
   dates) must be fixed; make the build fail on them. Warnings list recommended properties: add
   one only when the fact is confirmed (no opening hours you don't have).
5. **Spot-check rich results** for 3–5 key pages in Google's
   [Rich Results Test](https://search.google.com/test/rich-results) and the
   [Schema Markup Validator](https://validator.schema.org/).
6. **After launch,** watch Search Console's enhancement reports for errors.

## What to expect from rich results

Google's supported rich results change often; check the
[Search Gallery](https://developers.google.com/search/docs/appearance/structured-data/search-gallery)
before promising one. Notes as of November 2026 are in
[references/rich-results.md](references/rich-results.md). Markup Google no longer shows does no harm
and still describes the page to other consumers.

## Don'ts

- No markup for content that isn't visible on the page.
- No fake or self-written reviews and ratings.
- No `LocalBusiness` without a real address the business confirms.
- No separate, conflicting graphs from plugins and hand-written blocks on one page: merge them.
Pliki w paczce (6)
  • SKILL.md 4 KB
  • assets/graph-template.json 3 KB
  • references/graph-patterns.md 4 KB
  • references/rich-results.md 2 KB
  • scripts/jsonld-check.mjs 12 KB
  • scripts/site-files.mjs 11 KB

Wersje

RepozytoriumWynikLicencja
Ta strona · sharabarinillia/SEO-GEO-Vercel-Playbook-Skill100MIT
adobe/skills100Apache-2.0
devpilotX/ai-skill-ai100MIT
thedaviddias/front-end-checklist100MIT

Migawka bazy z 13.11.2026 · wersja paczki 48771e9d8d45 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 90schema
    Generuje poprawne dane strukturalne schema.org w JSON-LD dla stron, produktów, artykułów i wydarzeń oraz podłącza je do szablonów.
  • 100structured-data-for-ai-search
    Dodaje, naprawia i waliduje dane strukturalne JSON-LD, by wyszukiwarki i asystenci AI czytali stronę poprawnie, zgodnie z treścią.
  • 100clickd-schema-markup
    Generuje, podłącza i sprawdza dane strukturalne JSON-LD z widocznych faktów na stronach, takie jak Organization, Product, Article czy FAQPage.
  • 100schema-markup
    Dodaje, naprawia i weryfikuje dane strukturalne schema.org (JSON-LD) na stronie i uczciwie mówi, jakie rich results Google znaczniki jeszcze mogą dać.
  • 100schema
    Pomaga w pytaniach o dane strukturalne i znaczniki schema.org, np. JSON-LD, FAQ, Product i rich results w Google.
  • 100seo-schema
    Wykrywa istniejące dane JSON-LD na stronie, waliduje je względem wymagań wyników rozszerzonych Google i generuje brakujące schema (Article, Product, LocalBusiness, FAQPage, BreadcrumbList) w blokach gotowych do wklejenia.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.