Загрузка...

Блог

Technical SEO для SPA на FastAPI: canonical, sitemap и Search Console

Technical SEO для SPA на FastAPI: canonical, sitemap и Search Console

Одностраничное приложение с серверным рендером «оболочки» и клиентской навигацией легко даёт дубли URL: без слэша и со слэшем, лендинг и главная с одинаковым контентом, служебные пути из старых версий сайта. Ниже — практический чек-лист на примере продакшн-настроек: что проверить в коде и что смотреть в Google Search Console.

Почему SPA «ломает» отчёты GSC

Поисковик получает HTML от сервера для каждого маршрута. Если для разных URL отдаётся один и тот же индекс с разным link rel="canonical" до и после выполнения JavaScript, возникают статусы вроде «вариант страницы с canonical» или расхождение выбора canonical между Google и разметкой. Серверный слой мета (подстановка в HTML при отдаче) и клиентские метаданные должны совпадать по каноническому URL.

Канонический URL и trailing slash

Зафиксируйте единое правило: для публичных страниц один предпочтительный вид URL (обычно со слэшем в конце для разделов). Редиректы 301 с «коротких» вариантов (/chat → /chat/, /blog → /blog/) снимают дубли в выдаче. Путь в обработчике catch-all нормализуйте с ведущим /, чтобы словарь метаданных находил ключ /blog/…/, а не случайно подставлял мета главной.

Sitemap и дубликаты контента

В XML sitemap перечисляйте только URL, которые вы хотите видеть в индексе как самостоятельные. Если отдельная страница (например лендинг) сводится к той же сущности, что и главная, канонический адрес должен указывать на главную — и тогда дублирующий URL не обязан быть в sitemap. Иначе краулер видит «страница в карте сайта» и «canonical на другой URL» одновременно.

robots.txt и служебные ресурсы

API и статические ассеты с cache-buster в query не должны восприниматься как целевые лендинги. Закройте от индексации служебные префиксы (Disallow: /api/), при необходимости — каталоги CSS/JS; для JSON-эндпоинтов полезен заголовок X-Robots-Tag: noindex, кроме публичных HTML-страниц документации.

Что проверить в Search Console после правок

  • Страница → сводка по индексированию: снижение 404 на известных старых URL.
  • Канонические домены: единый хост и протокол (HTTPS).
  • Sitemap: успешная обработка без роста «исключённых» страниц из-за дублей.

Практики применения

  • Один источник правды для title, description и canonical — на сервере, до отдачи HTML.
  • Редиректы для устаревших путей из отчётов GSC, а не только 404-страница.
  • После изменений дождаться переобхода: метрики в консоли обновляются не сразу.

Итог: выровняйте серверные и клиентские мета, нормализуйте пути, ограничьте sitemap каноническими URL и закройте служебные пути — так technical SEO для SPA остаётся предсказуемым для краулеров.