Dane strukturalne (structured data) to sposób na opisanie treści strony internetowej w formacie
zrozumiałym dla wyszukiwarek. Schema.org to najczęściej używany słownik do tworzenia danych
strukturalnych, wspierany przez Google, Microsoft, Yahoo i Yandex.

## Czym są dane strukturalne?

Dane strukturalne to dodatkowe informacje umieszczone w kodzie HTML strony, które pomagają
wyszukiwarkom zrozumieć kontekst treści. Dzięki nim wyszukiwarki mogą wyświetlać **rozszerzone
wyniki** (rich results), takie jak:

- Gwiazdki ocen produktów
- Czas przygotowania przepisów
- Daty i lokalizacje wydarzeń
- Panele wiedzy o organizacjach

### Dane strukturalne a Semantic Web (Sieć Semantyczna)

Wdrożenie danych strukturalnych to praktyczny krok w stronę realizacji wizji [Semantic
Web](https://pl.wikipedia.org/wiki/Sie%C4%87_semantyczna). Jest to koncepcja „inteligentnego
internetu” stworzona przez Tima Bernersa-Lee, w której maszyny nie tylko wyświetlają tekst, ale
realnie rozumieją jego znaczenie i powiązania.

Stosując ustandaryzowany słownik [Schema.org](https://schema.org/), zmieniasz swoją stronę z
prostego dokumentu w element globalnej sieci danych:

* **Od słów do encji:** Wyszukiwarka przestaje widzieć tylko ciąg liter (np. „Jaguar”), a zaczyna
  rozpoznawać konkretny obiekt (samochód, zwierzę lub system).
* **Łączenie faktów:** Dane o autorze, dacie publikacji i temacie wpisu tworzą logiczne powiązania,
  które zasilają bazy wiedzy, takie jak Google Knowledge Graph.
* **Fundament dla AI:** Ustrukturyzowane informacje są kluczowe dla asystentów głosowych i modeli
  AI, które potrzebują precyzyjnych danych do generowania trafnych odpowiedzi.

## Format JSON-LD

Google rekomenduje format **JSON-LD** (JavaScript Object Notation for Linked Data) jako preferowany sposób wdrożenia danych strukturalnych:

```json
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "WikiZEIT",
  "url": "https://wikizeit.edu.pl/",
  "logo": "https://wikizeit.edu.pl/img/logo.svg",
  "description": "Projekt edukacyjny o Wikipedii i etycznym SEO"
}
```

JSON-LD jest wygodny, ponieważ:

1. Umieszczany jest w tagu `<script>`, oddzielnie od treści HTML
2. Łatwo go generować programowo
3. Nie wymaga modyfikacji istniejącej struktury HTML

## Typy Schema.org przydatne w SEO

Najczęściej używane typy w kontekście SEO to:

| Typ | Zastosowanie |
|-----|-------------|
| `Organization` | Firmy i organizacje |
| `Person` | Osoby publiczne, autorzy |
| `Article` / `BlogPosting` | Artykuły i wpisy blogowe |
| `WebPage` | Strony internetowe |
| `BreadcrumbList` | Nawigacja breadcrumb |
| `FAQPage` | Strony z często zadawanymi pytaniami |
| `HowTo` | Instrukcje i poradniki krok po kroku |
| `Course` | Kursy online, szkolenia i lekcje |
| `Review` | Recenzje produktów, książek lub filmów |
| `LocalBusiness` | Firmy działające stacjonarnie (adres, mapa) |
| `SoftwareApplication` | Aplikacje, narzędzia online i biblioteki |
| `Dataset` | Zbiory danych (ważne dla projektów naukowych) |
| `VideoObject` | Treści wideo osadzone na stronie |

Warto przejrzeć [oficjalną dokumentację na stronie
schema.org](https://schema.org/docs/documents.html).  Pomocna jest także wyszukiwarka.

Pamiętaj jednak, że nie każdy znacznik JSON-LD przekłada się na natychmiastowy efekt w wynikach
wyszukiwania ([SERP](https://pl.wikipedia.org/wiki/SERP)) w postaci gwiazdek czy dodatkowych
linków. Mimo to, zdecydowanie warto je dodawać. Dlaczego?

Ponieważ dane strukturalne budują tzw. graf wiedzy o Twojej stronie – pomagają Google powiązać
autora z tematem, a markę z produktem. Nawet jeśli dany element nie wyświetla się dziś jako "bajer"
w wyszukiwarce, ułatwia on algorytmom precyzyjne dopasowanie Twojej treści do konkretnych zapytań
użytkowników.

## Właściwość sameAs: Połącz się z bazami wiedzy

Właściwość `sameAs` w Schema.org pozwala wskazać, że Twoja marka/osoba jest tą samą encją, która
widnieje w innym miejscu. To klucz do budowania autorytetu.

W JSON-LD wygląda to tak:
```json
"sameAs": [
  "https://wikidata.org",
  "https://wikipedia.org",
  "https://www.linkedin.com"
  "https://x.com"
]
```

## Wikipedia jako definicja typu

Jeśli Schema.org nie posiada specyficznego typu dla Twojej działalności, możesz użyć
`additionalType` i podać link do odpowiedniego pojęcia w Wikipedii. To najwyższy poziom precyzji w
Sieci Semantycznej.

### Precyzyjny kontekst: About i Mentions

Zamiast liczyć na to, że Google samo zrozumie temat, możesz mu to wskazać. W typie `Article` użyj:
* **`about`**: Główny temat artykułu.
* **`mentions`**: Inne ważne pojęcia wspomniane w tekście.

Linkując w tych polach do konkretnych rekordów w Wikidanych, budujesz semantyczną mapę treści, która
jest niezależna od użytych słów kluczowych.

## Testowanie danych strukturalnych

Warto sprawdzić swoje dane przed wdrożeniem na produkcję.

Pierwszą rzeczą jest sprawdzenie, czy mamy poprawny format JSON. Można do tego użyć narzędzia [JSON
Lint](https://duckduckgo.com/?q=json+lint) (kopujemy całego JSONa i sprawdzamy czy nie ma błędów
składni). Gdy mamy poprawny JSON, powinniśmy sprawdzić poprawność Schema.org, poprzez narzędzie
[Walidatora Schema](https://validator.schema.org/).

Gdy mamy pewność, że wstępnie wszystko wygląda ok (poprawność na poziomie składni), możemy sprawdzić
poprawność semantyczną (poprawność danych strukturalnych). Google udostępnia narzędzie do testowania
tych danych: [Rich Results Test](https://search.google.com/test/rich-results).

## Potwierdzenie widoczne dla bota i ludzi

Dopełnieniem danych strukturalnych jest umieszczenie linku do elementu w Wikidanych w stopce
strony. To spójny sygnał „Entity-First SEO”, który ułatwia algorytmom potwierdzenie wiarygodności
Twojej witryny.

## Podsumowanie

Dane strukturalne to jeden z najważniejszych elementów technicznego SEO. Projekt WikiZEIT
wykorzystuje JSON-LD Schema.org na każdej stronie, aby zapewnić maksymalną widoczność w wynikach
wyszukiwania.

---
Źródła użyte w artykule:
* [Oficjalna strona projektu Schema.org](https://schema.org/)
* [Wprowadzenie do znaczników uporządkowanych danych w wyszukiwarce Google](https://developers.google.com/search/docs/appearance/structured-data/intro-structured-data)
* [Uporządkowane dane dotyczące artykułu (Article, NewsArticle, BlogPosting)](https://developers.google.com/search/docs/appearance/structured-data/article)
* [How To: Use additionalType and sameAs to link to Wikipedia](https://support.schemaapp.com/support/solutions/articles/33000277321-how-to-use-additionaltype-and-sameas-to-link-to-wikipedia)
