seo 0.5.0 → 0.7.0

package/dist/mcp.js

@@ -1,5 +1,5 @@
 import { createRequire as __seoCreateRequire } from 'node:module'; const require = __seoCreateRequire(import.meta.url);
-import { i as __toESM, n as load, r as __commonJSMin, t as version } from "./package-CsRkLZGn.js";
+import { i as __toESM, n as load, r as __commonJSMin, t as version } from "./package-CmplBMg7.js";
 import { createHash, randomUUID, sign } from "node:crypto";
 import { ZodOptional, z } from "zod";
 import { arch, homedir, platform, totalmem } from "node:os";
@@ -13774,7 +13774,7 @@ async function runAnalyticsReport(gfetch, propertyId, body, options) {
 //#endregion
 //#region packages/core/dist/bing/api.js
 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}`);
@@ -13799,7 +13799,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;
 	};
 }
 function day(value) {
@@ -13808,7 +13808,7 @@ function day(value) {
 	const date = legacy ? new Date(Number(legacy[1])) : new Date(value);
 	return Number.isNaN(date.getTime()) ? null : date.toISOString().slice(0, 10);
 }
-const count = (value) => typeof value === "number" && Number.isFinite(value) && value >= 0 ? value : null;
+const count$1 = (value) => typeof value === "number" && Number.isFinite(value) && value >= 0 ? value : null;
 function list(data, label) {
 	if (!Array.isArray(data)) throw new SeoError("OPTIONAL_PROVIDER_UNAVAILABLE", `Bing Webmaster returned an invalid ${label}.`);
 	return data.filter((item) => Boolean(item) && typeof item === "object");
@@ -13824,8 +13824,8 @@ async function bingTraffic(call, site) {
 	let invalidRows = 0;
 	for (const row of list(await call("GetRankAndTrafficStats", { siteUrl: site }), "traffic list")) {
 		const date = day(row.Date);
-		const clicks = count(row.Clicks);
-		const impressions = count(row.Impressions);
+		const clicks = count$1(row.Clicks);
+		const impressions = count$1(row.Impressions);
 		if (!date || clicks === null || impressions === null) {
 			invalidRows += 1;
 			continue;
@@ -13848,9 +13848,9 @@ async function keyed(call, method, params) {
 	for (const row of list(await call(method, params), "row list")) {
 		const date = day(row.Date);
 		const key = typeof row.Query === "string" ? row.Query.trim() : "";
-		const clicks = count(row.Clicks);
-		const impressions = count(row.Impressions);
-		const position = count(row.AvgImpressionPosition);
+		const clicks = count$1(row.Clicks);
+		const impressions = count$1(row.Impressions);
+		const position = count$1(row.AvgImpressionPosition);
 		if (!date || !key || clicks === null || impressions === null) {
 			invalidRows += 1;
 			continue;
@@ -14430,7 +14430,7 @@ async function readableSites(google, signIn) {
 		permissionLevel: entry.permissionLevel ?? ""
 	})).sort((a, b) => a.siteUrl.localeCompare(b.siteUrl));
 }
-const hostOf = (value) => {
+const hostOf$1 = (value) => {
 	try {
 		return new URL(value.includes("://") ? value : `https://${value.replace(/^sc-domain:/, "")}`).hostname.replace(/^www\./, "");
 	} catch {
@@ -14448,14 +14448,14 @@ async function runSites(input) {
 		};
 	})), input.bing ? listBingSites(input.bing).catch((error) => error instanceof Error ? error : new Error(String(error))) : Promise.resolve(null)]);
 	const bingSites = Array.isArray(bing) ? bing.filter((site) => site.verified) : [];
-	const bingByHost = new Map(bingSites.map((site) => [hostOf(site.url), site]));
+	const bingByHost = new Map(bingSites.map((site) => [hostOf$1(site.url), site]));
 	const properties = google.flatMap((account) => account.properties instanceof Error ? [] : account.properties.map((property) => ({
 		...property,
 		...named ? { account: account.email ?? "" } : {},
-		...Array.isArray(bing) ? { bing: bingByHost.get(hostOf(property.siteUrl))?.url ?? "" } : {}
+		...Array.isArray(bing) ? { bing: bingByHost.get(hostOf$1(property.siteUrl))?.url ?? "" } : {}
 	})));
-	const googleHosts = new Set(properties.map((property) => hostOf(property.siteUrl)));
-	const bingOnly = bingSites.filter((site) => !googleHosts.has(hostOf(site.url)));
+	const googleHosts = new Set(properties.map((property) => hostOf$1(property.siteUrl)));
+	const bingOnly = bingSites.filter((site) => !googleHosts.has(hostOf$1(site.url)));
 	const failed = google.filter((account) => account.properties instanceof Error);
 	const analytics = google.flatMap((account) => (account.analytics ?? []).flatMap((summary) => summary.propertySummaries.map((property) => ({
 		property: property.property.replace("properties/", ""),
@@ -14484,6 +14484,7 @@ async function runSites(input) {
 			], null)}` : "Google Analytics: no properties readable with these sign-ins.",
 			input.bing === void 0 ? null : bing === null ? "Bing Webmaster: not connected." : bing instanceof Error ? `Bing Webmaster: could not list sites. ${bing.message}` : bingOnly.length ? `Bing Webmaster sites with no Search Console property here (${bingOnly.length}): ${bingOnly.map((site) => site.url).join(", ")}.` : `Bing Webmaster: ${bingSites.length} verified sites; the bing column shows each one.`,
 			`Research keys: ${research.length ? research.join(", ") : "none"}.`,
+			input.clicky?.length ? `Clicky sites (seo_data with source "clicky"): ${input.clicky.join(", ")}.` : null,
 			`Add a Google account${input.bing === void 0 ? "" : ", Bing"} or a key: ${input.connect}`,
 			"Next: seo_report with a site."
 		].filter(Boolean).join("\n\n"),
@@ -14491,7 +14492,8 @@ async function runSites(input) {
 			searchConsole: properties,
 			googleAnalytics: analytics,
 			bing: Array.isArray(bing) ? bingSites : null,
-			research
+			research,
+			clicky: input.clicky ?? []
 		}
 	};
 }
@@ -14751,13 +14753,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;
@@ -16800,7 +16802,7 @@ function extractCanonicalEvidence($, headers, baseUrl) {
 //#region packages/core/dist/extract/content-sketch.js
 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) {
@@ -16811,7 +16813,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,
@@ -16823,6 +16825,11 @@ function contentSketch(value) {
 }
 //#endregion
 //#region packages/core/dist/extract/main-content.js
+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);
 }
@@ -16852,10 +16859,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,
@@ -16868,13 +16871,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();
@@ -16882,13 +16899,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;
@@ -16911,6 +16928,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/dist/extract/google-rich-results.js
 const SUPPORTED_TYPES = /* @__PURE__ */ new Set([
@@ -20686,7 +20725,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",
@@ -20751,7 +20790,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([
@@ -25631,6 +25670,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();
@@ -27687,7 +27729,7 @@ function analyzeCtrUnderperformersFromRows(input) {
 //#endregion
 //#region packages/core/dist/analyze/ctr-underperformers-report.js
 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;
@@ -27710,7 +27752,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"
@@ -30915,7 +30957,7 @@ function quickWinTemplateSummaries(items) {
 }
 //#endregion
 //#region packages/core/dist/analyze/site-diagnostics/quick-wins-report.js
-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;
@@ -30937,7 +30979,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"
@@ -31361,7 +31403,7 @@ function analyzeStrikingDistanceRows(input) {
 }
 //#endregion
 //#region packages/core/dist/analyze/striking-distance-report.js
-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;
@@ -31370,7 +31412,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;
 }
@@ -32810,20 +32852,394 @@ function analyzeInternalLinksFromRows(input) {
 		}
 	};
 }
-//#endregion
-//#region packages/core/dist/analyze/internal-links-report.js
-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/dist/analyze/internal-links-report.js
+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 {
@@ -32881,9 +33297,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 {
@@ -32953,7 +33368,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) {
@@ -32987,9 +33407,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 {
@@ -33079,12 +33498,21 @@ async function verifyInternalLinkCandidate(input) {
 				confidence
 			}
 		},
+		text: placementPage({
+			...page,
+			url: page.finalUrl,
+			html: fetched.html
+		}),
 		warnings
 	};
 }
 //#endregion
 //#region packages/core/dist/analyze/internal-links.js
 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,
@@ -33095,43 +33523,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) => {
@@ -33163,8 +33565,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, {
@@ -33185,10 +33586,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;
@@ -33197,25 +33597,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;
@@ -33277,13 +33679,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,
@@ -33315,18 +33718,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),
@@ -33334,6 +33739,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/dist/analyze/url-templates.js
 const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
@@ -36920,6 +37348,61 @@ async function updatePostmortemWorkflow(input, dependencies = {}) {
 		}
 	});
 }
+//#endregion
+//#region packages/core/dist/clicky/api.js
+const ENDPOINT$1 = "https://api.clicky.com/api/stats/4";
+const MAX_BYTES$1 = 5e6;
+var ClickyError = class extends Error {
+	code;
+	constructor(code, message) {
+		super(message);
+		this.code = code;
+	}
+};
+function isClickySiteId(value) {
+	return /^\d{1,30}$/u.test(value.trim());
+}
+function isClickySitekey(value) {
+	return /^[A-Za-z0-9]{12,64}$/u.test(value.trim());
+}
+async function clickyStats(site, types, options = {}) {
+	const url = new URL(ENDPOINT$1);
+	url.searchParams.set("site_id", site.siteId);
+	url.searchParams.set("sitekey", site.sitekey);
+	url.searchParams.set("type", types.join(","));
+	url.searchParams.set("output", "json");
+	url.searchParams.set("limit", String(options.limit ?? 1e3));
+	url.searchParams.set("app", "seo");
+	if (options.date) url.searchParams.set("date", options.date);
+	const response = await fetch(url).catch(() => {
+		throw new ClickyError("remote", "Could not reach Clicky. Try again.");
+	});
+	if (!response.ok) throw new ClickyError("remote", `Clicky returned ${response.status}.`);
+	const groups = await readJson(response, "Clicky", { maxBytes: MAX_BYTES$1 });
+	if (!Array.isArray(groups)) throw new ClickyError("remote", "Clicky returned invalid data.");
+	const failed = groups.find((group) => typeof group?.error === "string");
+	if (failed?.error) throw /sitekey|site id|authenticat|permission/iu.test(failed.error) ? new ClickyError("auth", `Clicky rejected site ID ${site.siteId} or its sitekey.`) : new ClickyError("remote", `Clicky: ${failed.error.slice(0, 200)}`);
+	const out = {};
+	for (const type of types) out[type] = [];
+	for (const group of groups) {
+		if (!group?.type || !(group.type in out)) continue;
+		for (const date of group.dates ?? []) for (const item of date.items ?? []) if (item && typeof item === "object") out[group.type]?.push(item);
+	}
+	return out;
+}
+async function clickyDomain(site) {
+	const { pages } = await clickyStats(site, ["pages"], {
+		date: "last-30-days",
+		limit: 1
+	});
+	const url = pages?.find((item) => item.url)?.url;
+	if (!url) return null;
+	try {
+		return new URL(url).hostname.replace(/^www\./u, "");
+	} catch {
+		return null;
+	}
+}
 function rowsText(input) {
 	const total = input.rows.length;
 	if (input.detail === "full") return `${input.title}\n\n${JSON.stringify(input.rows.slice(input.offset, input.offset + input.limit))}`;
@@ -37104,7 +37587,8 @@ async function runAnalyticsRows(input, google, options) {
 //#endregion
 //#region packages/core/dist/commands/bing.js
 const BING_LIMITS = ["Bing and Google count clicks, impressions and positions their own way. Their numbers sit side by side here and are never added together.", "Bing lists only its top queries and pages, grouped by week. A query or page missing from Bing’s list is unknown, not zero."];
-const LOCAL_BING = `Bing blocks the hosted server, so Bing data comes from the CLI on a machine. If you have a shell, link the CLI to the same account once: run \`npx -y seo login\`, show the person the link it prints, and after they approve it run \`npx -y seo login\` again. \`npx -y seo\` commands then use the same Google accounts, Bing and keys. Connect Bing on the account page if it is not connected, then run \`npx -y seo report --site <site> --section bing --json\`.`;
+const CLI_LINK = "If you have a shell, link the CLI to the same account once: run `npx -y seo login`, show the person the link it prints, and after they approve it run `npx -y seo login` again. `npx -y seo` commands then use the same Google accounts, Bing and keys.";
+const LOCAL_BING = `Bing blocks the hosted server, so Bing data comes from the CLI on a machine. ${CLI_LINK} Connect Bing on the account page if it is not connected, then run \`npx -y seo report --site <site> --section bing --json\`.`;
 const NO_BING_HERE = "Bing: not included here, so these totals show Google only. Some sites get most of their search visits from Bing; the CLI reads them with the same account: `npx -y seo login` once, then `npx -y seo report --site <site> --section bing --json`.";
 const BING_HOME = "https://www.bing.com/webmasters";
 const noBingData = (site) => `Bing has no data for ${site} yet. Newly added or newly verified sites take a few days to show data in Bing Webmaster Tools.`;
@@ -37322,6 +37806,161 @@ async function runBingRows(input, deps) {
 	};
 }
 //#endregion
+//#region packages/core/dist/commands/clicky.js
+const CLICKY_KEY_PREFIX = "x-clicky-";
+function clickySites(keys) {
+	const sites = [];
+	for (const [name, value] of keys) {
+		if (!name.startsWith("x-clicky-")) continue;
+		const siteId = name.slice(9);
+		if (!isClickySiteId(siteId)) continue;
+		let sitekey = value.trim();
+		let domain = null;
+		let account = false;
+		if (sitekey.startsWith("{")) try {
+			const parsed = JSON.parse(sitekey);
+			sitekey = typeof parsed.sitekey === "string" ? parsed.sitekey : "";
+			domain = typeof parsed.domain === "string" ? parsed.domain : null;
+			account = parsed.account === true;
+		} catch {
+			continue;
+		}
+		if (isClickySitekey(sitekey)) sites.push({
+			siteId,
+			sitekey,
+			domain,
+			account
+		});
+	}
+	return sites.sort((left, right) => left.siteId < right.siteId ? -1 : left.siteId > right.siteId ? 1 : 0);
+}
+const clickyLabel = (site) => site.domain ? `${site.siteId} (${site.domain})` : site.siteId;
+function hostOf(value) {
+	const text = value.trim().toLowerCase().replace(/^sc-domain:/u, "");
+	try {
+		return new URL(text.includes("://") ? text : `https://${text}`).hostname.replace(/^www\./u, "");
+	} catch {
+		return text;
+	}
+}
+async function pickClickySite(saved, target, connect, refresh) {
+	const host = hostOf(target);
+	const match = (site) => site.siteId === target.trim() || site.domain === host;
+	let sites = saved;
+	if (!sites.some(match) && refresh) sites = await refresh() ?? sites;
+	if (!sites.length) throw new CommandError("NO_KEY", `No Clicky site is saved. Add your Clicky account, or one site's ID and sitekey (Clicky, Preferences, Info): ${connect}`);
+	const found = sites.find(match);
+	if (found) return found;
+	if (!isClickySiteId(target)) {
+		for (const site of sites.filter((item) => !item.domain).slice(0, 10)) site.domain = await clickyDomain(site).catch(() => null);
+		const named = sites.find(match);
+		if (named) return named;
+	}
+	throw new CommandError("NO_ACCESS", `No saved Clicky site matches ${target}. Saved Clicky sites: ${sites.map(clickyLabel).join(", ")}. Pass one of these site IDs, or add the site: ${connect}`);
+}
+const DAY = 864e5;
+const isoDay = (time) => new Date(time).toISOString().slice(0, 10);
+function clickyRange(input) {
+	if (!input.startDate && !input.endDate) {
+		const end = Date.now() - DAY;
+		return {
+			startDate: isoDay(end - 27 * DAY),
+			endDate: isoDay(end)
+		};
+	}
+	const start = Date.parse(`${input.startDate}T00:00:00Z`);
+	const end = Date.parse(`${input.endDate}T00:00:00Z`);
+	if (!input.startDate || !input.endDate || !(start <= end)) throw new CommandError("INVALID_INPUT", "Send a start date and an end date together, in order.");
+	if ((end - start) / DAY + 1 > 31) throw new CommandError("INVALID_INPUT", "Clicky reads at most 31 days at a time. Send a shorter range.");
+	return {
+		startDate: input.startDate,
+		endDate: input.endDate
+	};
+}
+const count = (item) => {
+	const value = Number(item.value);
+	return Number.isSafeInteger(value) && value >= 0 ? value : null;
+};
+const totals = (items) => items.map((item) => ({
+	name: item.title ?? "",
+	visits: count(item)
+})).filter((item) => Boolean(item.name) && item.visits !== null);
+const line = (items) => {
+	const top = items.slice(0, 10).map((item) => `${item.name} ${item.visits}`);
+	const rest = items.slice(10);
+	if (rest.length) top.push(`${rest.length} others ${rest.reduce((sum, item) => sum + item.visits, 0)}`);
+	return top.join("; ");
+};
+const LIMIT = 1e3;
+async function runClickyRows(input, keys, options) {
+	const refresh = options.refresh;
+	const site = await pickClickySite(clickySites(keys), input.site, options.connect, refresh && (async () => {
+		const fresh = await refresh().catch(() => null);
+		return fresh && clickySites(fresh);
+	}));
+	const range = clickyRange(input);
+	const offset = input.offset ?? 0;
+	const stats = await clickyStats(site, [
+		"pages-entrance",
+		"traffic-sources",
+		"searches-engines"
+	], {
+		date: `${range.startDate},${range.endDate}`,
+		limit: LIMIT
+	}).catch((error) => {
+		if (error instanceof ClickyError) throw new CommandError(error.code === "auth" ? "NO_ACCESS" : "PROVIDER_ERROR", error.code === "auth" ? `${error.message} Save it again: ${options.connect}` : error.message);
+		throw error;
+	});
+	const entrances = stats["pages-entrance"] ?? [];
+	const visitsByPage = /* @__PURE__ */ new Map();
+	for (const item of entrances) {
+		const visits = count(item);
+		if (visits === null || !item.url) continue;
+		let page;
+		try {
+			page = new URL(item.url).pathname;
+		} catch {
+			continue;
+		}
+		visitsByPage.set(page, (visitsByPage.get(page) ?? 0) + visits);
+	}
+	const rows = [...visitsByPage].map(([page, visits]) => ({
+		page,
+		visits
+	})).sort((left, right) => right.visits - left.visits || (left.page < right.page ? -1 : left.page > right.page ? 1 : 0));
+	const sources = totals(stats["traffic-sources"] ?? []);
+	const engines = totals(stats["searches-engines"] ?? []);
+	const notes = [
+		"Visits by landing page from every source, as Clicky counts them, in the Clicky site’s time zone. Clicky does not split landing pages by source.",
+		sources.length ? `Traffic sources (visits): ${line(sources)}.` : "Traffic sources: none in this range.",
+		engines.length ? `Search engines (visits): ${line(engines)}.` : "Search engines: none in this range."
+	];
+	if (entrances.length >= LIMIT) notes.push(`Clicky returned its ${LIMIT}-row limit; pages past it are missing, not zero.`);
+	return {
+		text: rowsText({
+			title: `Clicky site ${clickyLabel(site)}: landing pages, ${range.startDate} to ${range.endDate}.`,
+			rows,
+			offset,
+			limit: 50,
+			detail: input.detail ?? "summary",
+			notes,
+			more: options.call
+		}),
+		data: {
+			siteId: site.siteId,
+			domain: site.domain,
+			range,
+			metric: "visits",
+			sources,
+			searchEngines: engines,
+			capped: entrances.length >= LIMIT,
+			total: rows.length,
+			offset,
+			rows: rows.slice(offset, offset + 50)
+		}
+	};
+}
+//#endregion
 //#region packages/core/dist/commands/domain-rating.js
 const DR_ATTRIBUTION = "domain_rating: Domain Rating by Ahrefs (https://ahrefs.com/).";
 const ENDPOINT = "https://api.ahrefs.com/v3/public/domain-rating-free";
@@ -37547,7 +38186,7 @@ function nextFor(section, call) {
 		"second-page": `Next: ${call("page")} for one page’s queries and live facts.`,
 		"content-decay": `Next: ${call("index")} for pages that lost most of their clicks; ${call("page")} to see which queries moved.`,
 		cannibalization: `Next: ${call("page")} on each competing URL to see Google’s chosen canonical.`,
-		"traffic-drop": `Next: ${call("compare")} with the date the drop started, for the pages and queries that moved.`,
+		"traffic-drop": `Next: ${call("compare")} with the date the drop started, for the pages and queries that moved; ${call("index")} for pages that lost almost all their clicks and their index status.`,
 		bing: `Next: ${call("data", { source: "bing" })} for every Bing row; ${call("page")} for one page.`
 	}[section];
 }
@@ -38235,11 +38874,13 @@ async function runPage(input, deps) {
 			}]
 		}]
 	});
-	const [[facts], indexed, now, then] = await Promise.all([
+	const full = input.detail === "full";
+	const [[facts], indexed, now, then, markdown] = await Promise.all([
 		deps.checkPages([input.url]),
 		deps.inspect(input.site, input.url),
 		query(range),
-		query(before)
+		query(before),
+		full && deps.pageMarkdown ? deps.pageMarkdown(input.url).catch((error) => ({ error: error instanceof Error ? error.message : String(error) })) : null
 	]);
 	const old = new Map(then.rows.map((row) => [row.keys[0], row]));
 	const seen = /* @__PURE__ */ new Set();
@@ -38274,23 +38915,32 @@ async function runPage(input, deps) {
 	const sum = (list, key) => list.reduce((total, row) => total + row[key], 0);
 	const offset = input.offset ?? 0;
 	return {
-		text: `${rowsText({
-			title: `${input.url} in ${input.site}, ${range.startDate} to ${range.endDate} against ${before.startDate} to ${before.endDate}.`,
-			notes: [
-				`Live page (fetched now, no redirects followed):\n${facts ? pageFactsTable([facts], null) : "Not fetched."}`,
-				indexed ? `Google index status:\n${table([indexed], Object.keys(indexed), null)}` : "Google index status: not available for this URL.",
-				`Query totals: clicks ${sum(now.rows, "clicks")} (was ${sum(then.rows, "clicks")}), impressions ${sum(now.rows, "impressions")} (was ${sum(then.rows, "impressions")}). Search Console hides rare queries, so these can be lower than the page total.`
-			],
-			rows,
-			offset,
-			limit: 50,
-			detail: input.detail ?? "summary",
-			more: (next) => deps.call("page", {
-				url: input.url,
-				detail: "rows",
-				offset: next
-			})
-		})}\n\nNext: ${deps.call("research")} serp with the top query to see who else ranks.\n\n${FACTS_ONLY}`,
+		text: [
+			rowsText({
+				title: `${input.url} in ${input.site}, ${range.startDate} to ${range.endDate} against ${before.startDate} to ${before.endDate}.`,
+				notes: [
+					`Live page (fetched now, no redirects followed):\n${facts ? pageFactsTable([facts], null) : "Not fetched."}`,
+					indexed ? `Google index status:\n${table([indexed], Object.keys(indexed), null)}` : "Google index status: not available for this URL.",
+					`Query totals: clicks ${sum(now.rows, "clicks")} (was ${sum(then.rows, "clicks")}), impressions ${sum(now.rows, "impressions")} (was ${sum(then.rows, "impressions")}). Search Console hides rare queries, so these can be lower than the page total.`,
+					deps.pageMarkdown ? `Main content as Markdown: ${deps.call("page", {
+						url: input.url,
+						detail: "full"
+					})}.` : `Main content as Markdown: only in the CLI and the local MCP server, with \`npx -y seo page --url ${input.url} --detail full\`.`
+				],
+				rows,
+				offset,
+				limit: 50,
+				detail: input.detail ?? "summary",
+				more: (next) => deps.call("page", {
+					url: input.url,
+					detail: "rows",
+					offset: next
+				})
+			}),
+			...full ? [markdownText(markdown, input.url)] : [],
+			`Next: ${deps.call("research")} serp with the top query to see who else ranks.`,
+			FACTS_ONLY
+		].join("\n\n"),
 		data: {
 			url: input.url,
 			range,
@@ -38298,10 +38948,17 @@ async function runPage(input, deps) {
 			page: facts ?? null,
 			index: indexed,
 			totalQueries: rows.length,
-			queries: rows.slice(offset, offset + 50)
+			queries: rows.slice(offset, offset + 50),
+			...full ? { markdown } : {}
 		}
 	};
 }
+function markdownText(markdown, url) {
+	if (!markdown) return `Main content as Markdown: not on this server; it runs in the CLI and the local MCP server. ${CLI_LINK} Then run \`npx -y seo page --url ${url} --detail full\`.`;
+	if ("error" in markdown) return `Main content as Markdown: the page could not be read (${markdown.error}).`;
+	if (!markdown.markdown) return "Main content as Markdown: the page has no main content to read.";
+	return `Main content as Markdown (live page${markdown.truncated ? `, cut to ${markdown.markdown.length.toLocaleString("en-US")} of ${markdown.characters.toLocaleString("en-US")} characters` : ""}):\n\n${markdown.markdown}`;
+}
 async function runCompare(input, deps) {
 	if (!/^\d{4}-\d{2}-\d{2}$/.test(input.date)) throw new CommandError("INVALID_INPUT", "The date must be YYYY-MM-DD.");
 	const last = latestFinalGscDate(deps.now?.() ?? /* @__PURE__ */ new Date());
@@ -38337,7 +38994,39 @@ const LOST_SHARE = .2;
 const MIN_LOST = 3;
 const CHECKED = 20;
 const INSPECTED = 10;
-const LOST_PAGES_RULE = `Pages that had at least ${MIN_LOST} clicks in the previous 28 days and kept ${LOST_SHARE * 100}% or less of them in the last 28 days, with a live check of the top ${CHECKED} and Google’s index status for the top ${INSPECTED}.`;
+const SITE_WIDE_MIN = 5;
+function indexSummary(inspected, home) {
+	const known = inspected.filter((item) => item?.verdict != null);
+	const indexed = known.filter((item) => item.verdict === "PASS").length;
+	const coverage = /* @__PURE__ */ new Map();
+	for (const item of known) {
+		if (item.verdict === "PASS") continue;
+		const state = item.coverage ?? item.verdict ?? "unknown";
+		coverage.set(state, (coverage.get(state) ?? 0) + 1);
+	}
+	const notIndexed = known.length - indexed;
+	const homeIndexed = home?.status?.verdict ? home.status.verdict === "PASS" : null;
+	const siteWide = notIndexed >= SITE_WIDE_MIN && notIndexed * 2 > known.length && homeIndexed;
+	const byCoverage = [...coverage].sort((a, b) => b[1] - a[1] || a[0].localeCompare(b[0])).map(([state, count]) => ({
+		state,
+		count
+	}));
+	return {
+		text: (known.length ? [`Index status of the ${known.length} inspected pages: ${indexed} indexed, ${notIndexed} not indexed${byCoverage.length ? ` (${byCoverage.map((item) => `${item.count} ${item.state}`).join("; ")})` : ""}.${home && homeIndexed !== null ? ` Home page ${home.url}: ${homeIndexed ? "indexed" : `not indexed (${home.status?.coverage ?? home.status?.verdict})`}.` : ""}`, siteWide ? `Site-wide pattern: ${notIndexed} of ${known.length} inspected pages are not in Google's index, but the home page is. This points to the whole site, not single pages. It does not show the cause.` : null] : []).filter(Boolean).join("\n"),
+		data: {
+			inspected: known.length,
+			indexed,
+			notIndexed,
+			byCoverage,
+			homePage: home && homeIndexed !== null ? {
+				url: home.url,
+				indexed: homeIndexed
+			} : null,
+			siteWide: Boolean(siteWide)
+		}
+	};
+}
+const LOST_PAGES_RULE = `Pages that had at least ${MIN_LOST} clicks in the previous 28 days and kept ${LOST_SHARE * 100}% or less of them in the last 28 days, with a live check of the top ${CHECKED} and Google’s index status for the top ${INSPECTED} and the home page.`;
 async function runLostPages(input, deps) {
 	const range = dateWindow(input, 28);
 	const before = earlierRange(range);
@@ -38355,7 +39044,17 @@ async function runLostPages(input, deps) {
 		clicks: current.get(row.keys[0]) ?? 0
 	})).filter((row) => row.clicks <= row.previous_clicks * LOST_SHARE).sort((a, b) => b.previous_clicks - b.clicks - (a.previous_clicks - a.clicks) || a.url.localeCompare(b.url));
 	const top = lost.slice(0, CHECKED);
-	const [facts, indexed] = await Promise.all([deps.checkPages(top.map((row) => row.url)), Promise.all(top.slice(0, INSPECTED).map((row) => deps.inspect(input.site, row.url)))]);
+	const homeUrl = top[0] ? `${new URL(top[0].url).origin}/` : null;
+	const [facts, indexed, homeStatus] = await Promise.all([
+		deps.checkPages(top.map((row) => row.url)),
+		Promise.all(top.slice(0, INSPECTED).map((row) => deps.inspect(input.site, row.url))),
+		homeUrl && !top.slice(0, INSPECTED).some((row) => row.url === homeUrl) ? deps.inspect(input.site, homeUrl).catch(() => null) : null
+	]);
+	const homeIndex = top.slice(0, INSPECTED).findIndex((row) => row.url === homeUrl);
+	const summary = indexSummary(homeIndex >= 0 ? indexed.filter((_, index) => index !== homeIndex) : indexed, homeUrl ? {
+		url: homeUrl,
+		status: homeIndex >= 0 ? indexed[homeIndex] ?? null : homeStatus
+	} : null);
 	const rows = top.map((row, index) => ({
 		...row,
 		status: facts[index]?.status ?? null,
@@ -38371,6 +39070,7 @@ async function runLostPages(input, deps) {
 			`Pages that lost their clicks on ${input.site}: ${range.startDate} to ${range.endDate} against ${before.startDate} to ${before.endDate}.`,
 			`${lost.length} pages kept ${LOST_SHARE * 100}% or less of at least ${MIN_LOST} clicks${lost.length > CHECKED ? `; the top ${CHECKED} by clicks lost are shown` : ""}.`,
 			rows.length ? table(rows, Object.keys(rows[0] ?? {}), originOf(input.site)) : "No pages lost their clicks.",
+			summary.text,
 			"Live checks are fetched now with no redirects followed. Index status is from URL Inspection; Google allows about 2,000 inspections a day per property.",
 			temporaryRedirectNote(rows),
 			`Next: ${deps.call("page")} for one URL; ${deps.call("report", {
@@ -38384,6 +39084,7 @@ async function runLostPages(input, deps) {
 			comparisonRange: before,
 			rule: LOST_PAGES_RULE,
 			lostPages: lost.length,
+			index: summary.data,
 			pages: rows
 		}
 	};
@@ -38436,9 +39137,9 @@ const detail = {
 const DATA_SOURCES = [
 	"search_console",
 	"google_analytics",
-	"bing"
+	"bing",
+	"clicky"
 ];
-const LOCAL_ANALYTICS = "Clicky and other analytics run on the person’s machine with the CLI and a provider package: `npx -y seo providers install @seoskill/clicky-provider`, connect it once with `seo providers connect clicky`, then `npx -y seo analytics clicky report --json`. `seo providers list` shows installed providers.";
 function tool(spec) {
 	return spec;
 }
@@ -38452,6 +39153,7 @@ const SHARED_TOOLS = [
 		run: async (surface) => runSites({
 			accounts: await surface.accounts(),
 			keys: await surface.keys(),
+			clicky: clickySites(await surface.keys()).map(clickyLabel),
 			signIn: surface.signIn,
 			bing: surface.deps.bing ? await surface.deps.bing() : void 0,
 			connect: surface.connect
@@ -38549,10 +39251,10 @@ const SHARED_TOOLS = [
 		name: "seo_data",
 		command: "data",
 		title: "Raw rows",
-		description: `Raw rows for questions the report does not answer. search_console (default): rows for any dimensions, each with the previous period and the change; page and query narrow to rows whose URL or query contains that text. google_analytics: landing pages for visits from search, with Google Analytics’ own metric names. bing: Bing Webmaster query or page rows (first dimension) for the same site, by week. ${LOCAL_ANALYTICS}`,
+		description: `Raw rows for questions the report does not answer. search_console (default): rows for any dimensions, each with the previous period and the change; page and query narrow to rows whose URL or query contains that text. google_analytics: landing pages for visits from search, with Google Analytics’ own metric names. bing: Bing Webmaster query or page rows (first dimension) for the same site, by week. clicky: landing-page visits, traffic sources and search engines from a Clicky site the person saved (site is its domain or Clicky site ID; at most 31 days).`,
 		input: 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."),
@@ -38560,6 +39262,17 @@ const SHARED_TOOLS = [
 			...detail
 		}),
 		run: async (surface, input) => {
+			if (input.source === "clicky") return runClickyRows({
+				site: input.site,
+				startDate: input.start_date,
+				endDate: input.end_date,
+				detail: input.detail,
+				offset: input.offset
+			}, await surface.keys(), {
+				connect: surface.connect,
+				call: (offset) => `seo_data with source "clicky", site "${input.site}", detail "rows", offset ${offset}`,
+				refresh: surface.refreshClicky
+			});
 			if (input.source === "bing") return runBingRows({
 				site: input.site,
 				dimension: input.dimensions[0] === "page" ? "page" : "query",
@@ -38603,10 +39316,10 @@ async function runSharedTool(tool, surface, input) {
 	if (!parsed.success) throw new CommandError("INVALID_INPUT", parsed.error.issues.map((issue) => `${issue.path.join(".") || "input"}: ${issue.message}`).join("; "));
 	return tool.run(surface, parsed.data);
 }
-const MCP_INSTRUCTIONS = `SEO Skill reads the person's own Search Console, Google Analytics, Bing Webmaster Tools and optional keyword and analytics accounts, and returns facts with their dates and limits. It gives no advice.
+const MCP_INSTRUCTIONS = `SEO Skill reads the person's own Search Console, Google Analytics, Bing Webmaster Tools, Clicky and optional keyword accounts, and returns facts with their dates and limits. It gives no advice.
 1. seo_sites: the properties the connected accounts can read.
 2. seo_report: the main report. Run it without a section first; it shows the overview and every section's count and top rows. Then ask for the one section you need.
-3. seo_page for one URL, seo_compare for before and after a date, seo_index for pages that lost their clicks, seo_research for keyword, competitor and backlink data from the DataForSEO or Ahrefs key the person saved, seo_data for raw rows.
+3. seo_page for one URL, seo_compare for before and after a date, seo_index for pages that lost their clicks, seo_research for keyword, competitor and backlink data from the DataForSEO or Ahrefs key the person saved, seo_data for raw rows, including Google Analytics, Bing and Clicky.
 Show the person the facts that matter, for example in a table or a small dashboard, and decide with them what to change. Do not edit pages without their approval.`;
 const mcpCall = (command, args) => {
 	const name = `seo_${command.replace("-", "_")}`;
@@ -38811,6 +39524,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
@@ -38833,12 +39547,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);
@@ -38846,6 +39565,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.`);
@@ -40835,46 +41559,18 @@ function registerOpportunityTools(server, dependencies = {}) {
 	server.registerTool("seo_internal_links", {
 		description: "Find verified internal-link review candidates for a target URL",
 		inputSchema: {
-			...mcpReportInputSchema([
-				"site",
-				"days",
-				"limit",
-				"checkLimit",
-				"minImpressions",
-				"includeBrand",
-				"js",
-				"fetchConcurrency",
-				"fetchIntervalCap",
-				"fetchIntervalMs",
-				"refresh"
-			]),
+			...mcpReportInputSchema(["site", "refresh"]),
 			targetUrl: z$1.string().url().refine((value) => /^https?:\/\//.test(value), "Use an HTTP(S) URL."),
-			days: z$1.number().int().min(1).max(548).optional(),
-			limit: z$1.number().int().min(1).max(100).optional(),
-			checkLimit: z$1.number().int().min(1).max(200).optional(),
-			minImpressions: z$1.number().min(0).max(1e9).optional(),
-			brandTerms: z$1.array(z$1.string().trim().min(1).max(200)).max(20).optional(),
-			fetchConcurrency: z$1.number().int().min(1).max(16).optional(),
-			fetchIntervalCap: z$1.number().int().min(1).max(60).optional(),
-			fetchIntervalMs: z$1.number().int().min(100).max(6e4).optional()
+			startDate: z$1.string().regex(/^\d{4}-\d{2}-\d{2}$/).optional(),
+			endDate: z$1.string().regex(/^\d{4}-\d{2}-\d{2}$/).optional()
 		}
-	}, async ({ site, targetUrl, days, limit, checkLimit, minImpressions, brandTerms, includeBrand, js, fetchConcurrency, fetchIntervalCap, fetchIntervalMs, refresh }) => {
+	}, async ({ site, targetUrl, startDate, endDate, refresh }) => {
 		try {
 			const result = await (dependencies.internalLinksReport ?? internalLinksReport)({
 				site,
 				targetUrl,
-				days,
-				limit,
-				checkLimit,
-				minImpressions,
-				brandTerms,
-				includeBrand,
-				js: resolveJsOption(js, void 0),
-				rate: fetchRateInput({
-					fetchConcurrency,
-					fetchIntervalCap,
-					fetchIntervalMs
-				}),
+				startDate,
+				endDate,
 				refresh
 			});
 			return toolSuccess(result.summary.verdict, result);
@@ -41183,12 +41879,14 @@ const REPORT_DEPTH = {
 		readOrder: [
 			"dataStatus, target verification, aliases, canonical, and technical signals",
 			"source completeness and selection attempted, checked, failed, unchecked, and exclusions",
-			"per-item exact versus lexical matches and linkEvidence"
+			"per-item exact versus lexical matches and linkEvidence",
+			"per-item placement: the sentence where a link fits, its anchors, and contentSimilarity"
 		],
 		doNotClaim: [
-			"A low checkLimit can leave plausible candidates unchecked, so absence is not proven.",
+			"The live check stops at 40 source pages, so unchecked candidates can remain and absence is not proven.",
 			"Query overlap does not prove a link belongs or that adding one improves rankings.",
-			"Priority is a heuristic, not estimated impact."
+			"Priority is a heuristic, not estimated impact.",
+			"Placement sentences, anchors and contentSimilarity are text heuristics; they do not prove the link helps a reader."
 		],
 		verify: "Read the source passage, add one contextual link if the target is genuinely useful, and re-crawl to confirm it.",
 		related: [
@@ -42362,6 +43060,7 @@ function registerSharedTools(server, options = {}) {
 		deps: nodeCommandDeps({ call: mcpCall }),
 		resolveSite: (site) => resolveLocalSite(site),
 		keys: localResearchKeys,
+		refreshClicky: localRefreshClicky,
 		drKey: null,
 		accounts: localAccounts,
 		signIn: LOCAL_SIGN_IN.signIn,
@@ -42386,14 +43085,20 @@ function registerSharedTools(server, options = {}) {
 	})));
 	server.registerTool("seo_internal_links", {
 		title: "Internal link opportunities",
-		description: "Pages of the same site that could link to a target page, from Search Console and live page checks on this machine.",
-		inputSchema: { url: z$1.url() },
+		description: "Pages of the same site that could link to a target page, from Search Console and live page checks on this machine. Each one names the sentence where the link fits and anchor text from it. Takes the target URL and optional dates (default: the last 90 days).",
+		inputSchema: {
+			url: z$1.url(),
+			start_date: z$1.string().regex(/^\d{4}-\d{2}-\d{2}$/).optional().describe("YYYY-MM-DD. Optional; send with end_date."),
+			end_date: z$1.string().regex(/^\d{4}-\d{2}-\d{2}$/).optional().describe("YYYY-MM-DD. Optional; send with start_date.")
+		},
 		annotations: readOnly
-	}, async ({ url }) => counted("internal-links", {}, options.telemetry, async () => {
+	}, async ({ url, start_date, end_date }) => counted("internal-links", {}, options.telemetry, async () => {
 		try {
 			return await executeReport("internal-links", {
 				site: await resolveLocalSite(url),
-				targetUrl: url
+				targetUrl: url,
+				startDate: start_date,
+				endDate: end_date
 			});
 		} catch (error) {
 			return toolError(localError(error));