easy-png-tools2/docs/plan-seo.md

# План: SEO + GEO — индексация и конкуренция в image tools

> **Статус (2026-09-11):** план к выполнению. C17 выполнен — `preview/*`
> переехали на реальные маршруты (в `noindex` сохраняются до запуска S1, см.
> `plan-redesign.md` C17). Сейчас применять можно domain-free часть S1.
> **Уточнено:** домен не был блокером C17 (см. §6). Задачи S1 разбиты на
> domain-free (можно делать параллельно с покупкой домена) и domain-required
> (после покупки и настройки домена на Vercel).
>
> **Цель:** каждая страница инструмента — индексируемый лендинг под конкретный
> интент («crop png», «make png transparent», «jpg to png»…), конкуренция с
> onlinepngtools.com за ядро запросов + попадание в ответы генеративных систем
> (ChatGPT, Perplexity, AI Overviews) — GEO.
>
> Задача: «для каждого инструмента — своя страница, и можно реально
> конкурировать с onlinepngtools».
>
> **Позиционирование (уточнено 2026-09-09):** сайт — не «PNG-инструменты», а
> **image tools с PNG-ядром**: любой инструмент работает с PNG/JPG/WebP/GIF/BMP
> на входе и отдаёт результат в PNG/JPG/WebP/BMP через селектор в кнопке
> Download. Дифференциатор — прозрачность/альфа/фон и no-upload-приватность.
> Референс-конкурент по ядру — onlinepngtools.com (см. §2). Долгосрочно ядро
> переезжает на wasm и обрастает API + PWA (оффлайн/установка) —
> `docs/roadmap.md` фазы 3–10, `docs/plan-platform.md`; для SEO это аргументы
> дистрибуции (S4c) и GEO-факты, схему сайта они не меняют.

## 0. Решения

- **Бренд: переименовать до индексации** (новое имя и домен сознательно не
  записаны в этом репозитории — см. §6 и локальный план
  `docs/plan-domain.local.md`, исключён из git: выбранное имя не должно утекать
  в историю коммитов до покупки домена). Легенда честная: «started as PNG tools,
  now all formats» — это контент-плюс, а не баг. Названия инструментов
  (`crop-png`, …) и localStorage-ключи не переименовывать (см. решение про слаги
  ниже). Точка истины по бренду: константа в i18n + README; хардкод в
  компонентах недопустим.
- **Форматы: формат = выбор в UI, не отдельные страницы.** Download-кнопка
  каждого инструмента — с селектором PNG/JPG/WebP/BMP (+quality для lossy). Райз
  «выбор формата/качества в Download» вытащен из backlog №7 в S1f: механика уже
  есть (`ToolEntry.output`), нужна как продуктовая основа «image
  tools»-позиционирования. Отдельные страницы-конвертеры — только для
  подтверждённых вордстатом интентов.
- **Слаги инструментов `-png` сохраняются.** Они держат низкоконкурентные
  png-интенты; широкие интенты («crop image online») переносятся теми же
  страницами контентом: H1 «Crop image», текст «works with PNG, JPG, WebP».
  URL-алиасы без `-png` не создаются (канонический беспорядок).
- **Индексируемая локаль — EN** (базовая; конкурент англоязычный). RU-версия —
  отдельно и позже: префикс `/ru/`, prerender обеих локалей, hreflang
  (сознательно отложено в `archive/plan-i18n.md`). Пока язык переключается на
  клиенте (localStorage) — для SEO не учитываем.
- **Прод-домен без `BASE_PATH`.** Сборка с базой (GitHub Pages `/repo/`) ломает
  абсолютные URL, canonical и «корневость» страниц. Свой домен + корень.
- **URL-схема инструментов:** короткие плоские адреса. После C17 вынести
  страницы инструментов в корень: `/crop-png` (как у конкурента), каталог —
  `/tools`. Переезд `/preview/tools/[id]` → `/[id]` сделать **одновременно с
  C17** (в одном атомарном коммите): после индексации переименование URL = 301 и
  потеря позиций.
- **Без GA и рекламных скриптов:** аналитика — self-hosted Plausible/Umami или
  Cloudflare Web Analytics. «No tracking» — часть позиционирования, её нельзя
  подрывать собственными скриптами.
- **Честные методы.** Никакого клонированного текста, дорвеев, PBN. Контент — по
  каждому инструменту, с ручной вычиткой.

## 1. Аудит (2026-09-09)

Фундамент уже есть:

- SvelteKit + `adapter-static`, `prerender = true` на весь сайт
  (`web/src/routes/+layout.ts`) — весь контент в статичном HTML, ботам не нужен
  JS. Это главный технический козырь.
- 121 инструмент в `registry-new` с «SEO-шными» id (`crop-png`,
  `add-border-png`, …) — URL уже повторяют паттерн конкурента.
- Уникальные `<title>` + `<meta description>` на страницах инструментов старой
  ветки; механика переносится на новую при C17.
- Каталог со ссылками на все инструменты (внутренняя перелинковка) и карта
  инструментов против конкурента: `docs/tools-map.md` (у них 311, из них 107 —
  нишевые клоны-серии Logo*/Icon*/Stamp* поверх обычных операций).
- EN-тексты в реестре + i18n-словари ru/en.

Чего нет (пробелы закрываются этапами ниже):

| Пробел                                                | Где сейчас                          | Этап   |
| ----------------------------------------------------- | ----------------------------------- | ------ |
| `sitemap.xml`                                         | нет                                 | S1     |
| `robots.txt` без `Sitemap:`                           | allow-all (`web/static/robots.txt`) | S1     |
| `rel=canonical`                                       | нет                                 | S1     |
| OG/Twitter-теги, OG-картинки                          | нет                                 | S1     |
| `noindex, nofollow` на страницах инструментов preview | `preview/tools/[id]/+page.svelte`   | S1/C17 |
| Контент страницы (H1-текст, how-to, FAQ, related)     | только title/description            | S2     |
| JSON-LD (SoftwareApplication, FAQPage, Breadcrumb)    | нет                                 | S3     |
| `llms.txt`, хабы категорий с текстом                  | нет                                 | S3     |
| GSC + приватная аналитика                             | нет                                 | S4     |

## 2. Конкурент (onlinepngtools.com)

Снято с живого сайта (2026-09-09):

- ~311 URL в sitemap, все плоские (`/crop-png`, `/create-transparent-png`);
  title вида «Crop a PNG – Online PNG Maker».
- Страница инструмента: h1 + 2–3 абзаца («World's simplest…», import/crop
  примеры), примеры «before/after», how-to-блок, огромные футерные перелинковки
  (серии Logo*/Icon*/Stamp*), страницы-хабы, price-wall.
- Сила: возраст домена, ссылочная масса, бренд, охват, серии-клоны под длинные
  хвосты.
- Слабость (наш контраргумент): реклама, ежедневные лимиты free-плана, платное
  коммерческое использование, апселл-модалки, страницы по ~450 КБ.
- Наш ответ в контенте каждой страницы: **no upload (всё локально в браузере),
  no signup, no limits, бесплатно в т.ч. для коммерческого использования, open
  source**.

## 3. Стратегия

1. **Не лобовая, а ядро интентов.** 80% объёма поиска приносят ~30–50 запросов.
   Покрытие инструментов у нас почти полное (121); приоритет — контент и
   качество страниц ядра, затем хвосты.
2. **Страница = лендинг, а не «пустая коробка».** Шаблон контента: H1 → 1–2
   абзаца «что делает» → как использовать (шаги) → параметры → FAQ (3–5 вопросов
   уровня People-Also-Ask) → related tools по категории.
3. **CWV как измеримое преимущество.** Лёгкие быстрые страницы против ~450-КБ
   страниц конкурента; после редизайна не потерять скорость.
4. **GEO.** LLM-системы цитируют страницы с прямыми определениями, списками,
   таблицами и уникальными фактами. Всё это уже есть в данных реестра — отдавать
   в HTML-структуре, без воды.
5. **Информационный контур — потом, не вместо.** Гайды по форматам (PNG/JPEG/
   WebP: история, модификации, lossy/lossless, прозрачность, «png vs jpeg») дают
   E-E-A-T, перехватывают сравнительные запросы и служат хабами внутренних
   ссылок на инструменты. Но это этап S3e и только после того, как написано ядро
   S2: транзакционная страница приносит конверсию, информационная — только
   трафик. Тонкие FAQ-страницы «про всё» не заводить — несколько сильных
   материалов с ссылками на 3–5 инструментов каждый.
6. **Дистрибуция.** GitHub-репо (звёзды/форки = сигналы), alternative.to,
   Product Hunt, Reddit по интенту — реальный путь набрать первые бэклинки без
   бюджетов.

## 4. Этапы

### S1. Технический минимум (сразу после C17)

Разбито на две группы: **domain-free** (делаем параллельно с покупкой домена) и
**domain-required** (после покупки и DNS-настройки).

#### S1-free: без домена (параллельно с C18–C19)

- [ ] **[S1e]** OG-картинки per-tool: генерация PNG-карточек скриптом на
      существующем ядре (мы сами умеем рисовать PNG) — имя инструмента + бренд,
      файл `static/og/[id].png`, ссылка из `Seo.svelte`. Относительные пути
      (`/og/crop-png.png`) работают без домена; при деплое на Vercel с
      собственным доменом OG-картинки будут корректными.
- [ ] **[S1f]** Download-кнопка с селектором формата PNG/JPG/WebP/BMP (+quality
      для lossy) для всех инструментов — механика `ToolEntry.output` уже есть
      (backlog №7, райз «выбор формата/качества»). Продуктовая основа «image
      tools»-позиционирования: без неё сайт остаётся PNG-сайтом. Вести
      параллельно с C18–C19.
- [ ] **[S1g]** Поведение конвертеров после S1f: не предлагать в меню форматов
      формат исходника (disable) — чтобы «convert png to jpg» не мог сохранить в
      png. Существующие страницы не трогать: `jpg-to-png`, `png-to-jpg`,
      `png-to-webp`, `png-to-bmp` остаются самостоятельными лендингами со своим
      контентом (§5).

#### S1-domain: с доменом (после покупки + DNS на Vercel)

- [ ] **[S1a]** Снять `noindex, no_follow` со страницы инструмента
      (`tools/[id]/+page.svelte`) — делается одновременно с S1d (canonical)
      чтобы Google сразу проиндексировал с правильным доменом.
- [ ] **[S1b]** Скрипт `web/scripts/gen-sitemap.mjs`: генерирует `sitemap.xml` в
      `build/` из `TOOLS` реестра (`registry-new`) + статических страниц. Вызов
      из `pnpm build` после `vite build` (adapter-static пишет в `build/`,
      дописываем файл там же). Origin — из env (`PUBLIC_SITE_ORIGIN`), учёт
      опционального `BASE_PATH`.
- [ ] **[S1c]** `robots.txt`: `Sitemap:` + закрыть служебные маршруты (`/kit` до
      C19; после — вернуть минимальный allow-all).
- [ ] **[S1d]** Компонент `Seo.svelte` (kit): canonical (абсолютный URL по
      актуальному маршруту), OG-теги (title/description/type/url/image),
      twitter:card. Подключить в root-layout. **Требует `PUBLIC_SITE_ORIGIN`**
      для абсолютных URL в canonical и OG:url.

> **Порядок S1:** S1e/S1f/S1g → покупка домена → S1a+S1b+S1c+S1d. Гейты: build
> зелёный; в `build/` лежит корректный `sitemap.xml` со всеми инструментами;
> canonical/OG присутствуют на всех страницах; e2e зелёные.

### S2. Контентный слой (параллельно C18–C19, волнами по категориям)

- [ ] **[S2a]** Схема данных: `seo`-блок per-tool (`longDescription`,
      `howTo: string[]`, `faq: {q, a}[]`) — в i18n-словарях (ru/en), не в коде
      реестра. Черновики — генерацией из схемы параметров инструмента, вычитка
      вручную пачками по категориям (самый трудоёмкий этап: ~121 × 2 локали; RU
      — отложить до решения о `/ru/`).
- [ ] **[S2b]** Компонент контента страницы инструмента (kit): H1, lead, how-to
      (`ol`), описание параметров (из схемы), FAQ, related tools (перелинковка
      внутри категории + 2–3 «соседних» интента).
- [ ] **[S2c]** Хлебные крошки (Каталог → Категория → Инструмент) в UI.
- [ ] **[S2d]** Первая волна контента — топ-30 инструментов ядра (приоритет по
      вордстату: transparent png, jpg→png, compress, resize, crop, rotate,
      circle crop, add text, pixelate, grayscale…).
- Гейты: на каждой странице инструмента — уникальный текст ≥ 300 слов, H1
  совпадает с интентом, FAQ ≥ 3, related ≥ 3; текст в статике (prerender), не в
  рантайме.

### S3. Структурированные данные + GEO

- [ ] **[S3a]** JSON-LD: `SoftwareApplication` (+ `offers` price 0) и `FAQPage`
      на страницах инструментов; `WebSite` + `Organization` на главной;
      `BreadcrumbList` на всех внутренних. Учесть: Google ограничил rich results
      по FAQ/HowTo для мелких сайтов — разметка нужна прежде всего для
      LLM-парсинга, она безвредна.
- [ ] **[S3b]** `llms.txt` в статике: короткий манифест сайта + список
      инструментов с одним предложением на каждый (генерится из реестра тем же
      скриптом, что sitemap).
- [ ] **[S3c]** Хабы категорий с текстом: 2–3 абзаца на категорию (что за
      группа, когда какие инструменты применять), не голые списки карточек.
- [ ] **[S3d]** GEO-редактура: каждое описание начинается прямым определением
      («Crop PNG is a free tool that cuts a rectangular area from a PNG image
      right in your browser»), списки/таблицы для фактов, без вводных «в
      современном мире…». Проверка: страница отвечает на запрос одним абзацем
      «без скролла».
- [ ] **[S3e]** _(опционально)_ Информационные гайды по форматам: 3–4 сильных
      материала (`/guides/png-format`, `/guides/jpeg-vs-png`, …): история и
      модификации формата, lossy/lossless, прозрачность, когда какой формат
      выбирать. Каждый — с ссылками на 3–5 связанных инструментов (хабы
      перелинковки), FAQ из гайдов продублирован как FAQPage-разметка. Приоритет
      ниже S2/S3a–d: только когда ядро написано и есть ресурс.
- Гейты: валидация JSON-LD (Rich Results Test без ошибок); `llms.txt` актуален
  при добавлении инструментов (генерация, а не ручное редактирование).

### S4. Измерение и запуск

- [ ] **[S4a]** Google Search Console: собственность на домен, отправка sitemap,
      мониторинг индексации и запросов. Бесплатно и обязательно.
- [ ] **[S4b]** Аналитика без трекинга: self-hosted Plausible/Umami либо
      Cloudflare Web Analytics. GA/ЯМ не ставим (позиционирование).
- [ ] **[S4c]** Дистрибуция: закрепить GitHub-репо (README со скриншотами),
      подача на alternative.to (страница против конкурента), Product Hunt,
      тематические Reddit/HN-треды. Бэклинки — главный дефицит для конкуренции.
- [ ] **[S4d]** _(опционально, позже)_ Сравнительные посадочные «vs …» (без
      негатива: «no limits, no signup, no upload») — по мере роста доверия
      домена.
- [ ] **[S4e]** Контроль CWV: Lighthouse на страницы ядра после каждого крупного
      этапа редизайна; цель — зелёные метрики на мобильных.

## 5. Приоритизация инструментов (первая волна контента)

Источник — `docs/tools-map.md` (121 реализовано; у конкурента 311, из них 107 —
клоны-серии). Первая волна — топ-интенты, где конкуренты ранжируются, а у нас
уже есть инструмент и он не хуже:

- прозрачность/фон: create-transparent-png, remove-background, change-opacity
- конвертация: jpg-to-png, png-to-jpg, webp-to-png, svg-to-png, png-to-base64
- геометрия: crop, resize, rotate, circle-crop, round-corners, flip
- цвет/фильтры: grayscale, invert, pixelate, add-text, watermark
- генерация: gradient, empty-canvas

Новая волна форматов (после S1f): jpg↔webp и другие конвертации «формат →
формат» — только по подтверждённому вордстату; базовые кейсы закрывает селектор
формата в Download (S1f), страницы заводим лишь там, где интент стабильно
ищется.

- **crop-png: H1 «Crop image online — free, no upload»**, текст «works with PNG,
  JPG, WebP» — широкий интент обслуживается контентом страницы с png-слагом,
  слаг при этом остаётся якорем дешёвого png-интента.

### Форматные варианты страниц (`crop-jpeg`, `crop-webp`, …)

Три возможных механики — важно не перепутать:

1. **301-редирект `/crop-jpeg` → `/crop-png`** — законно только для опечаток и
   альтернативных написаний (`crop-jpg` → `crop-jpeg`) и переименований
   существующих страниц. Для самостоятельного запроса редирект — это отказ от
   страницы: Google перестаёт показывать редирект, ранжировать будет только
   цель. Как посадочная под «crop jpeg» не работает вообще.
2. **Зеркало с canonical на `/crop-png`** — технически легально, но бесполезно:
   canonical-дубль в индекс не попадает, видимости не добавляет, а массовое
   производство таких зеркал выглядит как накрутка площади и при ошибке в
   canonical превращается в дорвейный кластер. Не делаем.
3. **Самостоятельная страница = самостоятельный контент.** Заводить `/crop-jpeg`
   можно только если: (а) интент подтверждён вордстатом, (б) на странице
   собственный текст — H1 «Crop JPEG», FAQ про качество/артефакты/ когда
   выбирать JPEG вместо PNG, отличия от png-кейса, (в) текст написан или выверен
   человеком, а не получен подстановкой формата в шаблон. Реестром
   автоматизировать **данные** (тот же tool, другой дефолтный output) — можно;
   автоматизировать **текст** — нельзя: массовая подстановка {tool}×{format} в
   шаблон — doorway-паттерн, риск deindex всего сайта.

Как правильно получать видимость под «jpeg»/«webp» без клонов: широкие
формулировки закрывает контент существующей страницы (H1 «Crop image», «works
with PNG, JPG, WebP» в тексте + селектор формата в Download, S1f). Отдельные
форматные страницы — точечные исключения по вордстату, не серия.

### Convert-инструменты: страницы и «универсальный конвертер»

Разводить два разных интента:

- **«convert png to jpg»** — интент «страница-конвертер»: пользователь ищет
  конкретную пару форматов (лучшее качество конверсии, меньше ошибок), это
  готовые лендинги. Существующие (`jpg-to-png`, `png-to-jpg`, `png-to-webp`,
  `png-to-bmp`, `svg-to-png`, …) **оставить и наполнить контентом как все**:
  свой H1 («Convert PNG to JPG — free, no upload»), FAQ про
  качество/прозрачность/фон, related. Селектор формата (S1f) их **не заменяет**
  — он про «уже открыл инструмент и хочу другой формат на выходе».
- **«convert image» / «image converter»** — интент «швейцарский нож». Под него —
  **один будущий инструмент `/convert-image`**: сначала пустой **core-tool** в
  `core/` — функция ре-энкода («копия с перекодированием»: декодирует любой
  поддержанный исходник в ImageData и кодирует в выбранный формат; поверх неё
  S1f строит селектор формата). `ToolEntry` и страницу добавлять **только вместе
  с собственным текстом** («Convert any image to PNG, JPG or WebP in your
  browser») — core в коде не обязывает к странице. Этот же шаблон потом
  закрывает форматные волны (jpg→webp и т.п.) без новых страниц.

Не делать: серию `convert-jpeg`/`convert-webp`-клонов с подстановкой формата
(doorway, см. выше) и «универсальный конвертер» как единственную страницу вместо
форматных лендингов — теряется ядро «convert png to jpg»-запросов.

Правило добавления новых инструментов: брать из хвоста конкурента только те
интенты, которые подтверждены вордстатом, и сразу с контентом S2 (страница без
текста — потраченный URL).

## 6. Переименование бренда и домен (сделать до S1-domain, дёшево сейчас)

Новое имя и конкретный домен **не записаны в этом репозитории** — детальный
чек-лист в `docs/plan-domain.local.md` (исключён из git через `.gitignore`),
чтобы выбранное имя не попало в историю коммитов до покупки домена.

- [ ] **[R1]** Механический переезд бренда на новое имя по чек-листу из
      локального плана: GitHub-репо + `git remote set-url`, README,
      `package.json` (корень + `web/`), `TopBar.svelte` / `Footer.svelte`,
      `favicon.svg` (title в SVG), i18n-строки (`en.ts`, `ru.ts`: defaultTitle,
      pageTitle, metaDescription). НЕ трогать: слаги инструментов (`*-png`),
      ключи localStorage (`easy-png-tools:*` — или мигрировать отдельной
      мелочью), историю docs/archive.
- [ ] **[R2]** Купить выбранный домен (кандидаты и пробы — в локальном плане) и
      настроить деплой на Vercel без `BASE_PATH` (§0). Домен нужен до S1-domain:
      canonical и sitemap генерятся от `PUBLIC_SITE_ORIGIN`.
- **Порядок:** R1+R2 можно делать параллельно с C17/C18/C19 (не блокируют). R2
  (домен) — блокер только для S1-domain (canonical + sitemap + снятие
  `noindex`). После индексации переименование = переезд с 301, потеря позиций и
  ссылок — не делать. Поэтому R1/R2 — до S1-domain, но не обязательно до C17.

## 7. Что осознанно НЕ делаем

- Клонирование 311 URL конкурента (низкокачественные дубли + нет ресурсов на
  контент) — вместо этого ядро + обоснованные хвосты.
- RU-локаль в индексе до решения о структуре `/ru/` + hreflang.
- GA/реклама/трекинг — противоречит позиционированию.
- Дорвеи, программные зеркала, покупные ссылки.
- Массово-сгенерированные форматные клоны (`crop-jpeg`/`crop-webp` как копии
  `crop-png` с подстановкой формата в шаблонный текст) — doorway-паттерн, риск
  deindex всего сайта. Форматная страница — только уникальный контент + вордстат
  (§5); редиректы — только для опечаток/переименований.
- URL-алиасы без `-png` для существующих инструментов и зеркальные
  страницы-конвертеры «на каждый формат» без вордстата.

## 8. Связанные документы

- `docs/plan-redesign.md` — C17 (снятие noindex + переезд маршрутов), C18–C21.
- `docs/tools-map.md` — карта «наш инструмент ↔ интент конкурента».
- `docs/backlog.md` — пункты SEO/GEO в общем бэклоге.
- `docs/roadmap.md` — фазы 2–8 (ядро TS→Rust/wasm, CLI); фазы 9–10 — API и PWA.
- `docs/plan-platform.md` — планы API и PWA (общее ядро, оффлайн-режим).
- `docs/archive/plan-i18n.md` — отложенная многоязычная схема (будущий `/ru/`).
- `docs/plan-domain.local.md` — план переименования/домена; **в git не входит**
  (`.gitignore`), лежит только локально.