seo 0.7.1 → 0.8.1

package/dist/mcp.js

@@ -1,5 +1,5 @@
 import { createRequire as __seoCreateRequire } from 'node:module'; const require = __seoCreateRequire(import.meta.url);
-import { i as __toESM, n as load, r as __commonJSMin, t as version } from "./package-BaQwwfSG.js";
+import { i as __toESM, n as load, r as __commonJSMin, t as version } from "./package-BjCto4m4.js";
 import { createHash, randomUUID, sign } from "node:crypto";
 import { ZodOptional, z } from "zod";
 import { arch, homedir, platform, totalmem } from "node:os";
@@ -13036,6 +13036,98 @@ const RULE_DEFINITIONS = [
 		howToFix: "Add twitter:card and matching metadata only when you need a specific X preview. Keep Open Graph metadata accurate either way.",
 		impactIfIgnored: "X may use fallback metadata or a simple link preview. Organic rankings are not affected.",
 		howToVerify: "Re-run the crawl and confirm twitterCard is present if a specific X preview is required."
+	},
+	{
+		id: "ai_search_bot_blocked",
+		title: "robots.txt blocks AI search bots",
+		category: "agents",
+		defaultSeverity: "medium",
+		whyItMatters: "AI search bots fetch pages to answer a person's question and cite the source. A blocked bot cannot read the site, so its answers cannot quote or link to it. Training bots are a separate choice and are listed apart.",
+		howToFix: "Allow the AI search and user bots in robots.txt if the site should appear in AI answers. Block training bots separately if the person wants that.",
+		impactIfIgnored: "ChatGPT, Claude, Perplexity and similar tools can leave the site out of answers and citations.",
+		howToVerify: "Re-run the crawl and confirm the search bots in ai.robotsTxt.botAccess show allowed: true.",
+		review: {
+			question: "Is the site meant to be left out of AI search answers?",
+			changeOnlyIf: "Change robots.txt when the person wants the site to appear in AI answers.",
+			ifNotNeeded: "Record that blocking AI search bots is a deliberate choice for this site."
+		},
+		agentHints: { evidenceFields: ["report.ai.robotsTxt.botAccess"] }
+	},
+	{
+		id: "llms_txt_missing",
+		title: "No llms.txt",
+		category: "agents",
+		defaultSeverity: "low",
+		whyItMatters: "llms.txt gives agents a short summary of the site and links to its main pages, ideally their Markdown copies. Search engines do not use it for ranking.",
+		howToFix: "Publish /llms.txt as plain text with a one-line summary and sections of links to the main pages.",
+		impactIfIgnored: "Agents must find the main pages by crawling, which costs them more requests and tokens.",
+		howToVerify: "Request /llms.txt and confirm a 200 plain text response.",
+		review: {
+			question: "Should agents get a reading list for this site?",
+			changeOnlyIf: "Add it when agents are expected to read or use the site.",
+			ifNotNeeded: "Record that the site has no llms.txt by choice."
+		},
+		agentHints: { evidenceFields: ["report.ai.llmsTxt"] }
+	},
+	{
+		id: "llms_txt_broken_link",
+		title: "llms.txt links to a page that does not load",
+		category: "agents",
+		defaultSeverity: "low",
+		whyItMatters: "An agent that follows a link in llms.txt and gets an error loses its reading list entry.",
+		howToFix: "Update or remove each broken link in llms.txt, or restore the page it points to.",
+		impactIfIgnored: "Agents waste requests and can miss the page.",
+		howToVerify: "Re-run the crawl and confirm ai.llmsTxt.links.broken is empty.",
+		agentHints: { evidenceFields: ["report.ai.llmsTxt.links"] }
+	},
+	{
+		id: "markdown_missing",
+		title: "No Markdown copy of the pages",
+		category: "agents",
+		defaultSeverity: "low",
+		whyItMatters: "A Markdown copy gives agents the page content without layout, scripts or navigation, at a fraction of the tokens. Neither a request with Accept: text/markdown nor a rel=\"alternate\" link returned one. Search engines do not use it for ranking.",
+		howToFix: "Serve a Markdown copy of each page, linked from the page with <link rel=\"alternate\" type=\"text/markdown\">, and return it for Accept: text/markdown with Vary: Accept.",
+		impactIfIgnored: "Agents read the full HTML, which costs more tokens and can include layout text.",
+		howToVerify: "Request a page with Accept: text/markdown and confirm a text/markdown response.",
+		review: {
+			question: "Should agents get a Markdown copy of the pages?",
+			changeOnlyIf: "Add it when agents are expected to read the site.",
+			ifNotNeeded: "Record that the site serves HTML only by choice."
+		},
+		agentHints: { evidenceFields: ["report.ai.markdownNegotiation", "report.ai.markdownCopies"] }
+	},
+	{
+		id: "markdown_alternate_missing",
+		title: "Page has no link to its Markdown copy",
+		category: "agents",
+		defaultSeverity: "low",
+		whyItMatters: "Other pages on the site link to a Markdown copy, but this one does not, so agents cannot find a copy for it.",
+		howToFix: "Add <link rel=\"alternate\" type=\"text/markdown\" href=\"...\"> to the page head, pointing at its Markdown copy.",
+		impactIfIgnored: "Agents read the full HTML for this page.",
+		howToVerify: "Re-run the crawl and confirm the page lists a Markdown alternate.",
+		agentHints: { evidenceFields: ["page.markdownAlternates", "report.ai.markdownCopies"] }
+	},
+	{
+		id: "markdown_alternate_on_private_page",
+		title: "Signed-in page links to a Markdown copy",
+		category: "agents",
+		defaultSeverity: "medium",
+		whyItMatters: "Signed-in pages should have no Markdown copy. This page needs a sign-in, yet it links to one. A copy can show agents content that a signed-out visitor cannot see, or fail and waste their requests.",
+		howToFix: "Remove the rel=\"alternate\" Markdown link, the Link header and any Markdown copy for signed-in routes. Public pages keep theirs, including noindex pages such as privacy and terms.",
+		impactIfIgnored: "Agents can request a copy that fails, or read content that was meant to stay behind a sign-in.",
+		howToVerify: "Re-run the crawl and confirm the page no longer lists a Markdown alternate.",
+		agentHints: { evidenceFields: ["page.markdownAlternates", "report.ai.markdownCopies.broken"] }
+	},
+	{
+		id: "markdown_copy_broken",
+		title: "Markdown copy does not load",
+		category: "agents",
+		defaultSeverity: "medium",
+		whyItMatters: "The page links to a Markdown copy that returns an error or HTML, so an agent that follows the link gets nothing useful. If the page needs a sign-in, remove the link instead.",
+		howToFix: "Make the linked URL return the page as text/markdown, or fix the link.",
+		impactIfIgnored: "Agents get an error or the HTML page instead of the copy.",
+		howToVerify: "Request the Markdown URL and confirm a 200 text/markdown response.",
+		agentHints: { evidenceFields: ["report.ai.markdownCopies.broken"] }
 	}
 ];
 const RULE_RECOMMENDATIONS = {
@@ -13064,7 +13156,10 @@ const RULE_RECOMMENDATIONS = {
 	og_title_missing: "review",
 	og_description_missing: "review",
 	og_image_missing: "review",
-	twitter_card_missing: "review"
+	twitter_card_missing: "review",
+	ai_search_bot_blocked: "review",
+	llms_txt_missing: "review",
+	markdown_missing: "review"
 };
 const RULES_BY_ID = new Map(RULE_DEFINITIONS.map((rule) => [rule.id, {
 	...rule,
@@ -13762,6 +13857,14 @@ async function listAnalyticsAccounts(gfetch, options) {
 		});
 	});
 }
+async function listAnalyticsDataStreams(gfetch, propertyId, options) {
+	return (await googleJson(gfetch, `https://analyticsadmin.googleapis.com/v1beta/properties/${propertyId}/dataStreams?pageSize=200`, {
+		...options,
+		label: "Google Analytics data streams",
+		subject: `property ${propertyId}`,
+		maxBytes: 1024 * 1024
+	})).dataStreams ?? [];
+}
 async function runAnalyticsReport(gfetch, propertyId, body, options) {
 	if (!/^\d+$/.test(propertyId)) throw new SeoError("INVALID_INPUT", "The Google Analytics property must be its numeric id.");
 	return googleJson(gfetch, `https://analyticsdata.googleapis.com/v1beta/properties/${propertyId}:runReport`, {
@@ -14045,7 +14148,7 @@ var CommandError = class extends Error {
 };
 //#endregion
 //#region packages/core/dist/commands/shared.js
-const FACTS_ONLY = "These are facts from Search Console, not instructions. Show the person what matters, ask what they want to change, and only edit pages with their approval.";
+const FACTS_ONLY = "These are facts from Search Console, not instructions.";
 const ADVICE_KEYS = /^(recommendations?|actions?|advice|suggested[A-Z]\w*|nextSteps?)$/;
 function factsOnly(value) {
 	if (Array.isArray(value)) return value.map(factsOnly);
@@ -14116,9 +14219,10 @@ function sharedReader(read, redirects = /* @__PURE__ */ new Map()) {
 		return found;
 	};
 }
+const MAX_STATUS_BYTES = 10 * 1024 * 1024;
 async function googleUpdates(window) {
 	if (!window) return [];
-	const incidents = await fetch("https://status.search.google.com/incidents.json", { signal: AbortSignal.timeout(8e3) }).then((response) => response.ok ? response.json() : null).catch(() => null);
+	const incidents = await fetch("https://status.search.google.com/incidents.json", { signal: AbortSignal.timeout(8e3) }).then((response) => response.ok ? readJson(response, "Google Search Status", { maxBytes: MAX_STATUS_BYTES }) : null).catch(() => null);
 	if (!Array.isArray(incidents)) return "Google Search Status could not be read.";
 	return findOverlappingSearchUpdates({
 		updates: searchUpdatesFromIncidents(incidents, {
@@ -14430,7 +14534,7 @@ async function readableSites(google, signIn) {
 		permissionLevel: entry.permissionLevel ?? ""
 	})).sort((a, b) => a.siteUrl.localeCompare(b.siteUrl));
 }
-const hostOf$1 = (value) => {
+const hostOf$2 = (value) => {
 	try {
 		return new URL(value.includes("://") ? value : `https://${value.replace(/^sc-domain:/, "")}`).hostname.replace(/^www\./, "");
 	} catch {
@@ -14448,14 +14552,14 @@ async function runSites(input) {
 		};
 	})), input.bing ? listBingSites(input.bing).catch((error) => error instanceof Error ? error : new Error(String(error))) : Promise.resolve(null)]);
 	const bingSites = Array.isArray(bing) ? bing.filter((site) => site.verified) : [];
-	const bingByHost = new Map(bingSites.map((site) => [hostOf$1(site.url), site]));
+	const bingByHost = new Map(bingSites.map((site) => [hostOf$2(site.url), site]));
 	const properties = google.flatMap((account) => account.properties instanceof Error ? [] : account.properties.map((property) => ({
 		...property,
 		...named ? { account: account.email ?? "" } : {},
-		...Array.isArray(bing) ? { bing: bingByHost.get(hostOf$1(property.siteUrl))?.url ?? "" } : {}
+		...Array.isArray(bing) ? { bing: bingByHost.get(hostOf$2(property.siteUrl))?.url ?? "" } : {}
 	})));
-	const googleHosts = new Set(properties.map((property) => hostOf$1(property.siteUrl)));
-	const bingOnly = bingSites.filter((site) => !googleHosts.has(hostOf$1(site.url)));
+	const googleHosts = new Set(properties.map((property) => hostOf$2(property.siteUrl)));
+	const bingOnly = bingSites.filter((site) => !googleHosts.has(hostOf$2(site.url)));
 	const failed = google.filter((account) => account.properties instanceof Error);
 	const analytics = google.flatMap((account) => (account.analytics ?? []).flatMap((summary) => summary.propertySummaries.map((property) => ({
 		property: property.property.replace("properties/", ""),
@@ -14767,7 +14871,7 @@ async function cloudCredentials(options = {}) {
 	return credentials;
 }
 function notSignedIn() {
-	return "Not signed in. Run `seo login` to use your seoskill.dev account on this machine (it prints a link to approve), or `seo auth login` to sign in with Google on this machine only.";
+	return "Not signed in. Run `seo login` to use your seoskill.dev account on this machine (it prints a link to approve), or `seo auth login` to sign in with Google on this machine only. `seo crawl --url <url>` works without sign-in.";
 }
 function tokenOf(item, what) {
 	if ("error" in item) throw new SeoError("AUTH_EXPIRED", `${what}: ${item.error}`);
@@ -21662,7 +21766,7 @@ function clientRenderedContentEvidence(page) {
 		}
 	};
 }
-function issue(ruleId, page, detail, evidence) {
+function issue$1(ruleId, page, detail, evidence) {
 	const rule = explainRule(ruleId);
 	if (!rule) throw new Error(`Missing rule guidance for ${ruleId}`);
 	return {
@@ -21827,7 +21931,7 @@ function auditCrawlPages(pages, opts = {}) {
 	}
 	for (const page of pages) {
 		if (page.status === 0) {
-			issues.push(issue("connection_error", page, page.error, {
+			issues.push(issue$1("connection_error", page, page.error, {
 				status: page.status,
 				error: page.error
 			}));
@@ -21835,23 +21939,23 @@ function auditCrawlPages(pages, opts = {}) {
 		}
 		if (page.accessBlock) continue;
 		if (page.status >= 500) {
-			issues.push(issue("server_error", page, String(page.status), { status: page.status }));
-			if ((page.internalInlinkCount ?? 0) > 0) issues.push(issue("broken_internal_link", page, String(page.status), {
+			issues.push(issue$1("server_error", page, String(page.status), { status: page.status }));
+			if ((page.internalInlinkCount ?? 0) > 0) issues.push(issue$1("broken_internal_link", page, String(page.status), {
 				status: page.status,
 				internalInlinkCount: page.internalInlinkCount
 			}));
 			continue;
 		}
 		if (page.status >= 400) {
-			issues.push(issue("client_error", page, String(page.status), { status: page.status }));
-			if (isBrokenLinkStatus(page.status) && (page.internalInlinkCount ?? 0) > 0) issues.push(issue("broken_internal_link", page, String(page.status), {
+			issues.push(issue$1("client_error", page, String(page.status), { status: page.status }));
+			if (isBrokenLinkStatus(page.status) && (page.internalInlinkCount ?? 0) > 0) issues.push(issue$1("broken_internal_link", page, String(page.status), {
 				status: page.status,
 				internalInlinkCount: page.internalInlinkCount
 			}));
 			continue;
 		}
 		if (page.status >= 300) {
-			issues.push(issue("redirected_url", page, `Status ${page.status}`, {
+			issues.push(issue$1("redirected_url", page, `Status ${page.status}`, {
 				requestedUrl: page.url,
 				finalUrl: page.finalUrl,
 				status: page.status
@@ -21862,7 +21966,7 @@ function auditCrawlPages(pages, opts = {}) {
 		const redirected = isRedirectedPage(page);
 		if (redirected) {
 			const redirectTarget = page.metaRefresh?.targetUrl ?? page.finalUrl;
-			issues.push(issue("redirected_url", page, `Final URL: ${redirectTarget}`, {
+			issues.push(issue$1("redirected_url", page, `Final URL: ${redirectTarget}`, {
 				requestedUrl: page.url,
 				finalUrl: redirectTarget,
 				status: page.status,
@@ -21873,46 +21977,46 @@ function auditCrawlPages(pages, opts = {}) {
 			}));
 		}
 		const redirectChain = page.fetchDiagnostics?.redirectChain ?? [];
-		if (redirectChain.length > 1) issues.push(issue("redirect_chain", page, `${redirectChain.length} hops`, {
+		if (redirectChain.length > 1) issues.push(issue$1("redirect_chain", page, `${redirectChain.length} hops`, {
 			redirectChain,
 			hops: redirectChain.length
 		}));
-		if ((page.responseTimeMs ?? 0) > SLOW_RESPONSE_MS) issues.push(issue("slow_response", page, `${page.responseTimeMs}ms`, {
+		if ((page.responseTimeMs ?? 0) > SLOW_RESPONSE_MS) issues.push(issue$1("slow_response", page, `${page.responseTimeMs}ms`, {
 			responseTimeMs: page.responseTimeMs,
 			thresholdMs: SLOW_RESPONSE_MS
 		}));
 		if (page.auditScope === "status") continue;
 		if (redirected) continue;
-		if (page.softAuthenticationGate) issues.push(issue("soft_authentication_gate", page, "A password form and login-specific page signals were observed.", page.softAuthenticationGate));
+		if (page.softAuthenticationGate) issues.push(issue$1("soft_authentication_gate", page, "A password form and login-specific page signals were observed.", page.softAuthenticationGate));
 		const renderedContent = clientRenderedContentEvidence(page);
-		if (renderedContent) issues.push(issue("client_rendered_content", page, "The raw response was an empty or near-empty shell.", renderedContent));
-		if (!renderedContent && isAuditableHtmlPage(page) && page.indexable && page.extractionStatus === "complete" && page.wordCount < NEAR_EMPTY_CONTENT_WORDS) issues.push(issue("near_empty_content", page, `${page.wordCount} extracted words`, {
+		if (renderedContent) issues.push(issue$1("client_rendered_content", page, "The raw response was an empty or near-empty shell.", renderedContent));
+		if (!renderedContent && isAuditableHtmlPage(page) && page.indexable && page.extractionStatus === "complete" && page.wordCount < NEAR_EMPTY_CONTENT_WORDS) issues.push(issue$1("near_empty_content", page, `${page.wordCount} extracted words`, {
 			wordCount: page.wordCount,
 			reviewBelowWords: NEAR_EMPTY_CONTENT_WORDS,
 			contentSample: page.contentSample,
 			outgoingInternalCount: page.outgoingInternalCount,
 			rendering: page.fetchDiagnostics?.rendering
 		}));
-		if (isHtmlPage(page) && (page.sizeBytes ?? 0) > LARGE_HTML_BYTES) issues.push(issue("large_html", page, `${Math.round((page.sizeBytes ?? 0) / 1024)} KB`, {
+		if (isHtmlPage(page) && (page.sizeBytes ?? 0) > LARGE_HTML_BYTES) issues.push(issue$1("large_html", page, `${Math.round((page.sizeBytes ?? 0) / 1024)} KB`, {
 			sizeBytes: page.sizeBytes,
 			thresholdBytes: LARGE_HTML_BYTES
 		}));
-		if (isHtmlPage(page) && !page.compression && (page.sizeBytes ?? 0) > COMPRESSION_MIN_BYTES) issues.push(issue("no_compression", page, void 0, {
+		if (isHtmlPage(page) && !page.compression && (page.sizeBytes ?? 0) > COMPRESSION_MIN_BYTES) issues.push(issue$1("no_compression", page, void 0, {
 			sizeBytes: page.sizeBytes,
 			thresholdBytes: COMPRESSION_MIN_BYTES,
 			compression: page.compression
 		}));
-		if (page.isHttps === false && !isLoopbackUrl(page.finalUrl || page.url)) issues.push(issue("http_not_secure", page, void 0, { finalUrl: page.finalUrl }));
+		if (page.isHttps === false && !isLoopbackUrl(page.finalUrl || page.url)) issues.push(issue$1("http_not_secure", page, void 0, { finalUrl: page.finalUrl }));
 		else if (page.isHttps === true) {
-			if ((page.mixedContentCount ?? 0) > 0) issues.push(issue("mixed_content", page, `${page.mixedContentCount} insecure resources`, {
+			if ((page.mixedContentCount ?? 0) > 0) issues.push(issue$1("mixed_content", page, `${page.mixedContentCount} insecure resources`, {
 				mixedContentCount: page.mixedContentCount,
 				mixedContentSamples: page.mixedContentSamples
 			}));
-			if (page.hasHsts === false) issues.push(issue("hsts_missing", page, void 0, { header: "strict-transport-security" }));
+			if (page.hasHsts === false) issues.push(issue$1("hsts_missing", page, void 0, { header: "strict-transport-security" }));
 		}
 		for (const link of page.externalLinkChecks ?? []) {
 			if (link.state !== "confirmed-broken") continue;
-			issues.push(issue("broken_external_link", page, link.url, {
+			issues.push(issue$1("broken_external_link", page, link.url, {
 				url: link.url,
 				status: link.status,
 				error: link.error,
@@ -21920,64 +22024,64 @@ function auditCrawlPages(pages, opts = {}) {
 				attempts: link.attempts
 			}));
 		}
-		if (page.indexable && (page.internalInlinkCount ?? 0) === 0 && !sameUrl(page.url, opts.startUrl)) issues.push(issue("orphan_page", page, "No internal inlinks", { internalInlinkCount: page.internalInlinkCount ?? 0 }));
-		if ((page.crawlDepth ?? 0) > DEEP_PAGE_DEPTH) issues.push(issue("deep_page", page, `Depth ${page.crawlDepth}`, {
+		if (page.indexable && (page.internalInlinkCount ?? 0) === 0 && !sameUrl(page.url, opts.startUrl)) issues.push(issue$1("orphan_page", page, "No internal inlinks", { internalInlinkCount: page.internalInlinkCount ?? 0 }));
+		if ((page.crawlDepth ?? 0) > DEEP_PAGE_DEPTH) issues.push(issue$1("deep_page", page, `Depth ${page.crawlDepth}`, {
 			crawlDepth: page.crawlDepth,
 			threshold: DEEP_PAGE_DEPTH
 		}));
-		if (page.indexable && isValuablePage(page) && (page.internalInlinkCount ?? 0) <= WEAK_VALUABLE_INLINKS) issues.push(issue("weak_internal_links_to_valuable_page", page, `${page.internalInlinkCount ?? 0} internal inlinks`, {
+		if (page.indexable && isValuablePage(page) && (page.internalInlinkCount ?? 0) <= WEAK_VALUABLE_INLINKS) issues.push(issue$1("weak_internal_links_to_valuable_page", page, `${page.internalInlinkCount ?? 0} internal inlinks`, {
 			internalInlinkCount: page.internalInlinkCount ?? 0,
 			searchMetrics: page.searchMetrics,
 			analytics: page.analytics
 		}));
-		if (page.robotsTxt?.allowed === false) issues.push(issue("robots_blocked", page, page.robotsTxt.matchedLine, { robotsTxt: page.robotsTxt }));
-		if (hasXRobotsDirective(page.xRobotsTag, "noindex")) issues.push(issue("x_robots_noindex", page, page.xRobotsTag, { xRobotsTag: page.xRobotsTag }));
+		if (page.robotsTxt?.allowed === false) issues.push(issue$1("robots_blocked", page, page.robotsTxt.matchedLine, { robotsTxt: page.robotsTxt }));
+		if (hasXRobotsDirective(page.xRobotsTag, "noindex")) issues.push(issue$1("x_robots_noindex", page, page.xRobotsTag, { xRobotsTag: page.xRobotsTag }));
 		const xRobotsNofollow = hasXRobotsDirective(page.xRobotsTag, "nofollow");
-		if (xRobotsNofollow) issues.push(issue("nofollow", page, page.xRobotsTag, { xRobotsTag: page.xRobotsTag }));
+		if (xRobotsNofollow) issues.push(issue$1("nofollow", page, page.xRobotsTag, { xRobotsTag: page.xRobotsTag }));
 		if (!isAuditableHtmlPage(page)) continue;
 		const title = page.title?.trim();
 		const titleWidth = title ? estimateSerpTitleWidth(title) : void 0;
 		const duplicateTitle = duplicateTitles.get(normalizedMetadata(title) ?? "");
-		if (!title) issues.push(issue("missing_title", page));
-		else if (titleWidth?.status === "over-reference") issues.push(issue("title_too_wide", page, `${titleWidth.estimatedPixels}px`, {
+		if (!title) issues.push(issue$1("missing_title", page));
+		else if (titleWidth?.status === "over-reference") issues.push(issue$1("title_too_wide", page, `${titleWidth.estimatedPixels}px`, {
 			title,
 			...titleWidth
 		}));
-		if (title && duplicateTitle) issues.push(issue("title_duplicate", page, duplicateTitle.value, {
+		if (title && duplicateTitle) issues.push(issue$1("title_duplicate", page, duplicateTitle.value, {
 			title,
 			duplicateCount: duplicateTitle.count,
 			sampleUrls: duplicateTitle.sampleUrls
 		}));
 		const metaDescription = page.metaDescription?.trim();
 		const duplicateDescription = duplicateDescriptions.get(normalizedMetadata(metaDescription) ?? "");
-		if (!metaDescription) issues.push(issue("missing_meta_description", page));
-		if (metaDescription && duplicateDescription) issues.push(issue("meta_description_duplicate", page, duplicateDescription.value, {
+		if (!metaDescription) issues.push(issue$1("missing_meta_description", page));
+		if (metaDescription && duplicateDescription) issues.push(issue$1("meta_description_duplicate", page, duplicateDescription.value, {
 			metaDescription,
 			duplicateCount: duplicateDescription.count,
 			sampleUrls: duplicateDescription.sampleUrls
 		}));
 		const h1Count = page.h1Count ?? (page.h1 ? 1 : 0);
-		if (h1Count === 0) issues.push(issue("h1_missing", page, "No H1 found", { h1Count }));
-		else if (h1Count > 1) issues.push(issue("h1_multiple", page, `${h1Count} H1 headings`, { h1Count }));
-		if (page.canonicalStatus === "conflicting") issues.push(issue("canonical_conflict", page, void 0, { candidates: page.canonicalCandidates }));
-		else if (page.canonicalStatus === "duplicate") issues.push(issue("canonical_multiple", page, page.canonical, {
+		if (h1Count === 0) issues.push(issue$1("h1_missing", page, "No H1 found", { h1Count }));
+		else if (h1Count > 1) issues.push(issue$1("h1_multiple", page, `${h1Count} H1 headings`, { h1Count }));
+		if (page.canonicalStatus === "conflicting") issues.push(issue$1("canonical_conflict", page, void 0, { candidates: page.canonicalCandidates }));
+		else if (page.canonicalStatus === "duplicate") issues.push(issue$1("canonical_multiple", page, page.canonical, {
 			canonical: page.canonical,
 			candidates: page.canonicalCandidates
 		}));
-		else if (page.canonicalStatus === "outside-head-only") issues.push(issue("canonical_outside_head", page, page.canonicalRaw, { candidates: page.canonicalCandidates }));
-		else if (page.canonicalStatus === "streamed-outside-head") issues.push(issue("canonical_streamed_in_body", page, page.canonical, {
+		else if (page.canonicalStatus === "outside-head-only") issues.push(issue$1("canonical_outside_head", page, page.canonicalRaw, { candidates: page.canonicalCandidates }));
+		else if (page.canonicalStatus === "streamed-outside-head") issues.push(issue$1("canonical_streamed_in_body", page, page.canonical, {
 			canonical: page.canonical,
 			candidates: page.canonicalCandidates
 		}));
 		if (!page.canonical) {
-			if (!["conflicting", "outside-head-only"].includes(page.canonicalStatus ?? "")) issues.push(page.canonicalRaw ? issue("canonical_invalid", page, page.canonicalRaw, { canonicalRaw: page.canonicalRaw }) : issue("canonical_missing", page));
+			if (!["conflicting", "outside-head-only"].includes(page.canonicalStatus ?? "")) issues.push(page.canonicalRaw ? issue$1("canonical_invalid", page, page.canonicalRaw, { canonicalRaw: page.canonicalRaw }) : issue$1("canonical_missing", page));
 		} else {
-			if (page.canonicalRaw && !absoluteHttpUrl(page.canonicalRaw)) issues.push(issue("canonical_non_absolute", page, page.canonicalRaw, {
+			if (page.canonicalRaw && !absoluteHttpUrl(page.canonicalRaw)) issues.push(issue$1("canonical_non_absolute", page, page.canonicalRaw, {
 				canonicalRaw: page.canonicalRaw,
 				canonical: page.canonical
 			}));
 			const canonicalTarget = pageByUrl.get(urlKey(page.canonical) ?? "");
-			if (canonicalTarget?.canonical && !sameUrl(canonicalTarget.canonical, page.canonical)) issues.push(issue("canonical_chain", page, page.canonical, {
+			if (canonicalTarget?.canonical && !sameUrl(canonicalTarget.canonical, page.canonical)) issues.push(issue$1("canonical_chain", page, page.canonical, {
 				canonical: page.canonical,
 				nextCanonical: canonicalTarget.canonical,
 				chain: [
@@ -21987,25 +22091,25 @@ function auditCrawlPages(pages, opts = {}) {
 				]
 			}));
 		}
-		if (hasMetaRobotsDirective(page.metaRobots, "noindex")) issues.push(issue("noindex", page, page.indexability, { metaRobots: page.metaRobots }));
-		if (hasMetaRobotsDirective(page.metaRobots, "nofollow") && !xRobotsNofollow) issues.push(issue("nofollow", page, page.metaRobots, { metaRobots: page.metaRobots }));
-		if (page.canonical && !sameUrl(page.canonical, page.finalUrl) && (page.declaredIndexability === "canonical-hint-other" || page.declaredIndexability === void 0 && /canonical/i.test(page.indexability ?? ""))) issues.push(issue("canonicalized_page", page, page.canonical, {
+		if (hasMetaRobotsDirective(page.metaRobots, "noindex")) issues.push(issue$1("noindex", page, page.indexability, { metaRobots: page.metaRobots }));
+		if (hasMetaRobotsDirective(page.metaRobots, "nofollow") && !xRobotsNofollow) issues.push(issue$1("nofollow", page, page.metaRobots, { metaRobots: page.metaRobots }));
+		if (page.canonical && !sameUrl(page.canonical, page.finalUrl) && (page.declaredIndexability === "canonical-hint-other" || page.declaredIndexability === void 0 && /canonical/i.test(page.indexability ?? ""))) issues.push(issue$1("canonicalized_page", page, page.canonical, {
 			canonical: page.canonical,
 			finalUrl: page.finalUrl,
 			indexability: page.indexability
 		}));
-		else if (page.canonical && !sameUrl(page.canonical, page.finalUrl)) issues.push(issue("canonical_mismatch", page, page.canonical, {
+		else if (page.canonical && !sameUrl(page.canonical, page.finalUrl)) issues.push(issue$1("canonical_mismatch", page, page.canonical, {
 			canonical: page.canonical,
 			finalUrl: page.finalUrl
 		}));
 		const contentDuplicate = page.mainContentHash ? duplicateContent.get(page.mainContentHash) : void 0;
-		if (contentDuplicate) issues.push(issue("duplicate_content", page, "Duplicate main content", {
+		if (contentDuplicate) issues.push(issue$1("duplicate_content", page, "Duplicate main content", {
 			mainContentHash: page.mainContentHash,
 			duplicateCount: contentDuplicate.count,
 			sampleUrls: contentDuplicate.sampleUrls
 		}));
 		const coverage = queryCoverage(page);
-		if (coverage && coverage.coverage < QUERY_COVERAGE_MIN) issues.push(issue("query_coverage_missing", page, coverage.query, {
+		if (coverage && coverage.coverage < QUERY_COVERAGE_MIN) issues.push(issue$1("query_coverage_missing", page, coverage.query, {
 			query: coverage.query,
 			impressions: page.topQuery?.impressions,
 			matchedTerms: coverage.matchedTerms,
@@ -22013,36 +22117,36 @@ function auditCrawlPages(pages, opts = {}) {
 			coverage: coverage.coverage,
 			threshold: QUERY_COVERAGE_MIN
 		}));
-		if ((page.imagesMissingAlt ?? 0) > 0) issues.push(issue("image_missing_alt", page, `${page.imagesMissingAlt} of ${page.imagesTotal ?? 0} images`, {
+		if ((page.imagesMissingAlt ?? 0) > 0) issues.push(issue$1("image_missing_alt", page, `${page.imagesMissingAlt} of ${page.imagesTotal ?? 0} images`, {
 			imagesTotal: page.imagesTotal,
 			imagesMissingAlt: page.imagesMissingAlt
 		}));
-		if (page.oversizedImageCandidates?.length) issues.push(issue("image_oversized_candidate", page, `${page.oversizedImageCandidates.length} image candidate${page.oversizedImageCandidates.length === 1 ? "" : "s"}`, {
+		if (page.oversizedImageCandidates?.length) issues.push(issue$1("image_oversized_candidate", page, `${page.oversizedImageCandidates.length} image candidate${page.oversizedImageCandidates.length === 1 ? "" : "s"}`, {
 			thresholdPx: OVERSIZED_IMAGE_CANDIDATE_LIMIT,
 			candidates: page.oversizedImageCandidates.slice(0, 10)
 		}));
-		if (!page.hasViewport) issues.push(issue("viewport_missing", page));
-		if (!page.lang) issues.push(issue("lang_missing", page));
+		if (!page.hasViewport) issues.push(issue$1("viewport_missing", page));
+		if (!page.lang) issues.push(issue$1("lang_missing", page));
 		const hreflang = page.hreflang ?? [];
 		if (hreflang.length) {
 			const malformed = hreflang.filter((item) => !hasRecognizableHreflangFormat(item.hreflang));
-			if (malformed.length) issues.push(issue("hreflang_invalid", page, `${malformed.length} malformed`, { malformed }));
+			if (malformed.length) issues.push(issue$1("hreflang_invalid", page, `${malformed.length} malformed`, { malformed }));
 			const duplicateCodes = [...new Set(hreflang.map((item) => item.hreflang.trim().toLowerCase()).filter((code, index, values) => values.indexOf(code) !== index))];
-			if (duplicateCodes.length) issues.push(issue("hreflang_duplicate", page, duplicateCodes.join(", "), { duplicateCodes }));
-			if (!hreflang.some((item) => sameUrl(item.href, page.finalUrl))) issues.push(issue("hreflang_incomplete", page, page.lang, {
+			if (duplicateCodes.length) issues.push(issue$1("hreflang_duplicate", page, duplicateCodes.join(", "), { duplicateCodes }));
+			if (!hreflang.some((item) => sameUrl(item.href, page.finalUrl))) issues.push(issue$1("hreflang_incomplete", page, page.lang, {
 				lang: page.lang,
 				finalUrl: page.finalUrl,
 				hreflang
 			}));
 		}
 		const structuredDataFormats = page.structuredDataFormats;
-		if (isAuditableHtmlPage(page) && page.indexable && structuredDataFormats && structuredDataFormats.length === 0 && (page.schemaTypes?.length ?? 0) === 0 && (page.invalidJsonLdCount ?? 0) === 0 && (page.unrecognizedJsonLdTypes?.length ?? 0) === 0) issues.push(issue("structured_data_missing", page, "No structured data detected", {
+		if (isAuditableHtmlPage(page) && page.indexable && structuredDataFormats && structuredDataFormats.length === 0 && (page.schemaTypes?.length ?? 0) === 0 && (page.invalidJsonLdCount ?? 0) === 0 && (page.unrecognizedJsonLdTypes?.length ?? 0) === 0) issues.push(issue$1("structured_data_missing", page, "No structured data detected", {
 			structuredDataFormats,
 			schemaTypes: page.schemaTypes ?? [],
 			invalidJsonLdCount: page.invalidJsonLdCount ?? 0,
 			unrecognizedJsonLdTypeCount: page.unrecognizedJsonLdTypes?.length ?? 0
 		}));
-		if ((page.invalidJsonLdCount ?? 0) > 0) issues.push(issue("jsonld_invalid", page, `${page.invalidJsonLdCount} invalid`, {
+		if ((page.invalidJsonLdCount ?? 0) > 0) issues.push(issue$1("jsonld_invalid", page, `${page.invalidJsonLdCount} invalid`, {
 			invalidJsonLdCount: page.invalidJsonLdCount,
 			invalidJsonLdSamples: page.invalidJsonLdSamples
 		}));
@@ -22052,15 +22156,15 @@ function auditCrawlPages(pages, opts = {}) {
 		if (incompleteRichResultCount) {
 			const details = incompleteRichResults.map((assessment) => `${assessment.schemaType}: ${assessment.missingRequiredProperties.join(", ")}`);
 			const omittedDetails = incompleteRichResultCount - details.length;
-			issues.push(issue("rich_result_required_fields_missing", page, [...details, ...omittedDetails > 0 ? [`${omittedDetails} more incomplete assessment${omittedDetails === 1 ? "" : "s"} omitted from bounded detail`] : []].join("; "), {
+			issues.push(issue$1("rich_result_required_fields_missing", page, [...details, ...omittedDetails > 0 ? [`${omittedDetails} more incomplete assessment${omittedDetails === 1 ? "" : "s"} omitted from bounded detail`] : []].join("; "), {
 				assessments: incompleteRichResults,
 				...page.googleRichResultsSelection ? { selection: page.googleRichResultsSelection } : {}
 			}));
 		}
-		if (!page.openGraphTitle) issues.push(issue("og_title_missing", page));
-		if (!page.openGraphDescription) issues.push(issue("og_description_missing", page));
-		if (!page.openGraphImage) issues.push(issue("og_image_missing", page));
-		if (!page.twitterCard) issues.push(issue("twitter_card_missing", page));
+		if (!page.openGraphTitle) issues.push(issue$1("og_title_missing", page));
+		if (!page.openGraphDescription) issues.push(issue$1("og_description_missing", page));
+		if (!page.openGraphImage) issues.push(issue$1("og_image_missing", page));
+		if (!page.twitterCard) issues.push(issue$1("twitter_card_missing", page));
 	}
 	return issues;
 }
@@ -22150,7 +22254,7 @@ const SEVERITY_SCORE = {
 const EFFORT_BY_CATEGORY = {
 	canonical: "medium",
 	content: "high",
-	geo: "medium",
+	agents: "low",
 	headings: "low",
 	images: "medium",
 	indexability: "medium",
@@ -22717,6 +22821,92 @@ const crawlSiteChecksSchema = z.object({ soft404: z.object({
 	complete: z.boolean()
 }) });
 //#endregion
+//#region packages/core/dist/analyze/crawler/site-crawl-ai-schema.js
+const crawlAiAvailabilitySchema = z.enum([
+	"available",
+	"absent",
+	"access-blocked",
+	"rate-limited",
+	"unreachable"
+]);
+const crawlAiLinkCheckSchema = z.object({
+	url: z.string().url(),
+	status: z.number().int().optional(),
+	contentType: z.string().optional(),
+	error: z.string().optional()
+});
+const crawlAiSignalsSchema = z.object({
+	robotsTxt: z.object({
+		url: z.string().url(),
+		exists: z.boolean(),
+		availability: crawlAiAvailabilitySchema,
+		status: z.number().int().optional(),
+		error: z.string().optional(),
+		sitemapUrls: z.array(z.string().url()),
+		contentSignals: z.array(z.string()).optional(),
+		botAccess: z.array(z.object({
+			userAgent: z.string(),
+			purpose: z.enum([
+				"search",
+				"training",
+				"other"
+			]),
+			allowed: z.boolean().nullable(),
+			declared: z.boolean(),
+			coveredByWildcard: z.boolean()
+		}))
+	}).optional(),
+	llmsTxt: z.object({
+		url: z.string().url(),
+		exists: z.boolean(),
+		availability: crawlAiAvailabilitySchema.optional(),
+		status: z.number().int().optional(),
+		error: z.string().optional(),
+		links: z.object({
+			found: z.number().int().nonnegative(),
+			checked: z.number().int().nonnegative(),
+			limit: z.number().int().positive(),
+			broken: z.array(crawlAiLinkCheckSchema)
+		}).optional()
+	}).optional(),
+	agentResources: z.array(z.object({
+		url: z.string().url(),
+		exists: z.boolean(),
+		status: z.number().int().optional(),
+		contentType: z.string().optional(),
+		validJson: z.boolean().optional()
+	})).optional(),
+	markdownNegotiation: z.object({
+		url: z.string().url(),
+		availability: crawlAiAvailabilitySchema,
+		status: z.number().int().optional(),
+		contentType: z.string().optional(),
+		markdown: z.boolean(),
+		varyAccept: z.boolean(),
+		error: z.string().optional()
+	}).optional(),
+	markdownCopies: z.object({
+		publicPages: z.number().int().nonnegative(),
+		publicPagesWithLink: z.number().int().nonnegative(),
+		privatePagesWithLink: z.number().int().nonnegative(),
+		checked: z.number().int().nonnegative(),
+		limit: z.number().int().positive(),
+		broken: z.array(crawlAiLinkCheckSchema.extend({
+			page: z.string().url(),
+			public: z.boolean()
+		})),
+		largest: z.object({
+			url: z.string().url(),
+			estimatedTokens: z.number().int().nonnegative()
+		}).optional()
+	}).optional(),
+	startPageHeaders: z.object({
+		url: z.string().url(),
+		linkRelations: z.array(z.string()),
+		contentSignal: z.string().optional()
+	}).optional()
+});
+//#endregion
 //#region packages/core/dist/analyze/crawler/schemas.js
 const crawlerRuleSeveritySchema = z.enum([
 	"low",
@@ -22739,7 +22929,7 @@ const crawlerRuleCategorySchema = z.enum([
 	"security",
 	"social",
 	"structured-data",
-	"geo"
+	"agents"
 ]);
 const crawlerRuleIdSchema = z.enum(listRules().map((rule) => rule.id));
 const crawlerRuleInfoSchema = z.object({
@@ -23365,41 +23555,6 @@ const crawlIssueGroupSchema = z.object({
 	count: z.number().int(),
 	sampleUrls: z.array(z.string().url())
 });
-const crawlAiSignalsSchema = z.object({
-	robotsTxt: z.object({
-		url: z.string().url(),
-		exists: z.boolean(),
-		availability: z.enum([
-			"available",
-			"absent",
-			"access-blocked",
-			"rate-limited",
-			"unreachable"
-		]),
-		status: z.number().int().optional(),
-		error: z.string().optional(),
-		sitemapUrls: z.array(z.string().url()),
-		contentSignals: z.array(z.string()).optional(),
-		botAccess: z.array(z.object({
-			userAgent: z.string(),
-			allowed: z.boolean().nullable(),
-			declared: z.boolean(),
-			coveredByWildcard: z.boolean()
-		}))
-	}).optional(),
-	llmsTxt: z.object({
-		url: z.string().url(),
-		exists: z.boolean(),
-		status: z.number().int().optional()
-	}).optional(),
-	agentResources: z.array(z.object({
-		url: z.string().url(),
-		exists: z.boolean(),
-		status: z.number().int().optional(),
-		contentType: z.string().optional(),
-		validJson: z.boolean().optional()
-	})).optional()
-});
 const crawlTopFixSchema = crawlIssueGroupSchema.extend({
 	recommendation: crawlerRuleRecommendationSchema,
 	score: z.number(),
@@ -23696,6 +23851,58 @@ const crawlReportSchema = z.discriminatedUnion("requestEvidenceStatus", [
 ]);
 z.toJSONSchema(crawlReportSchema), z.toJSONSchema(crawlIssueGroupSchema), z.toJSONSchema(crawlTopFixSchema), z.toJSONSchema(crawlerRuleInfoSchema), z.toJSONSchema(crawlRequestObservationSchema), z.toJSONSchema(crawlPageSnapshotSchema);
 //#endregion
+//#region packages/core/dist/analyze/crawler/agent-ready.js
+function needsSignIn(page) {
+	return page.status === 401 || page.status === 403 || Boolean(page.softAuthenticationGate);
+}
+function isPublicPage(page) {
+	return page.status >= 200 && page.status < 300 && !needsSignIn(page) && /\btext\/html\b/i.test(page.contentType ?? "");
+}
+function expectsMarkdown(page) {
+	return isPublicPage(page) && page.indexable;
+}
+function issue(ruleId, url, detail, evidence) {
+	const rule = explainRule(ruleId);
+	if (!rule) throw new Error(`Missing rule guidance for ${ruleId}`);
+	return {
+		ruleId,
+		title: rule.title,
+		category: rule.category,
+		severity: rule.defaultSeverity,
+		url,
+		detail,
+		...evidence ? { evidence } : {}
+	};
+}
+function agentReadyIssues(input) {
+	const { ai, startUrl } = input;
+	const issues = [];
+	const blocked = (ai.robotsTxt?.botAccess ?? []).filter((bot) => bot.purpose === "search" && bot.allowed === false);
+	if (blocked.length && ai.robotsTxt) issues.push(issue("ai_search_bot_blocked", ai.robotsTxt.url, `robots.txt blocks ${blocked.map((bot) => bot.userAgent).join(", ")} from the start URL.`, { blocked: blocked.map((bot) => bot.userAgent) }));
+	if (ai.llmsTxt?.availability === "absent") issues.push(issue("llms_txt_missing", ai.llmsTxt.url, `/llms.txt returned ${ai.llmsTxt.status === void 0 ? "no file" : `HTTP ${ai.llmsTxt.status}`}.`));
+	for (const link of ai.llmsTxt?.links?.broken ?? []) issues.push(issue("llms_txt_broken_link", link.url, link.status === void 0 ? `The link in llms.txt could not be fetched: ${link.error ?? "no response"}.` : `The link in llms.txt returned HTTP ${link.status}.`, {
+		llmsTxt: ai.llmsTxt?.url,
+		...link
+	}));
+	const expected = input.pages.filter(expectsMarkdown);
+	const linked = expected.filter((page) => page.markdownAlternates?.length);
+	const negotiation = ai.markdownNegotiation;
+	if (expected.length && !linked.length && negotiation?.availability === "available" && !negotiation.markdown) issues.push(issue("markdown_missing", startUrl, `Accept: text/markdown returned ${negotiation.contentType || "no content type"}, and none of ${expected.length} public pages links to a Markdown copy.`, { negotiation }));
+	if (linked.length) for (const page of expected) {
+		if (page.markdownAlternates?.length) continue;
+		issues.push(issue("markdown_alternate_missing", page.url, `${linked.length} of ${expected.length} public pages link to a Markdown copy; this one does not.`));
+	}
+	for (const page of input.pages) {
+		if (!needsSignIn(page) || !page.markdownAlternates?.length) continue;
+		issues.push(issue("markdown_alternate_on_private_page", page.url, `The page needs a sign-in but links to a Markdown copy at ${page.markdownAlternates[0]}.`, { markdownAlternates: page.markdownAlternates }));
+	}
+	for (const copy of ai.markdownCopies?.broken ?? []) {
+		if (!copy.public) continue;
+		issues.push(issue("markdown_copy_broken", copy.page, copy.status === void 0 ? `The Markdown copy at ${copy.url} could not be fetched: ${copy.error ?? "no response"}.` : `The Markdown copy at ${copy.url} returned HTTP ${copy.status}${copy.contentType ? ` as ${copy.contentType}` : ""}.`, { ...copy }));
+	}
+	return issues;
+}
+//#endregion
 //#region packages/core/dist/analyze/crawler/crawl-caveats.js
 function crawlCaveats(input) {
 	const caveats = input.cancelled ? ["Crawl cancelled before all queued URLs finished."] : input.pageLimitReached ? [`Stopped after reaching maxPages (${input.maxPages}).`] : [];
@@ -24133,66 +24340,137 @@ async function collectCrawlSiteChecks(input) {
 //#endregion
 //#region packages/core/dist/analyze/crawler/site-crawl-ai-signals.js
 const MAX_AUXILIARY_RESPONSE_BYTES = 2 * 1024 * 1024;
-const AI_BOT_USER_AGENTS = [
-	"GPTBot",
-	"OAI-SearchBot",
-	"ChatGPT-User",
-	"ClaudeBot",
-	"Claude-User",
-	"Claude-SearchBot",
-	"PerplexityBot",
-	"Perplexity-User",
-	"Google-Extended",
-	"CCBot",
-	"Applebot",
-	"Applebot-Extended",
-	"Bingbot",
-	"Amazonbot",
-	"Bytespider",
-	"Meta-ExternalAgent",
-	"Meta-ExternalFetcher",
-	"DuckAssistBot",
-	"MistralAI-User",
-	"Diffbot",
-	"cohere-ai"
+const LLMS_LINK_LIMIT = 20;
+const AI_BOTS = [
+	["OAI-SearchBot", "search"],
+	["ChatGPT-User", "search"],
+	["Claude-SearchBot", "search"],
+	["Claude-User", "search"],
+	["PerplexityBot", "search"],
+	["Perplexity-User", "search"],
+	["DuckAssistBot", "search"],
+	["MistralAI-User", "search"],
+	["Meta-ExternalFetcher", "search"],
+	["Applebot", "search"],
+	["Bingbot", "search"],
+	["GPTBot", "training"],
+	["ClaudeBot", "training"],
+	["Google-Extended", "training"],
+	["Applebot-Extended", "training"],
+	["Meta-ExternalAgent", "training"],
+	["CCBot", "training"],
+	["Bytespider", "training"],
+	["cohere-ai", "training"],
+	["Amazonbot", "other"],
+	["Diffbot", "other"]
 ];
 const AGENT_RESOURCE_PATHS = [
-	"/.well-known/agent.json",
-	"/agent.json",
+	"/.well-known/agent-skills/index.json",
+	"/.well-known/mcp/server-card.json",
 	"/.well-known/mcp.json",
-	"/.well-known/ai-plugin.json",
-	"/.well-known/openapi.json",
-	"/openapi.json"
+	"/.well-known/api-catalog",
+	"/openapi.json",
+	"/.well-known/oauth-protected-resource",
+	"/.well-known/oauth-authorization-server",
+	"/.well-known/http-message-signatures-directory"
 ];
-async function checkLlmsTxt(input) {
-	const llmsUrl = new URL("/llms.txt", input.url).toString();
+function availabilityOf(status) {
+	if (status >= 200 && status < 300) return "available";
+	if (status === 401 || status === 403) return "access-blocked";
+	if (status === 429) return "rate-limited";
+	if (status >= 400 && status < 500) return "absent";
+	return "unreachable";
+}
+function errorText(error) {
+	return error instanceof Error ? error.message : String(error);
+}
+async function get(input, url, headers, readBody = true) {
 	const controller = abortController({
 		timeoutMs: input.timeoutMs,
 		signal: input.signal
 	});
 	try {
-		const response = await input.fetch(llmsUrl, {
+		const response = await input.fetch(url, {
 			profile: "bot",
 			redirect: "follow",
-			signal: controller.signal
+			signal: controller.signal,
+			...headers ? { headers } : {}
 		});
-		const contentType = response.headers.get("content-type") ?? "";
-		const exists = response.status >= 200 && response.status < 300 && !/\btext\/html\b/i.test(contentType);
-		await response.body?.cancel().catch(() => void 0);
+		let text = "";
+		if (readBody) text = await readBoundedResponseText(response, MAX_AUXILIARY_RESPONSE_BYTES, `${new URL(url).pathname} response`);
+		else await response.body?.cancel().catch(() => void 0);
 		return {
-			url: response.url || llmsUrl,
-			exists,
-			status: response.status
+			url: response.url || url,
+			availability: availabilityOf(response.status),
+			status: response.status,
+			contentType: response.headers.get("content-type") ?? "",
+			headers: response.headers,
+			text
 		};
-	} catch {
+	} catch (error) {
 		return {
-			url: llmsUrl,
-			exists: false
+			url,
+			availability: "unreachable",
+			contentType: "",
+			text: "",
+			error: errorText(error)
 		};
 	} finally {
 		controller.cleanup();
 	}
 }
+const isHtml = (contentType) => /\btext\/html\b/i.test(contentType);
+const isMarkdown = (contentType) => /\btext\/(?:x-)?markdown\b/i.test(contentType);
+function brokenLink(result, expectText) {
+	if (result.availability === "available" && !(expectText && isHtml(result.contentType))) return void 0;
+	return {
+		url: result.url,
+		...result.status === void 0 ? {} : { status: result.status },
+		...result.contentType ? { contentType: result.contentType } : {},
+		...result.error ? { error: result.error } : {}
+	};
+}
+function llmsLinks(text, base) {
+	const origin = new URL(base).origin;
+	const links = [];
+	for (const match of text.matchAll(/\]\(\s*<?([^)\s>]+)>?/g)) try {
+		const url = new URL(match[1] ?? "", base);
+		url.hash = "";
+		if (url.origin === origin && !links.includes(url.toString())) links.push(url.toString());
+	} catch {}
+	return links;
+}
+async function checkLlmsTxt(input) {
+	const result = await get(input, new URL("/llms.txt", input.url).toString());
+	const availability = result.availability === "available" && isHtml(result.contentType) ? "absent" : result.availability;
+	const exists = availability === "available";
+	const base = {
+		url: result.url,
+		exists,
+		availability,
+		...result.status === void 0 ? {} : { status: result.status },
+		...result.error ? { error: result.error } : {}
+	};
+	if (!exists) return base;
+	const found = llmsLinks(result.text, result.url);
+	const broken = [];
+	let checked = 0;
+	for (const url of found.slice(0, LLMS_LINK_LIMIT)) {
+		if (input.signal?.aborted) break;
+		checked += 1;
+		const link = brokenLink(await get(input, url, void 0, false), false);
+		if (link) broken.push(link);
+	}
+	return {
+		...base,
+		links: {
+			found: found.length,
+			checked,
+			limit: LLMS_LINK_LIMIT,
+			broken
+		}
+	};
+}
 function parseRobots(robotsUrl, text) {
 	return robotsParserModule(robotsUrl, text);
 }
@@ -24224,118 +24502,135 @@ function sitemapUrlsFromRobots(text) {
 	return [...urls];
 }
 async function checkRobotsAiAccess(input) {
-	const robotsUrl = new URL("/robots.txt", input.url).toString();
-	const controller = abortController({
-		timeoutMs: input.timeoutMs,
-		signal: input.signal
-	});
-	try {
-		const response = await input.fetch(robotsUrl, {
-			profile: "bot",
-			redirect: "follow",
-			signal: controller.signal
-		});
-		const text = await readBoundedResponseText(response, MAX_AUXILIARY_RESPONSE_BYTES, "robots.txt response");
-		const available = response.status >= 200 && response.status < 300;
-		const absent = response.status >= 400 && response.status < 500 && response.status !== 429;
-		const availability = available ? "available" : [401, 403].includes(response.status) ? "access-blocked" : response.status === 429 ? "rate-limited" : absent ? "absent" : "unreachable";
-		const exists = available;
-		const declared = exists ? declaredUserAgents(text) : /* @__PURE__ */ new Set();
-		const parsed = parseRobots(robotsUrl, exists ? text : "");
-		return {
-			url: response.url || robotsUrl,
+	const result = await get(input, new URL("/robots.txt", input.url).toString());
+	const exists = result.availability === "available";
+	const unknown = result.availability === "rate-limited" || result.availability === "unreachable";
+	const declared = exists ? declaredUserAgents(result.text) : /* @__PURE__ */ new Set();
+	const parsed = parseRobots(result.url, exists ? result.text : "");
+	return {
+		robotsTxt: {
+			url: result.url,
 			exists,
-			availability,
-			status: response.status,
-			...["rate-limited", "unreachable"].includes(availability) ? { error: `robots.txt returned HTTP ${response.status}.` } : {},
-			sitemapUrls: exists ? sitemapUrlsFromRobots(text) : [],
-			contentSignals: exists ? contentSignalsFromRobots(text) : [],
-			botAccess: AI_BOT_USER_AGENTS.map((userAgent) => {
-				const lower = userAgent.toLowerCase();
-				return {
-					userAgent,
-					allowed: availability === "rate-limited" || availability === "unreachable" ? null : parsed.isAllowed(input.url, userAgent) ?? true,
-					declared: declared.has(lower),
-					coveredByWildcard: declared.has("*")
-				};
-			})
-		};
-	} catch (error) {
-		return {
-			url: robotsUrl,
-			exists: false,
-			availability: "unreachable",
-			error: error instanceof Error ? error.message : String(error),
-			sitemapUrls: [],
-			botAccess: AI_BOT_USER_AGENTS.map((userAgent) => ({
+			availability: result.availability,
+			...result.status === void 0 ? {} : { status: result.status },
+			...unknown ? { error: result.error ?? `robots.txt returned HTTP ${result.status}.` } : {},
+			sitemapUrls: exists ? sitemapUrlsFromRobots(result.text) : [],
+			...unknown ? {} : { contentSignals: exists ? contentSignalsFromRobots(result.text) : [] },
+			botAccess: AI_BOTS.map(([userAgent, purpose]) => ({
 				userAgent,
-				allowed: null,
-				declared: false,
-				coveredByWildcard: false
+				purpose,
+				allowed: unknown ? null : parsed.isAllowed(input.url, userAgent) ?? true,
+				declared: declared.has(userAgent.toLowerCase()),
+				coveredByWildcard: declared.has("*")
 			}))
-		};
-	} finally {
-		controller.cleanup();
-	}
+		},
+		allows: (url) => unknown ? null : parsed.isAllowed(url, SEO_CRAWLER_USER_AGENT) ?? true
+	};
 }
-async function checkAgentResource(input) {
-	const url = new URL(input.path, input.baseUrl).toString();
-	const controller = abortController({
-		timeoutMs: input.timeoutMs,
-		signal: input.signal
-	});
-	try {
-		const response = await input.fetch(url, {
-			profile: "bot",
-			redirect: "follow",
-			signal: controller.signal
-		});
-		const contentType = response.headers.get("content-type") ?? "";
-		const text = await readBoundedResponseText(response, MAX_AUXILIARY_RESPONSE_BYTES, "Agent resource response");
-		const exists = response.status >= 200 && response.status < 300;
+async function checkAgentResources(input) {
+	const resources = [];
+	for (const path of AGENT_RESOURCE_PATHS) {
+		if (input.signal?.aborted) break;
+		const result = await get(input, new URL(path, input.url).toString());
+		const exists = result.availability === "available" && !isHtml(result.contentType);
 		let validJson;
-		if (exists && /\bjson\b/i.test(contentType)) try {
-			JSON.parse(text);
+		if (exists && /\bjson\b/i.test(result.contentType)) try {
+			JSON.parse(result.text);
 			validJson = true;
 		} catch {
 			validJson = false;
 		}
-		return {
-			url: response.url || url,
+		resources.push({
+			url: result.url,
 			exists,
-			status: response.status,
-			contentType,
+			...result.status === void 0 ? {} : { status: result.status },
+			...result.contentType ? { contentType: result.contentType } : {},
 			...validJson === void 0 ? {} : { validJson }
-		};
-	} catch {
-		return {
-			url,
-			exists: false
-		};
-	} finally {
-		controller.cleanup();
-	}
-}
-async function checkAgentResources(input) {
-	const resources = [];
-	for (const path of AGENT_RESOURCE_PATHS) {
-		if (input.signal?.aborted) break;
-		resources.push(await checkAgentResource({
-			baseUrl: input.url,
-			path,
-			timeoutMs: input.timeoutMs,
-			fetch: input.fetch,
-			signal: input.signal
-		}));
+		});
 	}
 	return resources;
 }
-function collectCrawlAiSignals(input) {
-	return Promise.all([
+async function checkMarkdownNegotiation(input) {
+	const result = await get(input, input.url, { accept: "text/markdown" }, false);
+	const vary = result.headers?.get("vary") ?? "";
+	return {
+		url: result.url,
+		availability: result.availability,
+		...result.status === void 0 ? {} : { status: result.status },
+		...result.contentType ? { contentType: result.contentType } : {},
+		markdown: result.availability === "available" && isMarkdown(result.contentType),
+		varyAccept: vary.split(",").some((value) => value.trim().toLowerCase() === "accept"),
+		...result.error ? { error: result.error } : {}
+	};
+}
+async function collectCrawlAiSignals(input) {
+	const robots = await checkRobotsAiAccess(input);
+	const allows = input.respectRobots ? robots.allows : () => true;
+	const startAllowed = allows(input.url);
+	const [llmsTxt, agentResources, markdownNegotiation] = await Promise.all([
 		checkLlmsTxt(input),
-		checkRobotsAiAccess(input),
-		checkAgentResources(input)
+		checkAgentResources(input),
+		startAllowed ? checkMarkdownNegotiation(input) : Promise.resolve({
+			url: input.url,
+			availability: "unreachable",
+			markdown: false,
+			varyAccept: false,
+			error: startAllowed === null ? "Not requested: robots.txt could not be read." : "Not requested: robots.txt disallows the start URL."
+		})
 	]);
+	return {
+		signals: {
+			llmsTxt,
+			robotsTxt: robots.robotsTxt,
+			agentResources,
+			markdownNegotiation
+		},
+		allows
+	};
+}
+async function checkMarkdownCopies(input) {
+	const linked = input.pages.filter((page) => page.markdownAlternates?.length).sort((a, b) => Number(a.public) - Number(b.public) || a.url.localeCompare(b.url));
+	const broken = [];
+	let largest;
+	let checked = 0;
+	for (const page of linked.slice(0, 20)) {
+		if (input.signal?.aborted) break;
+		const url = page.markdownAlternates?.[0];
+		if (!url || !input.allows(url)) continue;
+		checked += 1;
+		const result = await get({
+			...input,
+			url
+		}, url);
+		const link = brokenLink(result, true);
+		if (link) {
+			broken.push({
+				...link,
+				page: page.url,
+				public: page.public
+			});
+			continue;
+		}
+		const estimatedTokens = Math.ceil(result.text.length / 4);
+		if (!largest || estimatedTokens > largest.estimatedTokens) largest = {
+			url: result.url,
+			estimatedTokens
+		};
+	}
+	return {
+		publicPages: input.pages.filter((page) => page.public).length,
+		publicPagesWithLink: linked.filter((page) => page.public).length,
+		privatePagesWithLink: linked.filter((page) => !page.public).length,
+		checked,
+		limit: 20,
+		broken,
+		...largest ? { largest } : {}
+	};
+}
+function linkRelations(header) {
+	const relations = /* @__PURE__ */ new Set();
+	for (const match of (header ?? "").matchAll(/rel\s*=\s*"?([^";,]+)"?/gi)) for (const value of (match[1] ?? "").trim().toLowerCase().split(/\s+/)) if (value) relations.add(value);
+	return [...relations].sort();
 }
 //#endregion
 //#region packages/core/dist/analyze/crawler/site-crawl-providers.js
@@ -26743,12 +27038,11 @@ async function crawlSite(input, dependencies) {
 			url: config.url,
 			timeoutMs: config.timeoutMs,
 			fetch: deps.fetch,
+			respectRobots: config.respectRobots,
 			signal
 		});
-		const llmsTxt = aiSignals?.[0];
+		const llmsTxt = aiSignals?.signals.llmsTxt;
 		const healthSitemapUrls = healthStrategy && !config.sitemapUrl && !isCancelled() ? await robotsSession?.sitemapUrls(origin) : void 0;
-		const robotsTxt = aiSignals?.[1];
-		const agentResources = aiSignals?.[2];
 		cancelled = isCancelled();
 		const enqueue = (value, depth) => {
 			const normalized = normalizeUrl$1(value, config.url);
@@ -26826,7 +27120,7 @@ async function crawlSite(input, dependencies) {
 				url: config.url,
 				sitemapUrl: config.sitemapUrl,
 				maxPages: config.maxPages,
-				declaredSitemapUrls: robotsTxt?.sitemapUrls ?? healthSitemapUrls ?? [],
+				declaredSitemapUrls: aiSignals?.signals.robotsTxt?.sitemapUrls ?? healthSitemapUrls ?? [],
 				warnings,
 				fetchSitemapUrls: deps.fetchSitemapUrls
 			});
@@ -27142,6 +27436,26 @@ async function crawlSite(input, dependencies) {
 				llmsTxtStatus: llmsTxt.status
 			};
 		}
+		const startPage = pages.find((page) => page.url === config.url || page.finalUrl === config.url);
+		const ai = aiSignals && !cancelled ? {
+			...aiSignals.signals,
+			markdownCopies: await checkMarkdownCopies({
+				allows: aiSignals.allows,
+				pages: pages.map((page) => ({
+					url: page.url,
+					markdownAlternates: page.markdownAlternates,
+					public: isPublicPage(page)
+				})),
+				timeoutMs: config.timeoutMs,
+				fetch: deps.fetch,
+				signal
+			}),
+			...startPage ? { startPageHeaders: {
+				url: startPage.url,
+				linkRelations: linkRelations(startPage.responseHeaders?.link),
+				...startPage.responseHeaders?.["content-signal"] ? { contentSignal: startPage.responseHeaders["content-signal"] } : {}
+			} } : {}
+		} : aiSignals?.signals;
 		const report = createCrawlReport({
 			config,
 			site,
@@ -27151,17 +27465,15 @@ async function crawlSite(input, dependencies) {
 			pages,
 			requests,
 			requestEvidenceStatus,
-			...!healthStrategy ? { ai: {
-				...llmsTxt ? { llmsTxt } : {},
-				...robotsTxt ? { robotsTxt } : {},
-				...agentResources ? { agentResources } : {}
-			} } : {},
+			...ai ? { ai } : {},
 			...sitemapDiscovery ? { sitemapDiscovery } : {},
 			...externalLinkVerification ? { externalLinkVerification } : {},
-			...siteCheckResult ? {
-				siteChecks: siteCheckResult.checks,
-				additionalIssues: siteCheckResult.issues
-			} : {},
+			...siteCheckResult ? { siteChecks: siteCheckResult.checks } : {},
+			additionalIssues: [...siteCheckResult?.issues ?? [], ...ai ? agentReadyIssues({
+				startUrl: config.url,
+				ai,
+				pages
+			}) : []],
 			status: reportStatus,
 			warnings,
 			caveats: crawlCaveats({
@@ -31571,9 +31883,9 @@ function strikingDistance(input, dependencies = defaultDependencies$5) {
 //#region packages/core/dist/updates/search-status.js
 const INCIDENTS_URL = "https://status.search.google.com/incidents.json";
 async function fetchSearchStatusIncidents() {
-	const response = await fetch$1(INCIDENTS_URL);
+	const response = await fetch$1(INCIDENTS_URL, { signal: AbortSignal.timeout(8e3) });
 	if (!response.ok) throw new SeoError("OPTIONAL_PROVIDER_UNAVAILABLE", `Google Search Status fetch failed with ${response.status}.`);
-	return await response.json();
+	return readJson(response, "Google Search Status", { maxBytes: 10 * 1024 * 1024 });
 }
 async function listSearchUpdates(input = {}) {
 	return searchUpdatesFromIncidents(await fetchSearchStatusIncidents(), input);
@@ -34856,7 +35168,7 @@ async function fetchCruxFieldData(input) {
 					headers: { "content-type": "application/json" },
 					signal: controller.signal
 				});
-				const json = await response.json().catch(() => ({}));
+				const json = await readJson(response, "CrUX").catch(() => ({}));
 				if (response.status === 404) return {
 					response,
 					json
@@ -37585,6 +37897,340 @@ async function runAnalyticsRows(input, google, options) {
 	};
 }
 //#endregion
+//#region packages/core/dist/ga4/matching.js
+function hostnameFromUrl(value) {
+	try {
+		const url = new URL(value);
+		if (url.protocol !== "http:" && url.protocol !== "https:") return void 0;
+		return url.hostname.toLowerCase().replace(/\.$/, "") || void 0;
+	} catch {
+		return;
+	}
+}
+function domainFromProperty(value) {
+	if (!value.startsWith("sc-domain:")) return void 0;
+	const domain = value.slice(10).trim().toLowerCase();
+	if (!domain || /[/:]/.test(domain)) return void 0;
+	return domain.replace(/\.$/, "") || void 0;
+}
+function matchForSite(site, streamHostname) {
+	const domain = domainFromProperty(site);
+	if (domain) return streamHostname === domain || streamHostname.endsWith(`.${domain}`) ? "domain" : void 0;
+	return hostnameFromUrl(site) === streamHostname ? "hostname" : void 0;
+}
+function matchGa4WebStreams(site, candidates) {
+	return candidates.flatMap((candidate) => {
+		const defaultUri = candidate.stream.webStreamData?.defaultUri;
+		if (!defaultUri) return [];
+		const hostname = hostnameFromUrl(defaultUri);
+		if (!hostname) return [];
+		const match = matchForSite(site, hostname);
+		if (!match) return [];
+		return [{
+			...candidate,
+			defaultUri,
+			hostname,
+			match
+		}];
+	});
+}
+//#endregion
+//#region packages/core/dist/commands/analytics-site.js
+const STREAM_CHECKS = 30;
+const AT_ONCE = 5;
+const TIED = 3;
+const hostOf$1 = (site) => {
+	const value = site.replace(/^sc-domain:/, "");
+	try {
+		return new URL(value.includes("://") ? value : `https://${value}`).hostname;
+	} catch {
+		return value;
+	}
+};
+const plain = (value) => value.toLowerCase().replace(/[^a-z0-9]/g, "");
+function ranked(site, candidates) {
+	const host = hostOf$1(site).replace(/^www\./, "");
+	const words = [plain(host), plain(host.split(".")[0] ?? "")].filter((word) => word.length >= 3);
+	const named = (candidate) => words.some((word) => plain(candidate.propertyName).includes(word)) ? 0 : 1;
+	return [...candidates].sort((a, b) => named(a) - named(b) || a.property.localeCompare(b.property, "en", { numeric: true }));
+}
+function best(site, matches) {
+	const host = hostOf$1(site).replace(/^www\./, "");
+	const score = (match) => match.hostname === host || match.hostname === `www.${host}` ? 0 : 1;
+	return [...matches].sort((a, b) => score(a) - score(b) || a.hostname.length - b.hostname.length || a.property.localeCompare(b.property, "en", { numeric: true }));
+}
+async function findProperty(access, site) {
+	const accounts = await access.accounts();
+	const listed = await Promise.all(accounts.map((account) => listAnalyticsAccounts(account.google, { signIn: access.signIn }).then((summaries) => ({
+		account,
+		summaries
+	}), (error) => error instanceof Error ? error : new Error(String(error)))));
+	const seen = /* @__PURE__ */ new Set();
+	const candidates = [];
+	for (const entry of listed) {
+		if (entry instanceof Error) continue;
+		for (const summary of entry.summaries) for (const item of summary.propertySummaries) {
+			const property = item.property.replace(/^properties\//, "");
+			if (seen.has(property) || !/^\d+$/.test(property)) continue;
+			seen.add(property);
+			candidates.push({
+				account: summary.account,
+				property,
+				propertyName: item.displayName ?? property,
+				google: entry.account.google
+			});
+		}
+	}
+	if (!candidates.length) {
+		const failed = listed.find((entry) => entry instanceof Error);
+		return failed ? `could not be read. ${failed.message}` : "the connected Google accounts cannot read any property.";
+	}
+	const order = ranked(site, candidates).slice(0, STREAM_CHECKS);
+	let failures = 0;
+	for (let start = 0; start < order.length; start += AT_ONCE) {
+		const batch = order.slice(start, start + AT_ONCE);
+		const streams = await Promise.all(batch.map((candidate) => listAnalyticsDataStreams(candidate.google, candidate.property, { signIn: access.signIn }).catch(() => {
+			failures += 1;
+			return [];
+		})));
+		const matches = best(site, batch.flatMap((candidate, index) => matchGa4WebStreams(site, (streams[index] ?? []).map((stream) => ({
+			...candidate,
+			stream
+		})))));
+		const found = /* @__PURE__ */ new Map();
+		for (const match of matches) {
+			const candidate = batch.find((item) => item.property === match.property);
+			if (!candidate || found.has(match.property)) continue;
+			found.set(match.property, {
+				property: match.property,
+				name: match.propertyName,
+				stream: match.defaultUri,
+				google: candidate.google
+			});
+		}
+		if (found.size) return [...found.values()].slice(0, TIED);
+	}
+	return `no web stream matches ${site} in ${order.length < candidates.length ? `the first ${order.length} of ${candidates.length} properties, named like the site first` : `${candidates.length} ${candidates.length === 1 ? "property" : "properties"}`}${failures ? ` (${failures} could not be read)` : ""}.`;
+}
+const AI_SOURCES = [
+	"chatgpt.com",
+	"chatgpt",
+	"chat.openai.com",
+	"perplexity.ai",
+	"perplexity",
+	"claude.ai",
+	"gemini.google.com",
+	"copilot.microsoft.com",
+	"copilot.com",
+	"chat.deepseek.com",
+	"meta.ai",
+	"grok.com",
+	"chat.mistral.ai",
+	"you.com",
+	"phind.com",
+	"poe.com"
+];
+const AI_SOURCE_PATTERN = `(www\\.)?(${AI_SOURCES.map((source) => source.replaceAll(".", "\\.")).join("|")})`;
+const AI_ROWS = 5;
+const filter = (fieldName, value, matchType = "EXACT") => ({ filter: {
+	fieldName,
+	stringFilter: {
+		matchType,
+		value
+	}
+} });
+async function totals$1(found, access, range, before, pages) {
+	const read = (dimensions, filters) => runAnalyticsReport(found.google, found.property, {
+		dateRanges: [{
+			...range,
+			name: "now"
+		}, {
+			...before,
+			name: "before"
+		}],
+		dimensions: dimensions.map((name) => ({ name })),
+		metrics: [{ name: "sessions" }, { name: "keyEvents" }],
+		...filters.length ? { dimensionFilter: { andGroup: { expressions: filters } } } : {},
+		limit: 100
+	}, { 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([
+		read(["sessionDefaultChannelGroup"], onPages),
+		read([], [
+			...onPages,
+			filter("sessionDefaultChannelGroup", "Organic Search"),
+			filter("sessionSource", "google")
+		]),
+		read(["sessionSource"], fromAi),
+		read(["landingPage"], fromAi)
+	]);
+	const sum = () => ({
+		google: {
+			sessions: 0,
+			keyEvents: 0
+		},
+		organic: {
+			sessions: 0,
+			keyEvents: 0
+		},
+		all: {
+			sessions: 0,
+			keyEvents: 0
+		}
+	});
+	const periods = {
+		now: sum(),
+		before: sum()
+	};
+	const each = (data, add) => {
+		const periodAt = (data.dimensionHeaders?.map((header) => header.name) ?? []).indexOf("dateRange");
+		for (const row of data.rows ?? []) {
+			const values = row.dimensionValues ?? [];
+			add((periodAt >= 0 ? values[periodAt] : values.at(-1))?.value === "before" ? periods.before : periods.now, values[0]?.value ?? "", {
+				sessions: Number(row.metricValues?.[0]?.value ?? 0),
+				keyEvents: Number(row.metricValues?.[1]?.value ?? 0)
+			});
+		}
+	};
+	const plus = (into, row) => {
+		into.sessions += row.sessions;
+		into.keyEvents += row.keyEvents;
+	};
+	each(channels, (period, channel, row) => {
+		plus(period.all, row);
+		if (channel === "Organic Search") plus(period.organic, row);
+	});
+	each(google, (period, _, row) => plus(period.google, row));
+	const byName = (data, key) => {
+		const rows = /* @__PURE__ */ new Map();
+		const periodAt = (data.dimensionHeaders?.map((header) => header.name) ?? []).indexOf("dateRange");
+		for (const row of data.rows ?? []) {
+			const values = row.dimensionValues ?? [];
+			const name = values[0]?.value ?? "";
+			const before = (periodAt >= 0 ? values[periodAt] : values.at(-1))?.value === "before";
+			const entry = rows.get(name) ?? {
+				now: 0,
+				before: 0,
+				keyEvents: 0
+			};
+			const sessions = Number(row.metricValues?.[0]?.value ?? 0);
+			if (before) entry.before += sessions;
+			else {
+				entry.now += sessions;
+				entry.keyEvents += Number(row.metricValues?.[1]?.value ?? 0);
+			}
+			rows.set(name, entry);
+		}
+		return [...rows].map(([name, entry]) => ({
+			[key]: name,
+			sessions: entry.now,
+			previousSessions: entry.before,
+			keyEvents: entry.keyEvents
+		})).sort((a, b) => b.sessions - a.sessions || b.previousSessions - a.previousSessions || String(a[key]).localeCompare(String(b[key])));
+	};
+	const bySource = byName(aiSources, "source");
+	const aiNow = bySource.reduce((total, row) => total + row.sessions, 0);
+	const aiBefore = bySource.reduce((total, row) => total + row.previousSessions, 0);
+	const data = { metadata: {
+		timeZone: channels.metadata?.timeZone,
+		subjectToThresholding: [
+			channels,
+			google,
+			aiSources,
+			aiPages
+		].some((data) => data.metadata?.subjectToThresholding),
+		dataLossFromOtherRow: [
+			channels,
+			google,
+			aiSources,
+			aiPages
+		].some((data) => data.metadata?.dataLossFromOtherRow)
+	} };
+	const notes = [];
+	if (data.metadata?.timeZone && data.metadata.timeZone !== "America/Los_Angeles") notes.push(`Google Analytics days use the property's time zone, ${data.metadata.timeZone}; Search Console days use Pacific time.`);
+	if (data.metadata?.subjectToThresholding) notes.push("Google Analytics applied thresholding; small rows can be hidden.");
+	if (data.metadata?.dataLossFromOtherRow) notes.push("Google Analytics grouped some rows into (other).");
+	return {
+		property: found.property,
+		propertyName: found.name,
+		webStream: found.stream,
+		...pages ? { landingPageContains: pages } : {},
+		organicSearchFromGoogle: {
+			sessions: periods.now.google.sessions,
+			previousSessions: periods.before.google.sessions,
+			sessionsChangePct: pct(periods.now.google.sessions, periods.before.google.sessions)
+		},
+		organicSearch: {
+			sessions: periods.now.organic.sessions,
+			previousSessions: periods.before.organic.sessions,
+			sessionsChangePct: pct(periods.now.organic.sessions, periods.before.organic.sessions),
+			keyEvents: periods.now.organic.keyEvents,
+			previousKeyEvents: periods.before.organic.keyEvents
+		},
+		allChannels: {
+			sessions: periods.now.all.sessions,
+			previousSessions: periods.before.all.sessions,
+			sessionsChangePct: pct(periods.now.all.sessions, periods.before.all.sessions)
+		},
+		aiAssistants: {
+			sessions: aiNow,
+			previousSessions: aiBefore,
+			sessionsChangePct: pct(aiNow, aiBefore),
+			bySource,
+			topLandingPages: byName(aiPages, "page").slice(0, 20),
+			sources: AI_SOURCES
+		},
+		notes
+	};
+}
+const change$1 = (value) => value === null ? "n/a" : `${value > 0 ? "+" : ""}${value}%`;
+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.";
+	return [
+		`Visits from AI assistants (ChatGPT, Perplexity, Claude, Gemini, Copilot and others): ${ai.sessions} sessions (was ${ai.previousSessions}, ${change$1(ai.sessionsChangePct)}). By source: ${list(ai.bySource, "source")}.`,
+		ai.topLandingPages.length ? `Top landing pages from AI assistants: ${list(ai.topLandingPages, "page")}.` : "",
+		"Only visits that pass a referrer or utm_source count; AI apps that send none show as Direct."
+	].filter(Boolean).join(" ");
+}
+async function analyticsBeside(access, site, range, before, pages) {
+	if (!access) return null;
+	try {
+		const found = await findProperty(access, site);
+		if (typeof found === "string") return {
+			text: `Google Analytics: ${found}`,
+			data: { error: found }
+		};
+		const read = await Promise.all(found.map((item) => totals$1(item, access, range, before, pages).catch((error) => error instanceof Error ? error : new Error(String(error)))));
+		const data = [...read.filter((item) => !(item instanceof Error))].sort((a, b) => b.allChannels.sessions - a.allChannels.sessions)[0];
+		if (!data) throw read[0];
+		const others = found.filter((item) => item.property !== data.property).map((item) => `${item.name} (${item.property})`);
+		const google = data.organicSearchFromGoogle;
+		const organic = data.organicSearch;
+		const all = data.allChannels;
+		const keyEvents = organic.keyEvents || organic.previousKeyEvents ? `, Organic Search key events ${organic.keyEvents} (was ${organic.previousKeyEvents})` : "";
+		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)}).`,
+				"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)),
+			data: {
+				...data,
+				...others.length ? { otherMatches: others } : {}
+			}
+		};
+	} catch (error) {
+		const message = error instanceof Error ? error.message : String(error);
+		return {
+			text: `Google Analytics: could not be read. ${message}`,
+			data: { error: message }
+		};
+	}
+}
+//#endregion
 //#region packages/core/dist/commands/bing.js
 const BING_LIMITS = ["Bing and Google count clicks, impressions and positions their own way. Their numbers sit side by side here and are never added together.", "Bing lists only its top queries and pages, grouped by week. A query or page missing from Bing’s list is unknown, not zero."];
 const CLI_LINK = "If you have a shell, link the CLI to the same account once: run `npx -y seo login`, show the person the link it prints, and after they approve it run `npx -y seo login` again. `npx -y seo` commands then use the same Google accounts, Bing and keys.";
@@ -37987,7 +38633,7 @@ async function lookup(domain, key) {
 		signal: AbortSignal.timeout(5e3)
 	});
 	if (!response.ok) return null;
-	const body = await response.clone().json();
+	const body = await readJson(response.clone(), "Ahrefs Domain Rating");
 	if (cache && !cached) {
 		const copy = new Response(response.body, response);
 		copy.headers.set("cache-control", `max-age=${TTL_SECONDS}`);
@@ -38146,7 +38792,7 @@ function temporaryRedirectNote(pages) {
 //#endregion
 //#region packages/core/dist/commands/report.js
 const SECTIONS = {
-	overview: "Site totals (clicks, impressions, CTR, position) against the previous period, by device, with the top pages and queries and their change.",
+	overview: "Site totals (clicks, impressions, CTR, position) against the previous period, by device, with the top pages and queries and their change, and Google Analytics sessions for the same dates from the property whose web stream matches the site.",
 	"quick-wins": "Query and page pairs at average positions 4 to 10 with a click-through rate below the site’s own curve for that position.",
 	"low-ctr": "Query and page pairs at average positions 1 to 4 with a click-through rate below the site’s own curve: titles and snippets to review with the person.",
 	"striking-distance": "Queries just outside the top positions, with impressions, for pages that already rank.",
@@ -38453,10 +39099,14 @@ async function allSections(input, deps) {
 	const origin = originOf(input.site);
 	const bing = once(() => bingFor(deps, input.site));
 	const ids = SECTION_IDS.filter((id) => id !== "bing" || deps.bing);
+	const range = dateWindow(input, DEFAULT_DAYS.overview);
+	const analytics = analyticsBeside(deps.analytics, input.site, range, earlierRange(range));
 	const [overview, ...rest] = await Promise.all(ids.map((id) => build(read, input.site, id, dateWindow(input, DEFAULT_DAYS[id]), now, bing).catch((error) => error instanceof Error ? error : new Error(String(error)))));
 	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 ga = await analytics;
+	if (ga) parts.push(ga.text);
 	const brand = rest.find((run) => !(run instanceof Error) && brandNote(run) !== null);
 	if (brand) parts.push(brandNote(brand));
 	const sections = {};
@@ -38486,6 +39136,7 @@ async function allSections(input, deps) {
 		data: {
 			site: input.site,
 			overview,
+			...ga ? { analytics: ga.data } : {},
 			sections
 		}
 	};
@@ -38499,14 +39150,25 @@ async function oneSection(input, deps) {
 	const bing = once(() => bingFor(deps, site));
 	let report = await build(sharedReader(deps.searchAnalytics), site, section, range, now, bing);
 	const next = nextFor(section, deps.call);
-	if (section === "overview" && detail !== "full") return {
-		text: `${overviewText(report, `overview of ${site}`, origin, 10)}\n\n${deps.bing ? await enginesLine(report, bing) : NO_BING_HERE}\n\nMore: ${deps.call("report", {
-			site,
-			section,
-			detail: "full"
-		})} for every row.\n\n${next}\n\n${FACTS_ONLY}`,
-		data: report
-	};
+	if (section === "overview") {
+		const ga = await analyticsBeside(deps.analytics, site, range, earlierRange(range));
+		if (ga) report.analytics = ga.data;
+		if (detail !== "full") return {
+			text: [
+				overviewText(report, `overview of ${site}`, origin, 10),
+				deps.bing ? await enginesLine(report, bing) : NO_BING_HERE,
+				ga?.text,
+				`More: ${deps.call("report", {
+					site,
+					section,
+					detail: "full"
+				})} for every row.`,
+				next,
+				FACTS_ONLY
+			].filter(Boolean).join("\n\n"),
+			data: report
+		};
+	}
 	let checked = [];
 	const merged = [];
 	if (PAGE_CHECKS.has(section)) {
@@ -38614,7 +39276,7 @@ async function dataForSeo([login, password], input) {
 		language_code: language ?? mainLanguage(input.country)
 	};
 	const post = async (path, task) => {
-		const result = (await (await call("dataforseo", new Request(`https://api.dataforseo.com/${path}`, {
+		const result = (await readJson(await call("dataforseo", new Request(`https://api.dataforseo.com/${path}`, {
 			method: "POST",
 			headers: {
 				authorization: `Basic ${btoa(`${login}:${password}`)}`,
@@ -38624,7 +39286,7 @@ async function dataForSeo([login, password], input) {
 				...market,
 				...task
 			}])
-		}))).json()).tasks?.[0];
+		})), "DataForSEO")).tasks?.[0];
 		if (!result || result.status_code >= 4e4) throw new CommandError("PROVIDER_ERROR", `dataforseo: ${result?.status_message ?? "no task result"}`);
 		return result.result?.[0]?.items ?? [];
 	};
@@ -38705,10 +39367,10 @@ async function ahrefs(key, input) {
 	const get = async (path, params) => {
 		const url = new URL(`https://api.ahrefs.com/v3/${path}`);
 		for (const [name, value] of Object.entries(params)) url.searchParams.set(name, value);
-		return await (await call("ahrefs", new Request(url, { headers: {
+		return readJson(await call("ahrefs", new Request(url, { headers: {
 			authorization: `Bearer ${key}`,
 			accept: "application/json"
-		} }))).json();
+		} })), "Ahrefs");
 	};
 	const today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
 	if (input.action === "keyword_metrics") return ((await get("keywords-explorer/overview", {
@@ -38996,19 +39658,25 @@ async function runCompare(input, deps) {
 		startDate: shiftIsoDate(input.date, -days),
 		endDate: shiftIsoDate(input.date, -1)
 	};
-	const [report, updates] = await Promise.all([siteOverview(sharedReader(deps.searchAnalytics), input.site, after, before, input.pages), googleUpdates({
-		start: before.startDate,
-		end: after.endDate
-	})]);
+	const [report, updates, analytics] = await Promise.all([
+		siteOverview(sharedReader(deps.searchAnalytics), input.site, after, before, input.pages),
+		googleUpdates({
+			start: before.startDate,
+			end: after.endDate
+		}),
+		analyticsBeside(deps.analytics, input.site, after, before, input.pages)
+	]);
 	return {
 		text: [
 			overviewText(report, `Compare on ${input.site}: ${days} days after ${input.date}`, originOf(input.site), 10),
+			analytics?.text,
 			listOfUpdates(updates),
 			`Next: ${deps.call("page")} for a page that moved.`,
 			FACTS_ONLY
 		].filter(Boolean).join("\n\n"),
 		data: {
 			...report,
+			...analytics ? { analytics: analytics.data } : {},
 			googleUpdates: updates
 		}
 	};
@@ -39225,7 +39893,7 @@ const SHARED_TOOLS = [
 		name: "seo_compare",
 		command: "compare",
 		title: "Before and after a date",
-		description: "Compares equal periods before and after a date, such as a site change or a Google update: totals, devices, and the pages and queries that moved, with Google updates in the window. Optional pages narrows it to URLs that contain that text, such as /blog/.",
+		description: "Compares equal periods before and after a date, such as a site change or a Google update: totals, devices, and the pages and queries that moved, Google Analytics sessions from the property whose web stream matches the site, and Google updates in the window. Optional pages narrows it to URLs that contain that text, such as /blog/.",
 		input: z.object({
 			site,
 			date: z.string().regex(/^\d{4}-\d{2}-\d{2}$/).describe("YYYY-MM-DD: the first day after the change."),
@@ -39342,8 +40010,7 @@ async function runSharedTool(tool, surface, input) {
 const MCP_INSTRUCTIONS = `SEO Skill reads the person's own Search Console, Google Analytics, Bing Webmaster Tools, Clicky and optional keyword accounts, and returns facts with their dates and limits. It gives no advice.
 1. seo_sites: the properties the connected accounts can read.
 2. seo_report: the main report. Run it without a section first; it shows the overview and every section's count and top rows. Then ask for the one section you need.
-3. seo_page for one URL, seo_compare for before and after a date, seo_index for pages that lost their clicks, seo_research for keyword, competitor and backlink data from the DataForSEO or Ahrefs key the person saved, seo_data for raw rows, including Google Analytics, Bing and Clicky.
-Show the person the facts that matter, for example in a table or a small dashboard, and decide with them what to change. Do not edit pages without their approval.`;
+3. seo_page for one URL, seo_compare for before and after a date, seo_index for pages that lost their clicks, seo_research for keyword, competitor and backlink data from the DataForSEO or Ahrefs key the person saved, seo_data for raw rows, including Google Analytics, Bing and Clicky.`;
 const mcpCall = (command, args) => {
 	const name = `seo_${command.replace("-", "_")}`;
 	const shown = Object.entries(args ?? {}).filter(([, value]) => value !== void 0);
@@ -39353,7 +40020,7 @@ const SKILL_RESOURCE = {
 	name: "seo-skill",
 	uri: "skill://seo/SKILL.md",
 	title: "SEO Skill",
-	description: "How to use these tools: the commands, the one-report flow and the evidence rules.",
+	description: "How to use these tools: what each command returns and how to reach it.",
 	mimeType: "text/markdown"
 };
 //#endregion
@@ -39550,7 +40217,11 @@ function nodeCommandDeps(options) {
 		pageMarkdown: async (url) => extractMainMarkdown(await fetchPage(url, { refresh: options.refresh })),
 		call: options.call,
 		bing: localBing,
-		bingConnect: LOCAL_BING_CONNECT
+		bingConnect: LOCAL_BING_CONNECT,
+		analytics: {
+			accounts: localAccounts,
+			signIn: LOCAL_SIGN_IN.signIn
+		}
 	};
 }
 const LOCAL_BING_CONNECT = "Connect Bing on your seoskill.dev account and run `seo login`, or run `seo providers bing connect` with an API key from Bing Webmaster Tools (Settings, API access).";