seo 0.5.0 → 0.7.0

package/dist/index.js

@@ -1,5 +1,5 @@
 import { createRequire as __seoCreateRequire } from 'node:module'; const require = __seoCreateRequire(import.meta.url);
-import { n as load, t as version } from "./package-CsRkLZGn.js";
+import { n as load, t as version } from "./package-CmplBMg7.js";
 import { SEO_PROVIDER_API_VERSION } from "./provider-sdk.js";
 import crypto, { createHash, randomUUID, sign } from "node:crypto";
 import { z } from "zod";
@@ -1598,7 +1598,7 @@ async function runAnalyticsReport(gfetch, propertyId, body, options) {
 //#endregion
 //#region packages/core/src/bing/api.ts
 const BASE = "https://ssl.bing.com/webmaster/api.svc/json";
-const MAX_BYTES$1 = 8e6;
+const MAX_BYTES$2 = 8e6;
 function bingCall(auth, options) {
 	return async (method, params = {}) => {
 		const url = new URL(`${BASE}/${method}`);
@@ -1623,7 +1623,7 @@ function bingCall(auth, options) {
 			if (response.status === 429 || /throttle/i.test(detail)) throw new SeoError("RATE_LIMITED", "Bing Webmaster is limiting requests. Try again in a few minutes.");
 			throw new SeoError("OPTIONAL_PROVIDER_UNAVAILABLE", `Bing Webmaster answered ${response.status}. ${detail}`.trim());
 		}
-		return (await readJson(response, "Bing Webmaster", { maxBytes: MAX_BYTES$1 })).d;
+		return (await readJson(response, "Bing Webmaster", { maxBytes: MAX_BYTES$2 })).d;
 	};
 }
 //#endregion
@@ -2088,13 +2088,13 @@ let credentials;
 function expiresSoon(value) {
 	return [...value.google, ...value.bing].some((item) => "expiresAt" in item && item.expiresAt - EARLY < Date.now());
 }
-async function cloudCredentials() {
+async function cloudCredentials(options = {}) {
 	const current = credentials ? await credentials.catch(() => null) : null;
-	if (current && !expiresSoon(current)) return current;
+	if (current && !expiresSoon(current) && !options.refreshClicky) return current;
 	credentials = (async () => {
 		const token = cloudToken();
 		if (!token) throw new SeoError("AUTH_REQUIRED", notSignedIn());
-		const result = await call$1("/account/cli/credentials", { token });
+		const result = await call$1(`/account/cli/credentials${options.refreshClicky ? "?clicky=refresh" : ""}`, { token });
 		if (result.status === 401) throw new SeoError("AUTH_EXPIRED", `This machine is not linked to a seoskill.dev account any more. ${CLOUD_SIGN_IN}`);
 		if (!result.ok) throw new SeoError("PROVIDER_UNAVAILABLE", `seoskill.dev returned ${result.status}. Try again in a minute.`);
 		return result.body;
@@ -4694,7 +4694,7 @@ function extractCanonicalEvidence($, headers, baseUrl) {
 //#region packages/core/src/extract/content-sketch.ts
 const SHINGLE_SIZE = 5;
 const MAX_HASHES = 32;
-function words(value) {
+function words$1(value) {
 	return value.normalize("NFKC").toLocaleLowerCase("en").match(/[\p{L}\p{N}]+/gu) ?? [];
 }
 function sampleIndexes(total, limit) {
@@ -4705,7 +4705,7 @@ function digest(value) {
 	return createHash("sha256").update(value).digest("hex").slice(0, 16);
 }
 function contentSketch(value) {
-	const tokens = words(value);
+	const tokens = words$1(value);
 	const hashes = sampleIndexes(Math.max(0, tokens.length - SHINGLE_SIZE + 1), MAX_HASHES).map((index) => digest(tokens.slice(index, index + SHINGLE_SIZE).join(" ")));
 	return {
 		version: 1,
@@ -4717,6 +4717,11 @@ function contentSketch(value) {
 }
 //#endregion
 //#region packages/core/src/extract/main-content.ts
+function parseDocument$1(html) {
+	const { document } = parseHTML(html);
+	if (document.documentElement?.localName === "html") return document;
+	return parseHTML(`<!doctype html><html><head></head><body>${html}</body></html>`).document;
+}
 function readableError(error) {
 	return error instanceof Error ? error.message : String(error);
 }
@@ -4746,10 +4751,6 @@ function resolveDocumentUrls(document, baseUrl) {
 	}
 }
 function readabilityResult(fetchResult, requested, fallbackReason, fallbackDetail) {
-	const { document } = parseHTML(fetchResult.html);
-	const bodyText = document.body.textContent ?? "";
-	const article = new Readability(document).parse();
-	const text = article?.textContent ?? bodyText;
 	const fallback = requested !== "readability";
 	const diagnostics = {
 		requested,
@@ -4762,13 +4763,27 @@ function readabilityResult(fetchResult, requested, fallbackReason, fallbackDetai
 			fallbackDetail
 		} : {}
 	};
-	return {
-		text,
-		excerpt: normalizedText(article?.excerpt),
-		wordCount: countCjkAwareWords(text),
-		diagnostics,
-		warnings: fallback && fallbackDetail ? [`Defuddle extraction fell back to Readability: ${fallbackDetail}`] : []
-	};
+	const warnings = fallback && fallbackDetail ? [`Defuddle extraction fell back to Readability: ${fallbackDetail}`] : [];
+	try {
+		const document = parseDocument$1(fetchResult.html);
+		const bodyText = document.body?.textContent ?? "";
+		const article = new Readability(document).parse();
+		const text = article?.textContent ?? bodyText;
+		return {
+			text,
+			excerpt: normalizedText(article?.excerpt),
+			wordCount: countCjkAwareWords(text),
+			diagnostics,
+			warnings
+		};
+	} catch (error) {
+		return {
+			text: "",
+			wordCount: 0,
+			diagnostics,
+			warnings: [...warnings, `The page's main content could not be read: ${readableError(error)}`]
+		};
+	}
 }
 function defaultParseDefuddle(document, options) {
 	return new Defuddle(document, options).parse();
@@ -4776,13 +4791,13 @@ function defaultParseDefuddle(document, options) {
 function extractMainContent(fetchResult, extractor = "defuddle", dependencies = {}) {
 	if (extractor === "readability") return readabilityResult(fetchResult, extractor);
 	try {
-		const { document } = parseHTML(fetchResult.html);
+		const document = parseDocument$1(fetchResult.html);
 		resolveDocumentUrls(document, fetchResult.finalUrl);
 		const article = (dependencies.parseDefuddle ?? defaultParseDefuddle)(document, {
 			url: fetchResult.finalUrl,
 			useAsync: false
 		});
-		const text = typeof article.content === "string" ? load(article.content).text() : document.body.textContent ?? "";
+		const text = typeof article.content === "string" ? load(article.content).text() : document.body?.textContent ?? "";
 		if (!text.trim()) return readabilityResult(fetchResult, extractor, "defuddle_empty", "Defuddle returned no main content");
 		const reportedWordCount = article.wordCount;
 		const hasValidWordCount = typeof reportedWordCount === "number" && Number.isFinite(reportedWordCount) && reportedWordCount >= 0;
@@ -4805,6 +4820,28 @@ function extractMainContent(fetchResult, extractor = "defuddle", dependencies =
 		return readabilityResult(fetchResult, extractor, "defuddle_error", readableError(error));
 	}
 }
+const MARKDOWN_LIMIT = 2e4;
+async function extractMainMarkdown(fetchResult) {
+	const document = parseDocument$1(fetchResult.html);
+	resolveDocumentUrls(document, fetchResult.finalUrl);
+	const { Defuddle: toMarkdown } = await import("defuddle/node");
+	const markdown = ((await toMarkdown(document, fetchResult.finalUrl, {
+		markdown: true,
+		useAsync: false
+	})).content ?? "").trim();
+	if (markdown.length <= 2e4) return {
+		markdown,
+		characters: markdown.length,
+		truncated: false
+	};
+	const cut = markdown.slice(0, MARKDOWN_LIMIT);
+	const end = cut.lastIndexOf("\n");
+	return {
+		markdown: (end > 2e4 / 2 ? cut.slice(0, end) : cut).trimEnd(),
+		characters: markdown.length,
+		truncated: true
+	};
+}
 //#endregion
 //#region packages/core/src/extract/google-rich-results.ts
 const SUPPORTED_TYPES = /* @__PURE__ */ new Set([
@@ -8639,7 +8676,7 @@ const QUERY_FLAG_METHOD = {
 		"navigational-other": "Names a domain that is not the property's host, ends with a spoken domain suffix or a login/site/app word, starts with a large platform name and adds no topic word, or is one short ASCII word that is not a brand term. Such queries usually look for another site."
 	}
 };
-const FUNCTION_WORDS = /* @__PURE__ */ new Set([
+const FUNCTION_WORDS$1 = /* @__PURE__ */ new Set([
 	"a",
 	"about",
 	"an",
@@ -8704,7 +8741,7 @@ function isLikelyAutomatedQuery(query) {
 	if (query.trim().split(/\s+/).filter(Boolean).some((token) => IDENTIFIER_TOKEN.test(token))) return true;
 	const tokens = tokenize(query);
 	if (tokens.length >= 20) return true;
-	if (tokens.length >= 8 && !/[^\p{ASCII}]/u.test(query) && !tokens.some((token) => FUNCTION_WORDS.has(token))) return true;
+	if (tokens.length >= 8 && !/[^\p{ASCII}]/u.test(query) && !tokens.some((token) => FUNCTION_WORDS$1.has(token))) return true;
 	return false;
 }
 const FILE_EXTENSIONS = /* @__PURE__ */ new Set([
@@ -14518,6 +14555,9 @@ async function storedSiteKeys() {
 		source: credential.source
 	};
 }
+async function readClickySiteKeys() {
+	return (await storedSiteKeys()).siteKeys;
+}
 async function readClickySiteKey(siteIdValue, input = {}) {
 	const siteId = normalizeClickySiteId(siteIdValue);
 	const environmentKey = (input.env ?? process.env)[CLICKY_SITEKEY_ENV]?.trim();
@@ -16679,7 +16719,7 @@ function analyzeCtrUnderperformersFromRows(input) {
 //#endregion
 //#region packages/core/src/analyze/ctr-underperformers-report.ts
 const MAX_GSC_ROWS$3 = 1e5;
-const DEFAULT_DAYS$3 = 28;
+const DEFAULT_DAYS$4 = 28;
 const MAX_DAYS$2 = 548;
 function plural$4(count, singular, pluralLabel = `${singular}s`) {
 	return count === 1 ? singular : pluralLabel;
@@ -16702,7 +16742,7 @@ async function ctrUnderperformersReportWith(input, dependencies) {
 	const explicitRange = explicitDateRange(input, MAX_DAYS$2);
 	const days = explicitRange?.days ?? integerOption$1({
 		value: input.days,
-		fallback: DEFAULT_DAYS$3,
+		fallback: DEFAULT_DAYS$4,
 		minimum: 1,
 		maximum: MAX_DAYS$2,
 		label: "Days"
@@ -19959,7 +19999,7 @@ function quickWinTemplateSummaries(items) {
 }
 //#endregion
 //#region packages/core/src/analyze/site-diagnostics/quick-wins-report.ts
-const DEFAULT_DAYS$2 = 28;
+const DEFAULT_DAYS$3 = 28;
 const MAX_DAYS$1 = 548;
 const DEFAULT_VERIFY_LIMIT$1 = 5;
 const MAX_VERIFY_LIMIT = 100;
@@ -19981,7 +20021,7 @@ async function quickWinsReportWith(input, dependencies) {
 	const explicitRange = explicitDateRange(input, MAX_DAYS$1);
 	const days = explicitRange?.days ?? integerOption$1({
 		value: input.days,
-		fallback: DEFAULT_DAYS$2,
+		fallback: DEFAULT_DAYS$3,
 		minimum: 1,
 		maximum: MAX_DAYS$1,
 		label: "Days"
@@ -20405,7 +20445,7 @@ function analyzeStrikingDistanceRows(input) {
 }
 //#endregion
 //#region packages/core/src/analyze/striking-distance-report.ts
-const DEFAULT_DAYS$1 = 28;
+const DEFAULT_DAYS$2 = 28;
 const MAX_DAYS = 548;
 const DEFAULT_VERIFY_LIMIT = 5;
 const MAX_SOURCE_ROWS$1 = 1e5;
@@ -20414,7 +20454,7 @@ function boundedInteger$2(value, fallback, minimum, maximum) {
 	return Math.min(maximum, Math.max(minimum, Math.floor(value)));
 }
 function reportDays(value) {
-	if (value === void 0) return DEFAULT_DAYS$1;
+	if (value === void 0) return DEFAULT_DAYS$2;
 	if (!Number.isInteger(value) || value < 1 || value > MAX_DAYS) throw new SeoError("INVALID_INPUT", `Days must be a whole number between 1 and ${MAX_DAYS}.`);
 	return value;
 }
@@ -21856,20 +21896,394 @@ function analyzeInternalLinksFromRows(input) {
 		}
 	};
 }
-//#endregion
-//#region packages/core/src/analyze/internal-links-report.ts
-function internalLinksIntegerOption(input) {
-	const value = input.value ?? input.fallback;
-	if (!Number.isInteger(value) || value < input.minimum || value > input.maximum) throw new SeoError("INVALID_INPUT", `${input.label} must be a whole number between ${input.minimum} and ${input.maximum}.`);
-	return value;
+const MAX_TERMS = 100;
+const PLACEMENT_SENTENCES = 2;
+const ANCHORS_PER_SENTENCE = 3;
+const MIN_SENTENCE_WORDS = 6;
+const NAME_WEIGHT = 2;
+const GENERIC_ANCHORS = /^(click here|here|read more|learn more|more|this|this post|this article|this page|link|website|check it out|see more|view|continue reading)$/i;
+function normalise(value) {
+	return value.normalize("NFKD").replace(/\p{Diacritic}/gu, "").normalize("NFC").replace(/([\p{L}\p{N}])[’'`]([\p{L}\p{N}])/gu, "$1$2").toLowerCase().replace(/&/g, " and ").replace(/[^\p{L}\p{N}]+/gu, " ").replace(/\s+/g, " ").trim();
+}
+const words = (value) => normalise(value).split(" ").filter(Boolean);
+const FUNCTION_WORDS = new Set("a an and are as at be but by for from has have how if in into is it its of on or that the their then there these they this to was we were what when where which who why will with you your our can do does not just more most also than too very about after before over under again all any each other some such no nor only own same so up out off one two both every few several many much should would could because while since although though until unless whether however".split(" "));
+const NOT_PLURAL = /* @__PURE__ */ new Set([
+	"always",
+	"atlas",
+	"canvas",
+	"gas",
+	"lens",
+	"means",
+	"news",
+	"perhaps",
+	"series",
+	"species",
+	"sometimes",
+	"whereas",
+	"yes",
+	"this",
+	"has",
+	"was",
+	"does",
+	"its"
+]);
+const CHE = /* @__PURE__ */ new Set([
+	"caches",
+	"niches",
+	"headaches",
+	"cliches",
+	"avalanches",
+	"moustaches"
+]);
+const NOT_AGENT = /* @__PURE__ */ new Set([
+	"customer",
+	"together",
+	"however",
+	"whatever",
+	"whenever",
+	"wherever",
+	"remember",
+	"consider",
+	"character",
+	"register",
+	"november",
+	"december",
+	"september",
+	"october"
+]);
+function singular(word) {
+	if (word.length <= 3 || !/^[a-z]+$/.test(word) || NOT_PLURAL.has(word) || /(ss|us|is)$/.test(word)) return word;
+	if (word.endsWith("ies") && word.length > 4) return `${word.slice(0, -3)}y`;
+	if (/(xes|ches|shes|sses)$/.test(word) && !CHE.has(word)) return word.slice(0, -2);
+	return word.endsWith("s") ? word.slice(0, -1) : word;
+}
+function stem(word) {
+	const one = singular(word);
+	if (!/^[a-z]+$/.test(one)) return one;
+	if (one.length >= 8 && one.endsWith("er") && !one.endsWith("eer") && one.at(-3) !== one.at(-4) && !NOT_AGENT.has(one)) return one.slice(0, -2);
+	if (one.length > 5 && one.endsWith("ly")) return one.slice(0, -2);
+	if (one.length > 5 && one.endsWith("ed") && !one.endsWith("eed")) return one.slice(0, -2);
+	if (one.length > 6 && one.endsWith("ing")) return one.slice(0, -3);
+	return one;
+}
+const terms = (text) => words(text).filter((word) => word.length > 1 && !FUNCTION_WORDS.has(word) && !/^\d+$/.test(word)).map(stem);
+const slugWords = (url) => {
+	try {
+		return new URL(url).pathname.split(/[/._-]+/).filter(Boolean).join(" ");
+	} catch {
+		return "";
+	}
+};
+function keyTerms(page) {
+	const key = /* @__PURE__ */ new Map();
+	const title = page.title.replace(/\s+[|\u2013\u2014-]\s+[^|\u2013\u2014]*$/u, "");
+	for (const term of terms(page.description)) key.set(term, 1);
+	for (const term of terms(`${title} ${page.h1} ${lastSegmentWords(page.url)}`)) key.set(term, NAME_WEIGHT);
+	for (const term of terms(siteName(page.url))) key.delete(term);
+	return key;
+}
+function lastSegmentWords(url) {
+	try {
+		return (new URL(url).pathname.split("/").filter(Boolean).at(-1) ?? "").split(/[._-]+/).join(" ");
+	} catch {
+		return "";
+	}
 }
-function internalLinksNumberOption(input) {
-	const value = input.value ?? input.fallback;
-	if (!Number.isFinite(value) || value < input.minimum || value > input.maximum) throw new SeoError("INVALID_INPUT", `${input.label} must be between ${input.minimum} and ${input.maximum}.`);
-	return value;
+function siteName(url) {
+	try {
+		return new URL(url).hostname.replace(/^www\./u, "").split(".")[0] ?? "";
+	} catch {
+		return "";
+	}
 }
-function internalLinksReportRange(days, now) {
-	return finalGscDateRange(days, now);
+function termCounts(page) {
+	const counts = {};
+	const add = (text, weight) => {
+		for (const term of terms(text)) counts[term] = (counts[term] ?? 0) + weight;
+	};
+	add(page.title, 3);
+	add(page.h1, 3);
+	add(slugWords(page.url), 3);
+	add(page.description, 2);
+	for (const heading of page.headings) add(heading, 2);
+	for (const sentence of page.sentences) add(sentence.text, 1);
+	return counts;
+}
+const SKIP = /* @__PURE__ */ new Set([
+	"script",
+	"style",
+	"noscript",
+	"svg",
+	"template",
+	"iframe",
+	"select"
+]);
+const CHROME = /* @__PURE__ */ new Set([
+	"nav",
+	"header",
+	"footer",
+	"aside"
+]);
+const MAIN = /* @__PURE__ */ new Set(["main", "article"]);
+const BLOCK = new Set("p div li h1 h2 h3 h4 h5 h6 blockquote td th dd dt pre section article main aside header footer nav figcaption summary details tr ul ol table body form".split(" "));
+const VOID = /* @__PURE__ */ new Set([
+	"br",
+	"hr",
+	"img",
+	"input",
+	"meta",
+	"link",
+	"wbr",
+	"source",
+	"col",
+	"embed"
+]);
+const ENTITIES = {
+	amp: "&",
+	lt: "<",
+	gt: ">",
+	quot: "\"",
+	apos: "'",
+	nbsp: " ",
+	hellip: "…",
+	mdash: "—",
+	ndash: "–",
+	rsquo: "’",
+	lsquo: "‘",
+	rdquo: "”",
+	ldquo: "“"
+};
+const TAG_ATTRS = String.raw`(?:[^>"'=]|=\s*"[^"]*"|=\s*'[^']*'|=(?!\s*["'])|["'])*`;
+const A_OPEN = "
";
+const UNSPACED = /[\p{Script=Han}\p{Script=Hiragana}\p{Script=Katakana}\p{Script=Thai}\p{Script=Lao}\p{Script=Khmer}\p{Script=Myanmar}]/u;
+function decode(text) {
+	return text.replace(/&(#x[0-9a-f]+|#\d+|[a-z]+);/gi, (match, code) => {
+		if (code[0] === "#") {
+			const hex = code[1] === "x" || code[1] === "X";
+			const point = Number.parseInt(code.slice(hex ? 2 : 1), hex ? 16 : 10);
+			return point > 0 && point <= 1114111 ? String.fromCodePoint(point) : "";
+		}
+		return ENTITIES[code.toLowerCase()] ?? match;
+	});
+}
+const clean$1 = (value) => value.split(A_OPEN).join("").replace(/\s+/g, " ").trim();
+function splitSentences(block) {
+	return block.replace(/\s+/g, " ").split(/(?<=[.!?…]["”’)]?)\s+(?=["“‘(]?[A-Z0-9])|(?<=[。！？])/).map((sentence) => sentence.trim()).filter((sentence) => sentence.length <= 500);
+}
+function pageSentences(html) {
+	const sentences = [];
+	const hasMain = /<(main|article)[\s>]|role=["']main["']/i.test(html);
+	const stack = [];
+	let skip = 0;
+	let chrome = 0;
+	let mainDepth = 0;
+	let main = hasMain ? 0 : 1;
+	let section = "";
+	let buffer = "";
+	let inAnchor = false;
+	const flushRaw = (tag) => {
+		const raw = buffer;
+		const text = clean$1(raw);
+		buffer = "";
+		if (!text || sentences.length >= 250) return;
+		if (/^h[1-6]$/.test(tag)) {
+			if (tag !== "h1") section = text;
+			return;
+		}
+		for (const part of tag === "li" ? [raw] : splitSentences(raw)) {
+			const sentence = clean$1(part);
+			if (sentence.length >= 25 && sentence.split(" ").length >= 4 || UNSPACED.test(sentence) && sentence.length >= 10) {
+				if (sentences.length >= 250) return;
+				sentences.push({
+					text: sentence,
+					section,
+					hasLink: part.includes(A_OPEN)
+				});
+			}
+		}
+	};
+	const closeTo = (tag) => {
+		if (!stack.some((entry) => entry.tag === tag)) return;
+		while (stack.length) {
+			const entry = stack.pop();
+			if (!entry) break;
+			flushRaw(entry.tag);
+			if (entry.main) {
+				main -= 1;
+				mainDepth -= 1;
+			}
+			if (entry.chrome) chrome -= 1;
+			if (entry.tag === tag) break;
+		}
+	};
+	const tokens = html.matchAll(new RegExp(String.raw`<!--[\s\S]*?-->|<!\[CDATA\[[\s\S]*?\]\]>|<(\/?)([a-zA-Z][\w:-]*)(${TAG_ATTRS})>|([^<]+)`, "g"));
+	for (const match of tokens) {
+		const [whole, close, rawTag, rawAttrs = "", text] = match;
+		if (text !== void 0) {
+			if (!skip && main > 0 && chrome === 0) buffer += decode(text);
+			continue;
+		}
+		if (!rawTag) continue;
+		const tag = rawTag.toLowerCase();
+		if (skip) {
+			if (close && SKIP.has(tag)) skip -= 1;
+			continue;
+		}
+		if (close) {
+			if (tag === "a") inAnchor = false;
+			else if (BLOCK.has(tag)) closeTo(tag);
+			continue;
+		}
+		if (SKIP.has(tag)) {
+			if (!whole.endsWith("/>")) skip += 1;
+			continue;
+		}
+		if (tag === "br") buffer += " ";
+		if (tag === "a" && !inAnchor && /\bhref\s*=/i.test(rawAttrs)) {
+			inAnchor = true;
+			if (main > 0 && chrome === 0) buffer += A_OPEN;
+		}
+		if (VOID.has(tag) || !BLOCK.has(tag)) continue;
+		const parent = stack[stack.length - 1];
+		if (parent) flushRaw(parent.tag);
+		const role = /\brole\s*=\s*["']?main/i.test(rawAttrs);
+		const isMain = MAIN.has(tag) || role;
+		const isChrome = tag === "nav" || tag === "aside" || CHROME.has(tag) && mainDepth === 0;
+		if (isMain) {
+			main += 1;
+			mainDepth += 1;
+		}
+		if (isChrome) chrome += 1;
+		stack.push({
+			tag,
+			main: isMain,
+			chrome: isChrome
+		});
+	}
+	while (stack.length) {
+		const last = stack[stack.length - 1];
+		if (!last) break;
+		closeTo(last.tag);
+	}
+	flushRaw("");
+	return sentences;
+}
+var LinkCorpus = class {
+	df = /* @__PURE__ */ new Map();
+	size;
+	constructor(pages) {
+		this.size = pages.length;
+		for (const counts of pages) for (const term in counts) this.df.set(term, (this.df.get(term) ?? 0) + 1);
+	}
+	idf(term) {
+		return Math.log((this.size + 1) / ((this.df.get(term) ?? 1) + 1)) + 1;
+	}
+	vector(counts) {
+		let norm = 0;
+		const shared = [];
+		for (const term in counts) {
+			const weight = (1 + Math.log(counts[term] ?? 1)) * this.idf(term);
+			norm += weight * weight;
+			if ((this.df.get(term) ?? 0) >= 2) shared.push([term, weight]);
+		}
+		norm = Math.sqrt(norm) || 1;
+		shared.sort((left, right) => right[1] - left[1] || (left[0] < right[0] ? -1 : left[0] > right[0] ? 1 : 0));
+		return new Map(shared.slice(0, MAX_TERMS).map(([term, weight]) => [term, weight / norm]));
+	}
+	similarity(left, right) {
+		let sum = 0;
+		for (const [term, weight] of left) sum += weight * (right.get(term) ?? 0);
+		return sum;
+	}
+	sentenceScore(sentence, key) {
+		if (!key.size) return 0;
+		const seen = new Set(terms(sentence));
+		let hit = 0;
+		let total = 0;
+		for (const [term, place] of key) {
+			const weight = this.idf(term) * place;
+			total += weight;
+			if (seen.has(term)) hit += weight;
+		}
+		return total ? hit / total : 0;
+	}
+};
+function anchorCandidates(sentence, key, corpus, limit) {
+	const scored = /* @__PURE__ */ new Map();
+	const parts = sentence.split(/\s+/).map((word) => word.replace(/^[^\p{L}\p{N}]+|[^\p{L}\p{N}]+$/gu, "")).filter(Boolean);
+	for (let size = 2; size <= 4; size += 1) for (let start = 0; start + size <= parts.length; start += 1) {
+		const gram = parts.slice(start, start + size);
+		const first = (gram[0] ?? "").toLowerCase();
+		const last = (gram[size - 1] ?? "").toLowerCase();
+		if (FUNCTION_WORDS.has(first) || FUNCTION_WORDS.has(last) || /^\d+$/.test(first) || /^\d+$/.test(last)) continue;
+		const stems = terms(gram.join(" "));
+		if (stems.length < 2) continue;
+		const hits = stems.filter((term) => key.has(term)).length;
+		const named = stems.reduce((sum, term) => sum + (key.get(term) ?? 0) * corpus.idf(term), 0);
+		if (!stems.some((term) => key.get(term) === NAME_WEIGHT)) continue;
+		if (Number(key.has(terms(first)[0] ?? "")) + Number(key.has(terms(last)[0] ?? "")) < 2) continue;
+		const text = gram.join(" ");
+		const lower = text.toLowerCase();
+		if (GENERIC_ANCHORS.test(lower)) continue;
+		const rarity = stems.reduce((sum, term) => sum + corpus.idf(term), 0);
+		const score = named * (1 + hits / key.size) + rarity * .05 - (size === 4 ? .2 : 0);
+		const existing = scored.get(lower);
+		if (!existing || existing.score < score) scored.set(lower, {
+			text,
+			score
+		});
+	}
+	return [...scored.values()].sort((left, right) => right.score - left.score || (left.text < right.text ? -1 : left.text > right.text ? 1 : 0)).slice(0, limit).map((item) => item.text);
+}
+function linkPlacement(source, target, corpus) {
+	const key = keyTerms(target);
+	const contentSimilarity = corpus.similarity(corpus.vector(termCounts(source)), corpus.vector(termCounts(target)));
+	const seen = /* @__PURE__ */ new Set();
+	const sentences = source.sentences.filter((sentence) => {
+		if (seen.has(sentence.text)) return false;
+		seen.add(sentence.text);
+		return !sentence.hasLink && sentence.text.split(/\s+/).length >= MIN_SENTENCE_WORDS;
+	}).map((sentence, index) => ({
+		sentence,
+		index,
+		match: corpus.sentenceScore(sentence.text, key)
+	})).filter((item) => item.match > 0).sort((left, right) => right.match - left.match || left.index - right.index).slice(0, PLACEMENT_SENTENCES).map(({ sentence, match }) => ({
+		text: sentence.text,
+		section: sentence.section,
+		match: Math.round(match * 100) / 100,
+		anchors: anchorCandidates(sentence.text, key, corpus, ANCHORS_PER_SENTENCE)
+	})).filter((item) => item.anchors.length > 0);
+	return {
+		contentSimilarity: Math.round(contentSimilarity * 100) / 100,
+		sentences
+	};
+}
+function placementPage(input) {
+	return {
+		url: input.url,
+		title: input.title ?? "",
+		h1: input.headings.find((heading) => heading.level === 1)?.text ?? "",
+		description: input.metaDescription ?? "",
+		headings: input.headings.filter((heading) => heading.level === 2 || heading.level === 3).slice(0, 8).map((heading) => heading.text),
+		sentences: pageSentences(input.html)
+	};
+}
+//#endregion
+//#region packages/core/src/analyze/internal-links-report.ts
+const DAY$1 = 864e5;
+const ISO_DAY = /^\d{4}-\d{2}-\d{2}$/;
+function internalLinksReportRange(input, fallbackDays, now) {
+	if (!input.startDate && !input.endDate) return {
+		...finalGscDateRange(fallbackDays, now),
+		days: fallbackDays
+	};
+	const { startDate, endDate } = input;
+	if (!startDate || !endDate || !ISO_DAY.test(startDate) || !ISO_DAY.test(endDate) || startDate > endDate) throw new SeoError("INVALID_INPUT", "Send a start date and an end date together, in order, as YYYY-MM-DD.");
+	return {
+		startDate,
+		endDate,
+		days: Math.round((Date.parse(`${endDate}T00:00:00Z`) - Date.parse(`${startDate}T00:00:00Z`)) / DAY$1) + 1
+	};
 }
 function completeInternalLinksSelection(analysis, runtime) {
 	return {
@@ -21927,9 +22341,8 @@ async function verifyInternalLinkTarget(input) {
 	let fetched;
 	try {
 		fetched = await input.dependencies.fetch(input.targetUrl, {
-			js: input.js ?? "auto",
-			refresh: input.refresh,
-			rate: input.rate
+			js: "auto",
+			refresh: input.refresh
 		});
 	} catch (error) {
 		return {
@@ -21999,7 +22412,12 @@ async function verifyInternalLinkTarget(input) {
 		verification: fatalSignals.length ? "technical-issue" : "verified",
 		technicalSignals: signals,
 		fetchDiagnostics: fetched.diagnostics,
-		warnings
+		warnings,
+		text: placementPage({
+			...page,
+			url: page.finalUrl,
+			html: fetched.html
+		})
 	};
 }
 function linksToAliases(page, aliases) {
@@ -22033,9 +22451,8 @@ async function verifyInternalLinkCandidate(input) {
 	let fetched;
 	try {
 		fetched = await input.dependencies.fetch(input.candidate.sourceUrl, {
-			js: input.js ?? "auto",
-			refresh: input.refresh,
-			rate: input.rate
+			js: "auto",
+			refresh: input.refresh
 		});
 	} catch (error) {
 		return {
@@ -22125,12 +22542,21 @@ async function verifyInternalLinkCandidate(input) {
 				confidence
 			}
 		},
+		text: placementPage({
+			...page,
+			url: page.finalUrl,
+			html: fetched.html
+		}),
 		warnings
 	};
 }
 //#endregion
 //#region packages/core/src/analyze/internal-links.ts
 const MAX_GSC_ROWS = 1e5;
+const DEFAULT_DAYS$1 = 90;
+const RESULT_LIMIT = 20;
+const CHECK_LIMIT = 40;
+const MIN_IMPRESSIONS = 1;
 const defaultDependencies$2 = {
 	searchAnalytics: querySearchAnalytics,
 	fetch: fetchPage,
@@ -22141,43 +22567,17 @@ async function internalLinksReport(input, dependencies = defaultDependencies$2)
 	const targetPage = new URL(assertUrlMatchesGscProperty(input.site, input.targetUrl));
 	targetPage.hash = "";
 	const targetUrl = targetPage.toString();
-	const days = internalLinksIntegerOption({
-		value: input.days,
-		fallback: 28,
-		minimum: 1,
-		maximum: 548,
-		label: "days"
-	});
-	const limit = internalLinksIntegerOption({
-		value: input.limit,
-		fallback: 20,
-		minimum: 1,
-		maximum: 100,
-		label: "limit"
-	});
-	const checkLimit = internalLinksIntegerOption({
-		value: input.checkLimit,
-		fallback: Math.max(limit, 40),
-		minimum: 1,
-		maximum: 200,
-		label: "checkLimit"
-	});
-	const minImpressions = internalLinksNumberOption({
-		value: input.minImpressions,
-		fallback: 1,
-		minimum: 0,
-		maximum: 1e9,
-		label: "minImpressions"
-	});
+	const limit = RESULT_LIMIT;
+	const checkLimit = CHECK_LIMIT;
+	const minImpressions = MIN_IMPRESSIONS;
 	const now = dependencies.now();
-	const range = internalLinksReportRange(days, now);
+	const { days, ...range } = internalLinksReportRange(input, DEFAULT_DAYS$1, now);
+	const brandTerms = deriveBrandTerms({ siteUrl: input.site });
 	const ledger = new SessionLedger();
 	const target = await verifyInternalLinkTarget({
 		site: input.site,
 		targetUrl,
-		js: input.js,
 		refresh: input.refresh,
-		rate: input.rate,
 		dependencies
 	});
 	const targetRequests = await Promise.all(target.aliases.map(async (alias) => {
@@ -22209,8 +22609,7 @@ async function internalLinksReport(input, dependencies = defaultDependencies$2)
 		site: input.site,
 		targetAliases: target.aliases,
 		minImpressions,
-		brandTerms: input.brandTerms,
-		includeBrand: input.includeBrand
+		brandTerms
 	});
 	const queryCandidates = target.verification === "verified" && preliminary.selection.targetEligibleQueries > 0;
 	const sourceResult = queryCandidates ? await dependencies.searchAnalytics(input.site, {
@@ -22231,10 +22630,9 @@ async function internalLinksReport(input, dependencies = defaultDependencies$2)
 		site: input.site,
 		targetAliases: target.aliases,
 		minImpressions,
-		brandTerms: input.brandTerms,
-		includeBrand: input.includeBrand
+		brandTerms
 	});
-	const items = [];
+	const found = [];
 	const warnings = [...target.warnings];
 	let attemptedSources = 0;
 	let checkedSources = 0;
@@ -22243,25 +22641,27 @@ async function internalLinksReport(input, dependencies = defaultDependencies$2)
 	let selfAliasExclusions = 0;
 	let failedChecks = 0;
 	for (const candidate of analysis.candidates) {
-		if (attemptedSources >= checkLimit || items.length >= limit) break;
+		if (attemptedSources >= checkLimit || found.length >= limit) break;
 		attemptedSources += 1;
 		const verified = await verifyInternalLinkCandidate({
 			site: input.site,
 			candidate,
 			target,
-			js: input.js,
 			refresh: input.refresh,
-			rate: input.rate,
 			dependencies
 		});
 		warnings.push(...verified.warnings);
-		if (verified.item) items.push(verified.item);
+		if (verified.item) found.push({
+			item: verified.item,
+			text: verified.text
+		});
 		if (verified.exclusion === "existing-link") existingLinkExclusions += 1;
 		if (verified.exclusion === "technical") technicalExclusions += 1;
 		if (verified.exclusion === "self-alias") selfAliasExclusions += 1;
 		if (verified.exclusion === "failed") failedChecks += 1;
 		else checkedSources += 1;
 	}
+	const items = placeLinks(found, target.text);
 	const uncheckedCandidates = Math.max(0, analysis.candidates.length - attemptedSources);
 	const targetTruncated = targetRequests.some(({ result }) => result.rowsFetched >= MAX_GSC_ROWS);
 	const sourceTruncated = sourceResult.rowsFetched >= MAX_GSC_ROWS;
@@ -22323,13 +22723,14 @@ async function internalLinksReport(input, dependencies = defaultDependencies$2)
 		},
 		methodology: {
 			id: "gsc_internal_link_candidates",
-			version: 3,
+			version: 4,
 			lexicalTargetLimit: 50,
 			matchedQueryEvidenceLimit: 10,
 			observedLinkEvidenceLimit: 20,
 			matching: "pairwise_exact_then_precision_lexical",
 			ranking: "exact_matches_then_matched_query_impressions_then_relevance",
-			contextualPlacementVerified: true
+			contextualPlacementVerified: true,
+			placement: "tfidf_sentence_match_then_phrase_anchors"
 		},
 		filters: {
 			minImpressions,
@@ -22361,18 +22762,20 @@ async function internalLinksReport(input, dependencies = defaultDependencies$2)
 			failedChecks,
 			uncheckedCandidates,
 			matchedQueryImpressions: items.reduce((sum, item) => sum + item.matchedQueryImpressions, 0),
-			brandFiltering: input.includeBrand ? "included" : "excluded",
+			brandFiltering: "excluded",
 			verdict: summaryVerdict
 		},
 		items,
 		warnings: structuredWarnings,
 		caveats: [
-			`Date window: ${range.startDate} to ${range.endDate} (${days} days), using final GSC data where available.`,
+			`Date window: ${range.startDate} to ${range.endDate} (${days} days), using final GSC data where available.${input.startDate ? "" : ` Without dates the window is the last ${DEFAULT_DAYS$1} days.`}`,
+			`Limits: up to ${checkLimit} source pages are checked live and up to ${limit} are returned. Queries need at least ${minImpressions} impression.`,
 			`Selection: ${analysis.selection.targetEligibleQueries} eligible target queries, ${analysis.selection.candidateUrls} matched source pages, ${attemptedSources} attempted, ${checkedSources} successfully checked, ${items.length} returned.`,
-			`Minimum retained query impressions: ${minImpressions}. Brand queries were ${input.includeBrand ? "included" : "excluded when detected or configured"}.`,
+			`Brand queries were left out. Brand terms found from the domain: ${brandTerms.join(", ") || "none"}.`,
 			"GSC query rows omit anonymized queries and lower-volume rows. A 100,000-row cap is reported separately when reached.",
 			"Exact query overlap is medium-confidence affinity evidence; lexical matches are low-confidence review evidence. Neither predicts traffic lift or link equity.",
 			"The fetch checks HTML link placement, but it cannot prove editorial relevance. Review intent and reader usefulness before adding a link.",
+			"Placement sentences are the source sentences without a link that share the most rare words with the target title, h1, description and URL. Anchors are phrases from those sentences. Content similarity compares the words of the checked pages only. All three are text heuristics, not ranking evidence.",
 			uncheckedCandidates ? `${uncheckedCandidates} matched source page${uncheckedCandidates === 1 ? " was" : "s were"} not checked because the output or check limit was reached.` : "",
 			failedChecks ? `${failedChecks} source verification attempt${failedChecks === 1 ? "" : "s"} failed. Failed fetches or extraction attempts are not counted as checked pages and do not support a missing-link conclusion.` : ""
 		].filter(Boolean),
@@ -22380,6 +22783,29 @@ async function internalLinksReport(input, dependencies = defaultDependencies$2)
 		ledgerSummary: ledger.summary()
 	};
 }
+function placeLinks(found, target) {
+	const corpus = new LinkCorpus([target, ...found.map((entry) => entry.text)].filter((page) => Boolean(page)).map(termCounts));
+	const placed = found.map(({ item, text }) => {
+		const placement = target && text ? linkPlacement(text, target, corpus) : {
+			contentSimilarity: 0,
+			sentences: []
+		};
+		const best = placement.sentences[0];
+		const recommendation = best ? {
+			...item.recommendation,
+			action: `${item.recommendation.action} It fits in: "${best.text}" Anchor text could be ${best.anchors.map((anchor) => `"${anchor}"`).join(" or ")}.`
+		} : {
+			...item.recommendation,
+			action: `${item.recommendation.action} No sentence on this page names the target, so a link here needs new text.`
+		};
+		return {
+			...item,
+			placement,
+			recommendation
+		};
+	});
+	return [...placed.filter((item) => item.placement.sentences.length > 0), ...placed.filter((item) => item.placement.sentences.length === 0)];
+}
 //#endregion
 //#region packages/core/src/analyze/url-templates.ts
 const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
@@ -26183,6 +26609,9 @@ const DIMENSIONS = [
 	"searchAppearance"
 ];
 //#endregion
+//#region packages/core/src/commands/clicky.ts
+const CLICKY_KEY_PREFIX = "x-clicky-";
+//#endregion
 //#region packages/core/src/commands/page-facts.ts
 const MAX_PAGES = 20;
 const TIMEOUT_MS = 6e3;
@@ -26334,7 +26763,7 @@ function indexStatusFrom(result) {
 		user_canonical: text(status.userCanonical)
 	};
 }
-const LOST_PAGES_RULE = `Pages that had at least 3 clicks in the previous 28 days and kept ${.2 * 100}% or less of them in the last 28 days, with a live check of the top 20 and Google’s index status for the top 10.`;
+const LOST_PAGES_RULE = `Pages that had at least 3 clicks in the previous 28 days and kept ${.2 * 100}% or less of them in the last 28 days, with a live check of the top 20 and Google’s index status for the top 10 and the home page.`;
 //#endregion
 //#region packages/core/src/commands/tools.ts
 const site = z.string().min(1).describe("Search Console property or site, such as sc-domain:example.com, https://example.com/ or example.com.");
@@ -26353,7 +26782,8 @@ const detail = {
 const DATA_SOURCES = [
 	"search_console",
 	"google_analytics",
-	"bing"
+	"bing",
+	"clicky"
 ];
 z.object({}), `${Object.entries(SECTIONS).map(([id, text]) => `- ${id}: ${text}`).join("\n")}`, z.object({
 	site,
@@ -26380,7 +26810,7 @@ z.object({}), `${Object.entries(SECTIONS).map(([id, text]) => `- ${id}: ${text}`
 	...detail
 }), z.object({
 	source: z.enum(DATA_SOURCES).default("search_console"),
-	site: z.string().min(1).describe("search_console and bing: the property or site. google_analytics: numeric property id from seo_sites."),
+	site: z.string().min(1).describe("search_console and bing: the property or site. google_analytics: numeric property id from seo_sites. clicky: the site or its Clicky site ID."),
 	dimensions: z.array(z.enum(DIMENSIONS)).max(4).default(["query"]).describe("search_console; bing uses the first, query or page."),
 	page: z.string().min(1).optional().describe("search_console only: URL text, such as /blog/."),
 	query: z.string().min(1).optional().describe("search_console only: query text."),
@@ -26594,6 +27024,7 @@ function nodeCommandDeps(options) {
 				return null;
 			}
 		},
+		pageMarkdown: async (url) => extractMainMarkdown(await fetchPage(url, { refresh: options.refresh })),
 		call: options.call,
 		bing: localBing,
 		bingConnect: LOCAL_BING_CONNECT
@@ -26616,12 +27047,17 @@ async function localAccounts() {
 	}));
 }
 async function localResearchKeys() {
-	const [dataForSeo, ahrefs, saved] = await Promise.all([
+	const [dataForSeo, ahrefs, clicky, saved] = await Promise.all([
 		readDataForSeoCredentials().catch(() => void 0),
 		readAhrefsApiKey().catch(() => void 0),
+		readClickySiteKeys().catch(() => ({})),
 		cloudLinked() ? cloudKeys().catch(() => ({})) : {}
 	]);
 	const keys = new Headers(saved);
+	for (const [siteId, sitekey] of Object.entries(clicky)) {
+		const name = `${CLICKY_KEY_PREFIX}${siteId}`;
+		if (!keys.has(name)) keys.set(name, sitekey);
+	}
 	if (dataForSeo) {
 		keys.set("x-dataforseo-login", dataForSeo.login);
 		keys.set("x-dataforseo-password", dataForSeo.password);
@@ -26629,6 +27065,11 @@ async function localResearchKeys() {
 	if (ahrefs?.apiKey) keys.set("x-ahrefs-key", ahrefs.apiKey);
 	return keys;
 }
+async function localRefreshClicky() {
+	if (!cloudLinked()) return null;
+	await cloudCredentials({ refreshClicky: true });
+	return localResearchKeys();
+}
 async function resolveLocalSite(site, options = {}) {
 	const found = matchProperty((await listSites(options.refresh, options.account)).map((entry) => entry.siteUrl), site);
 	if (!found) throw new CommandError("NO_ACCESS", `This Google login has no Search Console property for ${site}. Run \`seo sites\` to list the properties it can read.`);
@@ -28934,6 +29375,6 @@ function isoDate(daysAgo = 0) {
 	return date.toISOString().slice(0, 10);
 }
 //#endregion
-export { AHREFS_API_KEY_ENV, AHREFS_API_KEY_SECRET, AI_REFERRAL_SOURCES, AI_REFERRAL_SOURCES_VERSION, ANALYTICS_PROVIDER_IDS, AUDIT_PAGE_RULE_IDS, AhrefsClient, BING_API_KEY_ENV, BING_API_KEY_SECRET, BROWSER_USER_AGENT, CANNIBAL_MAXIMUM_DOMINANT_SHARE, CANNIBAL_MINIMUM_PAGE_SHARE, CLICKY_SITEKEY_ENV, CLICKY_SITE_KEYS_SECRET, CLOUD_SIGN_IN, CLOUD_URL, CRAWL_SKIP_REASONS, CTR_DEFAULT_LIMIT, CTR_MAX_LIMIT, CTR_MAX_MIN_IMPRESSIONS, DATAFORSEO_CREDENTIAL_SECRET, DATAFORSEO_LOGIN_ENV, DATAFORSEO_PASSWORD_ENV, DEFAULT_SEARCH_CONSOLE_EXPORT_ROW_LIMIT, DEFAULT_UNREACHED_PAGE_LIMIT, DataForSeoClient, GSC_FINAL_DATA_LAG_DAYS, GSC_TIME_ZONE, GoogleApiError, INCIDENTS_URL, INTERNAL_LINK_LEXICAL_TARGET_LIMIT, INTERNAL_LINK_MATCH_EVIDENCE_LIMIT, JsonFileStorageAdapter, LOCAL_BING_CONNECT, LOCAL_SIGN_IN, LOG_MAX_AGE_MS, LOG_MAX_FILE_BYTES, LOG_MAX_TOTAL_BYTES, LocalCredentialsProvider, MANAGED_PROVIDER_SECRET_NAMES, MAX_CRAWL_CONCURRENCY, MAX_CRAWL_DEPTH, MAX_CRAWL_PAGES, MAX_CRAWL_TIMEOUT_MS, MAX_SEARCH_CONSOLE_EXPORT_FILES, MAX_SEARCH_CONSOLE_EXPORT_ROW_LIMIT, PROVIDER_SECRET_NAMES, ProviderError, ProviderExtensionRegistry, RESEARCH_IMPORT_COLUMN_KEYS, ResponseSizeLimitError, SEO_CRAWLER_IDENTITY, SEO_CRAWLER_TOKEN, SEO_CRAWLER_USER_AGENT, SEO_PROVIDER_API_VERSION, SEO_VERSION, SERP_TITLE_REFERENCE_WIDTH_PX, SERP_TITLE_WIDTH_PROFILE, STEP_CHANGE_RULES, SeoError, ServiceAccountAccessTokenClient, SessionLedger, TELEMETRY_AGENTS, TELEMETRY_ENDPOINT, TELEMETRY_ERROR_CATEGORIES, TELEMETRY_EVENTS, TELEMETRY_FAILURE_CONTEXTS, TELEMETRY_FAILURE_REASONS, TELEMETRY_NOTICE, TELEMETRY_OPERATIONS, TELEMETRY_REPORTS, TELEMETRY_SCHEMA_VERSION, TELEMETRY_TIMEOUT_MS, agentActionsView, aiReferralSourceForValue, aiReferralsReport, analyticsConnectionLabel, analyticsConnectionProviderId, analyticsConnectionSchema, analyticsProviderDetails, analyticsProviderSchema, analyzeAiReferralRows, analyzeCannibalImportRows, analyzeCannibalRows, analyzeCtrUnderperformersFromRows, analyzeDecay, analyzeIndexCoverageSignals, analyzeInternalLinksFromRows, analyzePageOpportunitiesFromRows, analyzeQueryClustersFromRows, analyzeQuickWinsFromRows, analyzeSecondPageRows, analyzeSegmentRows, analyzeStrikingDistanceRows, analyzeTrafficAnomalyRows, assertCrawlConfigLimits, assertUrlMatchesGscProperty, auditCrawlPages, auditCrawlRequests, auditPage, authStatus, bearerFetch, boundedSitemapInventory, buildAgentFindings, buildQueryClusterReportFromRows, buildTelemetryPayload, cannibalImportReport, cannibalReport, cannibalReportWith, changeWindow, checkDatabaseReadiness, classifyTelemetryFailure, clearCache, cloudAccountFor, cloudBing, cloudCredentials, cloudGoogleEmails, cloudGoogleToken, cloudKeys, cloudLinked, cloudLogout, clusterQueryRows, combineRobotsValues, compareSegmentRows, configSchema, contentCoverageRecommendation, contentCoverageType, contentOptimizationFromPageOpportunities, contentOptimizationReport, countLabel, crawlConfigHash, crawlConfigSchema, crawlDefinitionId, crawlFixToQueueItem, crawlImplementationQueueWorkflow, crawlIssueGroupSchema, crawlIssueSchema, crawlOne, crawlPageSnapshotSchema, crawlReportSchema, crawlReportSummarySchema, crawlRequestObservationSchema, crawlRunId, crawlSite, crawlSkipImpact, crawlSkipReasonCountsFromRecord, crawlStatusOnly, crawlTopFixSchema, crawlerJsonSchemas, crawlerRuleCategorySchema, crawlerRuleIdSchema, crawlerRuleInfoSchema, crawlerRuleRecommendationSchema, crawlerRuleSeveritySchema, crawlerSchemas, createAuthorizedClient, createCrawlReport, createCtrBenchmarkContext, createGoogleAccessTokenClient, createLogger, createPageRenderer, ctrUnderperformersReport, ctrUnderperformersReportWith, decayClusterDrafts, decayComparisonRange, decayingReport, decayingReportWith, deleteAhrefsApiKey, deleteBingApiKey, deleteClickySiteKey, deleteDataForSeoCredentials, deleteManagedProviderSecrets, deleteProviderExtensionAccount, deleteProviderExtensionCredentials, deleteProviderSecret, deleteTokens, deriveBrandTerms, describeInstalledProviderExtension, detectBrandTerms, detectTelemetryAgent, diagnoseCsvFiles, diagnoseProperty, diagnosePropertyWorkflow, effectiveRobotsDirectives, effectiveSnippetControl, ensurePrivateDatabaseFiles, ensureSeoCliDirs, estimateSerpTitleWidth, expectedCtrForPosition, explainRule, fetchCruxFieldData, fetchPage, fetchPageStatus, fetchSearchStatusIncidents, fetchSitemapUrls, fileSize, finalGscDateRange, findOverlappingSearchUpdates, finishCloudLogin, formatRelativeExpiry, ga4MatchReason, ga4PropertyIdFromName, ga4ReportQualityWarnings, ga4RequestCanUseCache, ga4RowsToObjects, getAuthModeStatus, getCacheStats, getClientConfig, getDb, getPrivacySnapshot, getSeoCliPaths, getServiceAccountConfig, getServiceAccountStatus, getTelemetryStatus, getTokenStorageStatus, googleJson, groupCrawlIssues, hasMetaRobotsDirective, hasRule, hasXRobotsDirective, hashKey, indexCoverageSignals, inferTemplateMovement, initializeTelemetry, inspectProviderPackage, inspectSearchConsoleUrl, inspectUrl, installProviderPackage, installedProviderPackageSchema, installedProviderPackagesSchema, internalLinksReport, interpretUpdateCorrelation, isBrandQuery, isSkippableReportError, isTelemetryCi, isTelemetryOperation, isTelemetryReport, isoDate, isoWeek, latestFinalGscDate, linkRecover, linkRecoverRecommendation, listAnalyticsAccounts, listGa4AccountSummaries, listGa4DataStreams, listGoogleAccounts, listInstalledProviderExtensions, listRules, listSearchConsoleSites, listSearchUpdates, listSites, loadInstalledProviderExtensions, loadProviderExtensions, loadProviderPackage, loadSearchConsoleExport, localAccounts, localBing, localCredentialsProvider, localError, localGoogleFetch, localResearchKeys, loginWithLoopback, makeRunId, matchGa4WebStreams, measureCoverage, metaRobotsDirectives, migrateLegacyMacConfig, missingOAuthClientMessage, missingSharedClientLoginMessage, nodeCommandDeps, normalizeBrandText, normalizeClickySiteId, normalizeClickySiteKey, normalizeCrawlConfig, normalizeCrawlSkipReasonCounts, normalizeForCoverage, normalizeHttpUrl, normalizeJavaScriptRenderingMode, normalizeLoadedCrawlReport, normalizeProviderExtensionAccount, normalizedResearchColumnName, notSignedIn, noteCacheWrite, openCloudLink, pageEvidenceRecommendation, pageOpportunitiesReport, parseOlderThan, pendingCloudLogin, performanceAudit, performanceReportIsCacheable, plural, providerCapabilitySchema, providerConnectionFieldSchema, providerExactVersionSchema, providerExtensionIdSchema, providerIdSchema, providerIntegritySchema, providerKindSchema, providerPackageManifestSchema, providerPackageNameSchema, providerPreferenceSchema, providerRegistrationSchema, providerRequestJson, providerRequestText, pruneLogs, publicHttpFetch, queryClusterReport, queryClusterTokens, queryContentCoverageFromPage, queryContentFieldsFromPage, queryFieldCoverage, queryOpportunityRecommendation, queryPageMetrics, queryPageTopQuery, queryPagesMetrics, queryPagesMetricsBatch, queryPagesTopQueries, queryPagesTopQueriesBatch, querySearchAnalytics, quickWinsCsvRows, quickWinsReport, quickWinsReportWith, readAhrefsApiKey, readAllTokens, readBingApiKey, readBoundedResponseText, readClickySiteKey, readConfig, readDataForSeoCredentials, readInstalledProviderPackages, readJson, readJsonOrUndefined, readOauthClient, readProviderExtensionAccount, readProviderExtensionCredentials, readProviderSecret, readTokens, recommendationForRule, reconcileExportPagesWithCrawl, redirectTrace, refreshAuthToken, refreshPrioritiesCsvFiles, refreshPrioritiesWorkflow, registrableDomain, removeInstalledProviderPackage, renderCrawlCsv, renderCrawlHtml, renderCrawlJunit, renderCrawlMarkdownTickets, renderCrawlPagesCsv, renderCrawlPretty, renderCsv, renderPresentationTablesMarkdown, renderWorkflowMarkdown, reportNarrative, requestHeaders, requirePageVerification, researchImportColumns, resetSeoData, resolveLocalSite, resolveSegmentRanges, resolveSeoCliPaths, reviewObservations, roundedPosition, runAnalyticsProviderLandingPages, runAnalyticsReport, runDoctor, runGa4Report, runProviderExtensionAction, runtimeForProvider, safeProviderAdapterError, saveInstalledProviderPackage, searchAnalyticsRows, searchUpdatesFromIncidents, secondPage, secondPageWith, segmentComparisonRange, segmentImpact, segmentRangeDays, seoErrorEnvelope, sessionSourceInListFilter, setActiveGoogleAccount, setTelemetryEnabled, setTokenStorageMode, shiftIsoDate, shouldExcludeBrandQuery, startCloudLogin, strikingDistance, strikingDistanceWith, summarizeCrawlReport, pageTechnicalSignals as technicalPageSignals, telemetryErrorCategory, toSeoError, tokenSchema, tokenStoreSchema, topFixes, trackTelemetryCommandFailed, trackTelemetryReportComplete, trackTelemetryReportFailed, trackTelemetryReportStart, trackTelemetrySetupComplete, trafficAnomaly, trafficAnomalyWith, unavailableSegmentImpactReport, unicodeTokens, uninstallProviderExtension, updateCorrelation, updatePostmortemCsvFiles, updatePostmortemWorkflow, validateResearchImportColumnSources, verifyAnalyticsProvider, verifyProviderExtension, verifyQueryContent, verifyQueryContentWith, withAgentReportContract, workflowPresentation, writeAhrefsApiKey, writeBingApiKey, writeClickySiteKey, writeConfig, writeDataForSeoCredentials, writeInstalledProviderPackages, writeOauthClient, writeProviderExtensionAccount, writeProviderExtensionCredentials, writeProviderSecret, writeTokens, xRobotsDirectives };
+export { AHREFS_API_KEY_ENV, AHREFS_API_KEY_SECRET, AI_REFERRAL_SOURCES, AI_REFERRAL_SOURCES_VERSION, ANALYTICS_PROVIDER_IDS, AUDIT_PAGE_RULE_IDS, AhrefsClient, BING_API_KEY_ENV, BING_API_KEY_SECRET, BROWSER_USER_AGENT, CANNIBAL_MAXIMUM_DOMINANT_SHARE, CANNIBAL_MINIMUM_PAGE_SHARE, CLICKY_SITEKEY_ENV, CLICKY_SITE_KEYS_SECRET, CLOUD_SIGN_IN, CLOUD_URL, CRAWL_SKIP_REASONS, CTR_DEFAULT_LIMIT, CTR_MAX_LIMIT, CTR_MAX_MIN_IMPRESSIONS, DATAFORSEO_CREDENTIAL_SECRET, DATAFORSEO_LOGIN_ENV, DATAFORSEO_PASSWORD_ENV, DEFAULT_SEARCH_CONSOLE_EXPORT_ROW_LIMIT, DEFAULT_UNREACHED_PAGE_LIMIT, DataForSeoClient, GSC_FINAL_DATA_LAG_DAYS, GSC_TIME_ZONE, GoogleApiError, INCIDENTS_URL, INTERNAL_LINK_LEXICAL_TARGET_LIMIT, INTERNAL_LINK_MATCH_EVIDENCE_LIMIT, JsonFileStorageAdapter, LOCAL_BING_CONNECT, LOCAL_SIGN_IN, LOG_MAX_AGE_MS, LOG_MAX_FILE_BYTES, LOG_MAX_TOTAL_BYTES, LocalCredentialsProvider, MANAGED_PROVIDER_SECRET_NAMES, MAX_CRAWL_CONCURRENCY, MAX_CRAWL_DEPTH, MAX_CRAWL_PAGES, MAX_CRAWL_TIMEOUT_MS, MAX_SEARCH_CONSOLE_EXPORT_FILES, MAX_SEARCH_CONSOLE_EXPORT_ROW_LIMIT, PROVIDER_SECRET_NAMES, ProviderError, ProviderExtensionRegistry, RESEARCH_IMPORT_COLUMN_KEYS, ResponseSizeLimitError, SEO_CRAWLER_IDENTITY, SEO_CRAWLER_TOKEN, SEO_CRAWLER_USER_AGENT, SEO_PROVIDER_API_VERSION, SEO_VERSION, SERP_TITLE_REFERENCE_WIDTH_PX, SERP_TITLE_WIDTH_PROFILE, STEP_CHANGE_RULES, SeoError, ServiceAccountAccessTokenClient, SessionLedger, TELEMETRY_AGENTS, TELEMETRY_ENDPOINT, TELEMETRY_ERROR_CATEGORIES, TELEMETRY_EVENTS, TELEMETRY_FAILURE_CONTEXTS, TELEMETRY_FAILURE_REASONS, TELEMETRY_NOTICE, TELEMETRY_OPERATIONS, TELEMETRY_REPORTS, TELEMETRY_SCHEMA_VERSION, TELEMETRY_TIMEOUT_MS, agentActionsView, aiReferralSourceForValue, aiReferralsReport, analyticsConnectionLabel, analyticsConnectionProviderId, analyticsConnectionSchema, analyticsProviderDetails, analyticsProviderSchema, analyzeAiReferralRows, analyzeCannibalImportRows, analyzeCannibalRows, analyzeCtrUnderperformersFromRows, analyzeDecay, analyzeIndexCoverageSignals, analyzeInternalLinksFromRows, analyzePageOpportunitiesFromRows, analyzeQueryClustersFromRows, analyzeQuickWinsFromRows, analyzeSecondPageRows, analyzeSegmentRows, analyzeStrikingDistanceRows, analyzeTrafficAnomalyRows, assertCrawlConfigLimits, assertUrlMatchesGscProperty, auditCrawlPages, auditCrawlRequests, auditPage, authStatus, bearerFetch, boundedSitemapInventory, buildAgentFindings, buildQueryClusterReportFromRows, buildTelemetryPayload, cannibalImportReport, cannibalReport, cannibalReportWith, changeWindow, checkDatabaseReadiness, classifyTelemetryFailure, clearCache, cloudAccountFor, cloudBing, cloudCredentials, cloudGoogleEmails, cloudGoogleToken, cloudKeys, cloudLinked, cloudLogout, clusterQueryRows, combineRobotsValues, compareSegmentRows, configSchema, contentCoverageRecommendation, contentCoverageType, contentOptimizationFromPageOpportunities, contentOptimizationReport, countLabel, crawlConfigHash, crawlConfigSchema, crawlDefinitionId, crawlFixToQueueItem, crawlImplementationQueueWorkflow, crawlIssueGroupSchema, crawlIssueSchema, crawlOne, crawlPageSnapshotSchema, crawlReportSchema, crawlReportSummarySchema, crawlRequestObservationSchema, crawlRunId, crawlSite, crawlSkipImpact, crawlSkipReasonCountsFromRecord, crawlStatusOnly, crawlTopFixSchema, crawlerJsonSchemas, crawlerRuleCategorySchema, crawlerRuleIdSchema, crawlerRuleInfoSchema, crawlerRuleRecommendationSchema, crawlerRuleSeveritySchema, crawlerSchemas, createAuthorizedClient, createCrawlReport, createCtrBenchmarkContext, createGoogleAccessTokenClient, createLogger, createPageRenderer, ctrUnderperformersReport, ctrUnderperformersReportWith, decayClusterDrafts, decayComparisonRange, decayingReport, decayingReportWith, deleteAhrefsApiKey, deleteBingApiKey, deleteClickySiteKey, deleteDataForSeoCredentials, deleteManagedProviderSecrets, deleteProviderExtensionAccount, deleteProviderExtensionCredentials, deleteProviderSecret, deleteTokens, deriveBrandTerms, describeInstalledProviderExtension, detectBrandTerms, detectTelemetryAgent, diagnoseCsvFiles, diagnoseProperty, diagnosePropertyWorkflow, effectiveRobotsDirectives, effectiveSnippetControl, ensurePrivateDatabaseFiles, ensureSeoCliDirs, estimateSerpTitleWidth, expectedCtrForPosition, explainRule, fetchCruxFieldData, fetchPage, fetchPageStatus, fetchSearchStatusIncidents, fetchSitemapUrls, fileSize, finalGscDateRange, findOverlappingSearchUpdates, finishCloudLogin, formatRelativeExpiry, ga4MatchReason, ga4PropertyIdFromName, ga4ReportQualityWarnings, ga4RequestCanUseCache, ga4RowsToObjects, getAuthModeStatus, getCacheStats, getClientConfig, getDb, getPrivacySnapshot, getSeoCliPaths, getServiceAccountConfig, getServiceAccountStatus, getTelemetryStatus, getTokenStorageStatus, googleJson, groupCrawlIssues, hasMetaRobotsDirective, hasRule, hasXRobotsDirective, hashKey, indexCoverageSignals, inferTemplateMovement, initializeTelemetry, inspectProviderPackage, inspectSearchConsoleUrl, inspectUrl, installProviderPackage, installedProviderPackageSchema, installedProviderPackagesSchema, internalLinksReport, interpretUpdateCorrelation, isBrandQuery, isSkippableReportError, isTelemetryCi, isTelemetryOperation, isTelemetryReport, isoDate, isoWeek, latestFinalGscDate, linkRecover, linkRecoverRecommendation, listAnalyticsAccounts, listGa4AccountSummaries, listGa4DataStreams, listGoogleAccounts, listInstalledProviderExtensions, listRules, listSearchConsoleSites, listSearchUpdates, listSites, loadInstalledProviderExtensions, loadProviderExtensions, loadProviderPackage, loadSearchConsoleExport, localAccounts, localBing, localCredentialsProvider, localError, localGoogleFetch, localRefreshClicky, localResearchKeys, loginWithLoopback, makeRunId, matchGa4WebStreams, measureCoverage, metaRobotsDirectives, migrateLegacyMacConfig, missingOAuthClientMessage, missingSharedClientLoginMessage, nodeCommandDeps, normalizeBrandText, normalizeClickySiteId, normalizeClickySiteKey, normalizeCrawlConfig, normalizeCrawlSkipReasonCounts, normalizeForCoverage, normalizeHttpUrl, normalizeJavaScriptRenderingMode, normalizeLoadedCrawlReport, normalizeProviderExtensionAccount, normalizedResearchColumnName, notSignedIn, noteCacheWrite, openCloudLink, pageEvidenceRecommendation, pageOpportunitiesReport, parseOlderThan, pendingCloudLogin, performanceAudit, performanceReportIsCacheable, plural, providerCapabilitySchema, providerConnectionFieldSchema, providerExactVersionSchema, providerExtensionIdSchema, providerIdSchema, providerIntegritySchema, providerKindSchema, providerPackageManifestSchema, providerPackageNameSchema, providerPreferenceSchema, providerRegistrationSchema, providerRequestJson, providerRequestText, pruneLogs, publicHttpFetch, queryClusterReport, queryClusterTokens, queryContentCoverageFromPage, queryContentFieldsFromPage, queryFieldCoverage, queryOpportunityRecommendation, queryPageMetrics, queryPageTopQuery, queryPagesMetrics, queryPagesMetricsBatch, queryPagesTopQueries, queryPagesTopQueriesBatch, querySearchAnalytics, quickWinsCsvRows, quickWinsReport, quickWinsReportWith, readAhrefsApiKey, readAllTokens, readBingApiKey, readBoundedResponseText, readClickySiteKey, readClickySiteKeys, readConfig, readDataForSeoCredentials, readInstalledProviderPackages, readJson, readJsonOrUndefined, readOauthClient, readProviderExtensionAccount, readProviderExtensionCredentials, readProviderSecret, readTokens, recommendationForRule, reconcileExportPagesWithCrawl, redirectTrace, refreshAuthToken, refreshPrioritiesCsvFiles, refreshPrioritiesWorkflow, registrableDomain, removeInstalledProviderPackage, renderCrawlCsv, renderCrawlHtml, renderCrawlJunit, renderCrawlMarkdownTickets, renderCrawlPagesCsv, renderCrawlPretty, renderCsv, renderPresentationTablesMarkdown, renderWorkflowMarkdown, reportNarrative, requestHeaders, requirePageVerification, researchImportColumns, resetSeoData, resolveLocalSite, resolveSegmentRanges, resolveSeoCliPaths, reviewObservations, roundedPosition, runAnalyticsProviderLandingPages, runAnalyticsReport, runDoctor, runGa4Report, runProviderExtensionAction, runtimeForProvider, safeProviderAdapterError, saveInstalledProviderPackage, searchAnalyticsRows, searchUpdatesFromIncidents, secondPage, secondPageWith, segmentComparisonRange, segmentImpact, segmentRangeDays, seoErrorEnvelope, sessionSourceInListFilter, setActiveGoogleAccount, setTelemetryEnabled, setTokenStorageMode, shiftIsoDate, shouldExcludeBrandQuery, startCloudLogin, strikingDistance, strikingDistanceWith, summarizeCrawlReport, pageTechnicalSignals as technicalPageSignals, telemetryErrorCategory, toSeoError, tokenSchema, tokenStoreSchema, topFixes, trackTelemetryCommandFailed, trackTelemetryReportComplete, trackTelemetryReportFailed, trackTelemetryReportStart, trackTelemetrySetupComplete, trafficAnomaly, trafficAnomalyWith, unavailableSegmentImpactReport, unicodeTokens, uninstallProviderExtension, updateCorrelation, updatePostmortemCsvFiles, updatePostmortemWorkflow, validateResearchImportColumnSources, verifyAnalyticsProvider, verifyProviderExtension, verifyQueryContent, verifyQueryContentWith, withAgentReportContract, workflowPresentation, writeAhrefsApiKey, writeBingApiKey, writeClickySiteKey, writeConfig, writeDataForSeoCredentials, writeInstalledProviderPackages, writeOauthClient, writeProviderExtensionAccount, writeProviderExtensionCredentials, writeProviderSecret, writeTokens, xRobotsDirectives };
 
 //# sourceMappingURL=index.js.map