seo 0.2.21 → 0.2.22

package/dist/mcp.js

@@ -1,5 +1,5 @@
 import { createRequire as __seoCreateRequire } from 'node:module'; const require = __seoCreateRequire(import.meta.url);
-import { n as version, t as load } from "./esm-CSE-hgHf.js";
+import { n as version, t as load } from "./esm-insIkRuo.js";
 import { Headers, fetch as fetch$1 } from "undici";
 import { chmodSync, createReadStream, existsSync, mkdirSync, readFileSync, renameSync, rmSync, writeFileSync } from "node:fs";
 import { arch, homedir, platform, totalmem } from "node:os";
@@ -1811,7 +1811,7 @@ function aiReferralSourceForValue(value) {
 }
 //#endregion
 //#region packages/core/dist/analyze/ai-referrals-analysis.js
-function compareText$18(left, right) {
+function compareText$19(left, right) {
 	return left < right ? -1 : left > right ? 1 : 0;
 }
 function metric$1(row, name) {
@@ -1900,7 +1900,7 @@ function analyzeAiReferralRows(input) {
 	const generalCaveat = "Google Analytics only attributes visits that arrive with a recognized session source; some AI visits appear as direct, unassigned, or another source.";
 	const possiblyTruncated = input.sourceDiscovery.truncated || input.detail.truncated || input.totalUsersEvidence.truncated;
 	const allLandingPages = [...pageTotals.entries()].map(([landingPage, metrics]) => {
-		const topSourceId = [...metrics.sources.entries()].sort((left, right) => right[1] - left[1] || compareText$18(left[0], right[0]))[0]?.[0];
+		const topSourceId = [...metrics.sources.entries()].sort((left, right) => right[1] - left[1] || compareText$19(left[0], right[0]))[0]?.[0];
 		const topSource = topSourceId ? sourceTotals.get(topSourceId)?.definition : void 0;
 		if (!topSource) throw new SeoError("PROVIDER_UNAVAILABLE", "Could not resolve the top AI referral source.");
 		return {
@@ -1914,7 +1914,7 @@ function analyzeAiReferralRows(input) {
 				label: topSource.label
 			}
 		};
-	}).sort((left, right) => right.sessions - left.sessions || compareText$18(left.landingPage, right.landingPage));
+	}).sort((left, right) => right.sessions - left.sessions || compareText$19(left.landingPage, right.landingPage));
 	const landingPages = allLandingPages.slice(0, input.resultLimit);
 	const selection = {
 		limit: input.resultLimit,
@@ -1959,19 +1959,19 @@ function analyzeAiReferralRows(input) {
 			id: source.definition.id,
 			label: source.definition.label,
 			source: source.definition.label,
-			observedSessionSources: [...source.observedSessionSources].sort(compareText$18),
+			observedSessionSources: [...source.observedSessionSources].sort(compareText$19),
 			sessions: source.sessions,
 			eventCount: source.eventCount,
 			totalUsers: null,
 			shareOfAiSessions: total.sessions ? source.sessions / total.sessions : 0,
 			share: total.sessions ? source.sessions / total.sessions : 0
-		})).sort((left, right) => right.sessions - left.sessions || compareText$18(left.id, right.id)),
+		})).sort((left, right) => right.sessions - left.sessions || compareText$19(left.id, right.id)),
 		landingPages,
 		daily: [...dailyTotals.entries()].map(([date, metrics]) => ({
 			date,
 			...metrics,
 			totalUsers: null
-		})).sort((left, right) => compareText$18(left.date, right.date)),
+		})).sort((left, right) => compareText$19(left.date, right.date)),
 		caveats: [
 			generalCaveat,
 			"Attribution uses Google Analytics sessionSource only; landing-page text, medium text, and event referrers are never treated as referral sources.",
@@ -2061,7 +2061,7 @@ function sessionSourceInListFilter(values) {
 //#endregion
 //#region packages/core/dist/analyze/ai-referrals.js
 const DEFAULT_MAX_ROWS$1 = 1e5;
-const MAX_ROWS = 1e5;
+const MAX_ROWS$1 = 1e5;
 const DEFAULT_RESULT_LIMIT = 25;
 const MAX_RESULT_LIMIT = 1e3;
 function validIsoDate$1(value) {
@@ -2087,7 +2087,7 @@ function reportRange(input) {
 function maxRows(input) {
 	if (input.maxRows !== void 0 && input.limit !== void 0 && input.maxRows !== input.limit) throw new SeoError("INVALID_INPUT", "Use maxRows or the legacy limit option, not both.");
 	const value = input.maxRows ?? input.limit ?? DEFAULT_MAX_ROWS$1;
-	if (!Number.isInteger(value) || value < 1 || value > MAX_ROWS) throw new SeoError("INVALID_INPUT", `maxRows must be a whole number between 1 and ${MAX_ROWS}.`);
+	if (!Number.isInteger(value) || value < 1 || value > MAX_ROWS$1) throw new SeoError("INVALID_INPUT", `maxRows must be a whole number between 1 and ${MAX_ROWS$1}.`);
 	return value;
 }
 function resultLimit(input) {
@@ -5496,7 +5496,7 @@ function tokenStem(token) {
 function tokensMatch(a, b) {
 	return a === b || tokenStem(a) === tokenStem(b);
 }
-function includesTokenSequence(queryTokens, termTokens) {
+function includesTokenSequence$1(queryTokens, termTokens) {
 	if (!termTokens.length || termTokens.length > queryTokens.length) return false;
 	for (let index = 0; index <= queryTokens.length - termTokens.length; index++) if (termTokens.every((termToken, offset) => tokensMatch(queryTokens[index + offset] ?? "", termToken))) return true;
 	return false;
@@ -5525,7 +5525,7 @@ function isBrandQuery(query, brandTerms) {
 		const compactMatches = (compactTermLength >= 6 || /[^\p{ASCII}]/u.test(compactTerm) && compactTermLength >= 2) && compactQuery.includes(compactTerm);
 		const termTokens = normalizedTerm.split(" ");
 		if (termTokens.length === 1) return queryTokens.some((queryToken) => tokensMatch(queryToken, normalizedTerm)) || compactMatches;
-		return includesTokenSequence(queryTokens, termTokens) || compactMatches;
+		return includesTokenSequence$1(queryTokens, termTokens) || compactMatches;
 	});
 }
 function shouldExcludeBrandQuery(input) {
@@ -5771,7 +5771,7 @@ function resolveQueryOpportunityInput(input, now) {
 }
 //#endregion
 //#region packages/core/dist/analyze/query-opportunity-rows.js
-function compareText$17(left, right) {
+function compareText$18(left, right) {
 	const leftPoints = [...left].map((value) => value.codePointAt(0) ?? 0);
 	const rightPoints = [...right].map((value) => value.codePointAt(0) ?? 0);
 	for (let index = 0; index < Math.min(leftPoints.length, rightPoints.length); index++) {
@@ -5781,9 +5781,9 @@ function compareText$17(left, right) {
 	return leftPoints.length - rightPoints.length;
 }
 function compareQueryOpportunityRows(left, right) {
-	return right.impressions - left.impressions || right.clicks - left.clicks || left.position - right.position || compareText$17(left.query, right.query);
+	return right.impressions - left.impressions || right.clicks - left.clicks || left.position - right.position || compareText$18(left.query, right.query);
 }
-function validRow$3(row, query) {
+function validRow$4(row, query) {
 	return row.keys.length === 1 && Boolean(query) && Number.isFinite(row.clicks) && Number.isFinite(row.impressions) && Number.isFinite(row.ctr) && Number.isFinite(row.position) && row.clicks >= 0 && row.impressions > 0 && row.clicks <= row.impressions && row.ctr >= 0 && row.ctr <= 1 && row.position > 0;
 }
 function signature(row) {
@@ -5793,7 +5793,7 @@ function normalizeQueryOpportunityRows(rows, selection) {
 	const grouped = /* @__PURE__ */ new Map();
 	for (const row of rows) {
 		const query = row.keys[0]?.trim() ?? "";
-		if (!validRow$3(row, query)) {
+		if (!validRow$4(row, query)) {
 			selection.invalidRows++;
 			continue;
 		}
@@ -6762,11 +6762,11 @@ function selectBenchmarkRows$1(input) {
 }
 //#endregion
 //#region packages/core/dist/analyze/page-opportunities-analysis.js
-function compareText$16(left, right) {
+function compareText$17(left, right) {
 	return left < right ? -1 : left > right ? 1 : 0;
 }
 function compareItems$2(left, right) {
-	return (right.estimatedCtrClickShortfall ?? -1) - (left.estimatedCtrClickShortfall ?? -1) || right.impressions - left.impressions || left.position - right.position || compareText$16(left.query, right.query) || compareText$16(left.url, right.url);
+	return (right.estimatedCtrClickShortfall ?? -1) - (left.estimatedCtrClickShortfall ?? -1) || right.impressions - left.impressions || left.position - right.position || compareText$17(left.query, right.query) || compareText$17(left.url, right.url);
 }
 function analyzeRow(input) {
 	const query = input.row.keys[0]?.trim() ?? "";
@@ -11452,19 +11452,19 @@ function sanitizeIssues(issues) {
 function sanitizeMessages(values = []) {
 	return values.map((value) => sanitizeTenantString(value));
 }
-function compareText$15(left, right) {
+function compareText$16(left, right) {
 	return left < right ? -1 : left > right ? 1 : 0;
 }
 function sortPages(pages) {
-	return [...pages].sort((left, right) => compareText$15(left.url, right.url));
+	return [...pages].sort((left, right) => compareText$16(left.url, right.url));
 }
 function sortRequests(requests) {
 	return [...requests].sort((left, right) => {
-		const byUrl = compareText$15(left.requestedUrl, right.requestedUrl);
+		const byUrl = compareText$16(left.requestedUrl, right.requestedUrl);
 		if (byUrl) return byUrl;
-		const byOutcome = compareText$15(left.outcome, right.outcome);
+		const byOutcome = compareText$16(left.outcome, right.outcome);
 		if (byOutcome) return byOutcome;
-		return compareText$15(left.outcome === "response" ? `${left.status}:${left.finalUrl}` : left.outcome === "skipped" ? left.reason : `${left.failureKind}:${left.error}`, right.outcome === "response" ? `${right.status}:${right.finalUrl}` : right.outcome === "skipped" ? right.reason : `${right.failureKind}:${right.error}`);
+		return compareText$16(left.outcome === "response" ? `${left.status}:${left.finalUrl}` : left.outcome === "skipped" ? left.reason : `${left.failureKind}:${left.error}`, right.outcome === "response" ? `${right.status}:${right.finalUrl}` : right.outcome === "skipped" ? right.reason : `${right.failureKind}:${right.error}`);
 	});
 }
 function summarizeCrawlReport(input) {
@@ -11686,8 +11686,8 @@ function createCrawlReport(input) {
 		...input.externalLinkVerification ? { externalLinkVerification: sanitizeTenantValue(input.externalLinkVerification) } : {},
 		...input.siteChecks ? { siteChecks: sanitizeTenantValue(input.siteChecks) } : {},
 		...input.agentDiscovery ? { agentDiscovery: sanitizeTenantValue(input.agentDiscovery) } : {},
-		warnings: sanitizeMessages(input.warnings).sort(compareText$15),
-		caveats: sanitizeMessages(input.caveats).sort(compareText$15)
+		warnings: sanitizeMessages(input.warnings).sort(compareText$16),
+		caveats: sanitizeMessages(input.caveats).sort(compareText$16)
 	};
 }
 function normalizeLoadedCrawlReport(report) {
@@ -11717,8 +11717,8 @@ function normalizeLoadedCrawlReport(report) {
 		pages,
 		issues,
 		issueGroups: groupCrawlIssues(issues),
-		warnings: sanitizeMessages(report.warnings).sort(compareText$15),
-		caveats: sanitizeMessages(report.caveats).sort(compareText$15)
+		warnings: sanitizeMessages(report.warnings).sort(compareText$16),
+		caveats: sanitizeMessages(report.caveats).sort(compareText$16)
 	};
 }
 function toMeta(row) {
@@ -13586,12 +13586,12 @@ function urlPath(url) {
 		return "";
 	}
 }
-function compareText$14(left, right) {
+function compareText$15(left, right) {
 	return left < right ? -1 : left > right ? 1 : 0;
 }
 function landingPageValuesFromRows(rows) {
 	const orderedRows = [...rows].sort((left, right) => {
-		return compareText$14(normalizePath(left.landingPagePlusQueryString ?? ""), normalizePath(right.landingPagePlusQueryString ?? "")) || compareText$14(left.landingPagePlusQueryString ?? "", right.landingPagePlusQueryString ?? "") || compareText$14(left.sessions ?? "", right.sessions ?? "") || compareText$14(left.totalUsers ?? "", right.totalUsers ?? "") || compareText$14(left.conversions ?? "", right.conversions ?? "");
+		return compareText$15(normalizePath(left.landingPagePlusQueryString ?? ""), normalizePath(right.landingPagePlusQueryString ?? "")) || compareText$15(left.landingPagePlusQueryString ?? "", right.landingPagePlusQueryString ?? "") || compareText$15(left.sessions ?? "", right.sessions ?? "") || compareText$15(left.totalUsers ?? "", right.totalUsers ?? "") || compareText$15(left.conversions ?? "", right.conversions ?? "");
 	});
 	const values = /* @__PURE__ */ new Map();
 	for (const row of orderedRows) {
@@ -14865,7 +14865,7 @@ function countLabel(count, singular, pluralLabel = `${singular}s`) {
 	return `${count.toLocaleString("en-GB")} ${plural$4(count, singular, pluralLabel)}`;
 }
 const OKF_MAX_CONCEPTS = 5e3;
-function compareText$13(left, right) {
+function compareText$14(left, right) {
 	const leftPoints = [...left].map((value) => value.codePointAt(0) ?? 0);
 	const rightPoints = [...right].map((value) => value.codePointAt(0) ?? 0);
 	for (let index = 0; index < Math.min(leftPoints.length, rightPoints.length); index++) {
@@ -14955,7 +14955,7 @@ function okfTitle(value, report) {
 }
 function selectedOkfPages(report, requestedLimit) {
 	const limit = okfConceptLimit(requestedLimit);
-	const eligible = report.pages.filter((page) => page.indexable && page.status >= 200 && page.status < 300 && !page.blocked && !page.error).sort((left, right) => (right.searchMetrics?.clicks ?? 0) - (left.searchMetrics?.clicks ?? 0) || (right.searchMetrics?.impressions ?? 0) - (left.searchMetrics?.impressions ?? 0) || (right.internalLinkAuthorityScore ?? 0) - (left.internalLinkAuthorityScore ?? 0) || (right.internalInlinkCount ?? 0) - (left.internalInlinkCount ?? 0) || compareText$13(left.finalUrl, right.finalUrl));
+	const eligible = report.pages.filter((page) => page.indexable && page.status >= 200 && page.status < 300 && !page.blocked && !page.error).sort((left, right) => (right.searchMetrics?.clicks ?? 0) - (left.searchMetrics?.clicks ?? 0) || (right.searchMetrics?.impressions ?? 0) - (left.searchMetrics?.impressions ?? 0) || (right.internalLinkAuthorityScore ?? 0) - (left.internalLinkAuthorityScore ?? 0) || (right.internalInlinkCount ?? 0) - (left.internalInlinkCount ?? 0) || compareText$14(left.finalUrl, right.finalUrl));
 	const unique = /* @__PURE__ */ new Map();
 	for (const page of eligible) if (!unique.has(page.finalUrl)) unique.set(page.finalUrl, page);
 	const uniquePages = [...unique.values()];
@@ -16433,7 +16433,7 @@ const crawlReportSchema = z.discriminatedUnion("requestEvidenceStatus", [
 ]);
 z.toJSONSchema(crawlReportSchema), z.toJSONSchema(crawlIssueGroupSchema), z.toJSONSchema(crawlTopFixSchema), z.toJSONSchema(crawlerRuleInfoSchema), z.toJSONSchema(crawlRequestObservationSchema), z.toJSONSchema(crawlPageSnapshotSchema);
 const CTR_MAX_MIN_IMPRESSIONS = 1e9;
-function compareText$12(left, right) {
+function compareText$13(left, right) {
 	const leftPoints = [...left].map((value) => value.codePointAt(0) ?? 0);
 	const rightPoints = [...right].map((value) => value.codePointAt(0) ?? 0);
 	for (let index = 0; index < Math.min(leftPoints.length, rightPoints.length); index++) {
@@ -16442,7 +16442,7 @@ function compareText$12(left, right) {
 	}
 	return leftPoints.length - rightPoints.length;
 }
-function boundedInteger$6(value, fallback, minimum, maximum) {
+function boundedInteger$7(value, fallback, minimum, maximum) {
 	if (value === void 0 || !Number.isFinite(value)) return fallback;
 	return Math.min(maximum, Math.max(minimum, Math.floor(value)));
 }
@@ -16481,7 +16481,7 @@ function aggregateCtrRows(rows, selection) {
 			weightedPosition: 0,
 			sourceRows: 0
 		};
-		if (compareText$12(query, group.query) < 0) group.query = query;
+		if (compareText$13(query, group.query) < 0) group.query = query;
 		group.clicks += row.clicks;
 		group.impressions += row.impressions;
 		group.weightedPosition += row.position * row.impressions;
@@ -16519,8 +16519,8 @@ function initialSelection(sourceRows) {
 	};
 }
 function analyzeCtrUnderperformersFromRows(input) {
-	const minImpressions = boundedInteger$6(input.minImpressions, 200, 1, CTR_MAX_MIN_IMPRESSIONS);
-	const limit = boundedInteger$6(input.limit, 25, 1, 100);
+	const minImpressions = boundedInteger$7(input.minImpressions, 200, 1, CTR_MAX_MIN_IMPRESSIONS);
+	const limit = boundedInteger$7(input.limit, 25, 1, 100);
 	const selection = initialSelection(input.rows.length);
 	const benchmarkRows = aggregateCtrRows(input.rows, selection).filter((row) => {
 		const query = row.keys[0] ?? "";
@@ -16585,7 +16585,7 @@ function analyzeCtrUnderperformersFromRows(input) {
 				confidence: "low"
 			}
 		};
-	}).filter((item) => item.actualCtr < item.expectedCtr * .6).sort((left, right) => right.clickShortfall - left.clickShortfall || compareText$12(left.query, right.query) || compareText$12(left.url, right.url));
+	}).filter((item) => item.actualCtr < item.expectedCtr * .6).sort((left, right) => right.clickShortfall - left.clickShortfall || compareText$13(left.query, right.query) || compareText$13(left.url, right.url));
 	const items = eligibleItems.slice(0, limit);
 	selection.eligibleUnderperformers = eligibleItems.length;
 	selection.returnedUnderperformers = items.length;
@@ -16816,7 +16816,7 @@ function diagnosisDataStatus(input) {
 function fixed$1(value) {
 	return Number(value.toFixed(3));
 }
-function compareText$11(left, right) {
+function compareText$12(left, right) {
 	return left < right ? -1 : left > right ? 1 : 0;
 }
 function validMetric$2(value) {
@@ -16896,8 +16896,8 @@ function compareRetainedSegmentRows(input) {
 		else unmatched.push(unmatchedRow(row, "before"));
 	}
 	for (const [key, row] of after.rows) if (!before.rows.has(key)) unmatched.push(unmatchedRow(row, "after"));
-	matched.sort((left, right) => Math.abs(right.clickDelta) - Math.abs(left.clickDelta) || compareText$11(left.key, right.key));
-	unmatched.sort((left, right) => right.clicks - left.clicks || compareText$11(left.retainedIn, right.retainedIn) || compareText$11(left.key, right.key));
+	matched.sort((left, right) => Math.abs(right.clickDelta) - Math.abs(left.clickDelta) || compareText$12(left.key, right.key));
+	unmatched.sort((left, right) => right.clicks - left.clicks || compareText$12(left.retainedIn, right.retainedIn) || compareText$12(left.key, right.key));
 	return {
 		before,
 		after,
@@ -17607,13 +17607,13 @@ const MINIMUM_PAGE_SHARE = .1;
 const MINIMUM_PAGE_IMPRESSIONS = 10;
 const MAXIMUM_DOMINANT_SHARE = .8;
 const MAX_SUPPRESSIONS = 100;
-function boundedInteger$5(value, fallback, minimum, maximum) {
+function boundedInteger$6(value, fallback, minimum, maximum) {
 	if (value === void 0 || !Number.isFinite(value)) return fallback;
 	return Math.min(maximum, Math.max(minimum, Math.floor(value)));
 }
 function analyzeCannibalRows(input) {
-	const minImpressions = boundedInteger$5(input.minImpressions, 50, 0, 1e9);
-	const limit = boundedInteger$5(input.limit, 25, 1, 100);
+	const minImpressions = boundedInteger$6(input.minImpressions, 50, 0, 1e9);
+	const limit = boundedInteger$6(input.limit, 25, 1, 100);
 	const selection = {
 		sourceRows: input.rows.length,
 		invalidRows: 0,
@@ -17937,7 +17937,7 @@ function normalizeUrl(value) {
 		return;
 	}
 }
-function validRow$2(row, query, url) {
+function validRow$3(row, query, url) {
 	return Boolean(query && url) && Number.isFinite(row.clicks) && row.clicks >= 0 && Number.isFinite(row.impressions) && row.impressions > 0 && row.clicks <= row.impressions && Number.isFinite(row.ctr) && row.ctr >= 0 && row.ctr <= 1 && Number.isFinite(row.position) && row.position > 0;
 }
 function aggregateDecayRows(rows) {
@@ -17946,7 +17946,7 @@ function aggregateDecayRows(rows) {
 	for (const row of rows) {
 		const query = row.keys[0]?.trim() ?? "";
 		const url = normalizeUrl(row.keys[1]?.trim() ?? "");
-		if (!validRow$2(row, query, url)) {
+		if (!validRow$3(row, query, url)) {
 			invalid++;
 			continue;
 		}
@@ -18353,7 +18353,7 @@ function normalizedQuery(value) {
 function groupKey$1(item) {
 	return `${item.template.id}:${normalizedQuery(item.query)}`;
 }
-function compareText$10(left, right) {
+function compareText$11(left, right) {
 	return left < right ? -1 : left > right ? 1 : 0;
 }
 function groupAction(input) {
@@ -18389,11 +18389,11 @@ function groupQuickWins(items) {
 			technicalUrls
 		});
 		return group;
-	}).filter((group) => group !== void 0).sort((left, right) => right.totalEstimatedCtrClickShortfall - left.totalEstimatedCtrClickShortfall || right.totalImpressions - left.totalImpressions || compareText$10(left.id, right.id));
+	}).filter((group) => group !== void 0).sort((left, right) => right.totalEstimatedCtrClickShortfall - left.totalEstimatedCtrClickShortfall || right.totalImpressions - left.totalImpressions || compareText$11(left.id, right.id));
 }
 //#endregion
 //#region packages/core/dist/analyze/site-diagnostics/quick-wins-analysis-primitives.js
-function boundedInteger$4(value, fallback, minimum, maximum) {
+function boundedInteger$5(value, fallback, minimum, maximum) {
 	if (value === void 0 || !Number.isFinite(value)) return fallback;
 	return Math.min(maximum, Math.max(minimum, Math.floor(value)));
 }
@@ -18405,7 +18405,7 @@ function validHttpUrl(value) {
 		return false;
 	}
 }
-function validRow$1(row, query, url) {
+function validRow$2(row, query, url) {
 	return row.keys.length >= 2 && Boolean(query) && validHttpUrl(url) && Number.isFinite(row.clicks) && row.clicks >= 0 && Number.isFinite(row.impressions) && row.impressions > 0 && row.clicks <= row.impressions && Number.isFinite(row.ctr) && row.ctr >= 0 && row.ctr <= 1 && Number.isFinite(row.position) && row.position >= 1;
 }
 function selectBenchmarkRows(input) {
@@ -18427,7 +18427,7 @@ function selectBenchmarkRows(input) {
 	for (const row of input.rows) {
 		const query = row.keys[0]?.trim() ?? "";
 		const url = row.keys[1]?.trim() ?? "";
-		if (!validRow$1(row, query, url)) selection.invalidRows++;
+		if (!validRow$2(row, query, url)) selection.invalidRows++;
 		else if (row.position > 10) selection.outsideBenchmarkPositionRows++;
 		else if (isLowActionabilityQuery(query)) selection.lowActionabilityRows++;
 		else if (shouldExcludeBrandQuery({
@@ -18501,11 +18501,11 @@ function quickWinItem(input) {
 		}
 	};
 }
-function compareText$9(left, right) {
+function compareText$10(left, right) {
 	return left < right ? -1 : left > right ? 1 : 0;
 }
 function compareQuickWinItems(left, right) {
-	return right.estimatedCtrClickShortfall - left.estimatedCtrClickShortfall || right.impressions - left.impressions || compareText$9(left.query, right.query) || compareText$9(left.url, right.url);
+	return right.estimatedCtrClickShortfall - left.estimatedCtrClickShortfall || right.impressions - left.impressions || compareText$10(left.query, right.query) || compareText$10(left.url, right.url);
 }
 function roundedSum(values) {
 	return Number(values.reduce((sum, value) => sum + value, 0).toFixed(2));
@@ -18518,8 +18518,8 @@ const DEFAULT_LIMIT$3 = 25;
 const MAX_LIMIT$3 = 100;
 const FALLBACK_SOURCE = "builtin_position_ctr_curve_v1";
 function analyzeQuickWinsFromRows(input) {
-	const minImpressions = boundedInteger$4(input.minImpressions, DEFAULT_MIN_IMPRESSIONS$2, 0, MAX_MIN_IMPRESSIONS$2);
-	const limit = boundedInteger$4(input.limit, DEFAULT_LIMIT$3, 1, MAX_LIMIT$3);
+	const minImpressions = boundedInteger$5(input.minImpressions, DEFAULT_MIN_IMPRESSIONS$2, 0, MAX_MIN_IMPRESSIONS$2);
+	const limit = boundedInteger$5(input.limit, DEFAULT_LIMIT$3, 1, MAX_LIMIT$3);
 	const selected = selectBenchmarkRows(input);
 	const benchmarkContext = createCtrBenchmarkContext(selected.rows, {
 		samplePopulation: "all_qualified_url_samples",
@@ -18620,7 +18620,7 @@ function analyzeQuickWinsFromRows(input) {
 }
 //#endregion
 //#region packages/core/dist/analyze/site-diagnostics/quick-wins-templates.js
-function compareText$8(left, right) {
+function compareText$9(left, right) {
 	return left < right ? -1 : left > right ? 1 : 0;
 }
 function unique$2(values) {
@@ -18646,7 +18646,7 @@ function quickWinTemplateRecommendations(items) {
 			action: technicalUrls > 0 ? `Fix verified technical issues on ${technicalUrls} affected URLs before testing shared template changes.` : `Compare live results and verified page evidence for ${urls.length} affected URLs before testing a shared title, snippet, or heading change.`,
 			evidence: `${templateItems.length} eligible rows across ${urls.length} distinct URLs share this recognised template. Example queries: ${queries.join("; ")}.`
 		};
-	}).filter((item) => item !== void 0).sort((left, right) => right.totalEstimatedCtrClickShortfall - left.totalEstimatedCtrClickShortfall || right.totalImpressions - left.totalImpressions || compareText$8(left.templateId, right.templateId));
+	}).filter((item) => item !== void 0).sort((left, right) => right.totalEstimatedCtrClickShortfall - left.totalEstimatedCtrClickShortfall || right.totalImpressions - left.totalImpressions || compareText$9(left.templateId, right.templateId));
 }
 function quickWinTemplateSummaries(items) {
 	const templates = /* @__PURE__ */ new Map();
@@ -18665,13 +18665,13 @@ function quickWinTemplateSummaries(items) {
 		label: item.label,
 		rowCount: item.rows,
 		urlCount: item.urls.size,
-		sampleUrls: [...item.urls].sort(compareText$8).slice(0, 3)
-	})).sort((left, right) => right.urlCount - left.urlCount || right.rowCount - left.rowCount || compareText$8(left.id, right.id)).slice(0, 5);
+		sampleUrls: [...item.urls].sort(compareText$9).slice(0, 3)
+	})).sort((left, right) => right.urlCount - left.urlCount || right.rowCount - left.rowCount || compareText$9(left.id, right.id)).slice(0, 5);
 }
 //#endregion
 //#region packages/core/dist/analyze/site-diagnostics/quick-wins.js
 const DEFAULT_DAYS$3 = 28;
-const MAX_DAYS$3 = 548;
+const MAX_DAYS$4 = 548;
 const DEFAULT_VERIFY_LIMIT$1 = 5;
 const MAX_VERIFY_LIMIT = 100;
 const MAX_SOURCE_ROWS$3 = 1e5;
@@ -18695,12 +18695,12 @@ function applyVerification$1(item, coverage) {
 	};
 }
 async function quickWinsReport(input, dependencies = defaultDependencies$9) {
-	const explicitRange = explicitDateRange(input, MAX_DAYS$3);
+	const explicitRange = explicitDateRange(input, MAX_DAYS$4);
 	const days = explicitRange?.days ?? integerOption$2({
 		value: input.days,
 		fallback: DEFAULT_DAYS$3,
 		minimum: 1,
-		maximum: MAX_DAYS$3,
+		maximum: MAX_DAYS$4,
 		label: "Days"
 	});
 	const verifyLimit = integerOption$2({
@@ -18850,7 +18850,7 @@ async function quickWinsReport(input, dependencies = defaultDependencies$9) {
 }
 //#endregion
 //#region packages/core/dist/analyze/striking-distance-analysis-primitives.js
-function compareText$7(left, right) {
+function compareText$8(left, right) {
 	const leftPoints = [...left].map((character) => character.codePointAt(0) ?? 0);
 	const rightPoints = [...right].map((character) => character.codePointAt(0) ?? 0);
 	const length = Math.min(leftPoints.length, rightPoints.length);
@@ -18916,7 +18916,7 @@ function strikingDistanceItem(row) {
 	};
 }
 function compareStrikingDistanceItems(left, right) {
-	return right.priority.score - left.priority.score || right.impressions - left.impressions || left.position - right.position || compareText$7(left.query, right.query) || compareText$7(left.url, right.url);
+	return right.priority.score - left.priority.score || right.impressions - left.impressions || left.position - right.position || compareText$8(left.query, right.query) || compareText$8(left.url, right.url);
 }
 function groupStrikingDistanceItems(items) {
 	const grouped = /* @__PURE__ */ new Map();
@@ -18953,7 +18953,7 @@ function groupStrikingDistanceItems(items) {
 				action: shared ? `Review the sampled ${first.template.label.toLowerCase()} URLs for a recurring technical, content, or internal-link pattern before changing the shared template.` : `Review these URLs individually; the current evidence does not support a shared-template change.`
 			}
 		};
-	}).filter((group) => group !== void 0).sort((left, right) => right.totalImpressions - left.totalImpressions || right.uniqueUrls - left.uniqueUrls || compareText$7(left.id, right.id));
+	}).filter((group) => group !== void 0).sort((left, right) => right.totalImpressions - left.totalImpressions || right.uniqueUrls - left.uniqueUrls || compareText$8(left.id, right.id));
 }
 //#endregion
 //#region packages/core/dist/analyze/striking-distance-analysis.js
@@ -19068,7 +19068,7 @@ function analyzeStrikingDistanceRows(input) {
 //#endregion
 //#region packages/core/dist/analyze/striking-distance.js
 const DEFAULT_DAYS$2 = 28;
-const MAX_DAYS$2 = 548;
+const MAX_DAYS$3 = 548;
 const DEFAULT_VERIFY_LIMIT = 5;
 const MAX_SOURCE_ROWS$2 = 1e5;
 const defaultDependencies$8 = {
@@ -19076,13 +19076,13 @@ const defaultDependencies$8 = {
 	verifyContent: verifyQueryContent,
 	now: () => /* @__PURE__ */ new Date()
 };
-function boundedInteger$3(value, fallback, minimum, maximum) {
+function boundedInteger$4(value, fallback, minimum, maximum) {
 	if (value === void 0 || !Number.isFinite(value)) return fallback;
 	return Math.min(maximum, Math.max(minimum, Math.floor(value)));
 }
 function reportDays(value) {
 	if (value === void 0) return DEFAULT_DAYS$2;
-	if (!Number.isInteger(value) || value < 1 || value > MAX_DAYS$2) throw new SeoError("INVALID_INPUT", `Days must be a whole number between 1 and ${MAX_DAYS$2}.`);
+	if (!Number.isInteger(value) || value < 1 || value > MAX_DAYS$3) throw new SeoError("INVALID_INPUT", `Days must be a whole number between 1 and ${MAX_DAYS$3}.`);
 	return value;
 }
 function dateRange(days, now) {
@@ -19140,7 +19140,7 @@ async function strikingDistance(input, dependencies = defaultDependencies$8) {
 		brandTerms: input.brandTerms,
 		includeBrand: input.includeBrand
 	});
-	const verifyLimit = boundedInteger$3(input.verifyLimit, DEFAULT_VERIFY_LIMIT, 0, analysis.limit);
+	const verifyLimit = boundedInteger$4(input.verifyLimit, DEFAULT_VERIFY_LIMIT, 0, analysis.limit);
 	const verificationRequested = input.verifyContent === true || input.verifyContent !== false && input.verifyLimit !== void 0;
 	const attempted = verificationRequested ? Math.min(verifyLimit, analysis.items.length) : 0;
 	const items = await Promise.all(analysis.items.map(async (item, index) => {
@@ -23433,7 +23433,7 @@ function resolveProvider(input) {
 //#endregion
 //#region packages/core/dist/analyze/domain-research/shared.js
 const MAX_GSC_DOMAIN_ROWS = 1e5;
-function compareText$6(left, right) {
+function compareText$7(left, right) {
 	return left < right ? -1 : left > right ? 1 : 0;
 }
 function normalizedKeyword$1(value) {
@@ -23550,8 +23550,8 @@ function aggregateGscQueries(rows) {
 		clicks: item.clicks,
 		impressions: item.impressions,
 		averagePosition: item.positionWeight ? item.weightedPosition / item.positionWeight : null,
-		urls: [...item.urls].sort(compareText$6).slice(0, 5)
-	})).sort((left, right) => right.impressions - left.impressions || compareText$6(left.query, right.query));
+		urls: [...item.urls].sort(compareText$7).slice(0, 5)
+	})).sort((left, right) => right.impressions - left.impressions || compareText$7(left.query, right.query));
 }
 async function acquireGscQueries(input) {
 	const range = finalGscDateRange(input.days, input.now);
@@ -23917,7 +23917,7 @@ function pseoQueryPatterns(rows) {
 //#region packages/core/dist/analyze/pseo/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;
 const DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
-function compareText$5(left, right) {
+function compareText$6(left, right) {
 	const leftPoints = [...left].map((value) => value.codePointAt(0) ?? 0);
 	const rightPoints = [...right].map((value) => value.codePointAt(0) ?? 0);
 	for (let index = 0; index < Math.min(leftPoints.length, rightPoints.length); index++) {
@@ -23973,7 +23973,7 @@ function valueTokens(values) {
 		const tokens = value.normalize("NFKC").toLowerCase().match(/[\p{L}\p{N}]+/gu) ?? [];
 		for (const token of tokens.filter((item) => item.length > 1 || /[^\p{ASCII}]/u.test(item))) counts.set(token, (counts.get(token) ?? 0) + 1);
 	}
-	return [...counts.entries()].sort((a, b) => b[1] - a[1] || compareText$5(a[0], b[0])).slice(0, 8).map(([token]) => token);
+	return [...counts.entries()].sort((a, b) => b[1] - a[1] || compareText$6(a[0], b[0])).slice(0, 8).map(([token]) => token);
 }
 function templateShape(signature, urls) {
 	const signatureParts = signature.split("/").filter(Boolean);
@@ -24022,7 +24022,7 @@ function collectClusters(urls, signatures) {
 	return bySignature;
 }
 function clusterPseoTemplates(urls, opts = {}) {
-	const uniqueUrls = [...new Set(urls)].sort(compareText$5);
+	const uniqueUrls = [...new Set(urls)].sort(compareText$6);
 	const minUrls = opts.minUrls ?? 3;
 	const minShare = opts.minShare ?? .01;
 	const sampleSize = opts.sampleSize ?? 5;
@@ -24040,15 +24040,15 @@ function clusterPseoTemplates(urls, opts = {}) {
 		shape: templateShape(signature, clusterUrls),
 		urlCount: clusterUrls.length,
 		share: uniqueUrls.length ? clusterUrls.length / uniqueUrls.length : 0,
-		sampleUrls: clusterUrls.sort(compareText$5).slice(0, sampleSize)
-	})).filter((cluster) => cluster.shape.variableSegments.length > 0 && cluster.urlCount >= minUrls && cluster.share >= minShare).sort((a, b) => b.urlCount - a.urlCount || compareText$5(a.signature, b.signature)).slice(0, opts.limit ?? 50);
+		sampleUrls: clusterUrls.sort(compareText$6).slice(0, sampleSize)
+	})).filter((cluster) => cluster.shape.variableSegments.length > 0 && cluster.urlCount >= minUrls && cluster.share >= minShare).sort((a, b) => b.urlCount - a.urlCount || compareText$6(a.signature, b.signature)).slice(0, opts.limit ?? 50);
 }
 //#endregion
 //#region packages/core/dist/analyze/domain-research/gap-analysis.js
 const MAX_RELEVANCE_QUERY_REFS = 3;
 const MAX_FIRST_PARTY_PATTERN_URLS = 1e4;
 function terms(value) {
-	return [...new Set(pseoQueryTerms(value).map(canonicalPseoTerm).filter(Boolean))].sort(compareText$6);
+	return [...new Set(pseoQueryTerms(value).map(canonicalPseoTerm).filter(Boolean))].sort(compareText$7);
 }
 function observedVolume$1(row) {
 	return value(row.monthlySearchVolume) ?? -1;
@@ -24092,7 +24092,7 @@ function relevanceForKeyword(keyword, acquisition, tokenIndex) {
 		query: row.query,
 		overlap: terms(row.query).filter((token) => keywordTerms.includes(token)).length,
 		impressions: row.impressions
-	})).filter((row) => row.overlap > 0).sort((left, right) => right.overlap - left.overlap || right.impressions - left.impressions || compareText$6(left.query, right.query)).slice(0, MAX_RELEVANCE_QUERY_REFS).map((row) => row.query);
+	})).filter((row) => row.overlap > 0).sort((left, right) => right.overlap - left.overlap || right.impressions - left.impressions || compareText$7(left.query, right.query)).slice(0, MAX_RELEVANCE_QUERY_REFS).map((row) => row.query);
 	return {
 		state: sharedTokens.length >= 2 ? "observed-overlap" : sharedTokens.length === 1 ? "weak-overlap" : "unavailable",
 		sharedTokens,
@@ -24114,10 +24114,10 @@ function repeatedCompetitorPatterns(rows) {
 		urlCount: pattern.urlCount,
 		sampleUrls: pattern.sampleUrls,
 		evidenceRefs: items.flatMap((item) => pattern.sampleUrls.includes(item.row.url) ? [item.evidenceRef] : [])
-	}))).sort((left, right) => right.urlCount - left.urlCount || compareText$6(left.domain, right.domain) || compareText$6(left.signature, right.signature));
+	}))).sort((left, right) => right.urlCount - left.urlCount || compareText$7(left.domain, right.domain) || compareText$7(left.signature, right.signature));
 }
 function ownPatterns(acquisition) {
-	return clusterPseoTemplates([...new Set(acquisition.sourceRows.rows.flatMap((row) => row.urls))].sort(compareText$6).slice(0, MAX_FIRST_PARTY_PATTERN_URLS), {
+	return clusterPseoTemplates([...new Set(acquisition.sourceRows.rows.flatMap((row) => row.urls))].sort(compareText$7).slice(0, MAX_FIRST_PARTY_PATTERN_URLS), {
 		minUrls: 3,
 		minShare: 0,
 		limit: 50,
@@ -24158,10 +24158,10 @@ function analyzeCompetitorGap(acquisition) {
 		const byDomain = /* @__PURE__ */ new Map();
 		for (const item of rows) {
 			const current = byDomain.get(item.domain);
-			if (!current || item.row.rankGroup < current.row.rankGroup || item.row.rankGroup === current.row.rankGroup && compareText$6(item.row.url, current.row.url) < 0) byDomain.set(item.domain, item);
+			if (!current || item.row.rankGroup < current.row.rankGroup || item.row.rankGroup === current.row.rankGroup && compareText$7(item.row.url, current.row.url) < 0) byDomain.set(item.domain, item);
 		}
-		const retainedRows = [...byDomain.values()].sort((left, right) => left.row.rankGroup - right.row.rankGroup || compareText$6(left.domain, right.domain));
-		const best = [...retainedRows].sort((left, right) => observedVolume$1(right.row) - observedVolume$1(left.row) || left.row.rankGroup - right.row.rankGroup || compareText$6(left.domain, right.domain))[0];
+		const retainedRows = [...byDomain.values()].sort((left, right) => left.row.rankGroup - right.row.rankGroup || compareText$7(left.domain, right.domain));
+		const best = [...retainedRows].sort((left, right) => observedVolume$1(right.row) - observedVolume$1(left.row) || left.row.rankGroup - right.row.rankGroup || compareText$7(left.domain, right.domain))[0];
 		const firstParty = firstPartyByQuery.get(keyword);
 		const relevance = relevanceForKeyword(keyword, acquisition, tokenIndex.index);
 		const ownRank = ownRanks.get(keyword) ?? null;
@@ -24205,7 +24205,7 @@ function analyzeCompetitorGap(acquisition) {
 			},
 			evidenceRefs: retainedRows.map((item) => item.evidenceRef)
 		};
-	}).sort((left, right) => classificationOrder(left.classification) - classificationOrder(right.classification) || right.competitorCount - left.competitorCount || (value(right.monthlySearchVolume) ?? -1) - (value(left.monthlySearchVolume) ?? -1) || Math.min(...left.competitors.map((item) => item.rank)) - Math.min(...right.competitors.map((item) => item.rank)) || compareText$6(left.keyword, right.keyword));
+	}).sort((left, right) => classificationOrder(left.classification) - classificationOrder(right.classification) || right.competitorCount - left.competitorCount || (value(right.monthlySearchVolume) ?? -1) - (value(left.monthlySearchVolume) ?? -1) || Math.min(...left.competitors.map((item) => item.rank)) - Math.min(...right.competitors.map((item) => item.rank)) || compareText$7(left.keyword, right.keyword));
 	return {
 		rawRows,
 		candidates,
@@ -24677,7 +24677,7 @@ async function rankingPagesReport(input, dependencies = {}) {
 			impressions: row.impressions,
 			averagePosition: row.position
 		}] : [];
-	}).sort((left, right) => right.impressions - left.impressions || compareText$6(left.url, right.url));
+	}).sort((left, right) => right.impressions - left.impressions || compareText$7(left.url, right.url));
 	const firstPartyStatus = !input.site ? "not-requested" : (firstPartyResponse?.rowsFetched ?? 0) >= MAX_GSC_PAGE_ROWS ? "partial" : firstPartyResponse?.rows.length === 0 ? "empty" : "complete";
 	const findings = patterns.slice(0, 5).map((pattern, index) => ({
 		code: "repeated-ranking-page-pattern",
@@ -24758,7 +24758,7 @@ async function serpCompetitorsReport(input, dependencies = {}) {
 	const now = (dependencies.now ?? (() => /* @__PURE__ */ new Date()))();
 	const market = validatedMarket(input.market);
 	const providerId = validatedProvider(input.provider);
-	const keywords = [...new Set(input.keywords.map(normalizedKeyword$1))].filter(Boolean).sort(compareText$6);
+	const keywords = [...new Set(input.keywords.map(normalizedKeyword$1))].filter(Boolean).sort(compareText$7);
 	if (keywords.length < 2 || keywords.length > 200 || keywords.some((keyword) => keyword.length > 80 || keyword.split(/\s+/u).length > 10)) throw new SeoError("INVALID_INPUT", "SERP competitor research requires 2 to 200 keywords of at most 80 characters and 10 words.");
 	const target = input.targetDomain ? normalizeDomain$1(input.targetDomain) : null;
 	const declared = declaredCompetitors(input.declaredCompetitors);
@@ -26537,7 +26537,7 @@ function providerReportError(error) {
 	if (error.code === "rate-limit") throw new SeoError("RATE_LIMITED", error.message);
 	throw new SeoError("PROVIDER_UNAVAILABLE", error.message);
 }
-function validateInput$3(input) {
+function validateInput$4(input) {
 	if (input.keywords.length < 1 || input.keywords.length > MAX_REPORT_KEYWORDS || input.keywords.some((keyword) => {
 		const value = keyword.trim();
 		return value.length < 1 || value.length > 80 || value.split(/\s+/u).length > 10;
@@ -26571,7 +26571,7 @@ function findings$1(analysis) {
 	}).sort((left, right) => Number(right.code === "recent-demand-increase") - Number(left.code === "recent-demand-increase") || right.recentAverage - left.recentAverage || compareCodepoints$2(left.keyword, right.keyword)).slice(0, 10).map(({ recentAverage: _recentAverage, ...finding }) => finding);
 }
 async function keywordMetricsReport(input, dependencies = {}) {
-	const validated = validateInput$3(input);
+	const validated = validateInput$4(input);
 	let candidates;
 	try {
 		candidates = dependencies.candidates ?? await defaultCandidates$2();
@@ -26866,16 +26866,16 @@ function benchmarkDetails(benchmark) {
 		positiveUrlSamples: benchmark.positiveUrlSamples
 	};
 }
-function boundedInteger$2(input) {
+function boundedInteger$3(input) {
 	const value = Number.isFinite(input.value) ? input.value ?? 0 : input.fallback;
 	return Math.min(input.maximum ?? Number.POSITIVE_INFINITY, Math.max(1, Math.floor(value)));
 }
 function analyzeQueryClustersFromRows(input) {
-	const minImpressions = boundedInteger$2({
+	const minImpressions = boundedInteger$3({
 		value: input.minImpressions,
 		fallback: 25
 	});
-	const limit = boundedInteger$2({
+	const limit = boundedInteger$3({
 		value: input.limit,
 		fallback: 25,
 		maximum: 100
@@ -26994,7 +26994,7 @@ function integerInRange(value, fallback, minimum, maximum) {
 	if (value === void 0 || !Number.isFinite(value)) return fallback;
 	return Math.min(maximum, Math.max(minimum, Math.floor(value)));
 }
-function compareText$4(left, right) {
+function compareText$5(left, right) {
 	const leftPoints = [...left].map((character) => character.codePointAt(0) ?? 0);
 	const rightPoints = [...right].map((character) => character.codePointAt(0) ?? 0);
 	for (let index = 0; index < Math.min(leftPoints.length, rightPoints.length); index++) {
@@ -27013,7 +27013,7 @@ function normalizedHttpUrl(value) {
 		return;
 	}
 }
-function validRow(row, query, url) {
+function validRow$1(row, query, url) {
 	return Boolean(query && url) && Number.isFinite(row.clicks) && Number.isFinite(row.impressions) && Number.isFinite(row.ctr) && Number.isFinite(row.position) && row.clicks >= 0 && row.impressions > 0 && row.clicks <= row.impressions && row.ctr >= 0 && row.ctr <= 1 && row.position > 0;
 }
 function queryFromRow(row) {
@@ -27026,7 +27026,7 @@ function queryFromRow(row) {
 	};
 }
 function compareQueries(left, right) {
-	return right.impressions - left.impressions || left.position - right.position || right.clicks - left.clicks || compareText$4(left.query, right.query);
+	return right.impressions - left.impressions || left.position - right.position || right.clicks - left.clicks || compareText$5(left.query, right.query);
 }
 function recommendation(input) {
 	return {
@@ -27072,7 +27072,7 @@ function pageItem(url, rows) {
 	};
 }
 function compareItems$1(left, right) {
-	return right.priority.score - left.priority.score || right.impressions - left.impressions || left.position - right.position || compareText$4(left.url, right.url);
+	return right.priority.score - left.priority.score || right.impressions - left.impressions || left.position - right.position || compareText$5(left.url, right.url);
 }
 function analyzeSecondPageRows(input) {
 	const minImpressions = integerInRange(input.minImpressions, DEFAULT_MIN_IMPRESSIONS, 0, MAX_MIN_IMPRESSIONS);
@@ -27093,7 +27093,7 @@ function analyzeSecondPageRows(input) {
 	for (const row of input.rows) {
 		const query = row.keys[0]?.trim() ?? "";
 		const url = normalizedHttpUrl(row.keys[1]?.trim() ?? "");
-		if (!validRow(row, query, url)) selection.invalidRows++;
+		if (!validRow$1(row, query, url)) selection.invalidRows++;
 		else if (row.position <= 10 || row.position > 20) selection.outsidePositionRows++;
 		else if (shouldExcludeBrandQuery({
 			query,
@@ -27185,7 +27185,7 @@ function analyzeSecondPageRows(input) {
 //#endregion
 //#region packages/core/dist/analyze/keyword-opportunities.js
 const DEFAULT_DAYS$1 = 28;
-const MAX_DAYS$1 = 548;
+const MAX_DAYS$2 = 548;
 const DEFAULT_REPORT_LIMIT = 10;
 const MAX_REPORT_LIMIT = 25;
 const DEFAULT_KEYWORD_LIMIT = 30;
@@ -27202,7 +27202,7 @@ const SOURCE_ORDER = [
 	"second-page",
 	"striking-distance"
 ];
-function compareText$3(left, right) {
+function compareText$4(left, right) {
 	return left < right ? -1 : left > right ? 1 : 0;
 }
 function rounded(value, precision = 3) {
@@ -27214,7 +27214,7 @@ function integerOption$1(input) {
 	if (!Number.isInteger(input.value) || input.value < input.minimum || input.value > input.maximum) throw new SeoError("INVALID_INPUT", `${input.label} must be a whole number between ${input.minimum} and ${input.maximum}.`);
 	return input.value;
 }
-function validateInput$2(input) {
+function validateInput$3(input) {
 	const site = input.site.trim();
 	if (!site || site.length > 2048) throw new SeoError("INVALID_INPUT", "Use a valid Search Console property.");
 	if (input.minImpressions !== void 0 && (!Number.isInteger(input.minImpressions) || input.minImpressions < 0 || input.minImpressions > 1e9)) throw new SeoError("INVALID_INPUT", "Minimum impressions must be a whole number between 0 and 1000000000.");
@@ -27234,7 +27234,7 @@ function validateInput$2(input) {
 			value: input.days,
 			fallback: DEFAULT_DAYS$1,
 			minimum: 1,
-			maximum: MAX_DAYS$1,
+			maximum: MAX_DAYS$2,
 			label: "Days"
 		}),
 		limit: integerOption$1({
@@ -27346,7 +27346,7 @@ function aggregateCandidates(rows) {
 			impressions: rounded(row.impressions),
 			ctr: rounded(row.ctr, 4),
 			averagePosition: rounded(row.position, 2)
-		})).sort((left, right) => right.impressions - left.impressions || left.averagePosition - right.averagePosition || compareText$3(left.url, right.url));
+		})).sort((left, right) => right.impressions - left.impressions || left.averagePosition - right.averagePosition || compareText$4(left.url, right.url));
 		return [keyword, {
 			keyword,
 			clicks: rounded(clicks),
@@ -27580,7 +27580,7 @@ function nextSteps(input) {
 	return steps;
 }
 async function keywordOpportunitiesReport(input, dependencies = {}) {
-	const validated = validateInput$2(input);
+	const validated = validateInput$3(input);
 	const now = (dependencies.now ?? (() => /* @__PURE__ */ new Date()))();
 	const generatedAt = now.toISOString();
 	const range = finalGscDateRange(validated.days, now);
@@ -27948,7 +27948,7 @@ function providerError$2(error) {
 	if (error.code === "configuration") throw new SeoError("INVALID_INPUT", error.message);
 	throw new SeoError("PROVIDER_UNAVAILABLE", error.message);
 }
-function validateInput$1(input) {
+function validateInput$2(input) {
 	if (input.seeds.length < 1 || input.seeds.length > MAX_RESEARCH_SEEDS || input.seeds.some((seed) => {
 		const value = seed.trim();
 		return value.length < 1 || value.length > 80 || value.split(/\s+/u).length > 10;
@@ -28001,7 +28001,7 @@ async function keywordResearchReport(input, dependencies = {}) {
 		"suggestions"
 	];
 	const limit = input.limit ?? 50;
-	const validated = validateInput$1({
+	const validated = validateInput$2({
 		...input,
 		sources,
 		limit
@@ -28084,6 +28084,861 @@ async function keywordResearchReport(input, dependencies = {}) {
 	};
 }
 //#endregion
+//#region packages/core/dist/analyze/local-search/intent.js
+const NEARBY_PHRASES = [
+	"closest to me",
+	"in my area",
+	"near me",
+	"nearby"
+];
+const UK_POSTCODE = /\b[A-Z]{1,2}\d[A-Z\d]?\s*\d[A-Z]{2}\b/iu;
+const US_ZIP_CODE = /\b\d{5}(?:-\d{4})?\b/u;
+const US_ZIP_CONTEXT = /\b(?:around|near|nearby|postal(?:\s+code)?|zip(?:\s+code)?)\b/iu;
+function normalizeLocalSearchText(value) {
+	return value.normalize("NFKC").trim().replace(/\s+/gu, " ").toLowerCase();
+}
+function tokens(value) {
+	return normalizeLocalSearchText(value).match(/[\p{L}\p{N}]+/gu) ?? [];
+}
+function includesTokenSequence(source, candidate) {
+	if (candidate.length === 0 || candidate.length > source.length) return false;
+	return source.some((_, start) => candidate.every((token, offset) => source[start + offset] === token));
+}
+function termMatcher(terms) {
+	const root = {
+		children: /* @__PURE__ */ new Map(),
+		terms: []
+	};
+	for (const term of terms) {
+		let node = root;
+		for (const token of tokens(term)) {
+			const child = node.children.get(token) ?? {
+				children: /* @__PURE__ */ new Map(),
+				terms: []
+			};
+			node.children.set(token, child);
+			node = child;
+		}
+		node.terms.push(term);
+	}
+	return (source) => {
+		const matches = /* @__PURE__ */ new Set();
+		for (let start = 0; start < source.length; start++) {
+			let node = root;
+			for (let index = start; index < source.length; index++) {
+				node = node.children.get(source[index]);
+				if (!node) break;
+				for (const term of node.terms) matches.add(term);
+			}
+		}
+		return [...matches].sort((left, right) => left < right ? -1 : left > right ? 1 : 0);
+	};
+}
+function normalizeLocationTerms(values = []) {
+	return [...new Set(values.map(normalizeLocalSearchText).filter(Boolean))].sort((left, right) => left < right ? -1 : left > right ? 1 : 0);
+}
+function createLocalIntentClassifier(locationTerms) {
+	const matchLocations = termMatcher(locationTerms);
+	return (query) => {
+		const queryTokens = tokens(normalizeLocalSearchText(query));
+		const matchedLocations = matchLocations(queryTokens);
+		const matchedNearby = NEARBY_PHRASES.filter((phrase) => includesTokenSequence(queryTokens, tokens(phrase)));
+		const ukPostcode = UK_POSTCODE.exec(query)?.[0] ?? null;
+		const usZipCode = US_ZIP_CONTEXT.test(query) && US_ZIP_CODE.test(query) ? US_ZIP_CODE.exec(query)?.[0] ?? null : null;
+		const postalCode = ukPostcode ?? usZipCode;
+		const classes = [];
+		if (matchedLocations.length > 0) classes.push("named-location");
+		if (matchedNearby.length > 0) classes.push("nearby");
+		if (postalCode) classes.push("postal-code");
+		if (classes.length === 0) return null;
+		return {
+			heuristic: true,
+			method: "explicit-local-intent-v1",
+			classes,
+			matchedTerms: [
+				...matchedLocations,
+				...matchedNearby,
+				...postalCode ? [normalizeLocalSearchText(postalCode)] : []
+			]
+		};
+	};
+}
+//#endregion
+//#region packages/core/dist/analyze/local-search/analysis.js
+function compareText$3(left, right) {
+	return left < right ? -1 : left > right ? 1 : 0;
+}
+function validRow(row) {
+	const query = row.keys[0]?.trim() ?? "";
+	const page = row.keys[1]?.trim() ?? "";
+	let validPage = false;
+	try {
+		validPage = ["http:", "https:"].includes(new URL(page).protocol);
+	} catch {
+		validPage = false;
+	}
+	if (row.keys.length !== 2 || !query || !validPage || !Number.isFinite(row.clicks) || !Number.isFinite(row.impressions) || !Number.isFinite(row.ctr) || !Number.isFinite(row.position) || row.clicks < 0 || row.impressions <= 0 || row.clicks > row.impressions || row.ctr < 0 || row.ctr > 1 || row.position <= 0) return null;
+	return {
+		query,
+		page,
+		clicks: row.clicks,
+		impressions: row.impressions,
+		ctr: row.ctr,
+		position: row.position
+	};
+}
+function rowSignature(row) {
+	return `${row.clicks}\u0000${row.impressions}\u0000${row.ctr}\u0000${row.position}`;
+}
+function normalizeRows(rows, selection) {
+	const grouped = /* @__PURE__ */ new Map();
+	for (const source of rows) {
+		const row = validRow(source);
+		if (!row) {
+			selection.invalidRows++;
+			continue;
+		}
+		const key = `${row.query}\u0000${row.page}`;
+		grouped.set(key, [...grouped.get(key) ?? [], row]);
+	}
+	const result = [];
+	for (const group of grouped.values()) {
+		if (new Set(group.map(rowSignature)).size > 1) {
+			selection.conflictingRows += group.length;
+			continue;
+		}
+		selection.exactDuplicateRows += group.length - 1;
+		const row = group[0];
+		if (row) result.push(row);
+	}
+	return result;
+}
+function opportunityAction(position, pageCount) {
+	if (pageCount > 1) return "review-page-overlap";
+	if (position <= 3) return "protect-visibility";
+	if (position <= 20) return "improve-existing-page";
+	return "investigate-relevance";
+}
+function aggregateQueries(input) {
+	const grouped = /* @__PURE__ */ new Map();
+	for (const row of input.rows) {
+		if (isLowActionabilityQuery(row.query)) {
+			input.selection.lowActionabilityRows++;
+			continue;
+		}
+		if (shouldExcludeBrandQuery({
+			query: row.query,
+			siteUrl: input.site,
+			brandTerms: input.brandTerms,
+			includeBrand: input.includeBrand
+		})) {
+			input.selection.brandRows++;
+			continue;
+		}
+		grouped.set(row.query, [...grouped.get(row.query) ?? [], row]);
+	}
+	const opportunities = [];
+	for (const [query, rows] of grouped) {
+		const intent = input.classify(query);
+		if (!intent) {
+			input.selection.nonLocalRows += rows.length;
+			continue;
+		}
+		const impressions = rows.reduce((sum, row) => sum + row.impressions, 0);
+		if (impressions < input.minImpressions) {
+			input.selection.belowMinimumRows += rows.length;
+			continue;
+		}
+		const clicks = rows.reduce((sum, row) => sum + row.clicks, 0);
+		const averagePosition = rows.reduce((sum, row) => sum + row.position * row.impressions, 0) / impressions;
+		const pages = rows.map((row) => ({
+			url: row.page,
+			clicks: row.clicks,
+			impressions: row.impressions,
+			ctr: row.impressions ? row.clicks / row.impressions : 0,
+			averagePosition: row.position
+		})).sort((left, right) => right.impressions - left.impressions || right.clicks - left.clicks || left.averagePosition - right.averagePosition || compareText$3(left.url, right.url));
+		opportunities.push({
+			query,
+			clicks,
+			impressions,
+			ctr: impressions ? clicks / impressions : 0,
+			averagePosition,
+			intent,
+			action: opportunityAction(averagePosition, pages.length),
+			pages,
+			pageCoverage: {
+				available: pages.length,
+				returned: Math.min(3, pages.length),
+				omitted: Math.max(0, pages.length - 3)
+			}
+		});
+	}
+	return opportunities.sort((left, right) => right.impressions - left.impressions || right.clicks - left.clicks || left.averagePosition - right.averagePosition || compareText$3(left.query, right.query));
+}
+function localTemplates(opportunities) {
+	const clusters = clusterPseoTemplates(opportunities.flatMap((item) => item.pages.map((page) => page.url)), {
+		minUrls: 2,
+		minShare: 0,
+		limit: 10,
+		sampleSize: 5
+	});
+	return clusters.map((cluster) => {
+		const matched = opportunities.flatMap((item) => item.pages.filter((page) => templateForUrl(page.url, clusters) === cluster.signature).map((page) => ({
+			query: item.query,
+			page
+		})));
+		return {
+			heuristic: true,
+			signature: cluster.signature,
+			urlCount: cluster.urlCount,
+			sampleUrls: cluster.sampleUrls,
+			queryCount: new Set(matched.map((item) => item.query)).size,
+			clicks: matched.reduce((sum, item) => sum + item.page.clicks, 0),
+			impressions: matched.reduce((sum, item) => sum + item.page.impressions, 0)
+		};
+	});
+}
+function analyzeLocalSearchRows(input) {
+	const selection = {
+		sourceRows: input.rows.length,
+		invalidRows: 0,
+		exactDuplicateRows: 0,
+		conflictingRows: 0,
+		lowActionabilityRows: 0,
+		brandRows: 0,
+		nonLocalRows: 0,
+		belowMinimumRows: 0,
+		eligibleQueries: 0,
+		returnedQueries: 0,
+		omittedQueries: 0,
+		limit: input.limit,
+		minImpressions: input.minImpressions
+	};
+	const normalized = normalizeRows(input.rows, selection);
+	const eligible = aggregateQueries({
+		...input,
+		rows: normalized,
+		selection,
+		classify: createLocalIntentClassifier(input.locationTerms)
+	});
+	selection.eligibleQueries = eligible.length;
+	selection.returnedQueries = Math.min(input.limit, eligible.length);
+	selection.omittedQueries = Math.max(0, eligible.length - input.limit);
+	return {
+		selection,
+		eligibleSummary: {
+			clicks: eligible.reduce((sum, item) => sum + item.clicks, 0),
+			impressions: eligible.reduce((sum, item) => sum + item.impressions, 0),
+			namedLocationQueries: eligible.filter((item) => item.intent.classes.includes("named-location")).length,
+			nearbyQueries: eligible.filter((item) => item.intent.classes.includes("nearby")).length,
+			postalCodeQueries: eligible.filter((item) => item.intent.classes.includes("postal-code")).length,
+			pageOverlapQueries: eligible.filter((item) => item.action === "review-page-overlap").length
+		},
+		eligiblePageCount: new Set(eligible.flatMap((item) => item.pages.map((page) => page.url))).size,
+		opportunities: eligible.slice(0, input.limit).map((item) => ({
+			...item,
+			pages: item.pages.slice(0, 3)
+		})),
+		templates: localTemplates(eligible)
+	};
+}
+//#endregion
+//#region packages/core/dist/providers/dataforseo/serp-snapshot.js
+const MAX_SERP_DEPTH = 100;
+const SERP_ENDPOINT = "v3/serp/google/organic/live/advanced";
+function safeUrl$1(value) {
+	if (!value) return null;
+	try {
+		const parsed = new URL(value);
+		if (!["http:", "https:"].includes(parsed.protocol)) return null;
+		parsed.username = "";
+		parsed.password = "";
+		return parsed.toString();
+	} catch {
+		return null;
+	}
+}
+function validOrganic(item) {
+	return item.type === "organic" && Number.isSafeInteger(item.rank_group) && (item.rank_group ?? 0) > 0 && Number.isSafeInteger(item.rank_absolute) && (item.rank_absolute ?? 0) > 0 && Number.isSafeInteger(item.page) && (item.page ?? 0) > 0 && Boolean(item.domain?.trim()) && safeUrl$1(item.url) !== null;
+}
+function organicResult(item) {
+	if (!validOrganic(item)) return null;
+	const url = safeUrl$1(item.url);
+	if (!url) return null;
+	return {
+		rankGroup: item.rank_group,
+		rankAbsolute: item.rank_absolute,
+		page: item.page,
+		domain: item.domain.trim().toLowerCase(),
+		url,
+		title: item.title ?? null,
+		description: item.description ?? null,
+		isFeaturedSnippet: item.is_featured_snippet ?? null
+	};
+}
+function checkedAt(value, fallback) {
+	const timestamp = Date.parse(value);
+	return Number.isFinite(timestamp) ? new Date(timestamp).toISOString() : fallback;
+}
+function mapDataForSeoSerpSnapshot(input, snapshot, endpoint = SERP_ENDPOINT) {
+	const market = searchMarketSchema.parse(input.market);
+	const keyword = normalizedKeyword$2(input.keyword);
+	const location = locationRequest(market, "serp-snapshot");
+	const result = snapshot.response.tasks.flatMap((task) => task.result ?? []).find((item) => normalizedKeyword$2(item.keyword) === keyword);
+	if (!result) throw new ProviderError({
+		provider: "dataforseo",
+		operation: "serp-snapshot",
+		code: "invalid-response",
+		message: "DataForSEO returned no matching SERP result."
+	});
+	const warnings = [...snapshot.warnings];
+	const items = result.items ?? [];
+	const organicItems = items.filter((item) => item.type === "organic");
+	const mappedOrganicResults = organicItems.flatMap((item) => {
+		const mapped = organicResult(item);
+		return mapped ? [mapped] : [];
+	}).sort((left, right) => left.rankAbsolute - right.rankAbsolute || left.rankGroup - right.rankGroup || compareCodepoints$3(left.url, right.url));
+	const organicResults = mappedOrganicResults.slice(0, input.depth);
+	const invalidRows = organicItems.length - mappedOrganicResults.length;
+	const resultCapped = mappedOrganicResults.length > input.depth;
+	const invalidResultCount = result.se_results_count !== null && result.se_results_count !== void 0 && result.se_results_count < organicResults.length;
+	if (invalidRows > 0) warnings.push({
+		code: "invalid-organic-results",
+		field: "organicResults",
+		message: `DataForSEO returned ${invalidRows} organic result${invalidRows === 1 ? "" : "s"} without a valid rank, domain, or URL.`
+	});
+	if (!Number.isFinite(Date.parse(result.datetime))) warnings.push({
+		code: "invalid-serp-observation-time",
+		field: "checkedAt",
+		message: "DataForSEO returned an invalid SERP observation time; the local response time was retained."
+	});
+	const checkUrl = safeUrl$1(result.check_url);
+	if (result.check_url && !checkUrl) warnings.push({
+		code: "invalid-serp-check-url",
+		field: "checkUrl",
+		message: "DataForSEO returned an invalid SERP check URL."
+	});
+	if (invalidResultCount) warnings.push({
+		code: "invalid-serp-result-count",
+		field: "resultCount",
+		message: "DataForSEO returned an estimated result count below the retained organic result count; the estimate was discarded."
+	});
+	const features = [.../* @__PURE__ */ new Set([...result.item_types ?? [], ...items.map((item) => item.type)])].sort(compareCodepoints$3);
+	return {
+		schemaVersion: 1,
+		provider: "dataforseo",
+		capability: "serp-snapshot",
+		data: {
+			keyword,
+			effectiveKeyword: normalizedKeyword$2(result.spell?.keyword ?? result.keyword),
+			searchEngineDomain: result.se_domain?.trim().toLowerCase() ?? null,
+			checkedAt: checkedAt(result.datetime, snapshot.observedAt),
+			checkUrl,
+			resultCount: invalidResultCount ? null : result.se_results_count ?? null,
+			pagesCount: result.pages_count === void 0 ? null : result.pages_count,
+			features,
+			organicResults
+		},
+		observedAt: snapshot.observedAt,
+		market: {
+			...market,
+			device: market.device ?? "desktop"
+		},
+		coverage: {
+			requestedRows: input.depth,
+			returnedRows: snapshot.returnedRows,
+			retainedRows: organicResults.length,
+			invalidRows,
+			providerTotalRows: invalidResultCount ? null : result.se_results_count ?? null,
+			completeness: invalidRows > 0 || invalidResultCount ? "partial" : resultCapped ? "capped" : "complete",
+			nextCursor: null
+		},
+		cache: snapshot.cache,
+		cost: snapshot.cost,
+		request: {
+			operation: "serp-snapshot",
+			endpoint,
+			limit: input.depth,
+			filters: {
+				countryCode: market.countryCode,
+				languageCode: market.languageCode,
+				device: market.device ?? "desktop",
+				...location.locationCode !== void 0 ? { locationCode: location.locationCode } : { locationName: location.locationName }
+			},
+			sort: ["rankAbsolute:ascending", "url:codepoint-ascending"]
+		},
+		warnings
+	};
+}
+var DataForSeoSerpSnapshotProvider = class {
+	provider = "dataforseo";
+	capabilitySupport = [{
+		capability: "serp-snapshot",
+		status: "available",
+		markets: [{
+			searchEngines: ["google"],
+			devices: ["desktop", "mobile"],
+			location: "any"
+		}]
+	}];
+	client;
+	constructor(options = {}) {
+		this.client = options.client ?? new DataForSeoClient(options);
+	}
+	async serpSnapshot(input) {
+		const market = searchMarketSchema.parse(input.market);
+		if (market.searchEngine !== "google") throw new ProviderError({
+			provider: "dataforseo",
+			operation: "serp-snapshot",
+			code: "configuration",
+			message: "DataForSEO SERP snapshots currently support Google."
+		});
+		if (!Number.isSafeInteger(input.depth) || input.depth < 1 || input.depth > MAX_SERP_DEPTH) throw new ProviderError({
+			provider: "dataforseo",
+			operation: "serp-snapshot",
+			code: "configuration",
+			message: "SERP depth must be from 1 to 100."
+		});
+		const keyword = normalizedKeyword$2(input.keyword);
+		if (!keyword || keyword.length > 80 || keyword.split(/\s+/u).length > 10) throw new ProviderError({
+			provider: "dataforseo",
+			operation: "serp-snapshot",
+			code: "configuration",
+			message: "SERP snapshots require a keyword of at most 80 characters and 10 words."
+		});
+		const context = input.context ?? {
+			reportId: "serp-results",
+			reportRunId: randomUUID()
+		};
+		const location = locationRequest(market, "serp-snapshot");
+		return mapDataForSeoSerpSnapshot(input, await this.client.serpLive({
+			keyword,
+			languageCode: market.languageCode.split("-")[0],
+			...location,
+			device: market.device ?? "desktop",
+			depth: input.depth,
+			refresh: input.refresh,
+			context
+		}));
+	}
+};
+//#endregion
+//#region packages/core/dist/analyze/serp-results.js
+const MAX_REPORT_DEPTH = 100;
+function compareCodepoints(left, right) {
+	return left < right ? -1 : left > right ? 1 : 0;
+}
+function snapshotProvider(candidate) {
+	return "serpSnapshot" in candidate && typeof candidate.serpSnapshot === "function" ? candidate : null;
+}
+async function defaultCandidates() {
+	return [{
+		adapter: new DataForSeoSerpSnapshotProvider(),
+		connected: Boolean(await readDataForSeoCredentials()),
+		priority: 10
+	}];
+}
+function providerError$1(error) {
+	if (!(error instanceof ProviderError)) throw error;
+	if (error.code === "rate-limit") throw new SeoError("RATE_LIMITED", error.message);
+	if (error.code === "configuration") throw new SeoError("INVALID_INPUT", error.message);
+	throw new SeoError("PROVIDER_UNAVAILABLE", error.message);
+}
+function validateInput$1(input) {
+	const keyword = input.keyword.trim().replace(/\s+/gu, " ");
+	if (!keyword || keyword.length > 80 || keyword.split(/\s+/u).length > 10) throw new SeoError("INVALID_INPUT", "SERP results requires a keyword of at most 80 characters and 10 words.");
+	if (!Number.isSafeInteger(input.depth) || input.depth < 1 || input.depth > MAX_REPORT_DEPTH) throw new SeoError("INVALID_INPUT", `SERP result depth must be from 1 to ${MAX_REPORT_DEPTH}.`);
+	const market = searchMarketSchema.safeParse(input.market);
+	if (!market.success) throw new SeoError("INVALID_INPUT", "Use a valid search market.");
+	const provider = input.provider ? providerIdSchema.safeParse(input.provider) : void 0;
+	if (provider && !provider.success) throw new SeoError("INVALID_INPUT", "Use a supported SERP provider.");
+	return {
+		keyword,
+		market: market.data,
+		provider: provider?.data
+	};
+}
+function reportStatus$1(evidence) {
+	if (evidence.coverage.completeness === "unavailable" || evidence.coverage.completeness === "invalid") return "unavailable";
+	return evidence.coverage.completeness === "complete" ? "complete" : "partial";
+}
+function domainSummaries(snapshot) {
+	const byDomain = /* @__PURE__ */ new Map();
+	for (const result of snapshot.organicResults) byDomain.set(result.domain, [...byDomain.get(result.domain) ?? [], result.rankAbsolute]);
+	return [...byDomain.entries()].map(([domain, ranks]) => ({
+		domain,
+		resultCount: ranks.length,
+		ranks: [...ranks].sort((left, right) => left - right)
+	})).sort((left, right) => right.resultCount - left.resultCount || (left.ranks[0] ?? Number.MAX_SAFE_INTEGER) - (right.ranks[0] ?? Number.MAX_SAFE_INTEGER) || compareCodepoints(left.domain, right.domain));
+}
+function reportFindings(snapshot, domains) {
+	const findings = [];
+	if (snapshot.effectiveKeyword !== snapshot.keyword) findings.push({
+		code: "query-correction",
+		evidenceRef: "evidence.data.effectiveKeyword",
+		principle: "A corrected query changes the observed result context and does not prove the original wording has the same intent.",
+		detail: `The provider observed results for ${snapshot.effectiveKeyword} after the requested query ${snapshot.keyword}.`
+	});
+	for (const [index, domain] of domains.entries()) {
+		if (domain.resultCount <= 1) continue;
+		findings.push({
+			code: "repeated-domain",
+			evidenceRef: `domains[${index}]`,
+			principle: "Repeated results are descriptive snapshot evidence, not a domain strength or quality score.",
+			detail: `${domain.domain} appears ${domain.resultCount} times at absolute ranks ${domain.ranks.join(", ")}.`
+		});
+	}
+	return findings.slice(0, 10);
+}
+async function serpResultsReport(input, dependencies = {}) {
+	const depth = input.depth ?? 10;
+	const validated = validateInput$1({
+		...input,
+		depth
+	});
+	let candidates;
+	try {
+		candidates = dependencies.candidates ?? await defaultCandidates();
+	} catch (error) {
+		return providerError$1(error);
+	}
+	const resolution = resolveProvider({
+		capability: "serp-snapshot",
+		market: validated.market,
+		candidates,
+		provider: validated.provider
+	});
+	if (resolution.status === "unavailable") throw new SeoError("PROVIDER_UNAVAILABLE", resolution.reason === "provider-not-connected" ? "No connected provider can return live SERP results. Run `seo providers dataforseo connect` first." : validated.provider ? `${validated.provider} cannot return live SERP results for this market.` : "No configured provider can return live SERP results for this market.");
+	const provider = snapshotProvider(resolution.provider);
+	if (!provider) throw new SeoError("PROVIDER_UNAVAILABLE", "The selected provider has no live SERP implementation.");
+	let evidence;
+	try {
+		evidence = await provider.serpSnapshot({
+			keyword: validated.keyword,
+			market: validated.market,
+			depth,
+			refresh: input.refresh,
+			context: {
+				projectId: input.context?.projectId ?? input.projectId,
+				reportId: input.context?.reportId ?? "serp-results",
+				reportRunId: input.context?.reportRunId ?? randomUUID()
+			}
+		});
+	} catch (error) {
+		return providerError$1(error);
+	}
+	const domains = domainSummaries(evidence.data);
+	const dataStatus = reportStatus$1(evidence);
+	const generatedAt = (dependencies.now ?? (() => /* @__PURE__ */ new Date()))().toISOString();
+	const correctedQuery = evidence.data.effectiveKeyword !== evidence.data.keyword;
+	return {
+		schemaVersion: 1,
+		generatedAt,
+		dataStatus,
+		market: evidence.market,
+		summary: {
+			keyword: evidence.data.keyword,
+			effectiveKeyword: evidence.data.effectiveKeyword,
+			requestedDepth: depth,
+			organicResults: evidence.data.organicResults.length,
+			uniqueDomains: domains.length,
+			observedFeatures: evidence.data.features.length,
+			correctedQuery,
+			verdict: `${evidence.data.organicResults.length} organic results across ${domains.length} domains were retained from the ${evidence.market.device ?? "desktop"} snapshot.`
+		},
+		evidence,
+		domains,
+		findings: reportFindings(evidence.data, domains),
+		caveats: [
+			"This is one market, location, language, and device-specific result snapshot; it is not rank history.",
+			"Search results can change between checks and may differ from a person's signed-in or personalized results.",
+			"The provider result count is an estimate and may be missing; retained organic rows are bounded by the requested depth.",
+			"Repeated domains, result features, titles, and snippets do not establish content quality, authority, or ranking feasibility."
+		],
+		nextSteps: [
+			"Review the retained pages and result types before deciding whether the query fits an existing page, a new page, or no page.",
+			"Keep Search Console average position separate from these exact snapshot ranks when comparing first-party performance.",
+			"Repeat the same market and device check later if the decision depends on result stability."
+		]
+	};
+}
+//#endregion
+//#region packages/core/dist/analyze/local-search/report.js
+const MAX_DAYS$1 = 548;
+const MAX_ROWS = 5e4;
+function boundedInteger$2(input) {
+	const value = input.value ?? input.fallback;
+	if (!Number.isSafeInteger(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;
+}
+function validateInput(input) {
+	const site = input.site.trim();
+	if (!site) throw new SeoError("INVALID_INPUT", "site must not be empty.");
+	if (input.locationTerms && (input.locationTerms.length > 100 || input.locationTerms.some((term) => !term.trim() || term.length > 100))) throw new SeoError("INVALID_INPUT", "locationTerms must contain at most 100 non-empty terms of 100 characters or fewer.");
+	if (input.brandTerms && (input.brandTerms.length > 20 || input.brandTerms.some((term) => !term.trim() || term.length > 200))) throw new SeoError("INVALID_INPUT", "brandTerms must contain at most 20 non-empty terms of 200 characters or fewer.");
+	const includeSerps = input.includeSerps ?? false;
+	let market;
+	if (input.market) {
+		const parsed = searchMarketSchema.safeParse(input.market);
+		if (!parsed.success) throw new SeoError("INVALID_INPUT", "Use a valid search market.");
+		market = parsed.data;
+	}
+	if (includeSerps && !market?.location) throw new SeoError("INVALID_INPUT", "Local SERP evidence requires a country, language, and canonical location.");
+	if (!includeSerps && (input.market || input.provider || input.serpLimit !== void 0 || input.serpDepth !== void 0)) throw new SeoError("INVALID_INPUT", "Set includeSerps to true before passing market, provider, or SERP options.");
+	return {
+		site,
+		days: boundedInteger$2({
+			value: input.days,
+			fallback: 28,
+			minimum: 1,
+			maximum: MAX_DAYS$1,
+			label: "days"
+		}),
+		locationTerms: normalizeLocationTerms(input.locationTerms),
+		minImpressions: boundedInteger$2({
+			value: input.minImpressions,
+			fallback: 1,
+			minimum: 0,
+			maximum: 1e9,
+			label: "minImpressions"
+		}),
+		limit: boundedInteger$2({
+			value: input.limit,
+			fallback: 25,
+			minimum: 1,
+			maximum: 100,
+			label: "limit"
+		}),
+		maxRows: boundedInteger$2({
+			value: input.maxRows,
+			fallback: MAX_ROWS,
+			minimum: 1,
+			maximum: MAX_ROWS,
+			label: "maxRows"
+		}),
+		includeSerps,
+		market,
+		serpLimit: boundedInteger$2({
+			value: input.serpLimit,
+			fallback: 3,
+			minimum: 1,
+			maximum: 3,
+			label: "serpLimit"
+		}),
+		serpDepth: boundedInteger$2({
+			value: input.serpDepth,
+			fallback: 10,
+			minimum: 1,
+			maximum: 20,
+			label: "serpDepth"
+		})
+	};
+}
+function emptyCost() {
+	return {
+		currency: "USD",
+		estimatedMicros: 0,
+		actualMicros: 0,
+		taskIds: []
+	};
+}
+function aggregateCosts(costs) {
+	const estimated = costs.map((cost) => cost.estimatedMicros);
+	const actual = costs.map((cost) => cost.actualMicros);
+	return {
+		currency: "USD",
+		estimatedMicros: estimated.some((value) => value === null) ? null : estimated.reduce((sum, value) => sum + (value ?? 0), 0),
+		actualMicros: actual.some((value) => value === null) ? null : actual.reduce((sum, value) => sum + (value ?? 0), 0),
+		taskIds: [...new Set(costs.flatMap((cost) => cost.taskIds))].sort()
+	};
+}
+function costsWithUnknownRequest(costs) {
+	return {
+		currency: "USD",
+		estimatedMicros: null,
+		actualMicros: null,
+		taskIds: [...new Set(costs.flatMap((cost) => cost.taskIds))].sort()
+	};
+}
+async function acquireSerps(input) {
+	const selected = input.queries.slice(0, input.limit);
+	const selection = {
+		availableQueries: input.queries.length,
+		requestedQueries: selected.length,
+		omittedQueries: Math.max(0, input.queries.length - selected.length),
+		limit: input.limit,
+		depth: input.depth,
+		method: "highest-impression-local-queries-v1"
+	};
+	if (!input.requested) return {
+		requested: false,
+		status: "not-requested",
+		selection,
+		market: null,
+		reports: [],
+		cost: emptyCost(),
+		reason: "Local SERP snapshots were not requested, so no paid provider work was attempted."
+	};
+	if (selected.length === 0) return {
+		requested: true,
+		status: "skipped",
+		selection,
+		market: input.market ?? null,
+		reports: [],
+		cost: emptyCost(),
+		reason: "No retained local-intent query was available for a SERP snapshot."
+	};
+	if (!input.market) throw new SeoError("INVALID_INPUT", "Local SERP evidence requires a market.");
+	const reports = [];
+	try {
+		for (const query of selected) reports.push(await input.run({
+			keyword: query,
+			market: input.market,
+			depth: input.depth,
+			provider: input.provider,
+			projectId: input.projectId,
+			context: {
+				reportId: "local-search-demand",
+				reportRunId: input.reportRunId
+			},
+			refresh: input.refresh
+		}));
+	} catch (error) {
+		if (error instanceof SeoError && (error.code === "PROVIDER_UNAVAILABLE" || error.code === "RATE_LIMITED")) return {
+			requested: true,
+			status: reports.length > 0 ? "partial" : "unavailable",
+			selection,
+			market: input.market,
+			reports,
+			cost: costsWithUnknownRequest(reports.map((report) => report.evidence.cost)),
+			reason: "First-party local demand remains available, but not every requested SERP snapshot could be acquired.",
+			error: {
+				code: error.code,
+				message: error.message,
+				retryable: error.retryable
+			}
+		};
+		throw error;
+	}
+	return {
+		requested: true,
+		status: reports.every((report) => report.dataStatus === "complete") ? "complete" : "partial",
+		selection,
+		market: input.market,
+		reports,
+		cost: aggregateCosts(reports.map((report) => report.evidence.cost))
+	};
+}
+async function localSearchReport(input, dependencies = {}) {
+	const options = validateInput(input);
+	const now = (dependencies.now ?? (() => /* @__PURE__ */ new Date()))();
+	const generatedAt = now.toISOString();
+	const range = finalGscDateRange(options.days, now);
+	const source = await (dependencies.searchAnalytics ?? querySearchAnalytics)(options.site, {
+		...range,
+		dimensions: ["query", "page"],
+		type: "web",
+		dataState: "final",
+		maxRows: options.maxRows
+	}, { refresh: input.refresh });
+	const analysis = analyzeLocalSearchRows({
+		rows: source.rows,
+		site: options.site,
+		locationTerms: options.locationTerms,
+		brandTerms: input.brandTerms,
+		includeBrand: input.includeBrand,
+		minImpressions: options.minImpressions,
+		limit: options.limit
+	});
+	const serpEvidence = await acquireSerps({
+		requested: options.includeSerps,
+		queries: analysis.opportunities.map((item) => item.query),
+		market: options.market,
+		provider: input.provider,
+		projectId: input.projectId,
+		refresh: input.refresh,
+		limit: options.serpLimit,
+		depth: options.serpDepth,
+		reportRunId: randomUUID(),
+		run: dependencies.serpResults ?? serpResultsReport
+	});
+	const possiblyTruncated = source.rowsFetched >= options.maxRows;
+	const sourceEmpty = source.rows.length === 0;
+	const filtered = !sourceEmpty && analysis.selection.eligibleQueries === 0;
+	const partial = possiblyTruncated || serpEvidence.status === "partial" || serpEvidence.status === "unavailable";
+	const opportunities = analysis.opportunities;
+	const localPackSnapshots = serpEvidence.reports.filter((report) => report.evidence.data.features.includes("local_pack")).length;
+	const dataStatus = sourceEmpty ? "empty" : partial ? "partial" : filtered ? "filtered" : "complete";
+	const warnings = [];
+	if (possiblyTruncated) warnings.push(`Search Console reached the ${options.maxRows}-row retention cap. Lower-volume local queries may be missing.`);
+	if (analysis.selection.invalidRows > 0) warnings.push(`${analysis.selection.invalidRows} malformed Search Console rows were excluded.`);
+	if (analysis.selection.conflictingRows > 0) warnings.push(`${analysis.selection.conflictingRows} conflicting duplicate Search Console rows were excluded.`);
+	if (serpEvidence.error) warnings.push(serpEvidence.error.message);
+	const nextSteps = [];
+	if (!options.includeSerps) nextSteps.push("If the shortlisted queries justify paid verification, rerun with includeSerps true and an exact location and device to inspect current local result features and organic competitors.");
+	else if (serpEvidence.status === "unavailable") nextSteps.push("Check the provider connection, market support, and local spend limits before retrying the missing SERP snapshots.");
+	if (analysis.templates.length > 0) nextSteps.push("Run pseo-audit on the strongest repeated local page pattern before expanding it; verify source fields, page uniqueness, indexability, and representative output.");
+	if (opportunities.some((item) => item.action === "review-page-overlap")) nextSteps.push("Review overlapping pages query by query before consolidating anything; multiple retained pages do not by themselves prove harmful cannibalisation.");
+	nextSteps.push("Use location terms for the actual service area and repeat the report for materially different markets or devices instead of treating one area as representative.");
+	return {
+		schemaVersion: 1,
+		methodology: "local-search-demand-v1",
+		site: options.site,
+		generatedAt,
+		range,
+		rangeDays: options.days,
+		dataStatus,
+		source: {
+			provider: "google-search-console",
+			dimensions: ["query", "page"],
+			searchType: "web",
+			dataState: "final",
+			rowsFetched: source.rowsFetched,
+			calls: source.calls,
+			maxRows: options.maxRows,
+			possiblyTruncated,
+			completeness: possiblyTruncated ? "possibly-truncated" : "retained-query-page-rows-only"
+		},
+		methodologyDetails: {
+			intentMethod: "explicit-local-intent-v1",
+			suppliedLocationTerms: options.locationTerms,
+			automaticPatterns: [
+				"nearby-phrases",
+				"uk-postcodes",
+				"contextual-us-zip-codes"
+			],
+			opportunityOrder: "impressions-clicks-position-query-v1",
+			templateMethod: "pseo-url-template-clustering-v1"
+		},
+		selection: analysis.selection,
+		summary: {
+			localQueries: analysis.selection.eligibleQueries,
+			returnedQueries: opportunities.length,
+			pages: analysis.eligiblePageCount,
+			...analysis.eligibleSummary,
+			templates: analysis.templates.length,
+			serpSnapshots: serpEvidence.reports.length,
+			localPackSnapshots,
+			verdict: sourceEmpty ? "Search Console returned no retained query/page rows for this date window." : filtered ? "No retained query/page rows matched the supplied terms or automatic local-intent patterns." : `${countLabel(analysis.selection.eligibleQueries, "local-intent query")} found; ${countLabel(opportunities.length, "query")} returned for review.`
+		},
+		opportunities,
+		templates: analysis.templates,
+		serpEvidence,
+		warnings,
+		caveats: [
+			"Search Console exposes retained top query/page rows and does not guarantee every query. A row cap means lower-volume local demand may be missing.",
+			"Named-place, proximity, and postal-code matching are explicit heuristics. They can miss implicit local intent and postal-looking non-location terms.",
+			"A place in a query describes query wording, not the searcher's physical location. Search Console average position is not an exact local rank.",
+			"A Google Analytics city or region describes measured users under Analytics rules; it is not joined here because it cannot prove which search query brought a user.",
+			"A local_pack feature in a live snapshot proves only that the result type appeared in that market, device, and observation. It does not expose or validate every business listing.",
+			"Repeated URL patterns and page overlap are review signals, not proof that more pages should exist or that consolidation is required.",
+			input.includeBrand ? "Brand queries were included when they matched the local-intent rules." : "Brand-like queries were excluded using the site and supplied brand terms."
+		],
+		nextSteps
+	};
+}
+//#endregion
 //#region packages/core/dist/analyze/monitoring/crawl-recommendations.js
 function statusMovedToError(item) {
 	return item.kind !== "removed" && (item.after?.status ?? 0) >= 400 && (item.before?.status ?? 200) < 400;
@@ -32548,326 +33403,6 @@ function pseoOpportunityVerdict(input) {
 	return `${expansions} template-expansion candidate${expansions === 1 ? "" : "s"} and ${input.competitors.length} observed competitor domain${input.competitors.length === 1 ? "" : "s"} were retained for review.`;
 }
 //#endregion
-//#region packages/core/dist/providers/dataforseo/serp-snapshot.js
-const MAX_SERP_DEPTH = 100;
-const SERP_ENDPOINT = "v3/serp/google/organic/live/advanced";
-function safeUrl$1(value) {
-	if (!value) return null;
-	try {
-		const parsed = new URL(value);
-		if (!["http:", "https:"].includes(parsed.protocol)) return null;
-		parsed.username = "";
-		parsed.password = "";
-		return parsed.toString();
-	} catch {
-		return null;
-	}
-}
-function validOrganic(item) {
-	return item.type === "organic" && Number.isSafeInteger(item.rank_group) && (item.rank_group ?? 0) > 0 && Number.isSafeInteger(item.rank_absolute) && (item.rank_absolute ?? 0) > 0 && Number.isSafeInteger(item.page) && (item.page ?? 0) > 0 && Boolean(item.domain?.trim()) && safeUrl$1(item.url) !== null;
-}
-function organicResult(item) {
-	if (!validOrganic(item)) return null;
-	const url = safeUrl$1(item.url);
-	if (!url) return null;
-	return {
-		rankGroup: item.rank_group,
-		rankAbsolute: item.rank_absolute,
-		page: item.page,
-		domain: item.domain.trim().toLowerCase(),
-		url,
-		title: item.title ?? null,
-		description: item.description ?? null,
-		isFeaturedSnippet: item.is_featured_snippet ?? null
-	};
-}
-function checkedAt(value, fallback) {
-	const timestamp = Date.parse(value);
-	return Number.isFinite(timestamp) ? new Date(timestamp).toISOString() : fallback;
-}
-function mapDataForSeoSerpSnapshot(input, snapshot, endpoint = SERP_ENDPOINT) {
-	const market = searchMarketSchema.parse(input.market);
-	const keyword = normalizedKeyword$2(input.keyword);
-	const location = locationRequest(market, "serp-snapshot");
-	const result = snapshot.response.tasks.flatMap((task) => task.result ?? []).find((item) => normalizedKeyword$2(item.keyword) === keyword);
-	if (!result) throw new ProviderError({
-		provider: "dataforseo",
-		operation: "serp-snapshot",
-		code: "invalid-response",
-		message: "DataForSEO returned no matching SERP result."
-	});
-	const warnings = [...snapshot.warnings];
-	const items = result.items ?? [];
-	const organicItems = items.filter((item) => item.type === "organic");
-	const mappedOrganicResults = organicItems.flatMap((item) => {
-		const mapped = organicResult(item);
-		return mapped ? [mapped] : [];
-	}).sort((left, right) => left.rankAbsolute - right.rankAbsolute || left.rankGroup - right.rankGroup || compareCodepoints$3(left.url, right.url));
-	const organicResults = mappedOrganicResults.slice(0, input.depth);
-	const invalidRows = organicItems.length - mappedOrganicResults.length;
-	const resultCapped = mappedOrganicResults.length > input.depth;
-	const invalidResultCount = result.se_results_count !== null && result.se_results_count !== void 0 && result.se_results_count < organicResults.length;
-	if (invalidRows > 0) warnings.push({
-		code: "invalid-organic-results",
-		field: "organicResults",
-		message: `DataForSEO returned ${invalidRows} organic result${invalidRows === 1 ? "" : "s"} without a valid rank, domain, or URL.`
-	});
-	if (!Number.isFinite(Date.parse(result.datetime))) warnings.push({
-		code: "invalid-serp-observation-time",
-		field: "checkedAt",
-		message: "DataForSEO returned an invalid SERP observation time; the local response time was retained."
-	});
-	const checkUrl = safeUrl$1(result.check_url);
-	if (result.check_url && !checkUrl) warnings.push({
-		code: "invalid-serp-check-url",
-		field: "checkUrl",
-		message: "DataForSEO returned an invalid SERP check URL."
-	});
-	if (invalidResultCount) warnings.push({
-		code: "invalid-serp-result-count",
-		field: "resultCount",
-		message: "DataForSEO returned an estimated result count below the retained organic result count; the estimate was discarded."
-	});
-	const features = [.../* @__PURE__ */ new Set([...result.item_types ?? [], ...items.map((item) => item.type)])].sort(compareCodepoints$3);
-	return {
-		schemaVersion: 1,
-		provider: "dataforseo",
-		capability: "serp-snapshot",
-		data: {
-			keyword,
-			effectiveKeyword: normalizedKeyword$2(result.spell?.keyword ?? result.keyword),
-			searchEngineDomain: result.se_domain?.trim().toLowerCase() ?? null,
-			checkedAt: checkedAt(result.datetime, snapshot.observedAt),
-			checkUrl,
-			resultCount: invalidResultCount ? null : result.se_results_count ?? null,
-			pagesCount: result.pages_count === void 0 ? null : result.pages_count,
-			features,
-			organicResults
-		},
-		observedAt: snapshot.observedAt,
-		market: {
-			...market,
-			device: market.device ?? "desktop"
-		},
-		coverage: {
-			requestedRows: input.depth,
-			returnedRows: snapshot.returnedRows,
-			retainedRows: organicResults.length,
-			invalidRows,
-			providerTotalRows: invalidResultCount ? null : result.se_results_count ?? null,
-			completeness: invalidRows > 0 || invalidResultCount ? "partial" : resultCapped ? "capped" : "complete",
-			nextCursor: null
-		},
-		cache: snapshot.cache,
-		cost: snapshot.cost,
-		request: {
-			operation: "serp-snapshot",
-			endpoint,
-			limit: input.depth,
-			filters: {
-				countryCode: market.countryCode,
-				languageCode: market.languageCode,
-				device: market.device ?? "desktop",
-				...location.locationCode !== void 0 ? { locationCode: location.locationCode } : { locationName: location.locationName }
-			},
-			sort: ["rankAbsolute:ascending", "url:codepoint-ascending"]
-		},
-		warnings
-	};
-}
-var DataForSeoSerpSnapshotProvider = class {
-	provider = "dataforseo";
-	capabilitySupport = [{
-		capability: "serp-snapshot",
-		status: "available",
-		markets: [{
-			searchEngines: ["google"],
-			devices: ["desktop", "mobile"],
-			location: "any"
-		}]
-	}];
-	client;
-	constructor(options = {}) {
-		this.client = options.client ?? new DataForSeoClient(options);
-	}
-	async serpSnapshot(input) {
-		const market = searchMarketSchema.parse(input.market);
-		if (market.searchEngine !== "google") throw new ProviderError({
-			provider: "dataforseo",
-			operation: "serp-snapshot",
-			code: "configuration",
-			message: "DataForSEO SERP snapshots currently support Google."
-		});
-		if (!Number.isSafeInteger(input.depth) || input.depth < 1 || input.depth > MAX_SERP_DEPTH) throw new ProviderError({
-			provider: "dataforseo",
-			operation: "serp-snapshot",
-			code: "configuration",
-			message: "SERP depth must be from 1 to 100."
-		});
-		const keyword = normalizedKeyword$2(input.keyword);
-		if (!keyword || keyword.length > 80 || keyword.split(/\s+/u).length > 10) throw new ProviderError({
-			provider: "dataforseo",
-			operation: "serp-snapshot",
-			code: "configuration",
-			message: "SERP snapshots require a keyword of at most 80 characters and 10 words."
-		});
-		const context = input.context ?? {
-			reportId: "serp-results",
-			reportRunId: randomUUID()
-		};
-		const location = locationRequest(market, "serp-snapshot");
-		return mapDataForSeoSerpSnapshot(input, await this.client.serpLive({
-			keyword,
-			languageCode: market.languageCode.split("-")[0],
-			...location,
-			device: market.device ?? "desktop",
-			depth: input.depth,
-			refresh: input.refresh,
-			context
-		}));
-	}
-};
-//#endregion
-//#region packages/core/dist/analyze/serp-results.js
-const MAX_REPORT_DEPTH = 100;
-function compareCodepoints(left, right) {
-	return left < right ? -1 : left > right ? 1 : 0;
-}
-function snapshotProvider(candidate) {
-	return "serpSnapshot" in candidate && typeof candidate.serpSnapshot === "function" ? candidate : null;
-}
-async function defaultCandidates() {
-	return [{
-		adapter: new DataForSeoSerpSnapshotProvider(),
-		connected: Boolean(await readDataForSeoCredentials()),
-		priority: 10
-	}];
-}
-function providerError$1(error) {
-	if (!(error instanceof ProviderError)) throw error;
-	if (error.code === "rate-limit") throw new SeoError("RATE_LIMITED", error.message);
-	if (error.code === "configuration") throw new SeoError("INVALID_INPUT", error.message);
-	throw new SeoError("PROVIDER_UNAVAILABLE", error.message);
-}
-function validateInput(input) {
-	const keyword = input.keyword.trim().replace(/\s+/gu, " ");
-	if (!keyword || keyword.length > 80 || keyword.split(/\s+/u).length > 10) throw new SeoError("INVALID_INPUT", "SERP results requires a keyword of at most 80 characters and 10 words.");
-	if (!Number.isSafeInteger(input.depth) || input.depth < 1 || input.depth > MAX_REPORT_DEPTH) throw new SeoError("INVALID_INPUT", `SERP result depth must be from 1 to ${MAX_REPORT_DEPTH}.`);
-	const market = searchMarketSchema.safeParse(input.market);
-	if (!market.success) throw new SeoError("INVALID_INPUT", "Use a valid search market.");
-	const provider = input.provider ? providerIdSchema.safeParse(input.provider) : void 0;
-	if (provider && !provider.success) throw new SeoError("INVALID_INPUT", "Use a supported SERP provider.");
-	return {
-		keyword,
-		market: market.data,
-		provider: provider?.data
-	};
-}
-function reportStatus$1(evidence) {
-	if (evidence.coverage.completeness === "unavailable" || evidence.coverage.completeness === "invalid") return "unavailable";
-	return evidence.coverage.completeness === "complete" ? "complete" : "partial";
-}
-function domainSummaries(snapshot) {
-	const byDomain = /* @__PURE__ */ new Map();
-	for (const result of snapshot.organicResults) byDomain.set(result.domain, [...byDomain.get(result.domain) ?? [], result.rankAbsolute]);
-	return [...byDomain.entries()].map(([domain, ranks]) => ({
-		domain,
-		resultCount: ranks.length,
-		ranks: [...ranks].sort((left, right) => left - right)
-	})).sort((left, right) => right.resultCount - left.resultCount || (left.ranks[0] ?? Number.MAX_SAFE_INTEGER) - (right.ranks[0] ?? Number.MAX_SAFE_INTEGER) || compareCodepoints(left.domain, right.domain));
-}
-function reportFindings(snapshot, domains) {
-	const findings = [];
-	if (snapshot.effectiveKeyword !== snapshot.keyword) findings.push({
-		code: "query-correction",
-		evidenceRef: "evidence.data.effectiveKeyword",
-		principle: "A corrected query changes the observed result context and does not prove the original wording has the same intent.",
-		detail: `The provider observed results for ${snapshot.effectiveKeyword} after the requested query ${snapshot.keyword}.`
-	});
-	for (const [index, domain] of domains.entries()) {
-		if (domain.resultCount <= 1) continue;
-		findings.push({
-			code: "repeated-domain",
-			evidenceRef: `domains[${index}]`,
-			principle: "Repeated results are descriptive snapshot evidence, not a domain strength or quality score.",
-			detail: `${domain.domain} appears ${domain.resultCount} times at absolute ranks ${domain.ranks.join(", ")}.`
-		});
-	}
-	return findings.slice(0, 10);
-}
-async function serpResultsReport(input, dependencies = {}) {
-	const depth = input.depth ?? 10;
-	const validated = validateInput({
-		...input,
-		depth
-	});
-	let candidates;
-	try {
-		candidates = dependencies.candidates ?? await defaultCandidates();
-	} catch (error) {
-		return providerError$1(error);
-	}
-	const resolution = resolveProvider({
-		capability: "serp-snapshot",
-		market: validated.market,
-		candidates,
-		provider: validated.provider
-	});
-	if (resolution.status === "unavailable") throw new SeoError("PROVIDER_UNAVAILABLE", resolution.reason === "provider-not-connected" ? "No connected provider can return live SERP results. Run `seo providers dataforseo connect` first." : validated.provider ? `${validated.provider} cannot return live SERP results for this market.` : "No configured provider can return live SERP results for this market.");
-	const provider = snapshotProvider(resolution.provider);
-	if (!provider) throw new SeoError("PROVIDER_UNAVAILABLE", "The selected provider has no live SERP implementation.");
-	let evidence;
-	try {
-		evidence = await provider.serpSnapshot({
-			keyword: validated.keyword,
-			market: validated.market,
-			depth,
-			refresh: input.refresh,
-			context: {
-				projectId: input.context?.projectId ?? input.projectId,
-				reportId: input.context?.reportId ?? "serp-results",
-				reportRunId: input.context?.reportRunId ?? randomUUID()
-			}
-		});
-	} catch (error) {
-		return providerError$1(error);
-	}
-	const domains = domainSummaries(evidence.data);
-	const dataStatus = reportStatus$1(evidence);
-	const generatedAt = (dependencies.now ?? (() => /* @__PURE__ */ new Date()))().toISOString();
-	const correctedQuery = evidence.data.effectiveKeyword !== evidence.data.keyword;
-	return {
-		schemaVersion: 1,
-		generatedAt,
-		dataStatus,
-		market: evidence.market,
-		summary: {
-			keyword: evidence.data.keyword,
-			effectiveKeyword: evidence.data.effectiveKeyword,
-			requestedDepth: depth,
-			organicResults: evidence.data.organicResults.length,
-			uniqueDomains: domains.length,
-			observedFeatures: evidence.data.features.length,
-			correctedQuery,
-			verdict: `${evidence.data.organicResults.length} organic results across ${domains.length} domains were retained from the ${evidence.market.device ?? "desktop"} snapshot.`
-		},
-		evidence,
-		domains,
-		findings: reportFindings(evidence.data, domains),
-		caveats: [
-			"This is one market, location, language, and device-specific result snapshot; it is not rank history.",
-			"Search results can change between checks and may differ from a person's signed-in or personalized results.",
-			"The provider result count is an estimate and may be missing; retained organic rows are bounded by the requested depth.",
-			"Repeated domains, result features, titles, and snippets do not establish content quality, authority, or ranking feasibility."
-		],
-		nextSteps: [
-			"Review the retained pages and result types before deciding whether the query fits an existing page, a new page, or no page.",
-			"Keep Search Console average position separate from these exact snapshot ranks when comparing first-party performance.",
-			"Repeat the same market and device check later if the decision depends on result stability."
-		]
-	};
-}
-//#endregion
 //#region packages/core/dist/analyze/pseo-opportunities/serps.js
 function selectSerpKeywords(candidates, limit) {
 	const seedRefs = /* @__PURE__ */ new Set();
@@ -39218,6 +39753,7 @@ const TELEMETRY_REPORTS = [
 	"crawl-history",
 	"crawler-rules",
 	"llms-txt-audit",
+	"local-search-demand",
 	"generate-llms-txt",
 	"measure-change",
 	"monthly-report",
@@ -41315,6 +41851,74 @@ function registerKeywordTools(server, dependencies = {}) {
 	});
 }
 //#endregion
+//#region packages/mcp/src/local-search-tools.ts
+const localSearchInput = z$1.strictObject({
+	site: z$1.string().trim().min(1).max(2048),
+	days: z$1.number().int().min(1).max(548).optional(),
+	locationTerms: z$1.array(z$1.string().trim().min(1).max(100)).max(100).optional(),
+	minImpressions: z$1.number().int().min(0).max(1e9).optional(),
+	limit: z$1.number().int().min(1).max(100).optional(),
+	maxRows: z$1.number().int().min(1).max(5e4).optional(),
+	brandTerms: z$1.array(z$1.string().trim().min(1).max(200)).max(20).optional(),
+	includeBrand: z$1.boolean().optional(),
+	includeSerps: z$1.boolean().default(false),
+	countryCode: providerCountryCodeInput.optional(),
+	languageCode: providerLanguageCodeInput.optional(),
+	searchEngine: providerSearchEngineInput,
+	location: providerLocationInput.optional(),
+	device: providerDeviceInput.optional(),
+	provider: providerIdInput.optional(),
+	serpLimit: z$1.number().int().min(1).max(3).optional(),
+	serpDepth: z$1.number().int().min(1).max(20).optional(),
+	refresh: z$1.boolean().optional()
+}).superRefine((input, context) => {
+	const hasSerpOptions = Boolean(input.countryCode || input.languageCode || input.location || input.device || input.provider || input.serpLimit || input.serpDepth);
+	if (!input.includeSerps && hasSerpOptions) context.addIssue({
+		code: "custom",
+		path: ["includeSerps"],
+		message: "Set includeSerps to true before passing market, provider, or SERP options."
+	});
+	if (input.includeSerps && (!input.countryCode || !input.languageCode || !input.location)) context.addIssue({
+		code: "custom",
+		path: ["includeSerps"],
+		message: "Local SERP evidence requires countryCode, languageCode, and a canonical location."
+	});
+});
+function registerLocalSearchTools(server, dependencies = {}) {
+	server.registerTool("seo_local_search_demand", {
+		description: "Find retained local-intent demand, landing pages, repeated local templates, and optional location-specific SERP evidence",
+		inputSchema: localSearchInput
+	}, async ({ site, days, locationTerms, minImpressions, limit, maxRows, brandTerms, includeBrand, includeSerps, countryCode, languageCode, searchEngine, location, device, provider, serpLimit, serpDepth, refresh }) => {
+		try {
+			const report = await (dependencies.localSearchReport ?? localSearchReport)({
+				site,
+				days,
+				locationTerms,
+				minImpressions,
+				limit,
+				maxRows,
+				brandTerms,
+				includeBrand,
+				includeSerps,
+				...includeSerps && countryCode && languageCode && location ? { market: {
+					countryCode,
+					languageCode,
+					searchEngine,
+					location,
+					device
+				} } : {},
+				provider,
+				serpLimit,
+				serpDepth,
+				refresh
+			});
+			return toolSuccess(report.summary.verdict, compactAgentWorkflowOutput(report));
+		} catch (error) {
+			return toolError(error);
+		}
+	});
+}
+//#endregion
 //#region packages/mcp/src/monitoring-tools.ts
 function registerMonitoringTools(server) {
 	server.registerTool("seo_crawl_diff", {
@@ -43394,6 +43998,41 @@ const REPORT_DEPTH = {
 			}
 		]
 	},
+	"local-search-demand": {
+		readOrder: [
+			"dataStatus, source row cap, possiblyTruncated, and selection exclusions",
+			"methodologyDetails supplied terms and automatic heuristic patterns",
+			"opportunities intent evidence, metrics, page coverage, and action",
+			"templates as repeated page review signals",
+			"serpEvidence requested status, exact market, coverage, cache, cost, features, and organic rows",
+			"caveats and nextSteps"
+		],
+		doNotClaim: [
+			"A place in a query is not evidence of the searcher location, and Google Analytics geography cannot prove the query.",
+			"Search Console average position is not an exact city rank, and one live snapshot is not rank history.",
+			"A local pack feature does not expose every listing, prove business visibility, or replace Google Business Profile evidence.",
+			"A repeated local URL pattern does not prove shared intent, page quality, unique source data, or permission to scale."
+		],
+		verify: "Inspect representative landing pages and the retained live results in the same location, language, and device before changing or expanding local pages.",
+		related: [
+			{
+				id: "pseo-audit",
+				reason: "Validates repeated local page templates."
+			},
+			{
+				id: "serp-results",
+				reason: "Opens one local result snapshot."
+			},
+			{
+				id: "rank-tracking",
+				reason: "Measures exact local ranks over time."
+			},
+			{
+				id: "keyword-research",
+				reason: "Finds candidate terms beyond retained Search Console queries."
+			}
+		]
+	},
 	"saved-keywords": {
 		readOrder: [
 			"dataStatus, summary, evidence pagination, and any tag filter",
@@ -44285,6 +44924,17 @@ const REPORT_GUIDANCE = {
 		avoidWhen: ["You need exact current rankings or pages in the live results.", "You plan to turn every discovered term into a page without checking intent or fit."],
 		outcome: "A bounded keyword set with discovery sources, provider estimates, evidence states, and research follow-ups."
 	},
+	"local-search-demand": {
+		name: "Local search demand",
+		description: "Find location-specific Search Console demand and enrich a small shortlist with exact local result snapshots.",
+		useWhen: [
+			"You want to find retained queries that name a service area, use a proximity phrase, or contain a postcode or ZIP code.",
+			"You need to connect local demand with current landing pages and repeated programmatic page patterns.",
+			"You want optional city and device-specific result evidence without replacing first-party performance data."
+		],
+		avoidWhen: ["You need Google Business Profile performance or a complete business listing audit.", "You want the searcher location inferred from a place name in the query."],
+		outcome: "A bounded local-intent query and page queue, repeated local template signals, and optional local SERP feature and competitor evidence."
+	},
 	"saved-keywords": {
 		name: "Saved keyword set",
 		description: "Review one local keyword set with metric freshness, tags, page mappings, and explicit view limits.",
@@ -44863,6 +45513,11 @@ const reportGroups = [
 			"seo_serp_results"
 		]
 	},
+	{
+		category: "opportunities",
+		register: registerLocalSearchTools,
+		names: ["seo_local_search_demand"]
+	},
 	{
 		category: "opportunities",
 		register: registerDomainResearchTools,