docs: update plans

docs/plan-seo.md

@@ -0,0 +1,342 @@
+# План: SEO + GEO — индексация и конкуренция в image tools
+
+> **Статус (2026-09-09):** план к выполнению. Старт — после C17
+> (`plan-redesign.md`): до переезда `preview/*` на реальные маршруты страницы
+> инструментов в `noindex`, применять техминимум некуда.
+>
+> **Цель:** каждая страница инструмента — индексируемый лендинг под конкретный
+> интент («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)
+
+- [ ] **[S1a]** Снять `noindex, nofollow` со страницы инструмента
+      (`preview/tools/[id]/+page.svelte`) — встроено в C17 как атомарный шаг
+      (см. `plan-redesign.md`).
+- [ ] **[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:` + закрыть служебные маршруты
+      (`/preview/kit` до C17; после — вернуть минимальный allow-all).
+- [ ] **[S1d]** Компонент `Seo.svelte` (kit): canonical (абсолютный URL по
+      актуальному маршруту), OG-теги (title/description/type/url/image),
+      twitter:card. Подключить в root-layout.
+- [ ] **[S1e]** OG-картинки per-tool: генерация PNG-карточек скриптом на
+      существующем ядре (мы сами умеем рисовать PNG) — имя инструмента + бренд,
+      файл `static/og/[id].png`, ссылка из `Seo.svelte`.
+- [ ] **[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).
+- Гейты: 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, дёшево сейчас)
+
+Новое имя и конкретный домен **не записаны в этом репозитории** — детальный
+чек-лист в `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]** Купить выбранный домен (кандидаты и пробы — в локальном плане) и
+      настроить деплой без `BASE_PATH` (§0). Домен нужен до S1: canonical и
+      sitemap генерятся от `PUBLIC_SITE_ORIGIN`.
+- Порядок: R1+R2 в любой момент до C17; после индексации переименование =
+  переезд с 301, потеря позиций и ссылок — не делать.
+
+## 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`), лежит только локально.