Настройка Prerender.io для SEO SPA: nginx, Express

Вы запустили SPA на Vue 3 — страницы летают, UX отличный. Но Googlebot видит пустой <div id="app">, индексация — ноль. Трафик с поиска не растёт. В нашей практике клиент с интернет-магазином на Vue 3 после настройки Prerender.io получил рост индексации на 40% за месяц, а LCP упал с 4.2 до 1.1 секунды. Рассказываем, как настроить сервис правильно и без сюрпризов.

Prerender.io — это SaaS, который по запросу бота рендерит страницу в headless Chrome и отдаёт готовый HTML. Для обычных пользователей ничего не меняется. Мы используем его в 50+ проектах — от корпоративных сайтов до маркетплейсов. Экономия серверного времени по сравнению с полноценным SSR — до 70%, а нагрузка на сервер снижается в 3–5 раз.

Проблемы, которые решаем

SPA по умолчанию не отдают контент при выключенном JavaScript — поисковые боты видят пустой index.html. В итоге:

• Страницы не попадают в выдачу (или попадают с ошибками).
• Сниппеты пустые, Title — "React App".
• Внутренние ссылки не индексируются.

Например, клиент с каталогом на 10 000 товаров: без prerender боты индексировали только 12 страниц из 10 000. После настройки — 8 500 страниц за неделю.

Типичные ошибки:

• nginx не различает ботов и людей.
• Middleware неправильно отфильтровывает User-Agent.
• Кэш не сбрасывается после деплоя.

В 90% случаев проблема именно в фильтрации User-Agent. Мы настраиваем Prerender.io с учётом этих нюансов — так, чтобы боты получали полный HTML, а пользователи — быстрый SPA.

Почему Prerender.io, а не полноценный SSR?

SSR (Nuxt 3, Next.js) рендерит каждую страницу на сервере — это нагрузка и сложность. Prerender.io делает это только для ботов: тратит ресурсы только на рендеринг для поисковиков. Экономия серверного времени — до 70% по сравнению с SSR. Плюс не нужно переписывать фронтенд — подходит для любого SPA-фреймворка. На практике Prerender.io снижает нагрузку на сервер в 3–5 раз для проектов с высоким трафиком, особенно если большая часть страниц статична.

Как это работает (схематично)

1. Бот запрашивает /products/42.
2. nginx / middleware определяет User-Agent и проксирует на prerender.io.
3. Prerender.io рендерит страницу в headless Chrome.
4. Возвращает готовый HTML боту.

Пользователи получают обычный SPA — никаких изменений.

Настройка Prerender.io для SPA

Настройка nginx

map $http_user_agent $prerender_ua {
    ~*(Googlebot|AdsBot-Google|Googlebot-Image|Bingbot|Slurp|
       DuckDuckBot|Baiduspider|YandexBot|LinkedInBot|
       facebookexternalhit|Twitterbot|WhatsApp|TelegramBot)  "1";
    default "0";
}

server {
    listen 443 ssl;
    server_name company.com;

    location / {
        if ($prerender_ua = "1") {
            rewrite .* /$scheme://$host$request_uri? break;
            proxy_pass https://service.prerender.io;
            proxy_set_header X-Prerender-Token "YOUR_API_TOKEN";
            proxy_set_header X-Prerender-Host $host;
            proxy_connect_timeout 5s;
            proxy_read_timeout 60s;
        }

        try_files $uri /index.html;
    }
}

Middleware для Node.js (Express)

const prerender = require('prerender-node')

prerender.set('prerenderToken', process.env.PRERENDER_TOKEN)
prerender.set('prerenderServiceUrl', 'https://service.prerender.io/')

// Опциональные настройки
prerender.crawlerUserAgents.push('TelegramBot', 'WhatsApp')
prerender.set('blacklistPaths', ['/admin', '/dashboard', '/api'])

app.use(prerender)

Библиотека prerender-node доступна на GitHub.

Как настроить автоматический рекэш при деплое?

Prerender.io кэширует страницы автоматически. Но после деплоя кэш нужно сбрасывать для изменённых URL. Мы автоматизируем это через API:

# Очистить конкретный URL
curl -X POST https://api.prerender.io/recache \
  -H "Content-Type: application/json" \
  -d '{"prerenderToken": "YOUR_TOKEN", "url": "https://company.com/product/42"}'

# Рекэшировать при деплое (список измененных URL)
CHANGED_URLS=$(git diff HEAD~1 --name-only | grep "pages/" | ...)
for url in $CHANGED_URLS; do
  curl -X POST https://api.prerender.io/recache \
    -d "{\"prerenderToken\": \"$TOKEN\", \"url\": \"https://company.com/$url\"}"
done

Если страниц много — используем прекэш по sitemap:

import requests
import xml.etree.ElementTree as ET

def precache_sitemap(sitemap_url, prerender_token):
    response = requests.get(sitemap_url)
    root = ET.fromstring(response.content)
    ns = {'sm': 'http://www.sitemaps.org/schemas/sitemap/0.9'}

    urls = [loc.text for loc in root.findall('.//sm:loc', ns)]
    print(f"Precaching {len(urls)} URLs...")

    for url in urls:
        requests.post('https://api.prerender.io/recache',
                     json={'prerenderToken': prerender_token, 'url': url})

precache_sitemap('https://company.com/sitemap.xml', os.environ['PRERENDER_TOKEN'])

Prerender.io хранит кэш на своих серверах. Срок жизни кэша по умолчанию — 30 минут, его можно настроить через заголовки Cache-Control. Рекомендуем ставить max-age=3600 для статичных страниц и no-cache для динамических. Автоматический рекэш при деплое гарантирует, что боты увидят актуальную версию.

Как проверить, что prerender работает?

# Запрос как Googlebot
curl -A "Googlebot/2.1 (+http://www.google.com/bot.html)" \
  https://company.com/products/iphone-15 | \
  grep -o '<title>[^<]*</title>'

# Должен вернуть реальный title, не "React App" или пустую строку

Chrome DevTools → Network → Disable JS → перезагрузить страницу — если виден контент без JS, prerendering работает корректно для ботов.

Какие преимущества Prerender.io для SPA?

Быстрое внедрение — настройка занимает от 0,5 дня. Не требует переписывания кода. Экономия серверных ресурсов до 70%. Среднее время первого рендера холодной страницы — 1.5 секунды, горячей — 100 мс. Prerender.io поддерживает все популярные фреймворки: Vue, React, Angular.

Что входит в настройку под ключ

Сроки и стоимость

Базовая настройка (nginx + прекэш) — от 0,5 до 1 рабочего дня. Сложная интеграция (несколько middleware, кастомный рекэш) — до 2 дней. Стоимость фиксированная и рассчитывается индивидуально. Мы гарантируем, что после настройки Googlebot начнёт видеть контент. Наша команда имеет 5 лет опыта и выполнила более 50 проектов по SEO-оптимизации SPA.

Закажите настройку Prerender.io — получите консультацию инженера. Свяжитесь с нами, чтобы обсудить ваш проект. Получите консультацию инженера — мы поможем выбрать оптимальное решение.

Почему Core Web Vitals критичны для технического SEO

PageSpeed показывает 34/100 на мобильных. В Search Console — красные метрики по всем страницам категорий. Конкурент с сайтом на 3 года старше стоит выше в выдаче, несмотря на более слабые тексты. Техническая производительность стала прямым ранжирующим фактором — и разрыв между «приемлемо» и «быстро» стоит позиций. Мы решали эту проблему для десятков проектов — от интернет-магазинов до SaaS-платформ — и знаем, какие ошибки съедают ранжирование.

Core Web Vitals: что реально влияет на позиции

Google использует три метрики как сигналы ранжирования (Page Experience): LCP (Largest Contentful Paint), CLS (Cumulative Layout Shift), INP (Interaction to Next Paint, заменил FID с последнего крупного обновления алгоритма).

LCP: почему 8 секунд — это не проблема изображения

LCP измеряет время отрисовки самого большого видимого элемента страницы. Чаще всего — hero image или H1. Пороги: хорошо < 2.5s, плохо > 4s.

Типичный диагноз на реальном проекте: интернет-магазин одежды, LCP 7.8s на мобильных. Элемент — hero image категории, 4.2MB JPEG без srcset, загружается через CSS background-image (не <img>). Проблема здесь двойная: во-первых, браузер не может preload CSS background images через <link rel="preload"> стандартным способом. Во-вторых, 4.2MB на мобильном соединении — это физически медленно.

Решение по шагам:

1. Переносим hero из CSS background в <img> с fetchpriority="high" и loading="eager"
2. Конвертируем в WebP, добавляем srcset: 800w для мобильных, 1400w для десктопа
3. <link rel="preload" as="image" href="hero-800.webp" media="(max-width: 768px)"> в <head>
4. Убираем все render-blocking скрипты выше hero через defer

Итог: LCP 7.8s → 1.9s. Без смены хостинга, без CDN.

Если LCP — не изображение, а текстовый блок: проблема может быть в TTFB (медленный сервер), в render-blocking CSS/JS, или в web fonts с font-display: block.

CLS: смещения, которые раздражают пользователя и Google

CLS измеряет суммарный сдвиг элементов в процессе загрузки. Пороги: хорошо < 0.1, плохо > 0.25. CLS 0.35 — это баннер, который появляется через секунду и сдвигает всё содержимое страницы вниз.

Источники CLS:

• Изображения без заданных размеров. <img src="photo.jpg"> без width и height — браузер не резервирует место, контент прыгает при загрузке. Фикс: явные width/height или aspect-ratio в CSS.
• Рекламные блоки и виджеты. Google Ads, чат-виджеты, cookie consent — всё, что появляется после основного контента. Решение: резервировать место через min-height или загружать до рендера основного контента.
• Web fonts. FOUT (Flash of Unstyled Text) и FOIT (Flash of Invisible Text) могут вызывать переформатирование. font-display: swap с size-adjust (CSS свойство для выравнивания размеров fallback шрифта) минимизирует CLS.
• Динамический контент. Если блок появляется после загрузки (fetch данных, lazy load) — добавляем skeleton placeholder с нужными размерами.

INP: почему интерфейс «зависает» на 500ms

INP измеряет задержку ответа на любое взаимодействие пользователя: клик, тап, ввод. Пороги: хорошо < 200ms, плохо > 500ms. INP 680ms — это когда пользователь нажимает кнопку фильтра, а ничего не происходит полсекунды.

Главная причина высокого INP — заблокированный main thread. JavaScript-бандл 2.1MB парсируется и выполняется синхронно. Пока выполняется, пользовательские события не обрабатываются.

Диагностика через Chrome DevTools → Performance → взаимодействие с подозрительной задержкой → найти Long Tasks (> 50ms). Типичные виновники:

• Непрерывная обработка большого списка без requestIdleCallback или requestAnimationFrame
• Тяжёлые event listeners без debounce/throttle
• Синхронный setState в React, который триггерит полный ре-рендер сложного дерева компонентов
• Third-party scripts: livechat, аналитика, виджеты — они исполняются в том же main thread

Решения: code splitting через динамический import(), перенос тяжёлых вычислений в Web Workers, React.memo + useMemo для предотвращения лишних ре-рендеров, scheduler API для приоритизации задач.

Schema.org: разметка, которую читают роботы

Структурированные данные через JSON-LD — не прямой ранжирующий фактор, но дают rich snippets в выдаче (звёзды рейтингов, цены, дата публикации), что увеличивает CTR на 20–30%.

Типы разметки по сценариям:

• E-commerce: Product с offers (цена, наличие, валюта), aggregateRating (рейтинг из отзывов), brand. BreadcrumbList для навигации. ItemList для страниц категорий.
• Статьи и блог: Article или BlogPosting с author, datePublished, dateModified, image. Organization и WebSite на главной странице — помогают Google связать сайт с брендом.
• Локальный бизнес: LocalBusiness с address, telephone, openingHours, geo. Критично для локального SEO.
• FAQ: FAQPage с mainEntity — вопросы и ответы могут появляться прямо в выдаче как раскрывающийся блок.

Валидация: Google Rich Results Test и Schema Markup Validator. Частая ошибка — указать price без priceCurrency, или ratingValue без reviewCount. Google игнорирует неполную разметку.

Как проводить технический SEO-аудит

Сканируемость. robots.txt блокирует нужные страницы (или наоборот, не блокирует служебные). Canonical URLs настроены неправильно — дублируются страницы с UTM-метками. Sitemap содержит страницы с noindex. Всё это Screaming Frog или Sitebulb покажут за час сканирования.

Core Web Vitals в масштабе. Google Search Console → Core Web Vitals → смотрим не отдельные страницы, а группы URL (шаблон страницы продукта, шаблон категории, блог). Проблема обычно системная — одна ошибка в шаблоне портит сотни страниц.

JavaScript SEO. Google рендерит JavaScript, но с задержкой (иногда дни для полного рендера). Для критичного контента — SSR или SSG обязательны. Проверяем через Search Console → Inspect URL → View Crawled Page: что видит Googlebot.

Internal linking. Орфанные страницы (нет входящих внутренних ссылок) теряют PageRank. Битые ссылки (404) — сигнал качества.

Что входит в работу

• Документация: отчёт с найденными проблемами, roadmap по приоритетам, тайминги для каждого этапа.
• Доступы: настройка мониторинга (SpeedCurve, Sentry Search Console), передача dashboard.
• Обучение: разбор типичных ошибок для вашей команды (1–2 созвона).
• Поддержка: сопровождение в течение месяца после деплоя — проверка метрик, фикс регрессий.

Свяжитесь с нами — мы оценим ваш проект за 2 дня и покажем, сколько позиций можно вернуть за счёт технического SEO. Опыт работы с проектами уровня сотен тысяч посещений в месяц — гарантируем измеримый результат в Core Web Vitals до/после. Закажите аудит в этой форме — получите персональный чек-лист из 15 пунктов.