seo 0.8.2 → 0.8.3

package/dist/mcp.js

@@ -1,5 +1,5 @@
 import { createRequire as __seoCreateRequire } from 'node:module'; const require = __seoCreateRequire(import.meta.url);
-import { i as __toESM, n as version, r as __commonJSMin, t as load } from "./esm-DeY7lZeN.js";
+import { i as __toESM, n as version, r as __commonJSMin, t as load } from "./esm-BZhSLbcQ.js";
 import { createHash, randomUUID, sign } from "node:crypto";
 import { ZodOptional, z } from "zod";
 import { arch, homedir, platform, totalmem } from "node:os";
@@ -38604,7 +38604,7 @@ async function totals$1(found, access, range, before, pages) {
 	}, { signIn: access.signIn });
 	const onPages = pages ? [filter("landingPage", pages, "CONTAINS")] : [];
 	const fromAi = [...onPages, filter("sessionSource", AI_SOURCE_PATTERN, "FULL_REGEXP")];
-	const [channels, google, aiSources, aiPages] = await Promise.all([
+	const [channels, google, aiSources, aiPages, engines] = await Promise.all([
 		read(["sessionDefaultChannelGroup"], onPages),
 		read([], [
 			...onPages,
@@ -38612,7 +38612,8 @@ async function totals$1(found, access, range, before, pages) {
 			filter("sessionSource", "google")
 		]),
 		read(["sessionSource"], fromAi),
-		read(["landingPage"], fromAi)
+		read(["landingPage"], fromAi),
+		read(["sessionSource"], [...onPages, filter("sessionDefaultChannelGroup", "Organic Search")])
 	]);
 	const sum = () => ({
 		google: {
@@ -38679,6 +38680,7 @@ async function totals$1(found, access, range, before, pages) {
 		})).sort((a, b) => b.sessions - a.sessions || b.previousSessions - a.previousSessions || String(a[key]).localeCompare(String(b[key])));
 	};
 	const bySource = byName(aiSources, "source");
+	const byEngine = byName(engines, "source");
 	const aiNow = bySource.reduce((total, row) => total + row.sessions, 0);
 	const aiBefore = bySource.reduce((total, row) => total + row.previousSessions, 0);
 	const data = { metadata: {
@@ -38687,13 +38689,15 @@ async function totals$1(found, access, range, before, pages) {
 			channels,
 			google,
 			aiSources,
-			aiPages
+			aiPages,
+			engines
 		].some((data) => data.metadata?.subjectToThresholding),
 		dataLossFromOtherRow: [
 			channels,
 			google,
 			aiSources,
-			aiPages
+			aiPages,
+			engines
 		].some((data) => data.metadata?.dataLossFromOtherRow)
 	} };
 	const notes = [];
@@ -38722,6 +38726,7 @@ async function totals$1(found, access, range, before, pages) {
 			previousSessions: periods.before.all.sessions,
 			sessionsChangePct: pct(periods.now.all.sessions, periods.before.all.sessions)
 		},
+		organicSearchByEngine: byEngine.slice(0, 10),
 		aiAssistants: {
 			sessions: aiNow,
 			previousSessions: aiBefore,
@@ -38734,6 +38739,11 @@ async function totals$1(found, access, range, before, pages) {
 	};
 }
 const change$1 = (value) => value === null ? "n/a" : `${value > 0 ? "+" : ""}${value}%`;
+function engineText(rows) {
+	const shown = rows.filter((row) => row.sessions || row.previousSessions);
+	if (shown.length < 2) return "";
+	return `Organic Search sessions by search engine: ${shown.slice(0, AI_ROWS).map((row) => `${row.source} ${row.sessions} (was ${row.previousSessions})`).join(", ")}.`;
+}
 function aiText(ai) {
 	const list = (rows, key) => rows.slice(0, AI_ROWS).map((row) => `${row[key]} ${row.sessions} (was ${row.previousSessions})`).join(", ");
 	if (!ai.sessions && !ai.previousSessions) return "Visits from AI assistants (ChatGPT, Perplexity, Claude, Gemini, Copilot and others): none in either period.";
@@ -38762,10 +38772,11 @@ async function analyticsBeside(access, site, range, before, pages) {
 		return {
 			text: [
 				`Google Analytics, property ${data.propertyName} (${data.property}), matched by its web stream ${data.webStream}${pages ? `, landing pages whose path contains "${pages}"` : ""}: Organic Search sessions from Google ${google.sessions} (was ${google.previousSessions}, ${change$1(google.sessionsChangePct)}), from every search engine ${organic.sessions} (was ${organic.previousSessions}, ${change$1(organic.sessionsChangePct)})${keyEvents}, sessions from all channels ${all.sessions} (was ${all.previousSessions}, ${change$1(all.sessionsChangePct)}).`,
+				engineText(data.organicSearchByEngine),
 				"Sessions are Google Analytics’ own count, not Search Console clicks.",
 				...data.notes,
 				...others.length ? [`Other properties with a matching web stream, with fewer sessions: ${others.join(", ")}.`] : []
-			].join(" ").concat("\n\n", aiText(data.aiAssistants)),
+			].filter(Boolean).join(" ").concat("\n\n", aiText(data.aiAssistants)),
 			data: {
 				...data,
 				...others.length ? { otherMatches: others } : {}
@@ -39000,6 +39011,102 @@ async function runBingRows(input, deps) {
 		}
 	};
 }
+function moved(rows, range, before, name, limit) {
+	const now = sumWeeks(rows, range);
+	const then = sumWeeks(rows, before);
+	const old = new Map(then.rows.map((row) => [row.key, row]));
+	const seen = new Set(now.rows.map((row) => row.key));
+	const all = now.rows.map((row) => {
+		const earlier = old.get(row.key);
+		return {
+			[name]: row.key,
+			clicks: row.clicks,
+			previousClicks: earlier ? earlier.clicks : null,
+			clicksChange: earlier ? row.clicks - earlier.clicks : null,
+			impressions: row.impressions,
+			position: row.position
+		};
+	});
+	const by = (sign) => all.filter((row) => row.clicksChange !== null && sign * row.clicksChange > 0).sort((a, b) => sign * (b.clicksChange - a.clicksChange) || String(a[name]).localeCompare(String(b[name]))).slice(0, limit);
+	return {
+		top: all.slice(0, limit),
+		biggestLosses: by(-1),
+		biggestGains: by(1),
+		leftTopList: then.rows.filter((row) => !seen.has(row.key)).slice(0, limit).map((row) => ({
+			[name]: row.key,
+			previousClicks: row.clicks
+		})),
+		weeks: now.weeks,
+		previousWeeks: then.weeks
+	};
+}
+async function bingOverview(source, range, before) {
+	if (!source.call) throw new CommandError("NOT_CONNECTED", source.missing);
+	const [totals, queries, pages] = await Promise.all([
+		bingTotals(source, range, before),
+		bingQueries(source.call, source.site),
+		bingPages(source.call, source.site)
+	]);
+	if ("missing" in totals) throw new CommandError("NOT_CONNECTED", totals.missing);
+	const { current: now, previous: then } = totals;
+	const q = moved(queries.rows, range, before, "query", 15);
+	const p = moved(pages.rows, range, before, "page", 15);
+	return {
+		bingSite: source.site,
+		range,
+		comparisonRange: before,
+		summary: {
+			clicks: now.clicks,
+			previousClicks: then.clicks,
+			clicksChangePct: pct(now.clicks, then.clicks),
+			impressions: now.impressions,
+			previousImpressions: then.impressions,
+			impressionsChangePct: pct(now.impressions, then.impressions),
+			days: now.days,
+			previousDays: then.days
+		},
+		pages: p,
+		queries: q,
+		caveats: [
+			...now.days < now.expectedDays || then.days < then.expectedDays ? [`Bing has data for ${now.days} of ${now.expectedDays} days (earlier period ${then.days} of ${then.expectedDays}), so its totals are partial.`] : [],
+			`Totals are Bing's daily site totals. Page and query rows are Bing's weekly top rows: weeks ${q.weeks.join(", ") || "none"} against ${q.previousWeeks.join(", ") || "none"}.`,
+			...BING_LIMITS.slice(1)
+		]
+	};
+}
+function bingOverviewText(report, heading, origin, rowsPerList) {
+	const range = report.range;
+	const before = report.comparisonRange;
+	const t = report.summary;
+	const columns = (name) => [
+		name,
+		"clicks",
+		"previousClicks",
+		"clicksChange",
+		"impressions",
+		"position"
+	];
+	const part = (title, rows, name) => {
+		const list = rows ?? [];
+		return list.length ? `${title}:\n${table(list.slice(0, rowsPerList), columns(name), origin)}` : "";
+	};
+	const group = (key, name) => {
+		const lists = report[key];
+		return [
+			part(`Biggest Bing ${key === "pages" ? "page" : "query"} click losses`, lists.biggestLosses, name),
+			part(`Biggest Bing ${key === "pages" ? "page" : "query"} click gains`, lists.biggestGains, name),
+			lists.leftTopList?.length ? `Left Bing's top ${key} list (now unknown, not zero): ${lists.leftTopList.slice(0, rowsPerList).map((row) => `${row[name]} (had ${row.previousClicks} clicks)`).join(", ")}.` : "",
+			rowsPerList >= 10 ? part(`Top Bing ${key}`, lists.top, name) : ""
+		].filter(Boolean).join("\n\n");
+	};
+	return [
+		`${heading}, ${range.startDate} to ${range.endDate} against ${before.startDate} to ${before.endDate}.`,
+		t.days || t.previousDays ? `Bing totals: clicks ${t.clicks} (was ${t.previousClicks}, ${change(t.clicks, t.previousClicks)}), impressions ${t.impressions} (was ${t.previousImpressions}, ${change(t.impressions, t.previousImpressions)}).` : "Bing totals: unknown. Bing has no daily data for these dates.",
+		group("pages", "page"),
+		group("queries", "query"),
+		`Limits:\n${report.caveats.map((line) => `- ${line}`).join("\n")}`
+	].filter(Boolean).join("\n\n");
+}
 //#endregion
 //#region packages/core/dist/commands/clicky.js
 const CLICKY_KEY_PREFIX = "x-clicky-";
@@ -39732,6 +39839,24 @@ async function enginesLine(overview, bing) {
 		return `Bing: could not be read. ${error instanceof Error ? error.message : String(error)}`;
 	}
 }
+async function bingLead(overview, bing, origin, rowsPerList) {
+	const range = overview.range;
+	const before = overview.comparisonRange;
+	const google = overview.summary.clicks;
+	try {
+		const source = await bing();
+		if (!source.call) return null;
+		const totals = await bingTotals(source, range, before);
+		if ("missing" in totals || totals.current.clicks <= google) return null;
+		const report = await bingOverview(source, range, before);
+		return {
+			text: `## Bing\n${bingOverviewText(report, `Bing sends more clicks than Google here, so here is Bing's overview of ${totals.site}`, origin, rowsPerList)}`,
+			data: report
+		};
+	} catch {
+		return null;
+	}
+}
 async function build(read, site, section, range, now, bing) {
 	const dependencies = {
 		searchAnalytics: read,
@@ -39851,6 +39976,8 @@ async function allSections(input, deps) {
 	if (!overview || overview instanceof Error) throw overview ?? /* @__PURE__ */ new Error("The overview did not run.");
 	const parts = [overviewText(overview, `Report on ${input.site}`, origin, 5)];
 	parts.push(deps.bing ? await enginesLine(overview, bing) : NO_BING_HERE);
+	const bingFirst = deps.bing ? await bingLead(overview, bing, origin, 5) : null;
+	if (bingFirst) parts.push(bingFirst.text);
 	const ga = await analytics;
 	if (ga) parts.push(ga.text);
 	const brand = rest.find((run) => !(run instanceof Error) && brandNote(run) !== null);
@@ -39883,6 +40010,7 @@ async function allSections(input, deps) {
 			site: input.site,
 			overview,
 			...ga ? { analytics: ga.data } : {},
+			...bingFirst ? { bingOverview: bingFirst.data } : {},
 			sections
 		}
 	};
@@ -39899,10 +40027,13 @@ async function oneSection(input, deps) {
 	if (section === "overview") {
 		const ga = await analyticsBeside(deps.analytics, site, range, earlierRange(range));
 		if (ga) report.analytics = ga.data;
+		const bingFirst = deps.bing ? await bingLead(report, bing, origin, 10) : null;
+		if (bingFirst) report.bingOverview = bingFirst.data;
 		if (detail !== "full") return {
 			text: [
 				overviewText(report, `overview of ${site}`, origin, 10),
 				deps.bing ? await enginesLine(report, bing) : NO_BING_HERE,
+				bingFirst?.text,
 				ga?.text,
 				`More: ${deps.call("report", {
 					site,
@@ -39967,6 +40098,27 @@ function runReport$1(input, deps) {
 		section: input.section
 	}, deps) : allSections(input, deps);
 }
+async function runBingReport(input, deps) {
+	const range = dateWindow(input, DEFAULT_DAYS.overview);
+	const before = earlierRange(range);
+	const source = await bingFor(deps, input.site);
+	if (!source.call) throw new CommandError("NOT_CONNECTED", source.missing);
+	const [report, ga] = await Promise.all([bingOverview(source, range, before), analyticsBeside(deps.analytics, source.site, range, before)]);
+	if (ga) report.analytics = ga.data;
+	return {
+		text: [
+			bingOverviewText(report, `Bing report on ${source.site}. No Search Console property covers this site, so this report uses Bing`, originOf(source.site), 10),
+			ga?.text,
+			`More: ${deps.call("data", {
+				source: "bing",
+				site: input.site,
+				dimensions: "page"
+			})} for every Bing page, or the same with query.`,
+			FACTS_ONLY.replace("Search Console", "Bing Webmaster Tools")
+		].filter(Boolean).join("\n\n"),
+		data: report
+	};
+}
 //#endregion
 //#region packages/core/dist/commands/research-providers.js
 function need(headers, provider) {
@@ -40607,14 +40759,25 @@ const SHARED_TOOLS = [
 			...dates,
 			...detail
 		}),
-		run: async (surface, input) => runReport$1({
-			site: input.section === "bing" ? await surface.resolveSite(input.site).catch(() => input.site) : await surface.resolveSite(input.site),
-			section: input.section,
-			startDate: input.start_date,
-			endDate: input.end_date,
-			detail: input.detail,
-			offset: input.offset
-		}, surface.deps)
+		run: async (surface, input) => {
+			const resolved = await surface.resolveSite(input.site).catch((error) => error instanceof Error ? error : new Error(String(error)));
+			if (resolved instanceof Error && !input.section && surface.deps.bing) return runBingReport({
+				site: input.site,
+				startDate: input.start_date,
+				endDate: input.end_date
+			}, surface.deps).catch(() => {
+				throw resolved;
+			});
+			if (resolved instanceof Error && input.section !== "bing") throw resolved;
+			return runReport$1({
+				site: resolved instanceof Error ? input.site : resolved,
+				section: input.section,
+				startDate: input.start_date,
+				endDate: input.end_date,
+				detail: input.detail,
+				offset: input.offset
+			}, surface.deps);
+		}
 	}),
 	tool({
 		name: "seo_page",