hub-spoke-seo-parser

name: hub-spoke-seo-parser description: > Deterministyczny parser treści i architekt SEO. Przekształca surowy tekst prawny dostarczony przez użytkownika w strukturę plików HTML Hub & Spoke (index.html + spoke-N.html), zachowując 100% oryginalnej treści. Tekst został przygotowany przez prawników i NIE może być modyfikowany ani parafrazowany. Triggeruje na: "artykuł", "blog", "Hub & Spoke", "SEO", "artykuł filarowy", "przekształć tekst", "wygeneruj HTML z tekstu". argument-hint: "Wklej surowy tekst prawny/edukacyjny do przekształcenia"

Hub & Spoke SEO Parser

Przekształca surowy tekst prawny na gotowe pliki HTML wg modelu Hub & Spoke, zoptymalizowane pod SEO, przy jednoczesnym zachowaniu nienaruszonej treści autorskiej (prawniczej).

Kiedy używać

Użytkownik dostarcza tekst opracowany przez prawników i chce go opublikować.
Treść musi pozostać w pierwotnej postaci (brak zmian w słownictwie, strukturze zdań czy argumentacji).
Trzeba podzielić materiał na artykuł filarowy + artykuły wspierające (spoke).
Potrzebna jest architektura SEO (nagłówki Long-Tail, meta tagi).

REGUŁA KRYTYCZNA — NIENARUSZALNOŚĆ TREŚCI PRAWNEJ

Tekst wejściowy jest dokumentem prawnym. Bezwzględny zakaz:

Parafrazowania lub "upraszczania" języka.
Usuwania fragmentów, które wydają się "niepotrzebne".
Dodawania własnych wniosków, interpretacji lub "rad od AI".
Zmieniania kolejności informacji w obrębie danego akapitu/sekcji.

Dozwolone operacje (Optymalizacja SEO):

Rozpoznanie logicznej struktury tekstu (co jest bazą, co przykładem).
Wygenerowanie atrakcyjnych dla Google nagłówków SEO (H1, H2, <title>) na podstawie treści (bez jej zmieniania).
Opakowanie oryginalnego tekstu w tagi HTML (<p>, <ul>, <li>).
Dodanie linkowania wewnętrznego między HUBem a SPOKE'ami.

PIPELINE EGZEKUCJI

FAZA 1 — Analiza wzorca

Przeanalizuj dostarczony tekst i podziel go na dwie pule:

[BAZA TEORETYCZNA]: wstęp, definicje, zasady ogólne, podsumowanie — wszystko, co nie jest konkretnym przypadkiem.
[PRZYPADKI PRAKTYCZNE]: wyliczone przykłady z życia, "typowe sprawy", Q&A, casusy, scenariusze krok-po-kroku.

FAZA 2 — Artykuł Filarowy (`index.html`)

Weź całą [BAZĘ TEORETYCZNĄ].
Wygeneruj <h1> odzwierciedlający główny temat materiału (fraza główna SEO).
Wygeneruj <title> w formacie: {H1} | Kancelaria Notarialna Katarzyna Gołębiowska.
Wygeneruj unikalny <meta name="description"> (maks. 160 znaków) streszczający temat prawny w sposób zachęcający do kliknięcia.
Sformatuj treść wewnątrz <article class="blog-prose">:
- pierwszy akapit: <p class="blog-prose__lead">
- każdy podrozdział: <div class="blog-prose__section"><h2>…</h2><p>…</p></div>
- <strong> dla kluczowych terminów prawnych/branżowych

Na końcu artykułu dodaj sekcję z linkami do spoke'ów:

<div class="blog-prose__related">
  <h2>Rozwiązania z praktyki</h2>
  <div class="blog-spoke-grid">
    <a href="./spoke-1-nazwa.html" class="blog-spoke-link">{H1 artykułu wspierającego 1}</a>
    <!-- ... pozostałe <a class="blog-spoke-link"> ... -->
  </div>
</div>

Użyj struktury z ./assets/base-template.html, podmieniając:
- <title>, <meta name="description">, <link rel="canonical"> (na docelowy URL)
- Breadcrumbs w HTML i JSON-LD (3 poziomy)
- Wszystkie tagi Open Graph (og:title, og:description, og:url)
- Treść artykułu wewnątrz <article class="blog-prose">
Zapisz jako index.html w nowym katalogu źródłowym o nazwie opartej na temacie (np. site-src/blog/darowizna-testament-dozywocie/).

Jeśli artykuł dotyczy testamentu, dodaj bezpośrednio przed sekcją .blog-disclaimer akapit pobierania pliku PDF z wykazem dokumentów:

<p class="blog-download-box">
  Planujesz sporządzenie testamentu u notariusza? Przed wizytą w kancelarii warto przygotować niezbędne dane i dokumenty. Peła lista jest dostępna do pobrania w formacie PDF: 
  <a href="../../assets/pdf/testament-testament.pdf" download class="blog-download-link"><strong>pobierz wykaz dokumentów do testamentu (PDF)</strong></a>.
</p>

FAZA 3 — Artykuły Wspierające (`spoke-[id]-[nazwa].html`)

Dla każdego elementu z puli [PRZYPADKI PRAKTYCZNE]:

Wygeneruj nagłówek Long-Tail H1 — precyzyjne, życiowe zapytanie użytkownika w wyszukiwarce. (Np. "Czy można odwołać darowiznę domu?").
Wygeneruj unikalny <meta name="description"> dla każdego przypadku.
Wklej DOKŁADNIE ORYGINALNĄ treść przypadku — bez żadnych przeróbek — opakuj akapity w <p> wewnątrz <article class="blog-prose">.

Na dole pliku dodaj link powrotny:

<p class="back-link">
  <a href="./index.html">← Wróć do artykułu: {H1 z index.html}</a>
</p>

Wygeneruj przyjazną URL nazwę pliku z H1 (lowercase, bez polskich znaków, myślniki zamiast spacji, np. spoke-[id]-dom-opieka-zachowek.html). Zapisz go w tym samym katalogu co hub, np. site-src/blog/darowizna-testament-dozywocie/spoke-1-dom-opieka-zachowek.html.

Użyj struktury z Fazy 2 (szablonu base-template), z dwiema różnicami dla spoke'a:

wrapper treści ma używać klasy: <div class="blog-article__wrap"> (bez klasy wrap)

breadcrumb 4-poziomowy w HTML:

<a href="../../index.html">Strona główna</a><span>/</span
><a href="../../blog.html">Blog</a><span>/</span
><a href="./index.html">{H1 z index.html}</a><span>/</span
><span>{H1 spoke'a}</span>

Jeśli dany przypadek dotyczy testamentu, dodaj bezpośrednio przed sekcją .blog-disclaimer akapit pobierania pliku PDF z wykazem dokumentów, identycznie jak w Fazie 2 (krok 9).
JSON-LD Schema (BreadcrumbList) na 4 poziomy:
- Poziom 1: Strona główna (https://kieleckinotariusz.pl/)
- Poziom 2: Blog (https://kieleckinotariusz.pl/blog.html)
- Poziom 3: Hub (https://kieleckinotariusz.pl/blog/{kategoria}/)
- Poziom 4: Spoke (https://kieleckinotariusz.pl/blog/{kategoria}/spoke-[id]-[nazwa].html)

FAZA 4 — Wynik wyjściowy

Zwróć bloki kodu HTML w następującej kolejności:

### index.html
{kod}

### spoke-1-nazwa.html
{kod}

### spoke-2-nazwa.html
{kod}
...

Zachowaj 100% zgodności znakowej z oryginalnymi akapitami tekstowymi.

Aktualizacja site-src/pages/blog.html

Po wygenerowaniu plików zaproponuj użytkownikowi dodanie karty artykułu do site-src/pages/blog.html. Wzorzec karty (SEO-friendly):

<article
  class="blog-card"
  onclick="window.location = '{{relativeRoot}}blog/{folder}/index.html'"
>
  <div class="blog-card__body">
    <p class="blog-card__label">{Kategoria prawna}</p>
    <h2 class="blog-card__title">
      <a
        href="{{relativeRoot}}blog/{folder}/index.html"
        onclick="event.stopPropagation()"
        >{H1 z index.html}</a
      >
    </h2>
    <p class="blog-card__desc">{Pierwsze zdanie wstępu z index.html — absolutnie bez zmian}</p>
    <p class="blog-card__sub-label">Najczęstsze przypadki i pytania</p>
    <div class="blog-card__spokes">
      <!-- Dla każdego artykułu wspierającego (spoke): -->
      <a
        onclick="event.stopPropagation()"
        href="{{relativeRoot}}blog/{folder}/spoke-[id]-[nazwa].html"
        >{H1 spoke'a}</a
      >
    </div>
  </div>
  <a
    href="{{relativeRoot}}blog/{folder}/index.html"
    class="blog-card__arrow"
    onclick="event.stopPropagation()"
    aria-label="Czytaj artykuł"
    >→</a
  >
</article>

Upewnij się, że nowa karta jest umieszczana wewnątrz <div class="blog-cards"> w pliku site-src/pages/blog.html. Po dodaniu nowej karty, użytkownik powinien uruchomić npm run build w celu skompilowania zmian.

Zasoby

Szablon HTML: ./assets/base-template.html
Paleta kolorów serwisu: #4D2C26 (brąz), #EAE3D9 (pergamin), #A0614F (terakota), #2D2926 (antracyt)