Przejdź do treści

SEO w Astro: techniczny poradnik z przygotowaniem pod GEO i AEO

Maciej Sala

Founder StriveLab

15 min czytaniaAktualizacja

Szybka odpowiedź: jak zadbać o SEO strony w Astro?

  • Astro daje mocny start, ponieważ ogranicza JavaScript i renderuje treść jako HTML.
  • Najważniejsze obszary to Core Web Vitals, metadane każdej strony, sitemapa z @astrojs/sitemap, robots.txt i dane Schema.org.
  • Google nie wymaga specjalnego schematu ani plików pod wyszukiwarki AI.
  • Struktura i linkowanie w klastrach pomagają, ale nie gwarantują cytowania przez AI.
  • Efekty oceniaj w Search Console i danych rzeczywistych użytkowników.

Co Astro daje pod SEO już na starcie?

Oto, co Astro dostarcza już w standardzie:

  • Statyczny HTML. Google i inne roboty indeksujące dostają gotowy kod, więc nie ma zależności od JavaScriptu.

  • Zero JS domyślnie. Mniej kodu do pobrania i wykonania pomaga ograniczać obciążenie przeglądarki; wynik LCP i INP nadal trzeba zmierzyć.

  • Natywna optymalizacja obrazów przez astro:assets. WebP/AVIF, responsywny srcset po odpowiedniej konfiguracji i .

  • Routing oparty na plikach i czyste URL-e. /blog/moj-wpis/ zamiast ?page=123.

  • Content Collections z walidacją. Spójne metadane na poziomie systemu (szerzej w osobnym wpisie).

To dobra baza wydajnościowa, ale wynik Lighthouse zależy także od obrazów, fontów, skryptów i hostingu. Sam wybór Astro nie gwarantuje określonej liczby punktów.

Core Web Vitals w Astro: co trzeba mierzyć?

Core Web Vitals obejmują trzy metryki używane przez systemy rankingowe Google. Dobre wyniki nie gwarantują wysokiej pozycji:

  1. (Largest Contentful Paint), czyli czas do wyrenderowania największego elementu widocznego w początkowym oknie przeglądarki (viewport). Dobry wynik to ≤ 2,5 s.
  2. (Interaction to Next Paint), czyli czas reakcji strony na interakcję użytkownika; dobra strona to ≤ 200 ms (metryka zastąpiła FID w marcu 2024).
  3. (Cumulative Layout Shift), czyli miara nieoczekiwanych przesunięć układu, oparta na najgorszym oknie takich przesunięć; dla dobrej strony to ≤ 0,1.

Progi wydajnościowe są oceniane na podstawie 75. percentylu danych rzeczywistych użytkowników, osobno dla urządzeń mobilnych i komputerów. Dane CrUX w narzędziu PageSpeed Insights obejmują 28-dniowe okno pomiarowe – należy każdorazowo weryfikować, czy dotyczą konkretnego adresu URL, czy całej domeny (originu). Brak dostatecznej ilości danych terenowych nie oznacza automatycznego zaliczenia Core Web Vitals. Wyniki laboratoryjne Lighthouse służą celom diagnostycznym i nie zastępują pomiarów rzeczywistych, ponieważ standardowy test ładowania nie uwzględnia m.in. terenowego wskaźnika INP.

Ograniczenie JavaScriptu w Astro pomaga, ale CSS, fonty i czas odpowiedzi serwera nadal mogą opóźniać renderowanie. CLS wymaga uwagi niezależnie od frameworka.

Optymalizacja LCP w Astro

Najczęściej elementem LCP jest główny obraz (hero) na stronie głównej lub banner w nagłówku artykułu. Priorytety:

  1. Priorytet ładowania kluczowego obrazu.
Code
<Image
  src={heroImage}
  alt="Hero"
  width={1200}
  height={630}
  loading="eager"
  fetchpriority="high"
/>

Atrybut loading="eager" wyłącza leniwe ładowanie, natomiast fetchpriority="high" sugeruje wyższy priorytet pobierania w kolejce przeglądarki. Nie stanowi to jednak gwarancji bezwzględnego pierwszeństwa w sieci ani nie zastępuje instrukcji preload.

Zastosowanie dedykowanego znacznika <link rel="preload" as="image"> jest uzasadnione w przypadkach, gdy przeglądarka odkrywa dany obraz zbyt późno w kodzie strony. Wskazany zasób musi wówczas precyzyjnie odpowiadać właściwemu wariantowi responsywnemu, aby zapobiec zjawisku podwójnego pobierania plików.

  1. Wstępne połączenie (preconnect) z siecią obrazów.
Code
<link rel="preconnect" href="https://cdn.yoursite.com" />
  1. Optymalny format. <Image> domyślnie przetwarza obsługiwane obrazy rastrowe do WebP; <Picture> umożliwia warianty AVIF i WebP z formatem zapasowym. Responsywny srcset wymaga np. ustawienia layout="constrained" albo konfiguracji widths i sizes. Porównuj wagę przy akceptowalnej jakości, zamiast zakładać, że konkretny format zawsze będzie najmniejszy.

  2. Hosting blisko użytkownika. CDN i skuteczny cache mogą skrócić dostarczenie HTML oraz obrazów. Porównuj TTFB i LCP z regionów użytkowników; sama lokalizacja VPS w Niemczech nie przesądza o gorszym wyniku dla polskich odbiorców.

Optymalizacja CLS w Astro

Głównym źródłem CLS są obrazy bez zdefiniowanych wymiarów i późno ładujące się fonty.

Obrazy — zapewnij wymiary lub proporcje rezerwujące miejsce. Dla lokalnych importów <Image> potrafi ustalić wymiary automatycznie; można też podać je jawnie:

Code
<Image src={img} alt="..." width={800} height={450} />

Przeglądarka rezerwuje przestrzeń jeszcze przed pobraniem obrazu i układ nie skacze.

Fonty — wdrażaj Fonts ustabilizowane w Astro 6 (klucz fonts na najwyższym poziomie konfiguracji):

Code
import { defineConfig, fontProviders } from 'astro/config'
 
export default defineConfig({
  fonts: [
    {
      provider: fontProviders.google(),
      name: 'Inter',
      cssVariable: '--font-inter',
      // Astro generuje optymalne fallbacki z podobnymi metrykami
    },
  ],
})

Następnie dodaj font do layoutu i zastosuj zmienną CSS:

Code
---
import { Font } from 'astro:assets';
---
<html lang="pl">
  <head>
    <Font cssVariable="--font-inter" />
  </head>
  <body><slot /></body>
</html>
<style is:global>
  body { font-family: var(--font-inter); }
</style>

Astro próbuje wygenerować fallback o zbliżonych metrykach, co ogranicza przesunięcia tekstu podczas ładowania fontu. Efekt nadal warto sprawdzić w pomiarze CLS.

Server Islands. Dodawaj slot zastępczy (fallback slot) z tą samą wysokością co finalna zawartość. Szerzej o tym w artykule o Server Islands.

Optymalizacja INP w Astro

INP to metryka sprawdzająca, jak szybko strona reaguje na akcje użytkownika — kliknięcia, dotknięcia ekranu czy pisanie na klawiaturze. Mniejsza ilość JavaScriptu ułatwia ograniczenie opóźnień, ale o wyniku decyduje także koszt obsługi interakcji i renderowania. Na co trzeba uważać?

  • Nadmierne stosowanie dyrektywy client:load – ładowanie i hydratacja wszystkich komponentów od razu niepotrzebnie obciążają zasoby przeglądarki. W miarę możliwości zaleca się zastępowanie jej dyrektywą client:visible, która opóźnia wykonanie skryptów do momentu, w którym dany element znajdzie się w obszarze widocznym okna przeglądarki.

  • Niekontrolowane skrypty zewnętrzne – narzędzia analityczne, widgety czatu czy osadzone komponenty społecznościowe mogą znacząco obniżać wydajność interfejsu. Zasoby niekrytyczne należy ładować z atrybutem async lub defer, aby zapobiec blokowaniu parsowania dokumentu (gdzie defer zachowuje kolejność wykonywania, a async uruchamia skrypt natychmiast po pobraniu). Należy pamiętać, że atrybuty te eliminują blokowanie sieciowe, lecz nie redukują kosztu wykonania kodu JavaScript na głównym wątku.

  • Długie zadania blokujące wątek główny (long tasks) – ciężkie operacje synchroniczne w obsługach zdarzeń negatywnie wpływają na responsywność interfejsu niezależnie od wybranej biblioteki UI. W takich przypadkach należy dzielić pracę na mniejsze etapy lub przenosić obliczenia do obiektów Web Worker. Warto również uwzględnić, że mechanizmy współbieżnego renderowania w bibliotece React nie przenoszą automatycznie dowolnych obliczeń z obsługi zdarzeń poza główny wątek.

Metadane w Astro i <head> jako element technicznego SEO

Każda strona powinna mieć własne metadane. Przykład zakłada ustawienie produkcyjnego site w astro.config.mjs oraz image jako ścieżki lub URL w postaci tekstu:

Code
---
// src/layouts/Layout.astro
const { title, description, image, canonical } = Astro.props;
const canonicalURL = new URL(canonical ?? Astro.url.pathname, Astro.site);
---
 
<head>
  <meta charset="UTF-8" />
  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
 
  <title>{title} | NazwaFirmy</title>
  <meta name="description" content={description} />
  <link rel="canonical" href={canonicalURL} />
 
  <!-- Open Graph -->
  <meta property="og:type" content="website" />
  <meta property="og:url" content={canonicalURL} />
  <meta property="og:title" content={title} />
  <meta property="og:description" content={description} />
  {image && <meta property="og:image" content={new URL(image, Astro.site)} />}
 
  <!-- Twitter Card -->
  <meta name="twitter:card" content="summary_large_image" />
  <meta name="twitter:title" content={title} />
  <meta name="twitter:description" content={description} />
  {image && <meta name="twitter:image" content={new URL(image, Astro.site)} />}
 
  <!-- Favicons i inne -->
  <link rel="icon" type="image/svg+xml" href="/favicon.svg" />
  <meta name="generator" content={Astro.generator} />
</head>

Kluczowy element to , ponieważ bez niego ryzykujesz duplikację treści, np. /blog/wpis/ vs /blog/wpis?ref=twitter traktowane jako osobne strony. Canonical wskazuje preferowany adres jako silny sygnał; Google może wybrać inny URL kanoniczny. Usuwanie parametrów w przykładzie pasuje do parametrów śledzących, ale wymaga osobnej decyzji dla parametrów zmieniających treść, np. paginacji.

W przypadku Content Collections metadane naturalnie wiążą się ze schematem Zod, jeśli w schemacie wymagamy pól title i description. Astro nie narzuca tych pól automatycznie.

Dane uporządkowane (structured data) Schema.org w Astro

Dane uporządkowane pomagają Google zrozumieć treść i generować wyniki rozszerzone, takie jak gwiazdki, przepisy, wydarzenia czy elementy produktowe. W 2026 roku są też sensownym fundamentem pod GEO/AEO, ponieważ organizują informacje w formacie łatwym do maszynowej interpretacji.

Article / BlogPosting

Przykład zakłada date i opcjonalne updated jako obiekty Date zwalidowane przez z.coerce.date(), a image jako tekstową ścieżkę lub URL. Przy obrazie z lokalnego importu użyj jego pola .src. Ustaw też site w konfiguracji i zastąp przykładowe dane autora oraz wydawcy.

Code
---
const { post } = Astro.props;
 
const jsonLd = {
  '@context': 'https://schema.org',
  '@type': 'BlogPosting',
  headline: post.data.title,
  description: post.data.description,
  datePublished: post.data.date.toISOString(),
  dateModified: (post.data.updated ?? post.data.date).toISOString(),
  author: {
    '@type': 'Person',
    name: 'Jan Kowalski',
    url: 'https://example.com/o-mnie/',
  },
  publisher: {
    '@type': 'Organization',
    name: 'StriveLab',
    logo: {
      '@type': 'ImageObject',
      url: 'https://example.com/logo.png',
    },
  },
  image: post.data.image ? new URL(post.data.image, Astro.site).href : undefined,
  mainEntityOfPage: {
    '@type': 'WebPage',
    '@id': new URL(Astro.url.pathname, Astro.site).toString(),
  },
};
---
 
<script type="application/ld+json" set:html={JSON.stringify(jsonLd).replace(/</g, '\\u003c')} />

FAQ

W sytuacji, kiedy strona zawiera sekcję FAQ, możesz opisać ją przez FAQPage. Google zakończył wyświetlanie wyników rozszerzonych FAQ 7 maja 2026 r. Typ nadal istnieje w Schema.org, ale jego wdrożenie nie gwarantuje korzyści w odpowiedziach AI. Poniższe dane muszą odpowiadać pytaniom i odpowiedziom widocznym na stronie; najlepiej generować obie warstwy z tego samego źródła.

Code
---
const faqs = [
  { question: 'Czy Astro jest lepsze od Next.js?', answer: 'To zależy od projektu...' },
  { question: 'Czy mogę używać Reacta w Astro?', answer: 'Tak, Astro obsługuje różne biblioteki UI...' },
];
 
const faqJsonLd = {
  '@context': 'https://schema.org',
  '@type': 'FAQPage',
  mainEntity: faqs.map((faq) => ({
    '@type': 'Question',
    name: faq.question,
    acceptedAnswer: {
      '@type': 'Answer',
      text: faq.answer,
    },
  })),
};
---
 
<script type="application/ld+json" set:html={JSON.stringify(faqJsonLd).replace(/</g, '\\u003c')} />

Organization schema na stronie firmowej

sameAs powinno wskazywać profile tej samej organizacji. Profil osobisty autora należy do encji Person.

Code
{
  '@context': 'https://schema.org',
  '@type': 'Organization',
  name: 'NazwaFirmy',
  url: 'https://example.com',
  logo: 'https://example.com/logo.png',
  sameAs: [
    'https://www.linkedin.com/company/nazwafirmy/',
    'https://github.com/nazwa',
  ],
  contactPoint: {
    '@type': 'ContactPoint',
    email: 'contact@example.com',
    contactType: 'customer service',
  },
}

Sitemap i robots.txt w Astro

Astro udostępnia oficjalną integrację @astrojs/sitemap, która podczas budowania projektu generuje pliki /sitemap-index.xml i /sitemap-0.xml.

Code
npx astro add sitemap

Konfiguracja:

Code
// astro.config.mjs
import { defineConfig } from 'astro/config'
import sitemap from '@astrojs/sitemap'
 
export default defineConfig({
  site: 'https://example.com',
  integrations: [
    sitemap({
      filter: (page) => !page.includes('/private/'),
      i18n: {
        defaultLocale: 'pl',
        locales: {
          pl: 'pl-PL',
          en: 'en-US',
        },
      },
    }),
  ],
})

Wyszukiwarka Google całkowicie ignoruje parametry changefreq oraz priority. W przypadku wdrażania znacznika lastmod należy przypisywać – za pomocą funkcji serialize – rzeczywistą datę istotnej aktualizacji konkretnej podstrony, zamiast masowo podstawiać datę każdorazowego buildu dla całego serwisu. Z kolei konfigurację międzynarodową (i18n) należy ściśle dopasować do faktycznych ścieżek wersji językowych, ponieważ samo jej dodanie w kodzie nie generuje automatycznie brakujących tłumaczeń ani nowych tras.

robots.txt tworzysz ręcznie w public/robots.txt:

Code
User-agent: *
Allow: /

Sitemap: https://example.com/sitemap-index.xml

Rozdziel dostęp do wyszukiwania od wykorzystania treści do treningu. Przykładowo możesz zezwolić na ChatGPT Search, a zablokować crawler treningowy OpenAI (dopisz te grupy do istniejącego pliku):

Code
User-agent: OAI-SearchBot
Allow: /

User-agent: GPTBot
Disallow: /

Powyższe ustawienia są całkowicie niezależne. W przypadku innych dostawców należy każdorazowo weryfikować specyfikację konkretnego robota w oficjalnej dokumentacji, ponieważ nie wszystkie boty AI odpowiadają za proces wyszukiwania. Przykładowo, dostęp systemów Google do funkcji takich jak AI Overviews czy AI Mode jest kontrolowany bezpośrednio przez bota Googlebot, a nie Google-Extended. Poza konfiguracją pliku robots.txt warto upewnić się, że zapora WAF lub sieć CDN nie blokują dostępu autoryzowanym crawlerom.

Należy pamiętać, że plik robots.txt służy wyłącznie do ograniczania indeksowania i pobierania zawartości – nie stanowi on ani skutecznego mechanizmu ochrony prywatnych danych, ani pewnej metody usuwania adresów URL z indeksu wyszukiwarki. W przypadku publicznych stron wyłączanych z indeksowania należy stosować nagłówek lub znacznik noindex, zapewniając robotom możliwość jego odczytu, natomiast wszelkie treści o charakterze poufnym bezwzględnie zabezpieczać mechanizmami uwierzytelniania.

GEO i AEO w Astro, czyli widoczność w odpowiedziach AI

i to nowe warstwy SEO, kierowane pod Perplexity, ChatGPT Search, Claude oraz funkcje AI Google. Podstawy są podobne do klasycznego SEO, ale kilka akcentów przesuwa się gdzie indziej.

Czytelna struktura. Jasne nagłówki (H2, H3), definicje i zestawienia ułatwiają czytelnikom oraz systemom wyszukiwania interpretację treści. To dobra praktyka redakcyjna, a nie potwierdzony uniwersalny czynnik cytowania przez AI.

Zaczynaj sekcję od konkretnej odpowiedzi, jeśli pasuje to do tematu. Pisz tak, żeby pierwsze zdanie odpowiadało na pytanie zawarte w nagłówku, a reszta paragrafu to jego rozwinięcie.

Dane uporządkowane (Article, FAQ, HowTo tam, gdzie realnie pasuje do treści) porządkują znaczenie strony. Pomagają robotom i systemom wyszukiwania zrozumieć relacje między pytaniami, odpowiedziami, autorem i datami.

Czysty HTML bez zbędnego kodu wykonywanego w przeglądarce. Astro zyskuje tu przewagę: mniej skryptów startowych, mniej hydratacji i prostszy, semantyczny kod źródłowy. Roboty indeksujące AI otrzymują dokument bliższy klasycznej stronie HTML niż rozbudowanej aplikacji renderowanej po stronie klienta.

Rzetelne daty w dateModified. Aktualizuj datę po rzeczywistej, istotnej zmianie treści i zachowaj spójność z datą widoczną na stronie, ponieważ samo przestawienie daty nic nie da, a wygląda na próbę oszukiwania algorytmu.

Google nie wymaga specjalnego schematu danych ani plików AI, aby strona mogła pojawić się w AI Overviews lub AI Mode. Musi być zaindeksowana i kwalifikować się do wyświetlenia ze snippetem. Pozostałe zalecenia traktuj jako poprawę jakości i dostępności treści, a nie gwarancję cytowań. Strategię GEO niezależną od frameworka opisuję w przewodniku po GEO i optymalizacji treści pod AI.

Linkowanie wewnętrzne na stronie Astro

Astro nie narzuca domyślnej strategii linkowania wewnętrznego, ale budowa klastrów tematycznych, czyli grup powiązanych artykułów linkujących do siebie nawzajem, pomaga użytkownikom odkrywać powiązane treści i robotom odnajdywać strony.

Praktycznym przykładem są wszystkie moje artykuły o Astro, które odsyłają do siebie nawzajem — architektura wysp, dyrektywy klienckie, Content Collections, Server Islands i Astro vs Next.js. Takie linki ułatwiają odkrywanie wpisów i rozumienie ich kontekstu; nie gwarantują wzrostu pozycji całej grupy.

W Content Collections możesz to zautomatyzować: wystarczy zdefiniować w schemacie Zod pole relatedPosts jako tablicę referencji, np. z.array(reference('blog')), a następnie w szablonie artykułu wyrenderować na tej podstawie automatyczną sekcję „Zobacz też”.

Audyt SEO w Astro: praktyczne narzędzia

Wdrożenie strony to dopiero początek, ponieważ widoczność utrzymujesz regularnym audytem. Zerknij na pięć narzędzi pomagających diagnozować widoczność i jakość techniczną:

  1. Google Search Console. Absolutna podstawa zdrowia dla stron internetowych i to od wielu lat. To tutaj wyłapiesz błędy indeksacji, sprawdzisz realne wyniki Core Web Vitals i zobaczysz, po jakich hasłach użytkownicy rzeczywiście wchodzą na stronę. Odwiedzaj przynajmniej raz na tydzień, szczególnie na początku projektu lub po wielu zmianach na stronie.
  2. PageSpeed Insights. Świetne do szybkiego diagnozowania wydajności i szukania technicznych wąskich gardeł na konkretnych podstronach.
  3. Lighthouse (wbudowany w Chrome DevTools). Idealny do lokalnego testowania zmian, sprawdzania dostępności i dobrych praktyk jeszcze przed wypuszczeniem kodu na produkcję.
  4. Screaming Frog. Niezastąpiony przy większych serwisach, ponieważ pozwala „przeskanować” całą witrynę, znaleźć uszkodzone linki, brakujące metadane oraz wyłapać zduplikowane treści.
  5. Ahrefs / Semrush. Jeśli traktujesz SEO znacznie bardziej poważnie, to tutaj prześledzisz widoczność swojej domeny, profil linków oraz wszelkie ruchy konkurencji.

A jeśli wolisz oddać te kwestie w ręce kogoś, kto zajmuje się tym na co dzień — zerknij na mój audyt techniczny SEO. Przeprowadzę kompleksową analizę Twojej aplikacji i przygotuję gotowy plan optymalizacji albo po prostu wdrożę go za Ciebie.

Diagnostyka SEO specyficzna dla Astro

Klasyczne narzędzia audytowe (GSC, Screaming Frog, Lighthouse) dobrze mierzą objawy, ale w przypadku Astro są cztery obszary, gdzie przyczyna leży głębiej — w konfiguracji frameworka i architekturze tras — i gdzie ogólny raport narzędzia nic nie podpowie.

Dyrektywy client:* a widoczność dla crawlerów AI

Astro domyślnie renderuje komponenty UI do HTML bez wysyłania ich JavaScriptu. Dyrektywy client:load, client:idle i client:visible dodają hydratację — nie usuwają HTML wygenerowanego na serwerze. Wyjątkiem jest client:only.

DyrektywaKiedy JS się ładujeTreść w surowym HTML?
client:loadprzy ładowaniu stronyTak, wynik renderowania serwerowego
client:idlepo załadowaniu, gdy przeglądarka jest bezczynnaTak, wynik renderowania serwerowego
client:visiblegdy komponent pojawia się w widocznym obszarze oknaTak, wynik renderowania serwerowego
client:onlyprzy ładowaniu, bez renderowania serwerowegoTylko ewentualny slot="fallback", nie wynik komponentu
brak dyrektywyJS komponentu nie jest wysyłanyTak, wynik renderowania serwerowego

Zasada diagnostyczna: krytyczna treść powinna powstać podczas renderowania na serwerze. Jeśli komponent pobiera ją dopiero w efekcie przeglądarkowym, np. useEffect, nie będzie jej w początkowym HTML niezależnie od czasu hydratacji. Przy Server Islands początkowa odpowiedź zawiera fallback, a właściwa treść jest pobierana później.

Jak to sprawdzić:

Code
# Odpowiedź serwera bez wykonywania JS, po przekierowaniach
curl -sSL https://twojadomena.pl/ | grep -i "twoja-kluczowa-fraza"

Brak dopasowania wymaga obejrzenia całej odpowiedzi i statusu HTTP: przyczyną może być renderowanie dopiero w przeglądarce, ale też błąd serwera, blokada dostępu albo tekst rozdzielony znacznikami. Dopiero po rozpoznaniu przyczyny przenieś pobieranie i renderowanie ważnej treści na serwer. curl nie odtwarza renderowania Google; sprawdź też HTML w inspekcji URL Search Console.

Tryb renderowania per trasa w Astro

Astro pozwala mieszać trasy statyczne i serwerowe w jednym projekcie. Najpierw sprawdź output oraz adapter w astro.config.*: samo dodanie adaptera nie zmienia domyślnego trybu wszystkich stron.

Code
# Diagnostyka kodu oraz sprawdzenie logów budowania
npx astro check && npx astro build

astro check nie jest raportem aktywnego trybu SSR. O zachowaniu trasy decydują konfiguracja i eksport prerender na poziomie modułu strony lub endpointu, poza getStaticPaths:

Code
---
// Przy output: 'static' trasy są domyślnie prerenderowane.
// Ta konkretna trasa ma powstawać na żądanie (wymaga adaptera):
export const prerender = false;
 
// Przy output: 'server' domyślny jest SSR.
// Aby prerenderować konkretną trasę, użyj zamiast powyższego:
// export const prerender = true;
---

Dla blogów oraz serwisów usługowych prerenderowanie (SSG) znacząco upraszcza architekturę hostingu oraz mechanizmy buforowania. Z kolei renderowanie po stronie serwera (SSR) również dostarcza robotom w pełni gotowy kod HTML bez konieczności wykonywania skryptów JavaScript, jednak jego rzeczywista wydajność zależy przede wszystkim od czasu pobierania danych oraz efektywności strategii cache, a nie wyłącznie od samego trybu działania aplikacji.

Code
# Po buildzie — przykładowa kontrola wygenerowanego HTML
find dist -name "*.html" | head -20

Ścieżka wyjściowa zależy od outDir, build.format i adaptera: plik może znajdować się np. w dist/client/ albo mieć nazwę moj-wpis.html. Brak dist/blog/moj-wpis/index.html sam w sobie nie dowodzi SSR. Porównaj log buildu, ustawienia trasy i odpowiedź wdrożonego adresu.

Sitemap a trasy serwerowe i endpointy API

@astrojs/sitemap zbiera strony i pomija endpointy oraz przekierowania. Nie trzeba rutynowo usuwać endpointów src/pages/api/*.ts filtrem. Warto jednak sprawdzić, czy mapa nie zawiera stron prywatnych, szkiców albo adresów dodanych ręcznie.

Weryfikacja po buildzie (ścieżkę dopasuj do katalogu wyjściowego adaptera):

Code
# Sprawdź wpisy w wygenerowanej mapie
cat dist/sitemap-0.xml

Niepożądane strony można odfiltrować:

Code
// Fragment opcji integracji w astro.config.mjs
sitemap({
  filter: (page) =>
    !page.includes('/private/') &&
    !page.includes('/draft/'),
})

Deklaracja prerender = false nie wyklucza automatycznie podstrony z generowanej sitemapy, jeśli trasa posiada statycznie zdefiniowany adres. Standardowe integracje automatyczne nie potrafią jednak samodzielnie wyliczyć adresów dla dynamicznych tras SSR, takich jak np. /oferta/[slug].

W sytuacji, kiedy podstrony oparte o SSR mają być prawidłowo indeksowane, należy jawnie przekazać listę konkretnych adresów URL (np. pobranych z CMS-a lub zewnętrznego źródła danych) za pomocą opcji customPages lub przygotować dedykowany endpoint generujący mapę witryny w sposób dynamiczny.

Code
sitemap({
  customPages: ['https://twojadomena.pl/oferta/audyt-seo/'],
})

Dodawaj tylko kanoniczne, opublikowane adresy przeznaczone do indeksowania. Filtr sitemapy nie blokuje dostępu do strony ani sam nie wyłącza jej z indeksu.

Content Collections i brakujące strony w indeksie

Niezgodność wpisu ze schematem Zod skutkuje błędem walidacji już podczas ładowania kolekcji, zamiast cichego generowania pustego kodu HTML. W sytuacji, kiedy proces budowania zakończył się sukcesem, ale konkretnego wpisu brakuje w serwisie, należy kolejno zweryfikować filtry publikacji, adresy URL zwracane przez funkcję getStaticPaths, poprawność pobierania zasobu oraz prawidłowe wywołanie metody render() i umieszczenie otrzymanego komponentu <Content/> w szablonie.

W przypadku dynamicznych tras renderowanych po stronie serwera (SSR) niezbędna jest dodatkowo analiza logów aplikacyjnych – faza buildu nie wykonuje wszystkich możliwych zapytań ani nie gwarantuje stałej dostępności zewnętrznych źródeł danych w czasie rzeczywistego działania aplikacji.

Code
# Walidacja przed wdrożeniem; zachowaj pełny komunikat błędu
npx astro check && npx astro build

Polecenie astro check służy m.in. do diagnozowania błędów TypeScript oraz inicjalizacji synchronizacji projektu, natomiast walidacja struktury danych odbywa się w momencie ładowania kolekcji.

Po zakończeniu buildu należy zweryfikować poprawność działania zarówno dla istniejącego, opublikowanego wpisu, jak i dla losowego, nieistniejącego adresu. Ten drugi przypadek musi bezwzględnie zwracać kod odpowiedzi HTTP 404, a nie stronę z komunikatem o błędzie serwowaną ze statusem 200 (czyli soft 404). W przypadku zmiany adresów dla przeniesionych materiałów konieczna jest konfiguracja trwałych przekierowań (HTTP 301 lub 308) prowadzących do nowych lokalizacji URL.

Lista kontrolna SEO w Astro przed publikacją

Przed publikacją każda strona przechodzi przez krótki zestaw techniczny, który oczywiście nie zastępuje pracy redakcyjnej, ale eliminuje błędy wpływające na widoczność.

  • title, description, link kanoniczny i Open Graph są ustawione na finalne wartości, bez tekstów zastępczych.

  • Jeśli strona jest wielojęzyczna, wskazuje poprawne odpowiedniki językowe.

  • Obraz LCP ma stałe wymiary, sensowny alt, właściwy format i priorytet ładowania.

  • Treść, która ma się pozycjonować, jest w odpowiedzi HTML; późniejsza hydratacja może dodawać interaktywność.

  • Schema.org pasuje do realnej treści strony; FAQ wynika z sekcji faqs: i nie dubluje ręcznie dopisanych bloków. Schema Markup Validator sprawdza słownik Schema.org, a Rich Results Test — typy obsługiwane przez Google.

  • Sitemapa zawiera tylko kanoniczne, opublikowane URL-e zwracające 200, przeznaczone do indeksowania, bez noindex i blokady w robots.txt.

  • W artykule znajdują się linki wewnętrzne do powiązanych wpisów i usług, ale bez nienaturalnego upychania słów kluczowych w anchorach.

  • Po publikacji sprawdzasz reprezentatywne adresy w inspekcji URL Search Console oraz odpowiedzi HTTP przez curl. Weryfikujesz też przekierowania i status 404 dla nieistniejących stron.

Audyt techniczny i optymalizacja SEO.
Audyt techniczny SEO

Często zadawane pytania

Czy Astro jest lepsze pod SEO niż Next.js?

Astro domyślnie ogranicza JavaScript wysyłany do przeglądarki, co ułatwia optymalizację wydajności. Nie gwarantuje jednak lepszych Core Web Vitals ani pozycji niż Next.js. Wyniki zależą od treści, obrazów, skryptów i sposobu wdrożenia. Szerszą analizę znajdziesz w artykule porównawczym.

Czy muszę używać integracji `@astrojs/sitemap`?

Ręczne generowanie sitemapy nie jest obowiązkowe, ale generuje dodatkową pracę przy każdym nowym artykule i niesie ze sobą ryzyko pominięcia adresów URL. Automatyzacja tego procesu na podstawie ścieżek w projekcie eliminuje ten problem, dlatego warto wdrożyć ją już od publikacji pierwszego artykułu.

Co z AMP? Czy Astro wspiera AMP?

Astro nie posiada dedykowanej integracji z technologią AMP. Ponieważ Google nie wymaga już formatu AMP dla sekcji Top Stories, jego wdrożenie nie jest warunkiem koniecznym do obecności w tym miejscu. Standardowa, dobrze zoptymalizowana strona HTML z powodzeniem osiąga wysokie wyniki Core Web Vitals.

Jak sprawdzić, czy moja strona Astro dobrze renderuje się dla Google?

Do weryfikacji sposobu widzenia serwisu przez wyszukiwarkę służy narzędzie inspekcji adresów URL w Google Search Console, które umożliwia bezpośredni wgląd w kod HTML zarejestrowany przez roboty. Z kolei polecenie curl pozwala na pobranie czystej odpowiedzi serwera bez uruchamiania kodu JavaScript, co w zestawieniu z inspektorem DOM w narzędziach deweloperskich przeglądarki ułatwia identyfikację rozbieżności pomiędzy treścią statyczną a dynamiczną. Należy przy tym pamiętać, że prosta zmiana nagłówka User-Agent na bota Google w zwykłej przeglądarce nie odwzorowuje rzeczywistego procesu renderowania w infrastrukturze wyszukiwarki.

Czy dane uporządkowane realnie wpływają na pozycje?

Wdrożenie danych strukturalnych Schema.org nie przekłada się bezpośrednio na wyższe pozycje w wynikach wyszukiwania. Ich rola ma charakter pośredni – pomagają algorytmom poprawnie zinterpretować kontekst treści oraz mogą kwalifikować serwis do wyświetlania w formie wyników rozszerzonych. Samo zastosowanie znaczników nie gwarantuje jednak ani ich fizycznej prezentacji, ani wzrostu CTR, a także nie stanowi pewnej metody na uzyskanie cytowania w odpowiedziach systemów sztucznej inteligencji.

O autorze

Maciej Sala

Maciej Sala — konsultant technologiczny produktów cyfrowych i web developer z bogatym doświadczeniem w marketingu internetowym oraz SEO. Na co dzień pracuje z Reactem, Next.js i TypeScriptem, a ostatnio także z Astro i narzędziami do automatyzacji procesów AI. Sprawnie łączy perspektywę produktową z praktycznym podejściem do kodu. Przez kilka lat był związany z branżą gier wideo jako project manager i game designer. Absolwent historii na Uniwersytecie Jagiellońskim oraz studiów podyplomowych z marketingu internetowego na AGH w Krakowie. Po godzinach trenuje na siłowni, maluje figurki i rozwija własne projekty.

Pomagam przekładać takie tematy na konkretne wdrożenia w frontendzie, SEO, analityce i procesie produktowym.

Skontaktuj się ze mną
LH.pl – Hosting Mango

Biblioteka wiedzy na temat Astro

Czytaj dalej

Zobacz więcej wpisów
Astro czy Next.js w 2026: porównanie frameworków

Astro czy Next.js? Wybór frameworka musi być dokładnie przemyślany, zanim pojawi się pierwszy commit. Jeśli stoisz przed takim właśnie wyborem, w tym artykule staram się wykazać, w jakich obszarach najlepiej sprawdza się Astro , a w jakich będzie dominował Next.js .

Maciej Sala

Maciej Sala

Founder StriveLab

Framework Astro w praktyce: przewodnik od architektury po utrzymanie

Strona internetowa może mieć świetny wynik PageSpeed, a mimo to wciąż mieć różne problemy, poczynając od blokowania publikacji artykułów, a kończąc na gubieniu zapytania z formularza. Stworzyłem ten przewodnik, by sprawnie prowadził przez wybór technologii, migrację, model treści, rendering, SEO i testy, aż po wdrożenie i utrzymanie. Szczegółowe rozwiązania znajdziesz w materiałach przypisanych do poszczególnych etapów.

Maciej Sala

Maciej Sala

Founder StriveLab

Techniczna optymalizacja pod GEO i AEO w Next.js

Generative Engine Optimization GEO to praktyka optymalizacji treści tak, aby silniki AI ChatGPT, Perplexity, Google AI Overviews, Gemini i Claude cytowały je w swoich odpowiedziach. Answer Engine Optimization AEO koncentruje się na pojawianiu się w boksie z odpowiedzią, odpowiedziach głosowych i bezpośrednich odpowiedziach na stronach wyników wyszukiwania. Obie razem opisują dodatkowy wymiar widoczności i nie zastępują technicznego SEO ani jakości treści, od których zależy możliwość znalezienia strony.

Maciej Sala

Maciej Sala

Founder StriveLab

LH.pl – Cloud Server 1C4G