@operstack/audit 0.19.3 → 0.21.0

package/README.md

@@ -130,6 +130,19 @@ Each sampled page is read for five things: does it open with an answer carrying
 
 The letter states the scope and the shares; `--price` adds the money, because a short page is sometimes short on purpose and an automatic invoice for rewriting it is an invoice for work that should not happen. Utility pages are excluded and counted separately: nobody rewrites a privacy policy to open with a figure. Sources are asked for only where the page actually carries figures. Without Search Console access the scope is built on a sitemap sample, and the letter says so rather than implying we picked the pages that matter.
 
+## The demand map: what people ask that the site has no page for
+
+Half of "why no enquiries" is usually the same answer: people ask questions the site never wrote a page for. `demand` builds that map for the audit tier.
+
+```
+npx @operstack/audit demand audit.json --lang ru --region 225 --attach
+npx @operstack/audit demand https://example.com --lang en --region 84 --dry
+```
+
+Three sources, each named in the output. The queries come from free Yandex and Google autocomplete: seeds are the site's own H1 and page titles (brand words removed, phrases cut before the first number), eight patterns per seed, and only phrases that carry a topic word of the site survive, because autocomplete is happy to carry "property investment" off to Dubai. Volumes come from Topvisor, our paid tool (`TOPVISOR_USER_ID` and `TOPVISOR_KEY` in the environment; `--dry` prices the run and launches nothing; about 0.02 RUB per query). Whether the site has a page for a query is a word match against every URL in the sitemap plus the titles of up to `--titles` of them (short URLs first), with Cyrillic and transliterated slugs brought to one form.
+
+The map is an appendix, page 11 of the report, and the sources table names Topvisor as paid and counted towards no score. The same text tells the buyer where to check the figures for free: Yandex Wordstat and the Google Ads Keyword Planner with their own account. A query without a volume says "no data", never 0. `--seeds "a; b"` overrides the automatic seeds when the analyst knows the niche better than the headings do; `--no-volumes` builds the map without numbers.
+
 ## Example
 
 `examples/sample-audit.json` is a complete, fictional audit of "Example Villas". `npm run sample` renders it to HTML and PDF next to the JSON.

package/bin/audit.mjs

@@ -30,6 +30,7 @@ import { buildFoundationScope, renderFoundationScope, renderFoundationChecklist
 import { draftNarrative, stillEmpty } from '../src/narrative.mjs';
 import { renderAgentPrompts, agentPrompts } from '../src/prompts.mjs';
 import { render, checkNarrative } from '../src/render.mjs';
+import { buildDemandMap, renderDemandMarkdown, demandCsv } from '../src/demand.mjs';
 import { resolveBranding } from '../src/agency.mjs';
 import { rank, readList, runBatch, runProspect, split, summarise, toCsv, toMarkdown } from '../src/batch.mjs';
 import { writeFileSync, readFileSync } from 'node:fs';
@@ -51,6 +52,10 @@ if (!cmd || cmd === '--help' || cmd === '-h') {
     '      fill the narrative from the checks: the analyst edits a draft instead of writing one',
     '  operstack-audit prompts <audit.json> [--lang ru|en] [--limit 3] [--out prompts.md]',
     '      every finding rewritten as a task you can paste into Cursor or Claude Code',
+    '  operstack-audit demand <url | audit.json> [--lang ru|en] [--region 225] [--seeds "a; b"] [--max 200] [--titles 120] [--dry] [--no-volumes] [--attach]',
+    '      what people in the niche ask and which of it the site has no page for; queries from free',
+    '      autocomplete, volumes from Topvisor (TOPVISOR_USER_ID and TOPVISOR_KEY in env, --dry only prices it),',
+    '      --attach writes the map into audit.json so render prints it as an appendix',
     '  operstack-audit check <audit.json>',
     '      list narrative fields still holding placeholders and any score the checks do not support',
     '',
@@ -164,6 +169,20 @@ if (cmd === 'collect') {
   writeFileSync(out, renderAgentPrompts(audit, { lang, limit }));
   console.log(`${list.length} task(s): ${list.filter((x) => x.hasOwnText).length} written for that finding, ${list.filter((x) => !x.hasOwnText).length} generic`);
   console.log(`wrote ${out}`);
+} else if (cmd === 'demand') {
+  const isAudit = /\.json$/i.test(target || '');
+  const audit = isAudit ? JSON.parse(readFileSync(resolve(target), 'utf8')) : null;
+  const url = isAudit ? audit.meta.site : target;
+  const lang = opt('--lang', audit?.meta?.lang || 'en') === 'ru' ? 'ru' : 'en';
+  const seeds = opt('--seeds', '') ? opt('--seeds').split(';').map((s) => s.trim()).filter(Boolean) : undefined;
+  const d = await buildDemandMap(url, { lang, region: opt('--region'), seeds, pages: audit?.sample, brand: audit?.client?.name || '', max: Number(opt('--max', 200)) || 200, titles: Number(opt('--titles', 120)), dry: has('--dry'), volumes: !has('--no-volumes'), log: console.log });
+  const base = resolve(opt('--out', (isAudit ? target.replace(/\.json$/i, '') : d.host) + '-demand'));
+  writeFileSync(`${base}.json`, JSON.stringify(d, null, 2));
+  writeFileSync(`${base}.md`, renderDemandMarkdown(d));
+  writeFileSync(`${base}.csv`, demandCsv(d));
+  if (audit && has('--attach')) { audit.demand = d; writeFileSync(resolve(target), JSON.stringify(audit, null, 2)); console.log(`attached to ${target}`); }
+  console.log(`${d.totals.queries} queries, ${d.totals.uncovered} without a page; volumes: ${d.volumes.source}${d.volumes.price !== null && d.volumes.price !== undefined ? `, ${d.volumes.price} RUB` : ''}${d.volumes.note ? ` (${d.volumes.note})` : ''}`);
+  console.log(`wrote ${base}.json, .md, .csv`);
 } else if (cmd === 'fix-plan') {
   const audit = JSON.parse(readFileSync(resolve(target), 'utf8'));
   // Язык покупки решает и валюту, и письмо: за доллары платят по английскому списку, за рубли по русскому.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@operstack/audit",
-  "version": "0.19.3",
+  "version": "0.21.0",
   "description": "SEO, AEO and GEO audit generator: collect public signals from a site into audit.json, let an analyst or an agent fill the narrative, render the OperStack report as HTML and PDF.",
   "type": "module",
   "license": "MIT",
@@ -16,7 +16,8 @@
     "./foundation": "./src/foundation.mjs",
     "./narrative": "./src/narrative.mjs",
     "./prompts": "./src/prompts.mjs",
-    "./rendered": "./src/rendered.mjs"
+    "./rendered": "./src/rendered.mjs",
+    "./demand": "./src/demand.mjs"
   },
   "files": [
     "bin",
@@ -28,7 +29,7 @@
     "LICENSE"
   ],
   "scripts": {
-    "test": "node src/test-scores.mjs && node src/test-fix.mjs && node src/test-foundation.mjs && node src/test-narrative.mjs && node src/test-prompts.mjs && node src/test-sitemap.mjs && node src/test-overall.mjs && node src/test-blocked.mjs && node src/test-unmeasured.mjs && node src/test-rendered.mjs && node src/test-agent-surface.mjs && node src/test-agency.mjs && node src/test-i18n.mjs examples/sample-audit.json && node bin/audit.mjs check examples/sample-audit.json && node bin/audit.mjs render examples/sample-audit.json --out /tmp/operstack-audit-sample.html",
+    "test": "node src/test-scores.mjs && node src/test-fix.mjs && node src/test-foundation.mjs && node src/test-narrative.mjs && node src/test-prompts.mjs && node src/test-sitemap.mjs && node src/test-overall.mjs && node src/test-blocked.mjs && node src/test-unmeasured.mjs && node src/test-rendered.mjs && node src/test-demand.mjs && node src/test-agent-surface.mjs && node src/test-agency.mjs && node src/test-i18n.mjs examples/sample-audit.json && node bin/audit.mjs check examples/sample-audit.json && node bin/audit.mjs render examples/sample-audit.json --out /tmp/operstack-audit-sample.html",
     "sample": "node bin/audit.mjs render examples/sample-audit.json --pdf",
     "verify:live": "node src/verify-live.mjs"
   },

package/src/demand.mjs

@@ -0,0 +1,506 @@
+/**
+ * Карта спроса: что люди в нише спрашивают на самом деле и под что у сайта нет страницы.
+ *
+ * Простым языком. Аудит отвечает на вопрос «почему не идут заявки», и половина ответа почти
+ * всегда одна: люди спрашивают не то, о чём написан сайт. Эта карта показывает три вещи.
+ * Какие запросы задают в нише: их даёт бесплатное автодополнение Яндекса и Google, то есть
+ * это фразы, которые люди уже набирали. Сколько раз в месяц их задают: частоты из Topvisor,
+ * нашего платного инструмента. И есть ли на сайте страница под каждый запрос: сопоставление
+ * по словам адреса и заголовка, оценка, а не чтение смысла, и так и подписано.
+ *
+ * Правило от 11 сентября: платные данные не входят ни в один балл. Карта спроса это пометка
+ * к отчёту, а не оценка, и рядом всегда написано, где покупатель проверит те же числа сам и
+ * бесплатно: Wordstat Яндекса и Планировщик ключевых слов Google, со своим аккаунтом.
+ *
+ * Ни одного числа, которого нет в источнике: запрос без частоты так и подписывается словами.
+ * Ни одного лишнего рубля: цена спрашивается до запуска и пишется в результат.
+ */
+import { parse } from 'node-html-parser';
+
+const UA = 'Mozilla/5.0 (compatible; OperStack demand map; +https://oper-stack.com)';
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+const clean = (s) => String(s || '').replace(/\s+/g, ' ').trim();
+
+export const DEMAND_DEFAULTS = { max: 200, delayMs: 150, pollMs: 15000, timeoutMs: 20 * 60000, seedsMax: 12, sitemapMax: 3000 };
+export const DEMAND_PROJECT = 'OperStack: карта спроса';
+
+/** Регионы, с которыми мы работаем: ключ Topvisor (он же id геобазы Яндекса) и страна для подсказок Google. */
+export const REGIONS = {
+  225: { ru: 'Россия', en: 'Russia', gl: 'ru', engine: 'yandex' },
+  213: { ru: 'Москва', en: 'Moscow', gl: 'ru', engine: 'yandex' },
+  2: { ru: 'Санкт-Петербург', en: 'Saint Petersburg', gl: 'ru', engine: 'yandex' },
+  84: { ru: 'США', en: 'United States', gl: 'us', engine: 'google' },
+  102: { ru: 'Великобритания', en: 'United Kingdom', gl: 'gb', engine: 'google' },
+  95: { ru: 'Канада', en: 'Canada', gl: 'ca', engine: 'google' },
+  211: { ru: 'Австралия', en: 'Australia', gl: 'au', engine: 'google' },
+  96: { ru: 'Германия', en: 'Germany', gl: 'de', engine: 'google' },
+  210: { ru: 'ОАЭ', en: 'United Arab Emirates', gl: 'ae', engine: 'google' },
+  246: { ru: 'Греция', en: 'Greece', gl: 'gr', engine: 'google' },
+  983: { ru: 'Турция', en: 'Turkey', gl: 'tr', engine: 'google' },
+  994: { ru: 'Индия', en: 'India', gl: 'in', engine: 'google' },
+  995: { ru: 'Таиланд', en: 'Thailand', gl: 'th', engine: 'google' },
+  10620: { ru: 'Бангкок', en: 'Bangkok', gl: 'th', engine: 'google' },
+};
+
+/** Шаблоны, которыми зерно превращается в вопросы. Порядок важен: сначала само зерно. */
+export const PATTERNS = {
+  ru: ['{q}', 'как {q}', 'сколько стоит {q}', 'где {q}', '{q} цена', '{q} отзывы', 'что такое {q}', '{q} или'],
+  en: ['{q}', 'how to {q}', '{q} cost', 'best {q}', 'what is {q}', '{q} price', '{q} near me', '{q} vs'],
+};
+
+// Служебные слова не участвуют в сопоставлении: «как купить квартиру в сочи» и страница
+// «купить квартиру в Сочи» это одна тема, слово «как» темы не меняет.
+const STOP = {
+  ru: new Set('и в во на с со к ко по о об от до из за для при не что как это или а но у же ли бы то еще сколько стоит где цена отзывы такое лучшие лучший какой какая какие чем про без купить продажа продать заказать стоимость'.split(' ')),
+  en: new Set('the a an and or of to in on for with at by from is are be it this that vs near me how what best cost price which who why when where do does can should my your buy purchase sale'.split(' ')),
+};
+
+// Адреса русских сайтов почти всегда в латинице (/kvartiry-v-sochi/), а запросы в кириллице.
+// Чтобы «квартиры в сочи» нашли свою страницу, слова приводятся к одной латинской основе:
+// транслитерация, схлопывание вариантов написания (kh и h, ts и c, y и i), первые пять букв.
+const TRANSLIT = { а: 'a', б: 'b', в: 'v', г: 'g', д: 'd', е: 'e', ж: 'zh', з: 'z', и: 'i', й: 'y', к: 'k', л: 'l', м: 'm', н: 'n', о: 'o', п: 'p', р: 'r', с: 's', т: 't', у: 'u', ф: 'f', х: 'h', ц: 'c', ч: 'ch', ш: 'sh', щ: 'sch', ъ: '', ы: 'y', ь: '', э: 'e', ю: 'yu', я: 'ya' };
+const canon = (w) => {
+  const latin = [...w].map((ch) => (TRANSLIT[ch] !== undefined ? TRANSLIT[ch] : ch)).join('');
+  const same = latin.replace(/shch/g, 'sch').replace(/kh/g, 'h').replace(/ts/g, 'c').replace(/[yj]/g, 'i').replace(/'/g, '');
+  return same.length > 5 ? same.slice(0, 5) : same;
+};
+
+/** Слова, по которым запрос сравнивается со страницей: без служебных, приведённые к одной основе. */
+export function tokens(s, lang = 'en') {
+  return [...new Set(String(s || '').toLowerCase().replace(/ё/g, 'е').replace(/[^a-zа-я0-9\s-]/g, ' ').split(/[\s-]+/)
+    .filter((w) => w.length >= 3 && !STOP.ru.has(w) && !STOP.en.has(w))
+    .map(canon))];
+}
+
+const SPLIT_TITLE = /\s[|·•–—-]\s|:|\||\.\s|\?|!/;
+const GENERIC = /^(главная|главная страница|home|home page|homepage|контакты|contact us|contacts|about us|о нас|о компании|blog|блог|news|новости|privacy policy|политика конфиденциальности)$/;
+// Призывы, мессенджеры и служебные пункты меню: это не темы ниши, а кнопки.
+const JUNK = /получит|подобрать|подборк|заказать|заказ|скачать|записаться|оставить|заявк|позвонить|написать|консультац|whatsapp|telegram|viber|vpn|\bmax\b|войти|вход|регистрац|login|sign in|sign up|contact|download|get a |book a |request|subscribe|подписаться|cookie|политика/i;
+const TAIL_STOP = new Set('в во на с со к ко по о об от до из за для при и или а но у the a an and or of to in on for with at by from'.split(' '));
+
+/**
+ * Зёрна: о чём сайт, по его же заголовкам. Слова бренда вырезаются, иначе подсказки
+ * будут про название компании, а не про нишу. Фраза режется перед первым числом («новые
+ * проекты на Пхукете от 4,6 млн» становится «новые проекты на Пхукете»), потому что цена
+ * и срок это не тема, а хвостовой предлог после обрезки отбрасывается.
+ */
+function brandWordsOf(pages, host, brand) {
+  const brandWords = new Set([
+    ...String(host || '').replace(/^www\./, '').split('.')[0].toLowerCase().split('-').filter((w) => w.length >= 3),
+    ...clean(brand).toLowerCase().split(/[\s|:]+/).filter((w) => w.length >= 2),
+  ]);
+  // Сегмент заголовка, который повторяется на нескольких страницах, это тоже бренд.
+  const segCount = new Map();
+  for (const p of pages || []) for (const seg of clean(p.title).toLowerCase().split(SPLIT_TITLE)) { const k = clean(seg); if (k) segCount.set(k, (segCount.get(k) || 0) + 1); }
+  for (const [seg, n] of segCount) if (n >= 2 && (pages || []).length >= 2) for (const w of seg.split(' ')) brandWords.add(w);
+  return brandWords;
+}
+
+/**
+ * Якоря: слова темы сайта из H1 и заголовков страниц, без бренда. Запрос без якоря в карту
+ * не попадает: автодополнение охотно уводит «инвестиции в недвижимость» в Дубай, а сайт про
+ * Камбоджу. Лучше меньше запросов, но все про этот сайт.
+ */
+export function anchorsFromPages(pages, { host = '', brand = '', lang = 'en' } = {}) {
+  const brandWords = brandWordsOf(pages, host, brand);
+  const brandTok = new Set([...brandWords].flatMap((w) => tokens(w, lang)));
+  const out = new Set();
+  for (const p of pages || []) for (const raw of [p.h1, p.title]) for (const words of segments(raw, brandWords)) {
+    for (const t of tokens(words.join(' '), lang)) if (!brandTok.has(t) && !UNITS.has(t)) out.add(t);
+  }
+  // Слова из имени домена это чаще ниша, чем бренд: invest-cambodia, florida-estate, greek-invest.
+  // Заголовок такого сайта может быть лозунгом без географии, и без этих слов якорей не остаётся.
+  // Склеенное имя без дефисов (moregroupestate, globalyachtguide) словом не является.
+  for (const w of String(host || '').replace(/^www\./, '').split('.')[0].toLowerCase().split('-')) {
+    if (w.length >= 4 && w.length <= 10 && !HOST_GENERIC.has(w)) for (const t of tokens(w, lang)) out.add(t);
+  }
+  return out;
+}
+const HOST_GENERIC = new Set(['www', 'shop', 'online', 'site', 'web', 'group', 'best', 'top', 'official', 'company', 'estate', 'invest', 'agency', 'media', 'blog', 'news']);
+
+// Единицы и сроки из заголовков («от 4,6 млн ₽», «за 2 часа») темы не задают.
+const UNITS = new Set(['mln', 'tys', 'rub', 'usd', 'eur', 'chas', 'chasa', 'chaso', 'minut', 'dnei', 'dnia', 'nedel', 'mesia', 'goda', 'let', 'hour', 'hours', 'days', 'weeks', 'month', 'years', 'min', 'max']);
+
+/** Сегменты заголовка словами: разделители, обрезка перед первым числом, хвостовой предлог и бренд долой. */
+function segments(raw, brandWords) {
+  const out = [];
+  for (const part of clean(raw).split(SPLIT_TITLE)) {
+    let words = clean(part).toLowerCase().replace(/[«»"()]/g, '').split(' ').filter(Boolean);
+    const firstDigit = words.findIndex((w) => /\d/.test(w));
+    if (firstDigit === 0) continue;
+    if (firstDigit > 0) words = words.slice(0, firstDigit);
+    while (words.length && TAIL_STOP.has(words[words.length - 1])) words.pop();
+    words = words.filter((w) => !brandWords.has(w) && /[a-zа-яё]/i.test(w));
+    if (words.length) out.push(words);
+  }
+  return out;
+}
+
+export function seedsFromPages(pages, { host = '', brand = '', lang = 'en', max = DEMAND_DEFAULTS.seedsMax } = {}) {
+  const brandWords = brandWordsOf(pages, host, brand);
+  const anchors = anchorsFromPages(pages, { host, brand, lang });
+  const seen = new Set(); const out = [];
+  const consider = (raw, anchored) => {
+    for (const words of segments(raw, brandWords)) {
+      const s = words.join(' ');
+      if (words.length < 2 || words.length > 7 || GENERIC.test(s) || JUNK.test(s) || seen.has(s)) continue;
+      const tok = tokens(s, lang);
+      if (tok.length < 2) continue;
+      // Подзаголовки и меню годятся в зёрна, только если держатся за тему: «гибкие планы
+      // оплаты» и «что изменилось» это лозунги, а не то, что люди ищут.
+      if (anchored && !tok.some((t) => anchors.has(t))) continue;
+      seen.add(s); out.push(s);
+    }
+  };
+  // Сначала H1 и заголовки страниц: это темы. Меню в конце: там чаще кнопки, чем темы.
+  for (const p of pages || []) consider(p.h1, false);
+  for (const p of pages || []) consider(p.title, false);
+  for (const p of pages || []) for (const h of p.h2 || []) consider(h, true);
+  for (const p of pages || []) for (const n of p.nav || []) consider(n, true);
+  return out.slice(0, max);
+}
+
+async function defaultFetchText(url) {
+  const res = await fetch(url, { headers: { 'user-agent': UA, accept: 'text/html,application/xml,text/plain,*/*' }, redirect: 'follow', signal: AbortSignal.timeout(20000) });
+  if (!res.ok) throw new Error(`HTTP ${res.status} for ${url}`);
+  return res.text();
+}
+async function defaultFetchJson(url) {
+  const res = await fetch(url, { headers: { 'user-agent': UA }, signal: AbortSignal.timeout(8000) });
+  if (!res.ok) throw new Error(`HTTP ${res.status} for ${url}`);
+  return JSON.parse(await res.text());
+}
+
+/** Главная как страница для зёрен: заголовок, H1, подзаголовки H2, пункты меню и бренд из og:site_name. */
+export async function homePage(url, { fetchText = defaultFetchText } = {}) {
+  const root = parse(await fetchText(url));
+  const text = (el) => clean(el ? el.text : '');
+  return {
+    url, title: text(root.querySelector('title')), h1: text(root.querySelector('h1')),
+    h2: root.querySelectorAll('h2').map(text).slice(0, 12),
+    nav: root.querySelectorAll('nav a, header a').map(text).filter((t) => t.split(' ').length >= 2).slice(0, 30),
+    brand: root.querySelector('meta[property="og:site_name"]')?.getAttribute('content') || '',
+  };
+}
+
+/** Зёрна с самой главной. */
+export async function seedsFromSite(url, { fetchText = defaultFetchText, host, max, lang } = {}) {
+  const page = await homePage(url, { fetchText });
+  return seedsFromPages([page], { host: host || new URL(url).host, brand: page.brand, max, lang });
+}
+
+/** Одна подсказка: что автодополнение предлагает на эту фразу. Оба ответа имеют вид [фраза, [варианты]]. */
+export async function suggest(q, { engine = 'google', lang = 'en', gl = 'us', lr = 225, fetchJson = defaultFetchJson } = {}) {
+  const url = engine === 'yandex'
+    ? `https://suggest.yandex.ru/suggest-ff.cgi?part=${encodeURIComponent(q)}&lr=${lr}`
+    : `https://suggestqueries.google.com/complete/search?client=firefox&hl=${lang}&gl=${gl}&q=${encodeURIComponent(q)}`;
+  const body = await fetchJson(url);
+  const list = Array.isArray(body) && Array.isArray(body[1]) ? body[1] : [];
+  return list.map((x) => (Array.isArray(x) ? x[0] : x)).map(clean).filter(Boolean);
+}
+
+/**
+ * Из зёрен в запросы. Каждое зерно прогоняется через шаблоны и подсказки; остаются фразы
+ * из двух и более слов, у которых есть общее слово с зерном (иначе автодополнение уводит
+ * в сторону). Квота делится поровну между зёрнами: ниша шире одного заголовка.
+ */
+export async function expandQueries(seeds, { lang = 'en', region = 84, max = DEMAND_DEFAULTS.max, delayMs = DEMAND_DEFAULTS.delayMs, fetchJson, engines, anchors = null } = {}) {
+  const ru = lang === 'ru';
+  const gl = REGIONS[region]?.gl || (ru ? 'ru' : 'us');
+  const use = engines || (ru ? ['yandex', 'google'] : ['google']);
+  const perSeed = new Map(); let calls = 0; let failed = 0;
+  for (const seed of seeds) {
+    const bag = new Set();
+    const seedTok = tokens(seed, lang);
+    const anchorSet = anchors && anchors.size !== undefined ? anchors : (anchors ? new Set(anchors) : null);
+    const add = (s) => {
+      const n = clean(s).toLowerCase();
+      if (!n || bag.has(n) || n.split(' ').length < 2) return;
+      const tok = tokens(n, lang);
+      if (!tok.some((t) => seedTok.includes(t))) return;
+      if (anchorSet && anchorSet.size && !tok.some((t) => anchorSet.has(t))) return;
+      bag.add(n);
+    };
+    add(seed);
+    for (const tpl of PATTERNS[ru ? 'ru' : 'en']) {
+      const q = tpl.replace('{q}', seed);
+      for (const engine of use) {
+        calls += 1;
+        try { for (const s of await suggest(q, { engine, lang: ru ? 'ru' : 'en', gl, lr: region, fetchJson })) add(s); } catch { failed += 1; }
+        if (delayMs) await sleep(delayMs);
+      }
+    }
+    perSeed.set(seed, [...bag]);
+  }
+  const out = []; const seen = new Set();
+  for (let i = 0, more = true; more && out.length < max; i++) {
+    more = false;
+    for (const list of perSeed.values()) {
+      if (i >= list.length) continue;
+      more = true;
+      if (!seen.has(list[i])) { seen.add(list[i]); out.push(list[i]); }
+      if (out.length >= max) break;
+    }
+  }
+  return { queries: out, calls, failed, engines: use, perSeed: Object.fromEntries([...perSeed].map(([k, v]) => [k, v.length])) };
+}
+
+/** Клиент Topvisor: JSON-вызов и импорт ключей формой. Без ключей возвращает null. */
+export function topvisorClient({ userId = process.env.TOPVISOR_USER_ID, key = process.env.TOPVISOR_KEY, base = 'https://api.topvisor.com/v2/json/', fetchFn = globalThis.fetch } = {}) {
+  if (!userId || !key) return null;
+  const headers = { 'User-Id': String(userId).trim(), Authorization: `bearer ${String(key).trim()}` };
+  const unwrap = async (res, method) => {
+    const body = await res.json().catch(() => ({}));
+    if (body.errors && body.errors.length) throw new Error(`Topvisor ${method}: ${body.errors.map((e) => e.string || e.code).join('; ')}`);
+    return body.result;
+  };
+  return {
+    async call(method, body = {}) {
+      const res = await fetchFn(base + method, { method: 'POST', headers: { ...headers, 'Content-Type': 'application/json' }, body: JSON.stringify(body), signal: AbortSignal.timeout(60000) });
+      return unwrap(res, method);
+    },
+    async importKeywords(projectId, groupId, keywords) {
+      const boundary = `----operstack${Date.now()}`;
+      const part = (name, value) => `--${boundary}\r\nContent-Disposition: form-data; name="${name}"\r\n\r\n${value}\r\n`;
+      const body = part('project_id', projectId) + part('group_id', groupId) + part('keywords', keywords.join('\n')) + `--${boundary}--\r\n`;
+      const res = await fetchFn(`${base}add/keywords_2/keywords/import`, { method: 'POST', headers: { ...headers, 'Content-Type': `multipart/form-data; boundary=${boundary}` }, body, signal: AbortSignal.timeout(120000) });
+      return unwrap(res, 'add/keywords_2/keywords/import');
+    },
+  };
+}
+
+/**
+ * Частоты через Topvisor. Проект один на все карты, группа на каждый прогон. Порядок:
+ * проект, поисковик и регион в нём, группа, импорт, цена, запуск, опрос до заполнения.
+ * `dry` останавливается после цены: видно, сколько это стоит, и ничего не списано.
+ */
+export async function volumesViaTopvisor(queries, { lang = 'en', region = 84, engine, type, client, projectName = DEMAND_PROJECT, groupName, dry = false, pollMs = DEMAND_DEFAULTS.pollMs, timeoutMs = DEMAND_DEFAULTS.timeoutMs, log = () => {}, now = Date.now } = {}) {
+  const eng = engine || REGIONS[region]?.engine || (lang === 'ru' ? 'yandex' : 'google');
+  const searcher = eng === 'yandex' ? 0 : 1;
+  const vtype = type || (eng === 'yandex' ? 1 : 3);
+  const field = `volume:${region}:${searcher}:${vtype}`;
+  const result = { source: 'Topvisor', engine: eng, region: Number(region), type: vtype, price: null, currency: 'RUB', asked: queries.length, filled: 0, volumes: {}, projectId: null, groupId: null, launched: false, note: '' };
+  if (!client) { result.source = 'none'; result.note = 'no credentials'; return result; }
+  if (!queries.length) { result.note = 'no queries'; return result; }
+
+  const list = async () => (await client.call('get/projects_2/projects', { fields: ['id', 'name'], limit: 1000 })) || [];
+  let project = (await list()).find((p) => p.name === projectName);
+  if (!project) { await client.call('add/projects_2/projects', { url: 'oper-stack.com', name: projectName }); project = (await list()).find((p) => p.name === projectName); }
+  if (!project) throw new Error('Topvisor: проект для карты спроса не создался');
+  result.projectId = project.id;
+
+  // Поисковик и регион в проекте: без них частоты не запускаются. «Уже есть» не ошибка.
+  const soft = async (method, body) => { try { await client.call(method, body); } catch (e) { if (!/уже|already|exist|существ/i.test(e.message)) log(`  ${e.message}`); } };
+  await soft('add/positions_2/searchers', { project_id: project.id, searcher_key: searcher });
+  await soft('add/positions_2/searchers/regions', { project_id: project.id, searcher_key: searcher, region_key: Number(region), region_lang: lang === 'ru' ? 'ru' : 'en', region_device: 0, region_depth: 1 });
+  const [prj] = (await client.call('get/projects_2/projects', { fields: ['id'], show_searchers_and_regions: 1, filters: [{ name: 'id', operator: 'EQUALS', values: [project.id] }] })) || [];
+  const haveRegion = (prj?.searchers || []).some((s) => Number(s.key) === searcher && (s.regions || []).some((r) => Number(r.key) === Number(region)));
+  if (!haveRegion) throw new Error(`Topvisor: регион ${region} для поисковика ${eng} не добавился в проект`);
+
+  const gname = groupName || `${new Date().toISOString().slice(0, 10)} ${region}`;
+  await client.call('add/keywords_2/groups', { project_id: project.id, name: [gname] }).catch(() => client.call('add/keywords_2/groups', { project_id: project.id, names: [gname] }));
+  const groups = (await client.call('get/keywords_2/groups', { project_id: project.id, fields: ['id', 'name'], limit: 1000 })) || [];
+  const group = [...groups].reverse().find((g) => g.name === gname);
+  if (!group) throw new Error('Topvisor: группа не создалась');
+  result.groupId = group.id;
+  await client.importKeywords(project.id, group.id, queries);
+
+  const filters = [{ name: 'group_id', operator: 'EQUALS', values: [group.id] }];
+  const q = { project_id: project.id, qualifiers: [{ region_key: Number(region), searcher_key: searcher, type: vtype }], target_type: 'keywords', filters };
+  const priceRes = await client.call('get/keywords_2/volumes/price', q);
+  const p = priceRes && priceRes.pricesByUsers ? Object.values(priceRes.pricesByUsers)[0] : null;
+  result.price = p && Number.isFinite(Number(p.price)) ? Number(p.price) : null;
+  log(`  Topvisor: ${queries.length} запросов, ${eng}, регион ${region}, цена ${result.price === null ? 'неизвестна' : `${result.price} ₽`}`);
+  if (dry) { result.note = 'dry run: not launched'; return result; }
+
+  await client.call('edit/keywords_2/volumes/go', q);
+  result.launched = true;
+  const started = now();
+  for (;;) {
+    const rows = (await client.call('get/keywords_2/keywords', { project_id: project.id, fields: ['name', field], filters, limit: 10000 })) || [];
+    const vols = {}; let filled = 0;
+    for (const r of rows) { const v = r[field]; if (v !== null && v !== undefined && v !== '') { vols[clean(r.name).toLowerCase()] = Number(v); filled += 1; } }
+    result.volumes = vols; result.filled = filled;
+    if (rows.length && filled >= rows.length) break;
+    if (now() - started > timeoutMs) { result.note = `timeout: ${filled} of ${rows.length}`; break; }
+    await sleep(pollMs);
+  }
+  return result;
+}
+
+/** Все адреса из карт сайта, чтобы было с чем сопоставлять запросы. Только адреса: заголовков у нас нет. */
+export async function sitemapPages(url, { fetchText = defaultFetchText, max = DEMAND_DEFAULTS.sitemapMax } = {}) {
+  const origin = new URL(url).origin;
+  const robots = await fetchText(`${origin}/robots.txt`).catch(() => '');
+  const listed = [...robots.matchAll(/^sitemap:\s*(\S+)/gim)].map((m) => m[1]);
+  const queue = listed.length ? listed : [`${origin}/sitemap.xml`, `${origin}/sitemap_index.xml`];
+  const urls = new Set(); const seen = new Set(); let files = 0;
+  while (queue.length && urls.size < max && files < 30) {
+    const u = queue.shift();
+    if (seen.has(u)) continue;
+    seen.add(u); files += 1;
+    const xml = await fetchText(u).catch(() => '');
+    if (!xml) continue;
+    const locs = [...xml.matchAll(/<loc>\s*([^<\s]+)\s*<\/loc>/gi)].map((m) => m[1]);
+    if (/<sitemapindex/i.test(xml)) queue.push(...locs);
+    else for (const l of locs) { if (urls.size >= max) break; urls.add(l); }
+  }
+  return [...urls].map((u) => ({ url: u, title: '', h1: '' }));
+}
+
+/**
+ * Заголовки для адресов из карты сайта. Адреса русских сайтов часто английские (/districts/),
+ * а запросы русские, и по одному адресу «районы пхукета» свою страницу не найдут. Заголовок
+ * страницы написан на языке сайта, поэтому дочитываем его для первых `max` адресов, начиная
+ * с коротких: разделы важнее глубоких карточек. Страница не ответила, значит остаётся адрес.
+ */
+export async function enrichTitles(pages, { fetchText = defaultFetchText, max = 120, concurrency = 4 } = {}) {
+  const depth = (u) => { try { return new URL(u).pathname.split('/').filter(Boolean).length; } catch { return 99; } };
+  const todo = (pages || []).filter((p) => p && p.url && !p.title && !p.h1).sort((a, b) => depth(a.url) - depth(b.url) || a.url.length - b.url.length).slice(0, Math.max(0, max));
+  let i = 0; let done = 0;
+  const worker = async () => {
+    while (i < todo.length) {
+      const p = todo[i++];
+      try {
+        const root = parse(await fetchText(p.url));
+        p.title = clean(root.querySelector('title')?.text); p.h1 = clean(root.querySelector('h1')?.text);
+        if (p.title || p.h1) done += 1;
+      } catch { /* остаётся адрес */ }
+    }
+  };
+  await Promise.all(Array.from({ length: Math.max(1, concurrency) }, worker));
+  return done;
+}
+
+const pageTokens = (p, lang) => {
+  let path = '';
+  try { path = decodeURIComponent(new URL(p.url).pathname); } catch { path = String(p.url || ''); }
+  return new Set(tokens(`${path.replace(/[/_.]+/g, ' ')} ${p.title || ''} ${p.h1 || ''}`, lang));
+};
+
+/** Есть ли под запрос страница: все значимые слова запроса встречаются в адресе или заголовке одной страницы. */
+export function coverage(queries, pages, { lang = 'en' } = {}) {
+  const index = (pages || []).filter((p) => p && p.url).map((p) => ({ url: p.url, tok: pageTokens(p, lang) }));
+  return queries.map((q) => {
+    const qt = tokens(q, lang);
+    if (!qt.length) return { q, covered: false, url: null };
+    const hit = index.find((p) => qt.every((t) => p.tok.has(t)));
+    return { q, covered: Boolean(hit), url: hit ? hit.url : null };
+  });
+}
+
+export function demandTotals(queries) {
+  const known = queries.filter((q) => q.volume !== null && q.volume !== undefined);
+  const sum = (l) => l.reduce((a, q) => a + (Number(q.volume) || 0), 0);
+  return {
+    queries: queries.length, withVolume: known.length,
+    covered: queries.filter((q) => q.covered).length, uncovered: queries.filter((q) => !q.covered).length,
+    volumeTotal: sum(known), volumeCovered: sum(known.filter((q) => q.covered)), volumeUncovered: sum(known.filter((q) => !q.covered)),
+  };
+}
+
+/**
+ * Вся карта одним вызовом. Страницы можно передать из audit.json (`sample`), тогда зёрна
+ * берутся из их заголовков; иначе читается главная. Адреса для сопоставления всегда
+ * дочитываются из карт сайта.
+ */
+export async function buildDemandMap(url, opts = {}) {
+  const { lang = 'en', region: regionIn, seeds: seedsIn, pages: pagesIn, max, dry = false, volumes = true, client = topvisorClient(), fetchText = defaultFetchText, fetchJson = defaultFetchJson, log = () => {}, engines, delayMs, pollMs, timeoutMs, groupName, now, titles = 120, brand = '' } = opts;
+  const region = Number(regionIn) || (lang === 'ru' ? 225 : 84);
+  const host = new URL(url).host.replace(/^www\./, '');
+  log(`карта спроса: ${host}, язык ${lang}, регион ${region} (${REGIONS[region]?.[lang] || region})`);
+  const pages = pagesIn && pagesIn.length ? pagesIn : [await homePage(url, { fetchText })];
+  const brandName = brand || pages.find((p) => p.brand)?.brand || '';
+  const seeds = seedsIn && seedsIn.length ? seedsIn.map(clean).filter(Boolean) : seedsFromPages(pages, { host, brand: brandName, lang });
+  const anchors = anchorsFromPages(pages, { host, brand: brandName, lang });
+  for (const sd of seedsIn || []) for (const t of tokens(sd, lang)) anchors.add(t);
+  log(`  зёрна (${seeds.length}): ${seeds.join('; ')}`);
+  log(`  якорные слова темы (${anchors.size}): ${[...anchors].join(', ')}`);
+  const exp = await expandQueries(seeds, { lang, region, max, fetchJson, engines, anchors, delayMs: delayMs ?? DEMAND_DEFAULTS.delayMs });
+  log(`  запросов: ${exp.queries.length} из ${exp.calls} обращений к подсказкам, не ответили ${exp.failed}`);
+  const fromSitemap = await sitemapPages(url, { fetchText }).catch(() => []);
+  const known = new Set((pagesIn || []).map((p) => p.url));
+  const extra = fromSitemap.filter((p) => !known.has(p.url));
+  const titled = titles ? await enrichTitles(extra, { fetchText, max: titles }) : 0;
+  log(`  страниц для сопоставления: ${(pagesIn || []).length + extra.length}, заголовков дочитано ${titled}`);
+  const sitePages = [...(pagesIn || []), ...extra];
+  const cov = coverage(exp.queries, sitePages, { lang });
+  let vol = { source: 'none', engine: null, type: null, volumes: {}, price: null, currency: 'RUB', filled: 0, asked: exp.queries.length, note: volumes ? 'no credentials' : 'volumes off', projectId: null, groupId: null };
+  if (volumes && exp.queries.length) vol = await volumesViaTopvisor(exp.queries, { lang, region, client, dry, log, pollMs, timeoutMs, now, groupName: groupName || `${host} ${new Date().toISOString().slice(0, 10)}` });
+  const queries = cov.map((c) => ({ q: c.q, volume: vol.volumes[c.q.toLowerCase()] ?? null, covered: c.covered, url: c.url }))
+    .sort((a, b) => ((b.volume ?? -1) - (a.volume ?? -1)) || a.q.localeCompare(b.q));
+  return {
+    host, url, lang: lang === 'ru' ? 'ru' : 'en', region, regionName: REGIONS[region]?.[lang === 'ru' ? 'ru' : 'en'] || String(region), collectedAt: new Date().toISOString(),
+    seeds, anchors: [...anchors], discovery: { calls: exp.calls, failed: exp.failed, engines: exp.engines }, pagesIndexed: sitePages.length, titlesRead: titled,
+    volumes: { source: vol.source, engine: vol.engine, type: vol.type, price: vol.price, currency: vol.currency || 'RUB', filled: vol.filled, asked: vol.asked, note: vol.note || '', projectId: vol.projectId, groupId: vol.groupId },
+    queries, totals: demandTotals(queries),
+  };
+}
+
+const esc = (s) => String(s ?? '').replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;');
+const fmt = (n, lang) => Number(n).toLocaleString(lang === 'ru' ? 'ru-RU' : 'en-US');
+const pathOf = (u) => { try { const x = new URL(u); return x.pathname + x.search; } catch { return String(u || ''); } };
+
+const COPY = {
+  ru: {
+    title: 'Карта спроса', eyebrow: 'Спрос',
+    lead: (d) => `Что люди в этой нише спрашивают на самом деле и есть ли у сайта страница под каждый вопрос. Запросы взяты из подсказок ${d.discovery?.engines?.includes('yandex') ? 'Яндекса и Google' : 'Google'}: это фразы, которые люди уже набирали. ${d.volumes.source === 'Topvisor' ? `Частота это сколько раз в месяц запрос задают в регионе «${d.regionName}», по данным Topvisor.` : 'Частоты для этой карты не собирались, поэтому доли считаются по числу запросов.'} Столбец «Страница» показывает, нашлась ли на сайте страница, в адресе или заголовке которой есть все слова запроса: это оценка по словам, а не чтение смысла.`,
+    cells: { queries: 'Запросов', covered: 'Есть страница', uncovered: 'Нет страницы', share: 'Спрос без страницы' },
+    verdict: (t) => (t.volumeTotal > 0
+      ? `Под ${t.uncovered} запросов из ${t.queries} у сайта нет страницы. По частотам это ${Math.round(t.volumeUncovered / t.volumeTotal * 100)} % спроса ниши (${fmt(t.volumeUncovered, 'ru')} из ${fmt(t.volumeTotal, 'ru')} запросов в месяц), который сейчас проходит мимо сайта.`
+      : `Под ${t.uncovered} запросов из ${t.queries} у сайта нет страницы: ${t.queries ? Math.round(t.uncovered / t.queries * 100) : 0} % найденных вопросов ниши.`),
+    cols: { q: 'Запрос', v: 'В месяц', p: 'Страница' }, noVolume: 'нет данных', noPage: 'нет',
+    more: (n) => `Ещё ${n} запросов в приложении к отчёту (файл карты спроса).`,
+    empty: 'Подсказки не дали ни одного запроса по заголовкам этого сайта. Так бывает у сайтов без содержательных заголовков: сначала нужны страницы с темами, потом карта.',
+    source: (d) => `Откуда числа. Запросы: автодополнение ${d.discovery?.engines?.includes('yandex') ? 'Яндекса и Google' : 'Google'}, бесплатно, без аккаунта. ${d.volumes.source === 'Topvisor' ? 'Частоты: Topvisor, платный инструмент OperStack; в баллы отчёта они не входят. ' : ''}Проверить самому и бесплатно: Яндекс Wordstat (wordstat.yandex.ru) и Планировщик ключевых слов Google Ads, со своим бесплатным аккаунтом. Числа там могут отличаться на округление и дату сбора.`,
+  },
+  en: {
+    title: 'Demand map', eyebrow: 'Demand',
+    lead: (d) => `What people in this niche actually ask, and whether the site has a page for each question. The queries come from ${d.discovery?.engines?.includes('yandex') ? 'Yandex and Google' : 'Google'} autocomplete: phrases people have already typed. ${d.volumes.source === 'Topvisor' ? `Volume is how many times a month the query is searched in ${d.regionName}, according to Topvisor.` : 'Volumes were not collected for this map, so the shares are counted by number of queries.'} The "Page" column says whether a page on the site carries every word of the query in its address or title: a word match, not a reading of meaning.`,
+    cells: { queries: 'Queries', covered: 'Has a page', uncovered: 'No page', share: 'Demand without a page' },
+    verdict: (t) => (t.volumeTotal > 0
+      ? `${t.uncovered} of ${t.queries} queries have no page on the site. By volume that is ${Math.round(t.volumeUncovered / t.volumeTotal * 100)}% of the niche's demand (${fmt(t.volumeUncovered, 'en')} of ${fmt(t.volumeTotal, 'en')} searches a month) passing the site by.`
+      : `${t.uncovered} of ${t.queries} queries have no page on the site: ${t.queries ? Math.round(t.uncovered / t.queries * 100) : 0}% of the questions found in the niche.`),
+    cols: { q: 'Query', v: 'A month', p: 'Page' }, noVolume: 'no data', noPage: 'none',
+    more: (n) => `${n} more queries in the report appendix (the demand map file).`,
+    empty: 'Autocomplete returned no queries for this site\'s headings. That happens on sites without descriptive headings: pages with topics come first, the map after.',
+    source: (d) => `Where the numbers come from. Queries: ${d.discovery?.engines?.includes('yandex') ? 'Yandex and Google' : 'Google'} autocomplete, free, no account. ${d.volumes.source === 'Topvisor' ? 'Volumes: Topvisor, a paid tool OperStack pays for; they count towards no score in this report. ' : ''}Check it yourself for free: Yandex Wordstat (wordstat.yandex.ru) and the Google Ads Keyword Planner, with your own free account. Their figures may differ by rounding and by the date of collection.`,
+  },
+};
+
+/** Тело раздела для отчёта: цифры, вывод, таблица, откуда данные. Обёртку страницы даёт отчёт. */
+export function renderDemandHtml(d, { lang = d.lang, limit = 40 } = {}) {
+  const L = COPY[lang === 'ru' ? 'ru' : 'en'];
+  const t = d.totals || demandTotals(d.queries || []);
+  if (!t.queries) return `<p>${esc(L.lead(d))}</p><p>${esc(L.empty)}</p><p class="scorecard-foot">${esc(L.source(d))}</p>`;
+  const share = t.volumeTotal > 0 ? `${Math.round(t.volumeUncovered / t.volumeTotal * 100)} %` : `${Math.round(t.uncovered / t.queries * 100)} %`;
+  const cells = [[L.cells.queries, t.queries], [L.cells.covered, t.covered], [L.cells.uncovered, t.uncovered], [L.cells.share, share]]
+    .map(([k, v]) => `<div class="kpi"><div class="kpi-value">${esc(v)}</div><div class="kpi-label">${esc(k)}</div></div>`).join('');
+  const rows = (d.queries || []).slice(0, limit).map((q) => `<tr><td>${esc(q.q)}</td><td class="num">${q.volume === null || q.volume === undefined ? esc(L.noVolume) : fmt(q.volume, lang)}</td><td>${q.covered ? esc(pathOf(q.url)) : `<span class="status-bad">${esc(L.noPage)}</span>`}</td></tr>`).join('');
+  const rest = Math.max(0, (d.queries || []).length - limit);
+  return `<p>${esc(L.lead(d))}</p><div class="kpis">${cells}</div><div class="verdict"><p><strong>${esc(L.verdict(t))}</strong></p></div><table><tr><th>${esc(L.cols.q)}</th><th class="num">${esc(L.cols.v)}</th><th>${esc(L.cols.p)}</th></tr>${rows}</table>${rest ? `<p class="scorecard-foot">${esc(L.more(rest))}</p>` : ''}<p class="scorecard-foot">${esc(L.source(d))}</p>`;
+}
+
+/** Та же карта текстом: для файла рядом с отчётом и для письма. */
+export function renderDemandMarkdown(d, { lang = d.lang, limit = 200 } = {}) {
+  const L = COPY[lang === 'ru' ? 'ru' : 'en'];
+  const t = d.totals || demandTotals(d.queries || []);
+  const head = [`# ${L.title}: ${d.host}`, '', L.lead(d), ''];
+  if (!t.queries) return [...head, L.empty, '', L.source(d)].join('\n');
+  const table = [`| ${L.cols.q} | ${L.cols.v} | ${L.cols.p} |`, '|---|---:|---|', ...(d.queries || []).slice(0, limit).map((q) => `| ${q.q} | ${q.volume === null || q.volume === undefined ? L.noVolume : fmt(q.volume, lang)} | ${q.covered ? pathOf(q.url) : L.noPage} |`)];
+  return [...head, `**${L.verdict(t)}**`, '', ...table, '', L.source(d)].join('\n');
+}
+
+/** Строка для таблицы источников отчёта: карта спроса названа платной и не входящей в балл. */
+export function demandSourceRow(d, lang = d.lang) {
+  const ru = lang === 'ru';
+  if (d.volumes?.source === 'Topvisor') {
+    return { name: ru ? 'Topvisor (частоты для карты спроса)' : 'Topvisor (volumes for the demand map)', access: ru ? 'Платный инструмент, в баллы не входит' : 'Paid tool, counts towards no score', detail: ru ? `частоты ${d.totals?.withVolume ?? 0} запросов в регионе «${d.regionName}»; сами запросы из бесплатных подсказок` : `volumes for ${d.totals?.withVolume ?? 0} queries in ${d.regionName}; the queries themselves come from free autocomplete` };
+  }
+  return { name: ru ? 'Подсказки поиска (карта спроса)' : 'Search autocomplete (demand map)', access: ru ? 'Бесплатно, без аккаунта' : 'Free, no account needed', detail: ru ? `${d.totals?.queries ?? 0} запросов; частоты не собирались` : `${d.totals?.queries ?? 0} queries; no volumes collected` };
+}
+
+export function demandCsv(d) {
+  const line = (a) => a.map((x) => `"${String(x ?? '').replace(/"/g, '""')}"`).join(',');
+  return [line(['query', 'volume', 'has_page', 'url']), ...(d.queries || []).map((q) => line([q.q, q.volume ?? '', q.covered ? 1 : 0, q.url || '']))].join('\n');
+}

package/src/index.mjs

@@ -6,4 +6,5 @@ export { localiseChecks, localiseBasisNote, untranslated, AREAS_RU } from './i18
 export { buildFixPlan, renderFixPlan, renderFixChecklist, buildFixReport, renderFixReport, FIX_ACTIONS } from './fix.mjs';
 export { buildFoundationScope, renderFoundationScope, renderFoundationChecklist } from './foundation.mjs';
 export { draftNarrative, stillEmpty } from './narrative.mjs';
-export { agentPrompt, agentPrompts, renderAgentPrompts } from './prompts.mjs';
+export { agentPrompt, agentPrompts, renderAgentPrompts, firstFixParts, FIRST_FIX_IDS } from './prompts.mjs';
+export { buildDemandMap, expandQueries, coverage, seedsFromPages, volumesViaTopvisor, topvisorClient, renderDemandHtml, renderDemandMarkdown, demandSourceRow, demandCsv, demandTotals, REGIONS as DEMAND_REGIONS, DEMAND_DEFAULTS } from './demand.mjs';

package/src/prompts.mjs

@@ -174,3 +174,84 @@ export function renderAgentPrompts(audit, opts = {}) {
        'You do not need to know any code. Your job is to say what to do and look at the result.', ''];
   return [intro.join('\n').trimEnd(), ...list.map((x) => x.text)].join('\n\n');
 }
+
+/**
+ * Первая правка на бесплатной странице тремя частями: что сейчас, что поменять, как проверить.
+ *
+ * Зачем: бесплатная проверка (`checkVisibility`) отдаёт находки как { id, area, text }, а
+ * задания выше написаны по строкам аудита с другими ключами (`llms` против `llms-missing`).
+ * Страница показывала только текст находки, а три части приходили лишь письмом. Здесь каждая
+ * находка бесплатной проверки сопоставлена с заданием явно, по одному ключу на id; для находок,
+ * у которых задания в наборе нет, текст написан тут же. Неизвестный id даёт null: страница
+ * тогда честно показывает одну находку, а не чужое указание по чужому сайту.
+ *
+ * «Сейчас» это сам текст находки: он уже измерен и назван, второй раз не формулируем.
+ */
+const FIRST_FIX_BY_PROMPT = {
+  'robots-all-blocked': 'robots',
+  'robots-fetchers-blocked': 'ai-search-access',
+  'llms-missing': 'llms',
+  'canonical-missing': 'canonical',
+  'og-missing': 'og',
+  'schema-org-missing': 'schema',
+  'schema-faq-missing': 'faq-schema',
+  'dates-missing': 'dates',
+  'answer-first-missing': 'answer-first',
+  'sources-missing': 'sources',
+  'thin-pages': 'thin',
+};
+
+const FIRST_FIX_OWN = {
+  'robots-training-blocked': {
+    ru: { task: 'Реши, хочешь ли ты, чтобы модели ИИ учились на сайте. Если да, убери из robots.txt запреты для обучающих роботов, которые названы в строке «Сейчас». Если нет, оставь как есть: это осознанный выбор, а не ошибка, и балл он снижает немного.', verify: 'В robots.txt для названных обучающих роботов нет строки Disallow, либо решение закрыть их записано владельцем словами.' },
+    en: { task: 'Decide whether you want AI models to learn from the site. If yes, remove the robots.txt rules that block the training crawlers named under Now. If no, leave it: that is a deliberate choice, not a mistake, and it costs only a little of the score.', verify: 'robots.txt has no Disallow for the training crawlers named, or the decision to keep them out is written down by the owner.' },
+  },
+  'noai-meta': {
+    ru: { task: 'На одной из страниц стоит мета-тег robots со значением noai: он просит системы ИИ не использовать содержимое. Если хочешь, чтобы сайт цитировали в ответах, убери это значение из шаблона страниц. Если это осознанный запрет, оставь.', verify: 'В HTML проверенных страниц нет мета-тега robots со значением noai.' },
+    en: { task: 'One of the pages carries a robots meta tag with the value noai: it asks AI systems not to use the content. If you want the site quoted in answers, remove that value from the page template. If the ban is deliberate, leave it.', verify: 'The HTML of the sampled pages has no robots meta tag with the value noai.' },
+  },
+  'llms-foreign': {
+    ru: { task: 'Перепиши llms.txt так, чтобы ссылки в нём вели на страницы этого сайта, а не на чужие домены. Чужую ссылку оставь только там, где без неё нельзя (например, профиль в каталоге), и не в начале файла.', verify: 'Большинство ссылок в llms.txt ведут на этот же домен, и первые из них тоже.' },
+    en: { task: 'Rewrite llms.txt so its links point at pages of this site rather than other domains. Keep an outside link only where it cannot be avoided (a directory profile, say), and never at the top of the file.', verify: 'Most links in llms.txt point at this domain, and so do the first ones.' },
+  },
+  'llms-not-text': {
+    ru: { task: 'Адрес /llms.txt отдаёт HTML-страницу вместо текста. Сделай так, чтобы по этому адресу отдавался сам текстовый файл с типом text/plain, а не страница сайта и не заглушка «не найдено» с кодом 200.', verify: '/llms.txt отвечает кодом 200 с типом text/plain, и в ответе текстовый указатель, а не разметка HTML.' },
+    en: { task: '/llms.txt serves an HTML page instead of text. Make that address return the text file itself with the type text/plain, not a site page and not a "not found" page with a 200 status.', verify: '/llms.txt answers 200 with text/plain, and the body is a text index rather than HTML markup.' },
+  },
+  'schema-article-missing': {
+    ru: { task: 'Добавь на страницы статей и записей разметку Article или BlogPosting в JSON-LD: заголовок, дата публикации, дата изменения, автор, издатель. Бери данные со страницы, ничего не придумывай.', verify: 'На странице статьи есть JSON-LD с типом Article или BlogPosting, и проверка разметки не показывает ошибок.' },
+    en: { task: 'Add Article or BlogPosting markup in JSON-LD to the article pages: headline, date published, date modified, author, publisher. Take the data from the page, invent nothing.', verify: 'An article page carries JSON-LD of type Article or BlogPosting and the markup validator shows no errors.' },
+  },
+  'few-h2': {
+    ru: { task: 'Разбей длинные страницы на разделы: каждый начинается заголовком H2, который звучит как вопрос или тема раздела. На странице должно быть не меньше трёх таких разделов. Ради объёма ничего не дописывай, только структурируй то, что есть.', verify: 'На каждой проверенной странице не меньше трёх заголовков H2, и по ним понятно, о чём страница, без чтения текста.' },
+    en: { task: 'Split the long pages into sections, each opening with an H2 that reads as the question or topic of that section. A page needs at least three. Add nothing for length, only structure what is there.', verify: 'Every sampled page has at least three H2 headings, and they alone tell what the page is about.' },
+  },
+  'no-tables': {
+    ru: { task: 'Там, где на странице есть цифры, которые сравнивают (цены, сроки, площади, условия), собери их в таблицу с подписанными столбцами. Строй её только из данных, которые уже есть на странице или у владельца.', verify: 'На страницах со сравниваемыми цифрами есть хотя бы одна настоящая таблица (тег table), а не картинка и не список.' },
+    en: { task: 'Where a page has figures that get compared (prices, timings, areas, terms), put them in a table with labelled columns. Build it only from data already on the page or held by the owner.', verify: 'Pages with comparable figures carry at least one real table (a table tag), not an image and not a list.' },
+  },
+  'sitemap-no-lastmod': {
+    ru: { task: 'Проставь в карте сайта (sitemap.xml) каждой странице поле lastmod с настоящей датой последнего изменения содержимого. Дату сборки или сегодняшнее число во все строки не ставь: это хуже, чем пустое поле.', verify: 'У каждого url в sitemap.xml есть lastmod, даты различаются между страницами и совпадают с датой изменения на самой странице.' },
+    en: { task: 'Give every page in sitemap.xml a lastmod with the real date its content last changed. Do not stamp the build date or today on every line: that is worse than leaving it empty.', verify: 'Every url in sitemap.xml has a lastmod, the dates differ between pages and match the modified date on the page itself.' },
+  },
+};
+
+/** Все id находок бесплатной проверки, для которых есть три части. */
+export const FIRST_FIX_IDS = [...Object.keys(FIRST_FIX_BY_PROMPT), ...Object.keys(FIRST_FIX_OWN)];
+
+/**
+ * @param {{id?: string, area?: string, text?: string}} finding элемент `fixes[]` из `checkVisibility`
+ * @param {{lang?: 'ru'|'en'}} opts
+ * @returns {{now: string, task: string, verify: string, rule: string, labels: {now: string, task: string, verify: string}}|null}
+ */
+export function firstFixParts(finding, opts = {}) {
+  const lang = opts.lang === 'ru' ? 'ru' : 'en';
+  const h = HEAD[lang];
+  const id = finding && finding.id;
+  const now = String((finding && finding.text) || '').trim();
+  if (!id || !now) return null;
+  const own = FIRST_FIX_OWN[id] ? withLang(FIRST_FIX_OWN[id], lang)
+    : (FIRST_FIX_BY_PROMPT[id] && P[FIRST_FIX_BY_PROMPT[id]] ? withLang(P[FIRST_FIX_BY_PROMPT[id]], lang) : null);
+  if (!own || !own.task || !own.verify) return null;
+  return { now, task: own.task, verify: own.verify, rule: h.rule, labels: { now: h.now, task: h.task, verify: h.verify } };
+}

package/src/render.mjs

@@ -11,6 +11,7 @@ import { computeScores, computeOverall } from './collect.mjs';
 import { localiseBasisNote, AREAS_RU } from './i18n.mjs';
 import { MESSAGES as VISIBILITY_MESSAGES } from './visibility.mjs';
 import { softenHex } from './agency.mjs';
+import { renderDemandHtml, demandSourceRow } from './demand.mjs';
 
 const esc = (s) => String(s ?? '').replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;');
 const isPlaceholder = (s) => typeof s === 'string' && /\{\{[^}]*\}\}/.test(s);
@@ -53,7 +54,7 @@ const LABELS = {
     secOffpage: 'Off-page, conversion, limitations', offpageEyebrow: '07 · Off-page', offpageTitle: 'Off-page and trust', conversionEyebrow: '08 · Conversion', conversionTitle: 'Conversion and UX', colElement: 'Element', limitationsEyebrow: '09 · Limitations', sourcesTitle: 'Where the data comes from', colSource: 'Source', colAccess: 'Access', colWhatRead: 'What was read',
     sourcesFoot: 'Every score in this report is computed from sources marked free. Nothing that costs money is counted in a score, so you can re-run this audit yourself and get the same numbers.',
     limitations: 'Limitations',
-    secRoadmap: 'Roadmap', roadmapEyebrow: '10 · Roadmap', roadmapTitle: 'What to do, in order', keyMessage: 'Key message:',
+    secRoadmap: 'Roadmap', roadmapEyebrow: '10 · Roadmap', demandEyebrow: '11 · Demand', demandTitle: 'Demand map', secDemand: 'Demand', roadmapTitle: 'What to do, in order', keyMessage: 'Key message:',
     runningHead: 'SEO, AEO and GEO audit',
     statusOk: '✓ OK', statusWarn: '△ Partial', statusBad: '✗ Problem', statusNa: '· Note',
     areas: null,
@@ -93,7 +94,7 @@ const LABELS = {
     secOffpage: 'Ссылки, конверсия, ограничения', offpageEyebrow: '07 · Ссылки', offpageTitle: 'Ссылки и доверие', conversionEyebrow: '08 · Конверсия', conversionTitle: 'Конверсия и удобство', colElement: 'Элемент', limitationsEyebrow: '09 · Ограничения', sourcesTitle: 'Откуда взяты данные', colSource: 'Источник', colAccess: 'Доступ', colWhatRead: 'Что прочитали',
     sourcesFoot: 'Каждая оценка в этом отчёте посчитана из источников с пометкой «бесплатно». Ничего платного ни в одну оценку не входит, поэтому вы можете повторить этот аудит сами и получить те же цифры.',
     limitations: 'Ограничения',
-    secRoadmap: 'План работ', roadmapEyebrow: '10 · План', roadmapTitle: 'Что делать и в каком порядке', keyMessage: 'Главное сообщение:',
+    secRoadmap: 'План работ', roadmapEyebrow: '10 · План', demandEyebrow: '11 · Спрос', demandTitle: 'Карта спроса', secDemand: 'Спрос', roadmapTitle: 'Что делать и в каком порядке', keyMessage: 'Главное сообщение:',
     runningHead: 'Аудит SEO, AEO и GEO',
     statusOk: '✓ Норма', statusWarn: '△ Частично', statusBad: '✗ Проблема', statusNa: '· Заметка',
     areas: AREAS_RU,
@@ -214,7 +215,12 @@ function css() {
   table { width: 100%; border-collapse: collapse; margin: 3mm 0 5mm; font-size: 9.2pt; }
   th { text-align: left; padding: 2.5mm 3mm; font-size: 7.8pt; letter-spacing: .06em; text-transform: uppercase; color: var(--muted); border-bottom: 2px solid var(--ink); font-weight: 600; }
   td { padding: 2.2mm 3mm; border-bottom: 1px solid var(--rule); vertical-align: top; }
-  .status-ok { color: var(--ok); font-weight: 600; white-space: nowrap; } .status-warn { color: var(--warn); font-weight: 600; white-space: nowrap; } .status-bad { color: var(--danger); font-weight: 600; white-space: nowrap; } .status-na { color: var(--muted); }
+  .status-ok { color: var(--ok); font-weight: 600; white-space: nowrap; } .status-warn { color: var(--warn); font-weight: 600; white-space: nowrap; } .status-bad { color: var(--danger); font-weight: 600; white-space: nowrap; }
+  .kpis { display: flex; gap: 4mm; margin: 4mm 0 5mm; }
+  .kpi { flex: 1; background: var(--panel); border-radius: 4px; padding: 3mm 4mm; }
+  .kpi-value { font-family: "Fraunces", "Iowan Old Style", Georgia, serif; font-size: 17pt; font-weight: 600; color: var(--ink); line-height: 1.1; }
+  .kpi-label { font-size: 8.5pt; color: var(--muted); margin-top: 1mm; }
+  td.num, th.num { text-align: right; font-variant-numeric: tabular-nums; white-space: nowrap; } .status-na { color: var(--muted); }
   .cards { display: grid; gap: 3mm; margin: 4mm 0; }
   .card { border-left: 3px solid var(--danger); background: #fbf1f0; padding: 3.5mm 4mm; border-radius: 0 4px 4px 0; }
   .card.warn { border-left-color: var(--warn); background: #fdf8ee; }
@@ -299,9 +305,15 @@ export function toHtml(audit, brand = null) {
   const geoRows = [...checksBy('aeo'), ...checksBy('geo')].map((c) => `<tr><td>${esc(c.label)}</td>${statusCell(c.status, L)}<td>${esc(c.value)}${c.comment ? `. ${esc(c.comment.charAt(0).toUpperCase() + c.comment.slice(1))}` : ''}</td></tr>`).join('') + (a.geo.rows || []).map(([k, s, d]) => `<tr><td>${t(k)}</td><td>${t(s)}</td><td>${t(d)}</td></tr>`).join('');
   pages.push(`<div class="page">${header(a, L.secAeo, L)}<div class="eyebrow">${L.aeoEyebrow}</div><h2>${L.aeoTitle}</h2><p class="lead">Whether the site's answers can be lifted into "People also ask", AI overviews, ChatGPT and Perplexity.</p><div class="two-col"><div><h3>${L.aeoWorks}</h3>${list(a.aeo.works)}</div><div><h3>${L.aeoBlocks}</h3>${list(a.aeo.blocks)}</div></div><div class="callout"><p><strong>${L.recommendation}</strong> ${t(a.aeo.recommendation)}</p></div><h2>${L.geoTitle}</h2><table><tr><th>${L.colSignal}</th><th>${L.colStatus}</th><th>${L.colDetail}</th></tr>${geoRows}</table><div class="callout"><p>${t(a.geo.callout)}</p></div>${footer(a, n++, preparedBy)}</div>`);
   const checkTable = (g) => (checksBy(g).length ? `<table><tr><th>${L.colCheck}</th><th>${L.colStatus}</th><th>${L.colFinding}</th></tr>${checksBy(g).map((c) => `<tr><td>${esc(c.label)}</td>${statusCell(c.status, L)}<td>${esc(c.value)}${c.comment ? `<br><span style="color:var(--muted)">${esc(c.comment)}</span>` : ''}</td></tr>`).join('')}</table>` : '');
-  pages.push(`<div class="page">${header(a, L.secOffpage, L)}<div class="eyebrow">${L.offpageEyebrow}</div><h2>${L.offpageTitle}</h2>${checkTable('offpage')}${list(a.offpage.listed)}<p>${t(a.offpage.note)}</p><div class="eyebrow" style="margin-top:8mm">${L.conversionEyebrow}</div><h2>${L.conversionTitle}</h2>${checkTable('conversion')}<table><tr><th>${L.colElement}</th><th>${L.colStatus}</th></tr>${(a.conversion.rows || []).map(([k, v]) => `<tr><td>${t(k)}</td><td>${t(v)}</td></tr>`).join('')}</table><div class="eyebrow" style="margin-top:8mm">${L.limitationsEyebrow}</div><h2>${L.sourcesTitle}</h2>${(a.sources || []).length ? `<table><tr><th>${L.colSource}</th><th>${L.colAccess}</th><th>${L.colWhatRead}</th></tr>${a.sources.map((s) => `<tr><td>${t(s.name)}</td><td>${t(s.access)}</td><td>${t(s.detail)}</td></tr>`).join('')}</table><p class="scorecard-foot">${L.sourcesFoot}</p>` : ''}<h3>${L.limitations}</h3>${list(a.limitations)}${footer(a, n++, preparedBy)}</div>`);
+  const sources = [...(a.sources || []), ...(a.demand && Array.isArray(a.demand.queries) ? [demandSourceRow(a.demand, a.meta?.lang === 'ru' ? 'ru' : 'en')] : [])];
+  pages.push(`<div class="page">${header(a, L.secOffpage, L)}<div class="eyebrow">${L.offpageEyebrow}</div><h2>${L.offpageTitle}</h2>${checkTable('offpage')}${list(a.offpage.listed)}<p>${t(a.offpage.note)}</p><div class="eyebrow" style="margin-top:8mm">${L.conversionEyebrow}</div><h2>${L.conversionTitle}</h2>${checkTable('conversion')}<table><tr><th>${L.colElement}</th><th>${L.colStatus}</th></tr>${(a.conversion.rows || []).map(([k, v]) => `<tr><td>${t(k)}</td><td>${t(v)}</td></tr>`).join('')}</table><div class="eyebrow" style="margin-top:8mm">${L.limitationsEyebrow}</div><h2>${L.sourcesTitle}</h2>${sources.length ? `<table><tr><th>${L.colSource}</th><th>${L.colAccess}</th><th>${L.colWhatRead}</th></tr>${sources.map((s) => `<tr><td>${t(s.name)}</td><td>${t(s.access)}</td><td>${t(s.detail)}</td></tr>`).join('')}</table><p class="scorecard-foot">${L.sourcesFoot}</p>` : ''}<h3>${L.limitations}</h3>${list(a.limitations)}${footer(a, n++, preparedBy)}</div>`);
   const phases = (a.roadmap || []).map((p) => `<div class="phase"><div class="phase-head"><span class="badge">${esc(p.badge)}</span><span class="phase-title">${t(p.title)}</span></div>${olist(p.items)}</div>`).join('');
   pages.push(`<div class="page">${header(a, L.secRoadmap, L)}<div class="eyebrow">${L.roadmapEyebrow}</div><h2>${L.roadmapTitle}</h2>${phases}<div class="verdict"><p><strong>${L.keyMessage}</strong> ${t(a.closing)}</p></div>${footer(a, n++, preparedBy)}</div>`);
+  // Карта спроса идёт приложением после дорожной карты: она не входит в баллы, и об этом
+  // сказано в ней самой и в таблице источников выше.
+  if (a.demand && Array.isArray(a.demand.queries)) {
+    pages.push(`<div class="page">${header(a, L.secDemand, L)}<div class="eyebrow">${L.demandEyebrow}</div><h2>${L.demandTitle}</h2>${renderDemandHtml(a.demand, { lang: a.meta?.lang === 'ru' ? 'ru' : 'en' })}${footer(a, n++, preparedBy)}</div>`);
+  }
   return `<!doctype html><html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1"><title>${esc(a.client.name)}: SEO, AEO and GEO audit</title><link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Fraunces:opsz,wght@9..144,600&family=IBM+Plex+Sans:wght@400;500;600&family=IBM+Plex+Mono&display=swap"><style>${css()}${accentCss}</style></head><body>${pages.join('\n')}</body></html>`;
 }
 

package/src/test-demand.mjs

@@ -0,0 +1,243 @@
+#!/usr/bin/env node
+/**
+ * Карта спроса: зёрна, подсказки, частоты, покрытие, вывод.
+ *
+ * Здесь держится пять вещей. Зёрна берутся из заголовков без слов бренда. Подсказки
+ * фильтруются по общему слову с зерном и делятся поровну между зёрнами. Клиент Topvisor
+ * ходит по методам в правильном порядке, спрашивает цену до запуска и в сухом прогоне не
+ * запускает ничего. Покрытие считается по словам адреса и заголовка. В выводе нет ни null,
+ * ни undefined, ни нуля вместо «нет данных», и доли сходятся с таблицей.
+ */
+import { createServer } from 'node:http';
+import { readFileSync } from 'node:fs';
+import { toHtml } from './render.mjs';
+import { verifyScores, computeScores } from './collect.mjs';
+import { anchorsFromPages, enrichTitles, tokens, seedsFromPages, expandQueries, coverage, sitemapPages, topvisorClient, volumesViaTopvisor, buildDemandMap, renderDemandHtml, renderDemandMarkdown, demandSourceRow, demandCsv, demandTotals, PATTERNS, REGIONS } from './demand.mjs';
+
+let bad = 0;
+const ok = (n, c) => { if (c) console.log(`ok   ${n}`); else { bad++; console.error(`FAIL ${n}`); } };
+const is = (n, a, b) => ok(`${n} (ждали ${JSON.stringify(b)}, вышло ${JSON.stringify(a)})`, JSON.stringify(a) === JSON.stringify(b));
+
+// ---- слова
+is('основа слова: квартира и квартиры совпадают', [...tokens('квартиру в сочи', 'ru')].sort(), [...tokens('квартира сочи', 'ru')].sort());
+is('кириллица и латинский адрес сходятся к одной основе', tokens('квартиры у моря', 'ru'), tokens('kvartiry u morya', 'ru'));
+is('варианты транслитерации схлопнуты', tokens('площадь хутор цена', 'ru'), tokens('ploshchad khutor', 'ru'));
+ok('служебные слова выпадают', !tokens('как купить квартиру в сочи', 'ru').includes('как'));
+ok('английские тоже, и «buy» не различает страницы', JSON.stringify(tokens('how to buy a condo in miami', 'en')) === JSON.stringify(['condo', 'miami']));
+is('ё и е одно и то же', tokens('ещё жильё', 'ru'), tokens('еще жилье', 'ru'));
+
+// ---- зёрна
+{
+  const pages = [
+    { url: 'https://invest-cambodia.com/', title: 'Invest Cambodia | Real estate in Phnom Penh', h1: 'Real estate in Phnom Penh' },
+    { url: 'https://invest-cambodia.com/visa/', title: 'Cambodia retirement visa: rules 2026 - Invest Cambodia', h1: 'Cambodia retirement visa' },
+    { url: 'https://invest-cambodia.com/contact/', title: 'Contact us', h1: 'Contact us' },
+  ];
+  const s = seedsFromPages(pages, { host: 'www.invest-cambodia.com' });
+  ok('бренд вырезан из зёрен', !s.some((x) => /invest/.test(x)) && s.includes('real estate in phnom penh'));
+  ok('заголовок разбит по разделителям', s.includes('retirement visa: rules 2026'.replace(': rules 2026', '')) || s.includes('retirement visa') || s.includes('cambodia retirement visa'));
+  ok('«contact us» не зерно', !s.includes('contact us'));
+  ok('дубли схлопнуты', new Set(s).size === s.length);
+  is('лимит зёрен работает', seedsFromPages(pages, { host: 'x.com', max: 1 }).length, 1);
+  // Главная MORE Group 15.09.2026: заголовок с брендом и сроком, H1 с ценой, меню из кнопок.
+  const mg = seedsFromPages([{
+    url: 'https://moregroupestate.ru/', title: 'MORE Group: агентство недвижимости на Пхукете. Подбор объекта за 2 часа', h1: 'Новые проекты на Пхукете от 4,6 млн ₽',
+    h2: ['Получите подборку под ваш бюджет', 'Районы Пхукета', 'Калькулятор доходности', 'Почему инвестировать в Пхукет?'],
+    nav: ['MORE Group', 'О компании', 'Подборка за 2 часа', 'Получить подборку за 2 часа', 'M MAX без VPN', 'TG Telegram', 'WA WhatsApp'],
+  }], { host: 'moregroupestate.ru', brand: 'MORE Group' });
+  is('H1 без цены идёт первым', mg[0], 'новые проекты на пхукете');
+  ok('тема из заголовка после двоеточия', mg.includes('агентство недвижимости на пхукете'));
+  ok('подзаголовки дают темы, если держатся за якорь', mg.includes('районы пхукета') && mg.includes('почему инвестировать в пхукет'));
+  ok('подзаголовок без якоря (лозунг) не зерно', !mg.includes('гибкие планы оплаты') && !mg.includes('калькулятор доходности'));
+  ok('кнопки, мессенджеры и бренд не зёрна', !mg.some((x) => /подборк|telegram|whatsapp|vpn|more group|о компании/.test(x)));
+  const an = anchorsFromPages([{ title: 'MORE Group: агентство недвижимости на Пхукете', h1: 'Новые проекты на Пхукете от 4,6 млн ₽' }], { host: 'moregroupestate.ru', brand: 'MORE Group', lang: 'ru' });
+  ok('якоря: тема без бренда, чисел и единиц', an.has('phuke') && an.has('nedvi') && !an.has('more') && !an.has('group') && !an.has('mln') && ![...an].some((t) => /\d/.test(t)));
+  const an2 = anchorsFromPages([{ title: 'MORE Group: агентство недвижимости на Пхукете. Подбор объекта за 2 часа', h1: '' }], { host: 'moregroupestate.ru', brand: 'MORE Group', lang: 'ru' });
+  ok('срок из заголовка («за 2 часа») не якорь', !an2.has('chasa') && an2.has('podbo'));
+  const cam = seedsFromPages([{ title: 'Invest Cambodia: property investment in Phnom Penh', h1: 'Property investment for foreign buyers', h2: ['What changed', 'Who should not buy here', 'Areas of Phnom Penh'], nav: ['Get your shortlist'] }], { host: 'invest-cambodia.com', lang: 'en' });
+  ok('лозунги главной не зёрна, а раздел про районы да', !cam.includes('what changed') && !cam.includes('who should not buy here') && cam.includes('areas of phnom penh'));
+  const camAn = anchorsFromPages([{ title: 'Property, measured before it is sold', h1: 'Property investment for foreign buyers' }], { host: 'invest-cambodia.com', lang: 'en' });
+  ok('география из имени домена стала якорем, а общее слово «invest» нет', camAn.has('cambo') && !camAn.has('inves'));
+  const mgAn = anchorsFromPages([{ title: 'MORE Group: агентство недвижимости на Пхукете', h1: '' }], { host: 'moregroupestate.ru', brand: 'MORE Group', lang: 'ru' });
+  ok('склеенное имя домена якорем не стало', !mgAn.has('moreg'));
+  const rep = seedsFromPages([{ title: 'Виллы на Пхукете | Юг-Дом', h1: '' }, { title: 'Дома у моря | Юг-Дом', h1: '' }], { host: 'x.ru' });
+  ok('повторяющийся сегмент заголовка признан брендом', rep.includes('виллы на пхукете') && !rep.some((x) => /юг-дом/.test(x)));
+}
+
+// ---- подсказки с поддельным автодополнением
+{
+  const fake = async (url) => {
+    const q = decodeURIComponent((url.match(/[?&](?:q|part)=([^&]*)/) || [])[1] || '');
+    if (/сломан/.test(q)) throw new Error('boom');
+    const base = q.replace(/^(как|где|что такое|сколько стоит)\s+/, '').replace(/\s+(цена|отзывы|или)$/, '');
+    return [q, [`${base} недорого`, `${base} у моря`, 'совсем другое', 'один', `${q} 2026`]];
+  };
+  const r = await expandQueries(['квартира в сочи', 'дом в сломанном месте'], { lang: 'ru', region: 225, max: 6, delayMs: 0, fetchJson: fake, engines: ['yandex'] });
+  is('обращений столько, сколько шаблонов на зерно', r.calls, PATTERNS.ru.length * 2);
+  ok('падение одного зерна не роняет прогон', r.failed === PATTERNS.ru.length && r.queries.length > 0);
+  ok('чужие фразы отфильтрованы по общему слову', !r.queries.includes('совсем другое'));
+  ok('фразы из одного слова выпали', !r.queries.includes('один'));
+  ok('лимит соблюдён', r.queries.length <= 6);
+  ok('само зерно в списке первым', r.queries[0] === 'квартира в сочи');
+  const two = await expandQueries(['alpha beta', 'gamma delta'], { lang: 'en', region: 84, max: 4, delayMs: 0, engines: ['google'], fetchJson: async (u) => { const q = decodeURIComponent((u.match(/q=([^&]*)/) || [])[1]); const b = q.replace(/^(how to|what is|best)\s+/, '').replace(/\s+(cost|price|near me|vs)$/, ''); return [q, [`${b} one`, `${b} two`, `${b} three`]]; } });
+  ok('квота делится между зёрнами поровну', two.queries.filter((q) => q.startsWith('alpha')).length === 2 && two.queries.filter((q) => q.startsWith('gamma')).length === 2);
+  const anchored = await expandQueries(['квартира в сочи'], { lang: 'ru', region: 225, max: 20, delayMs: 0, engines: ['yandex'], anchors: new Set(['sochi']), fetchJson: async () => ['x', ['квартира в сочи недорого', 'квартира в анапе недорого', 'квартиры сочи у моря']] });
+  ok('без якорного слова запрос выпадает, даже если делит слово с зерном', anchored.queries.includes('квартира в сочи недорого') && anchored.queries.includes('квартиры сочи у моря') && !anchored.queries.includes('квартира в анапе недорого'));
+}
+
+// ---- покрытие
+{
+  const pages = [{ url: 'https://x.ru/kvartiry-v-sochi/', title: '', h1: '' }, { url: 'https://x.ru/blog/post-1/', title: 'Дом у моря: цены 2026', h1: 'Дом у моря' }];
+  const c = coverage(['купить квартиру в сочи', 'дом у моря цена', 'вилла в анапе'], pages, { lang: 'ru' });
+  ok('покрытие по латинскому адресу русского сайта', c[0].covered && c[0].url === 'https://x.ru/kvartiry-v-sochi/');
+  ok('покрытие по заголовку', c[1].covered && /post-1/.test(c[1].url));
+  ok('нет страницы, значит нет', !c[2].covered && c[2].url === null);
+  const en = coverage(['buy condo miami', 'phuket villa rental', 'rent condo miami'], [{ url: 'https://y.com/miami/condos-for-sale/', title: '', h1: '' }], { lang: 'en' });
+  ok('«купить» не отличает страницу: сайт продажи отвечает на запрос про покупку', en[0].covered && !en[1].covered);
+  ok('а «снять» отличает: страница продажи не про аренду', !en[2].covered);
+}
+
+// ---- карты сайта
+{
+  const files = {
+    'https://x.ru/robots.txt': 'User-agent: *\nSitemap: https://x.ru/sitemap-index.xml\n',
+    'https://x.ru/sitemap-index.xml': '<sitemapindex><sitemap><loc>https://x.ru/s1.xml</loc></sitemap><sitemap><loc>https://x.ru/s2.xml</loc></sitemap></sitemapindex>',
+    'https://x.ru/s1.xml': '<urlset><url><loc>https://x.ru/a/</loc></url><url><loc>https://x.ru/b/</loc></url></urlset>',
+    'https://x.ru/s2.xml': '<urlset><url><loc>https://x.ru/c/</loc></url><url><loc> https://x.ru/a/ </loc></url></urlset>',
+  };
+  const p = await sitemapPages('https://x.ru/', { fetchText: async (u) => { if (!files[u]) throw new Error('404'); return files[u]; } });
+  is('адреса из вложенных карт без дублей', p.map((x) => x.url), ['https://x.ru/a/', 'https://x.ru/b/', 'https://x.ru/c/']);
+  const none = await sitemapPages('https://y.ru/', { fetchText: async () => { throw new Error('404'); } });
+  is('без карты пустой список, не ошибка', none, []);
+}
+
+// ---- заголовки для английских адресов русского сайта
+{
+  let fetched = 0;
+  const html = { 'https://x.ru/districts/': '<title>Районы Пхукета: где купить | Юг-Дом</title><h1>Районы Пхукета</h1>', 'https://x.ru/districts/bang-tao/': '<title>Банг Тао</title>', 'https://x.ru/a/b/c/': '<title>Глубоко</title>' };
+  const pages = [{ url: 'https://x.ru/a/b/c/', title: '', h1: '' }, { url: 'https://x.ru/districts/bang-tao/', title: '', h1: '' }, { url: 'https://x.ru/districts/', title: '', h1: '' }, { url: 'https://x.ru/dead/', title: '', h1: '' }];
+  const done = await enrichTitles(pages, { max: 3, concurrency: 2, fetchText: async (u) => { fetched += 1; if (!html[u]) throw new Error('404'); return html[u]; } });
+  ok('короткие адреса читаются первыми, лимит соблюдён', fetched === 3 && done === 2 && pages.find((p) => p.url === 'https://x.ru/a/b/c/').title === '' && pages.find((p) => p.url === 'https://x.ru/districts/bang-tao/').title === 'Банг Тао');
+  ok('страница без ответа остаётся адресом, не ошибкой', pages.find((p) => p.url === 'https://x.ru/dead/').title === '');
+  const c = coverage(['районы пхукета'], pages, { lang: 'ru' });
+  ok('русский запрос нашёл страницу с английским адресом по заголовку', c[0].covered && c[0].url === 'https://x.ru/districts/');
+}
+
+// ---- Topvisor на поддельном сервере
+function fakeTopvisor() {
+  const state = { projects: [{ id: 1, name: 'Другой', site: 'z.ru' }], searchers: {}, groups: [], keywords: [], launched: 0, polls: 0, calls: [] };
+  const server = createServer((req, res) => {
+    let raw = ''; req.on('data', (d) => { raw += d; });
+    req.on('end', () => {
+      const method = req.url.replace(/^\//, '');
+      let body = {};
+      const ct = req.headers['content-type'] || '';
+      if (ct.startsWith('multipart/form-data')) {
+        const b = ct.split('boundary=')[1];
+        for (const part of raw.split(`--${b}`)) { const m = part.match(/name="([^"]+)"\r\n\r\n([\s\S]*?)\r\n$/); if (m) body[m[1]] = m[2]; }
+      } else { try { body = JSON.parse(raw || '{}'); } catch { body = {}; } }
+      state.calls.push({ method, body, auth: req.headers.authorization, uid: req.headers['user-id'] });
+      const send = (result) => { res.setHeader('content-type', 'application/json'); res.end(JSON.stringify({ result })); };
+      const fail = (s) => { res.setHeader('content-type', 'application/json'); res.end(JSON.stringify({ result: null, errors: [{ code: 2001, string: s }] })); };
+      if (method === 'get/projects_2/projects') {
+        const list = state.projects.filter((p) => !body.filters || body.filters.every((f) => f.values.includes(p.id)));
+        return send(body.show_searchers_and_regions ? list.map((p) => ({ ...p, searchers: Object.entries(state.searchers[p.id] || {}).map(([k, regs]) => ({ key: Number(k), regions: regs.map((r) => ({ key: r })) })) })) : list);
+      }
+      if (method === 'add/projects_2/projects') { state.projects.push({ id: 7, name: body.name, site: body.url }); return send(7); }
+      if (method === 'add/positions_2/searchers') { state.searchers[body.project_id] ||= {}; if (state.searchers[body.project_id][body.searcher_key]) return fail('Поисковая система уже добавлена'); state.searchers[body.project_id][body.searcher_key] = []; return send(1); }
+      if (method === 'add/positions_2/searchers/regions') { state.searchers[body.project_id][body.searcher_key].push(body.region_key); return send(1); }
+      if (method === 'add/keywords_2/groups') { if (!Array.isArray(body.name)) return fail('name must be array'); const id = 100 + state.groups.length; state.groups.push({ id, name: body.name[0], project_id: body.project_id }); return send([id]); }
+      if (method === 'get/keywords_2/groups') return send(state.groups.filter((g) => g.project_id === body.project_id));
+      if (method === 'add/keywords_2/keywords/import') { for (const k of String(body.keywords).split('\n')) state.keywords.push({ id: state.keywords.length + 1, name: k, group_id: Number(body.group_id) }); return send(state.keywords.length); }
+      if (method === 'get/keywords_2/volumes/price') { const n = state.keywords.filter((k) => k.group_id === body.filters[0].values[0]).length; return send({ pricesByUsers: { 1: { price: Math.round(n * 2) / 100, limits: n } } }); }
+      if (method === 'edit/keywords_2/volumes/go') { state.launched += 1; return send(true); }
+      if (method === 'get/keywords_2/keywords') {
+        state.polls += 1;
+        const field = body.fields.find((f) => f.startsWith('volume:'));
+        return send(state.keywords.filter((k) => k.group_id === body.filters[0].values[0]).map((k, i) => ({ id: k.id, name: k.name, [field]: state.polls >= 2 ? (i + 1) * 100 : null })));
+      }
+      return fail(`Call to undefined method: ${method}`);
+    });
+  });
+  return new Promise((resolve) => server.listen(0, '127.0.0.1', () => resolve({ state, server, base: `http://127.0.0.1:${server.address().port}/` })));
+}
+{
+  const { state, server, base } = await fakeTopvisor();
+  const client = topvisorClient({ userId: '5', key: 'secret', base });
+  const dry = await volumesViaTopvisor(['купить квартиру в сочи', 'дом у моря цена'], { lang: 'ru', region: 225, client, dry: true, groupName: 'x.ru 2026-09-15' });
+  ok('сухой прогон: цена получена, ничего не запущено', dry.price === 0.04 && !dry.launched && state.launched === 0 && /dry/.test(dry.note));
+  ok('заголовки с ключами на месте', state.calls.every((c) => c.auth === 'bearer secret' && c.uid === '5'));
+  const order = state.calls.map((c) => c.method);
+  ok('проект создан, потому что его не было', order.includes('add/projects_2/projects') && state.projects.some((p) => p.name === 'OperStack: карта спроса'));
+  ok('цена спрошена после импорта и до запуска', order.indexOf('add/keywords_2/keywords/import') < order.indexOf('get/keywords_2/volumes/price') && !order.includes('edit/keywords_2/volumes/go'));
+  const priceCall = state.calls.find((c) => c.method === 'get/keywords_2/volumes/price').body;
+  is('определитель частоты: регион, Яндекс, тип 1', priceCall.qualifiers, [{ region_key: 225, searcher_key: 0, type: 1 }]);
+  is('фильтр по группе, а не по всему проекту', priceCall.filters[0].name, 'group_id');
+  const full = await volumesViaTopvisor(['купить квартиру в сочи', 'дом у моря цена'], { lang: 'ru', region: 225, client, groupName: 'x.ru 2026-09-15 b', pollMs: 1 });
+  ok('полный прогон: запущено один раз, частоты заполнены', state.launched === 1 && full.launched && full.filled === 2 && full.volumes['купить квартиру в сочи'] === 100 && full.volumes['дом у моря цена'] === 200);
+  ok('повторное добавление поисковика не ошибка', full.projectId === 7);
+  const en = await volumesViaTopvisor(['buy condo miami'], { lang: 'en', region: 84, client, groupName: 'y.com', pollMs: 1 });
+  is('для английского: Google, тип 3, регион 84', state.calls.filter((c) => c.method === 'edit/keywords_2/volumes/go').pop().body.qualifiers, [{ region_key: 84, searcher_key: 1, type: 3 }]);
+  ok('поле частоты названо по определителю', state.calls.filter((c) => c.method === 'get/keywords_2/keywords').pop().body.fields.includes('volume:84:1:3'));
+  ok('без ключей источник «none», а не ошибка', (await volumesViaTopvisor(['x y'], { client: null })).source === 'none');
+  server.close();
+}
+
+// ---- вся карта с подделками и вывод
+{
+  const { state, server, base } = await fakeTopvisor();
+  const client = topvisorClient({ userId: '5', key: 'secret', base });
+  const files = {
+    'https://x.ru/': '<html><head><title>Квартиры у моря в Сочи | Юг-Дом</title></head><body><h1>Квартиры у моря в Сочи</h1><nav><a href="/">Главная</a><a href="/doma/">Дома в Сочи</a></nav></body></html>',
+    'https://x.ru/robots.txt': 'Sitemap: https://x.ru/sitemap.xml',
+    'https://x.ru/sitemap.xml': '<urlset><url><loc>https://x.ru/kvartiry-u-morya-v-sochi/</loc></url><url><loc>https://x.ru/doma/</loc></url></urlset>',
+  };
+  const fetchJson = async (u) => { const q = decodeURIComponent((u.match(/[?&](?:q|part)=([^&]*)/) || [])[1] || ''); const b = q.replace(/^(как|где|что такое|сколько стоит)\s+/, '').replace(/\s+(цена|отзывы|или)$/, ''); return [q, [`${b} недорого`, `${b} вторичка`]]; };
+  const d = await buildDemandMap('https://x.ru/', { lang: 'ru', client, fetchText: async (u) => { if (!files[u]) throw new Error('404'); return files[u]; }, fetchJson, delayMs: 0, pollMs: 1, max: 20, engines: ['yandex'] });
+  ok('хозяин и регион названы', d.host === 'x.ru' && d.region === 225 && d.regionName === 'Россия');
+  ok('зёрна без бренда', d.seeds.includes('квартиры у моря в сочи') && !d.seeds.some((s) => /юг-дом/.test(s)));
+  ok('частоты собраны на все запросы', d.volumes.source === 'Topvisor' && d.totals.withVolume === d.totals.queries && d.totals.queries > 0);
+  ok('отсортировано по частоте', d.queries.every((q, i) => i === 0 || (d.queries[i - 1].volume ?? -1) >= (q.volume ?? -1)));
+  ok('итоги сходятся', d.totals.covered + d.totals.uncovered === d.totals.queries && d.totals.volumeCovered + d.totals.volumeUncovered === d.totals.volumeTotal);
+  ok('есть и покрытые, и непокрытые', d.totals.covered > 0 && d.totals.uncovered > 0);
+  ok('в JSON нет undefined', !/undefined/.test(JSON.stringify(d)));
+  const html = renderDemandHtml(d);
+  const md = renderDemandMarkdown(d);
+  ok('в выводе нет null, undefined, NaN', !/null|undefined|NaN/.test(html + md));
+  ok('вывод называет долю спроса без страницы', /% спроса ниши/.test(html) && /% спроса ниши/.test(md));
+  ok('источник назван и сказано, где проверить бесплатно', /Topvisor/.test(html) && /wordstat\.yandex\.ru/.test(html) && /в баллы отчёта они не входят/.test(html));
+  ok('таблица содержит запросы и адреса', /<table>/.test(html) && /\/kvartiry-u-morya-v-sochi\//.test(html));
+  const enHtml = renderDemandHtml({ ...d, lang: 'en', regionName: 'Russia' }, { lang: 'en' });
+  ok('английский вывод без кириллицы вне запросов', !/[А-Яа-яЁё]/.test(enHtml.replace(/<td>[^<]*<\/td>/g, '')));
+  const row = demandSourceRow(d);
+  ok('строка источников: платно и не в балл', /Платный/.test(row.access) && /не входит/.test(row.access));
+  const csv = demandCsv(d).split('\n');
+  ok('csv: шапка плюс строка на запрос', csv.length === d.queries.length + 1 && csv[0] === '"query","volume","has_page","url"');
+  const off = await buildDemandMap('https://x.ru/', { lang: 'ru', volumes: false, fetchText: async (u) => files[u] || '', fetchJson, delayMs: 0, max: 5, engines: ['yandex'] });
+  ok('без частот доля считается по числу запросов и так и сказано', off.volumes.source === 'none' && /по числу запросов/.test(renderDemandHtml(off)) && /% найденных вопросов/.test(renderDemandHtml(off)));
+  ok('запрос без частоты подписан словами, а не нулём', /нет данных/.test(renderDemandHtml(off)) && !/<td class="num">0<\/td>/.test(renderDemandHtml(off)));
+  const empty = renderDemandHtml({ host: 'e.ru', lang: 'ru', region: 225, regionName: 'Россия', seeds: [], discovery: { engines: ['yandex'] }, volumes: { source: 'none' }, queries: [], totals: demandTotals([]) });
+  ok('пустая карта объяснена словами', /ни одного запроса/.test(empty) && !/NaN/.test(empty));
+  is('регионов по умолчанию хватает на оба языка', [REGIONS[225].engine, REGIONS[84].engine], ['yandex', 'google']);
+  server.close();
+}
+
+// ---- отчёт: карта печатается приложением, входит в таблицу источников и не трогает баллы
+{
+  const sample = JSON.parse(readFileSync(new URL('../examples/sample-audit.json', import.meta.url), 'utf8'));
+  const before = JSON.stringify(computeScores(sample.checks || []).scores);
+  const fixture = { host: 'example-villas.example', lang: 'en', region: 84, regionName: 'United States', seeds: ['villas phuket'], discovery: { calls: 8, failed: 0, engines: ['google'] }, pagesIndexed: 3, volumes: { source: 'Topvisor', engine: 'google', type: 3, price: 1.2, currency: 'RUB', filled: 2, asked: 2, note: '', projectId: 1, groupId: 2 }, queries: [{ q: 'villas phuket for sale', volume: 880, covered: true, url: 'https://www.example-villas.example/villas/' }, { q: 'phuket villa rental', volume: 590, covered: false, url: null }] };
+  fixture.totals = demandTotals(fixture.queries);
+  const withMap = { ...sample, demand: fixture };
+  const html = toHtml(withMap);
+  ok('в отчёте появилась страница «11 · Demand»', /11 · Demand/.test(html) && /Demand map/.test(html));
+  ok('таблица источников называет Topvisor платным и не входящим в балл', /Topvisor \(volumes for the demand map\)/.test(html) && /counts towards no score/.test(html));
+  ok('без карты страницы нет', !/11 · Demand/.test(toHtml(sample)));
+  is('баллы с картой и без неё одинаковы', JSON.stringify(computeScores(withMap.checks || []).scores), before);
+  ok('проверка баллов проходит с картой', verifyScores(withMap).ok !== false);
+  const ruHtml = toHtml({ ...sample, meta: { ...sample.meta, lang: 'ru' }, demand: { ...fixture, lang: 'ru', regionName: 'США' } });
+  ok('русский отчёт: «11 · Спрос»', /11 · Спрос/.test(ruHtml) && /Карта спроса/.test(ruHtml));
+}
+
+if (bad) { console.error(`\n${bad} тест(ов) упало`); process.exit(1); }
+console.log('\nкарта спроса: зёрна, подсказки, частоты, покрытие и вывод в порядке');

package/src/test-prompts.mjs

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 /** Задания для ИИ-агента: полнота, язык, запрет на выдумки. */
-import { agentPrompt, agentPrompts, renderAgentPrompts } from './prompts.mjs';
+import { readFileSync } from 'node:fs';
+import { agentPrompt, agentPrompts, renderAgentPrompts, firstFixParts, FIRST_FIX_IDS } from './prompts.mjs';
 import { FIX_ACTIONS } from './fix.mjs';
 
 let bad = 0;
@@ -79,5 +80,33 @@ ok('и предупреждает делать по одной', /по одно
 ok('и обещает, что код знать не нужно', /кода знать не нужно/i.test(head));
 ok('в файле нет пустых сдвоенных строк', !/\n\n\n/.test(head));
 
+// ---- первая правка на бесплатной странице тремя частями.
+// Список id берётся из исходника бесплатной проверки, а не из головы: новая находка без
+// сопоставления уронит этот тест, а не оставит покупателя без задачи молча.
+{
+  const src = readFileSync(new URL('./visibility.mjs', import.meta.url), 'utf8');
+  const ids = [...new Set([...src.matchAll(/id: '([a-z0-9-]+)', level: (?!'na')/g)].map((m) => m[1]))];
+  ok(`находок бесплатной проверки в исходнике больше десяти (${ids.length})`, ids.length > 10);
+  const missing = [];
+  for (const id of ids) for (const lang of ['ru', 'en']) {
+    const p = firstFixParts({ id, area: 'x', text: 'что-то измерено' }, { lang });
+    if (!p || !p.now || p.task.length < 30 || p.verify.length < 20 || /null|undefined/.test(JSON.stringify(p))) missing.push(`${id}/${lang}`);
+    else if (lang === 'en' && /[А-Яа-яЁё]/.test(p.task + p.verify + p.rule + Object.values(p.labels).join(''))) missing.push(`${id}/en: кириллица`);
+  }
+  is('у каждой находки бесплатной проверки есть три части на обоих языках', missing, []);
+  is('и в списке экспорта нет лишних id, которых проверка не выдаёт', FIRST_FIX_IDS.filter((id) => !ids.includes(id)), []);
+  is('неизвестная находка даёт null, а не чужое указание', firstFixParts({ id: 'что-то-новое', text: 'x' }, { lang: 'ru' }), null);
+  is('находка без текста даёт null', firstFixParts({ id: 'llms-missing', text: '' }, { lang: 'ru' }), null);
+  is('пустой вход даёт null', firstFixParts(null), null);
+  const p = firstFixParts({ id: 'robots-fetchers-blocked', area: 'Пускает ли роботов ИИ', text: 'Закрыты поисковые роботы ответных систем: OAI-SearchBot.' }, { lang: 'ru' });
+  is('«сейчас» это сам текст находки', p.now, 'Закрыты поисковые роботы ответных систем: OAI-SearchBot.');
+  ok('задача про открытие поисковых роботов', /Открой в robots\.txt/.test(p.task));
+  ok('подписи на русском', p.labels.now === 'Сейчас' && p.labels.task === 'Задача' && p.labels.verify === 'Как проверить');
+  ok('правило про выдумки на месте', /не выдумывай факты/.test(p.rule));
+  const e = firstFixParts({ id: 'llms-missing', text: 'No llms.txt.' }, { lang: 'en' });
+  ok('английские подписи', e.labels.now === 'Now' && e.labels.verify === 'How to check');
+  ok('незнакомый язык падает в английский', firstFixParts({ id: 'llms-missing', text: 'x' }, { lang: 'de' }).labels.now === 'Now');
+}
+
 if (bad) { console.error(`\n${bad} тест(ов) упало`); process.exit(1); }
 console.log('\nвсе тесты заданий прошли');