seo 0.5.0 → 0.6.0

package/dist/mcp.js

@@ -1,5 +1,5 @@
 import { createRequire as __seoCreateRequire } from 'node:module'; const require = __seoCreateRequire(import.meta.url);
-import { i as __toESM, n as load, r as __commonJSMin, t as version } from "./package-CsRkLZGn.js";
+import { i as __toESM, n as load, r as __commonJSMin, t as version } from "./package-CwLtPH6B.js";
 import { createHash, randomUUID, sign } from "node:crypto";
 import { ZodOptional, z } from "zod";
 import { arch, homedir, platform, totalmem } from "node:os";
@@ -13774,7 +13774,7 @@ async function runAnalyticsReport(gfetch, propertyId, body, options) {
 //#endregion
 //#region packages/core/dist/bing/api.js
 const BASE = "https://ssl.bing.com/webmaster/api.svc/json";
-const MAX_BYTES$1 = 8e6;
+const MAX_BYTES$2 = 8e6;
 function bingCall(auth, options) {
 	return async (method, params = {}) => {
 		const url = new URL(`${BASE}/${method}`);
@@ -13799,7 +13799,7 @@ function bingCall(auth, options) {
 			if (response.status === 429 || /throttle/i.test(detail)) throw new SeoError("RATE_LIMITED", "Bing Webmaster is limiting requests. Try again in a few minutes.");
 			throw new SeoError("OPTIONAL_PROVIDER_UNAVAILABLE", `Bing Webmaster answered ${response.status}. ${detail}`.trim());
 		}
-		return (await readJson(response, "Bing Webmaster", { maxBytes: MAX_BYTES$1 })).d;
+		return (await readJson(response, "Bing Webmaster", { maxBytes: MAX_BYTES$2 })).d;
 	};
 }
 function day(value) {
@@ -13808,7 +13808,7 @@ function day(value) {
 	const date = legacy ? new Date(Number(legacy[1])) : new Date(value);
 	return Number.isNaN(date.getTime()) ? null : date.toISOString().slice(0, 10);
 }
-const count = (value) => typeof value === "number" && Number.isFinite(value) && value >= 0 ? value : null;
+const count$1 = (value) => typeof value === "number" && Number.isFinite(value) && value >= 0 ? value : null;
 function list(data, label) {
 	if (!Array.isArray(data)) throw new SeoError("OPTIONAL_PROVIDER_UNAVAILABLE", `Bing Webmaster returned an invalid ${label}.`);
 	return data.filter((item) => Boolean(item) && typeof item === "object");
@@ -13824,8 +13824,8 @@ async function bingTraffic(call, site) {
 	let invalidRows = 0;
 	for (const row of list(await call("GetRankAndTrafficStats", { siteUrl: site }), "traffic list")) {
 		const date = day(row.Date);
-		const clicks = count(row.Clicks);
-		const impressions = count(row.Impressions);
+		const clicks = count$1(row.Clicks);
+		const impressions = count$1(row.Impressions);
 		if (!date || clicks === null || impressions === null) {
 			invalidRows += 1;
 			continue;
@@ -13848,9 +13848,9 @@ async function keyed(call, method, params) {
 	for (const row of list(await call(method, params), "row list")) {
 		const date = day(row.Date);
 		const key = typeof row.Query === "string" ? row.Query.trim() : "";
-		const clicks = count(row.Clicks);
-		const impressions = count(row.Impressions);
-		const position = count(row.AvgImpressionPosition);
+		const clicks = count$1(row.Clicks);
+		const impressions = count$1(row.Impressions);
+		const position = count$1(row.AvgImpressionPosition);
 		if (!date || !key || clicks === null || impressions === null) {
 			invalidRows += 1;
 			continue;
@@ -14430,7 +14430,7 @@ async function readableSites(google, signIn) {
 		permissionLevel: entry.permissionLevel ?? ""
 	})).sort((a, b) => a.siteUrl.localeCompare(b.siteUrl));
 }
-const hostOf = (value) => {
+const hostOf$1 = (value) => {
 	try {
 		return new URL(value.includes("://") ? value : `https://${value.replace(/^sc-domain:/, "")}`).hostname.replace(/^www\./, "");
 	} catch {
@@ -14448,14 +14448,14 @@ async function runSites(input) {
 		};
 	})), input.bing ? listBingSites(input.bing).catch((error) => error instanceof Error ? error : new Error(String(error))) : Promise.resolve(null)]);
 	const bingSites = Array.isArray(bing) ? bing.filter((site) => site.verified) : [];
-	const bingByHost = new Map(bingSites.map((site) => [hostOf(site.url), site]));
+	const bingByHost = new Map(bingSites.map((site) => [hostOf$1(site.url), site]));
 	const properties = google.flatMap((account) => account.properties instanceof Error ? [] : account.properties.map((property) => ({
 		...property,
 		...named ? { account: account.email ?? "" } : {},
-		...Array.isArray(bing) ? { bing: bingByHost.get(hostOf(property.siteUrl))?.url ?? "" } : {}
+		...Array.isArray(bing) ? { bing: bingByHost.get(hostOf$1(property.siteUrl))?.url ?? "" } : {}
 	})));
-	const googleHosts = new Set(properties.map((property) => hostOf(property.siteUrl)));
-	const bingOnly = bingSites.filter((site) => !googleHosts.has(hostOf(site.url)));
+	const googleHosts = new Set(properties.map((property) => hostOf$1(property.siteUrl)));
+	const bingOnly = bingSites.filter((site) => !googleHosts.has(hostOf$1(site.url)));
 	const failed = google.filter((account) => account.properties instanceof Error);
 	const analytics = google.flatMap((account) => (account.analytics ?? []).flatMap((summary) => summary.propertySummaries.map((property) => ({
 		property: property.property.replace("properties/", ""),
@@ -14484,6 +14484,7 @@ async function runSites(input) {
 			], null)}` : "Google Analytics: no properties readable with these sign-ins.",
 			input.bing === void 0 ? null : bing === null ? "Bing Webmaster: not connected." : bing instanceof Error ? `Bing Webmaster: could not list sites. ${bing.message}` : bingOnly.length ? `Bing Webmaster sites with no Search Console property here (${bingOnly.length}): ${bingOnly.map((site) => site.url).join(", ")}.` : `Bing Webmaster: ${bingSites.length} verified sites; the bing column shows each one.`,
 			`Research keys: ${research.length ? research.join(", ") : "none"}.`,
+			input.clicky?.length ? `Clicky sites (seo_data with source "clicky"): ${input.clicky.join(", ")}.` : null,
 			`Add a Google account${input.bing === void 0 ? "" : ", Bing"} or a key: ${input.connect}`,
 			"Next: seo_report with a site."
 		].filter(Boolean).join("\n\n"),
@@ -14491,7 +14492,8 @@ async function runSites(input) {
 			searchConsole: properties,
 			googleAnalytics: analytics,
 			bing: Array.isArray(bing) ? bingSites : null,
-			research
+			research,
+			clicky: input.clicky ?? []
 		}
 	};
 }
@@ -14751,13 +14753,13 @@ let credentials;
 function expiresSoon(value) {
 	return [...value.google, ...value.bing].some((item) => "expiresAt" in item && item.expiresAt - EARLY < Date.now());
 }
-async function cloudCredentials() {
+async function cloudCredentials(options = {}) {
 	const current = credentials ? await credentials.catch(() => null) : null;
-	if (current && !expiresSoon(current)) return current;
+	if (current && !expiresSoon(current) && !options.refreshClicky) return current;
 	credentials = (async () => {
 		const token = cloudToken();
 		if (!token) throw new SeoError("AUTH_REQUIRED", notSignedIn());
-		const result = await call$1("/account/cli/credentials", { token });
+		const result = await call$1(`/account/cli/credentials${options.refreshClicky ? "?clicky=refresh" : ""}`, { token });
 		if (result.status === 401) throw new SeoError("AUTH_EXPIRED", `This machine is not linked to a seoskill.dev account any more. ${CLOUD_SIGN_IN}`);
 		if (!result.ok) throw new SeoError("PROVIDER_UNAVAILABLE", `seoskill.dev returned ${result.status}. Try again in a minute.`);
 		return result.body;
@@ -25631,6 +25633,9 @@ async function storedSiteKeys() {
 		source: credential.source
 	};
 }
+async function readClickySiteKeys() {
+	return (await storedSiteKeys()).siteKeys;
+}
 async function readClickySiteKey(siteIdValue, input = {}) {
 	const siteId = normalizeClickySiteId(siteIdValue);
 	const environmentKey = (input.env ?? process.env)[CLICKY_SITEKEY_ENV]?.trim();
@@ -36920,6 +36925,61 @@ async function updatePostmortemWorkflow(input, dependencies = {}) {
 		}
 	});
 }
+//#endregion
+//#region packages/core/dist/clicky/api.js
+const ENDPOINT$1 = "https://api.clicky.com/api/stats/4";
+const MAX_BYTES$1 = 5e6;
+var ClickyError = class extends Error {
+	code;
+	constructor(code, message) {
+		super(message);
+		this.code = code;
+	}
+};
+function isClickySiteId(value) {
+	return /^\d{1,30}$/u.test(value.trim());
+}
+function isClickySitekey(value) {
+	return /^[A-Za-z0-9]{12,64}$/u.test(value.trim());
+}
+async function clickyStats(site, types, options = {}) {
+	const url = new URL(ENDPOINT$1);
+	url.searchParams.set("site_id", site.siteId);
+	url.searchParams.set("sitekey", site.sitekey);
+	url.searchParams.set("type", types.join(","));
+	url.searchParams.set("output", "json");
+	url.searchParams.set("limit", String(options.limit ?? 1e3));
+	url.searchParams.set("app", "seo");
+	if (options.date) url.searchParams.set("date", options.date);
+	const response = await fetch(url).catch(() => {
+		throw new ClickyError("remote", "Could not reach Clicky. Try again.");
+	});
+	if (!response.ok) throw new ClickyError("remote", `Clicky returned ${response.status}.`);
+	const groups = await readJson(response, "Clicky", { maxBytes: MAX_BYTES$1 });
+	if (!Array.isArray(groups)) throw new ClickyError("remote", "Clicky returned invalid data.");
+	const failed = groups.find((group) => typeof group?.error === "string");
+	if (failed?.error) throw /sitekey|site id|authenticat|permission/iu.test(failed.error) ? new ClickyError("auth", `Clicky rejected site ID ${site.siteId} or its sitekey.`) : new ClickyError("remote", `Clicky: ${failed.error.slice(0, 200)}`);
+	const out = {};
+	for (const type of types) out[type] = [];
+	for (const group of groups) {
+		if (!group?.type || !(group.type in out)) continue;
+		for (const date of group.dates ?? []) for (const item of date.items ?? []) if (item && typeof item === "object") out[group.type]?.push(item);
+	}
+	return out;
+}
+async function clickyDomain(site) {
+	const { pages } = await clickyStats(site, ["pages"], {
+		date: "last-30-days",
+		limit: 1
+	});
+	const url = pages?.find((item) => item.url)?.url;
+	if (!url) return null;
+	try {
+		return new URL(url).hostname.replace(/^www\./u, "");
+	} catch {
+		return null;
+	}
+}
 function rowsText(input) {
 	const total = input.rows.length;
 	if (input.detail === "full") return `${input.title}\n\n${JSON.stringify(input.rows.slice(input.offset, input.offset + input.limit))}`;
@@ -37322,6 +37382,161 @@ async function runBingRows(input, deps) {
 	};
 }
 //#endregion
+//#region packages/core/dist/commands/clicky.js
+const CLICKY_KEY_PREFIX = "x-clicky-";
+function clickySites(keys) {
+	const sites = [];
+	for (const [name, value] of keys) {
+		if (!name.startsWith("x-clicky-")) continue;
+		const siteId = name.slice(9);
+		if (!isClickySiteId(siteId)) continue;
+		let sitekey = value.trim();
+		let domain = null;
+		let account = false;
+		if (sitekey.startsWith("{")) try {
+			const parsed = JSON.parse(sitekey);
+			sitekey = typeof parsed.sitekey === "string" ? parsed.sitekey : "";
+			domain = typeof parsed.domain === "string" ? parsed.domain : null;
+			account = parsed.account === true;
+		} catch {
+			continue;
+		}
+		if (isClickySitekey(sitekey)) sites.push({
+			siteId,
+			sitekey,
+			domain,
+			account
+		});
+	}
+	return sites.sort((left, right) => left.siteId < right.siteId ? -1 : left.siteId > right.siteId ? 1 : 0);
+}
+const clickyLabel = (site) => site.domain ? `${site.siteId} (${site.domain})` : site.siteId;
+function hostOf(value) {
+	const text = value.trim().toLowerCase().replace(/^sc-domain:/u, "");
+	try {
+		return new URL(text.includes("://") ? text : `https://${text}`).hostname.replace(/^www\./u, "");
+	} catch {
+		return text;
+	}
+}
+async function pickClickySite(saved, target, connect, refresh) {
+	const host = hostOf(target);
+	const match = (site) => site.siteId === target.trim() || site.domain === host;
+	let sites = saved;
+	if (!sites.some(match) && refresh) sites = await refresh() ?? sites;
+	if (!sites.length) throw new CommandError("NO_KEY", `No Clicky site is saved. Add your Clicky account, or one site's ID and sitekey (Clicky, Preferences, Info): ${connect}`);
+	const found = sites.find(match);
+	if (found) return found;
+	if (!isClickySiteId(target)) {
+		for (const site of sites.filter((item) => !item.domain).slice(0, 10)) site.domain = await clickyDomain(site).catch(() => null);
+		const named = sites.find(match);
+		if (named) return named;
+	}
+	throw new CommandError("NO_ACCESS", `No saved Clicky site matches ${target}. Saved Clicky sites: ${sites.map(clickyLabel).join(", ")}. Pass one of these site IDs, or add the site: ${connect}`);
+}
+const DAY = 864e5;
+const isoDay = (time) => new Date(time).toISOString().slice(0, 10);
+function clickyRange(input) {
+	if (!input.startDate && !input.endDate) {
+		const end = Date.now() - DAY;
+		return {
+			startDate: isoDay(end - 27 * DAY),
+			endDate: isoDay(end)
+		};
+	}
+	const start = Date.parse(`${input.startDate}T00:00:00Z`);
+	const end = Date.parse(`${input.endDate}T00:00:00Z`);
+	if (!input.startDate || !input.endDate || !(start <= end)) throw new CommandError("INVALID_INPUT", "Send a start date and an end date together, in order.");
+	if ((end - start) / DAY + 1 > 31) throw new CommandError("INVALID_INPUT", "Clicky reads at most 31 days at a time. Send a shorter range.");
+	return {
+		startDate: input.startDate,
+		endDate: input.endDate
+	};
+}
+const count = (item) => {
+	const value = Number(item.value);
+	return Number.isSafeInteger(value) && value >= 0 ? value : null;
+};
+const totals = (items) => items.map((item) => ({
+	name: item.title ?? "",
+	visits: count(item)
+})).filter((item) => Boolean(item.name) && item.visits !== null);
+const line = (items) => {
+	const top = items.slice(0, 10).map((item) => `${item.name} ${item.visits}`);
+	const rest = items.slice(10);
+	if (rest.length) top.push(`${rest.length} others ${rest.reduce((sum, item) => sum + item.visits, 0)}`);
+	return top.join("; ");
+};
+const LIMIT = 1e3;
+async function runClickyRows(input, keys, options) {
+	const refresh = options.refresh;
+	const site = await pickClickySite(clickySites(keys), input.site, options.connect, refresh && (async () => {
+		const fresh = await refresh().catch(() => null);
+		return fresh && clickySites(fresh);
+	}));
+	const range = clickyRange(input);
+	const offset = input.offset ?? 0;
+	const stats = await clickyStats(site, [
+		"pages-entrance",
+		"traffic-sources",
+		"searches-engines"
+	], {
+		date: `${range.startDate},${range.endDate}`,
+		limit: LIMIT
+	}).catch((error) => {
+		if (error instanceof ClickyError) throw new CommandError(error.code === "auth" ? "NO_ACCESS" : "PROVIDER_ERROR", error.code === "auth" ? `${error.message} Save it again: ${options.connect}` : error.message);
+		throw error;
+	});
+	const entrances = stats["pages-entrance"] ?? [];
+	const visitsByPage = /* @__PURE__ */ new Map();
+	for (const item of entrances) {
+		const visits = count(item);
+		if (visits === null || !item.url) continue;
+		let page;
+		try {
+			page = new URL(item.url).pathname;
+		} catch {
+			continue;
+		}
+		visitsByPage.set(page, (visitsByPage.get(page) ?? 0) + visits);
+	}
+	const rows = [...visitsByPage].map(([page, visits]) => ({
+		page,
+		visits
+	})).sort((left, right) => right.visits - left.visits || (left.page < right.page ? -1 : left.page > right.page ? 1 : 0));
+	const sources = totals(stats["traffic-sources"] ?? []);
+	const engines = totals(stats["searches-engines"] ?? []);
+	const notes = [
+		"Visits by landing page from every source, as Clicky counts them, in the Clicky site’s time zone. Clicky does not split landing pages by source.",
+		sources.length ? `Traffic sources (visits): ${line(sources)}.` : "Traffic sources: none in this range.",
+		engines.length ? `Search engines (visits): ${line(engines)}.` : "Search engines: none in this range."
+	];
+	if (entrances.length >= LIMIT) notes.push(`Clicky returned its ${LIMIT}-row limit; pages past it are missing, not zero.`);
+	return {
+		text: rowsText({
+			title: `Clicky site ${clickyLabel(site)}: landing pages, ${range.startDate} to ${range.endDate}.`,
+			rows,
+			offset,
+			limit: 50,
+			detail: input.detail ?? "summary",
+			notes,
+			more: options.call
+		}),
+		data: {
+			siteId: site.siteId,
+			domain: site.domain,
+			range,
+			metric: "visits",
+			sources,
+			searchEngines: engines,
+			capped: entrances.length >= LIMIT,
+			total: rows.length,
+			offset,
+			rows: rows.slice(offset, offset + 50)
+		}
+	};
+}
+//#endregion
 //#region packages/core/dist/commands/domain-rating.js
 const DR_ATTRIBUTION = "domain_rating: Domain Rating by Ahrefs (https://ahrefs.com/).";
 const ENDPOINT = "https://api.ahrefs.com/v3/public/domain-rating-free";
@@ -37547,7 +37762,7 @@ function nextFor(section, call) {
 		"second-page": `Next: ${call("page")} for one page’s queries and live facts.`,
 		"content-decay": `Next: ${call("index")} for pages that lost most of their clicks; ${call("page")} to see which queries moved.`,
 		cannibalization: `Next: ${call("page")} on each competing URL to see Google’s chosen canonical.`,
-		"traffic-drop": `Next: ${call("compare")} with the date the drop started, for the pages and queries that moved.`,
+		"traffic-drop": `Next: ${call("compare")} with the date the drop started, for the pages and queries that moved; ${call("index")} for pages that lost almost all their clicks and their index status.`,
 		bing: `Next: ${call("data", { source: "bing" })} for every Bing row; ${call("page")} for one page.`
 	}[section];
 }
@@ -38337,7 +38552,39 @@ const LOST_SHARE = .2;
 const MIN_LOST = 3;
 const CHECKED = 20;
 const INSPECTED = 10;
-const LOST_PAGES_RULE = `Pages that had at least ${MIN_LOST} clicks in the previous 28 days and kept ${LOST_SHARE * 100}% or less of them in the last 28 days, with a live check of the top ${CHECKED} and Google’s index status for the top ${INSPECTED}.`;
+const SITE_WIDE_MIN = 5;
+function indexSummary(inspected, home) {
+	const known = inspected.filter((item) => item?.verdict != null);
+	const indexed = known.filter((item) => item.verdict === "PASS").length;
+	const coverage = /* @__PURE__ */ new Map();
+	for (const item of known) {
+		if (item.verdict === "PASS") continue;
+		const state = item.coverage ?? item.verdict ?? "unknown";
+		coverage.set(state, (coverage.get(state) ?? 0) + 1);
+	}
+	const notIndexed = known.length - indexed;
+	const homeIndexed = home?.status?.verdict ? home.status.verdict === "PASS" : null;
+	const siteWide = notIndexed >= SITE_WIDE_MIN && notIndexed * 2 > known.length && homeIndexed;
+	const byCoverage = [...coverage].sort((a, b) => b[1] - a[1] || a[0].localeCompare(b[0])).map(([state, count]) => ({
+		state,
+		count
+	}));
+	return {
+		text: (known.length ? [`Index status of the ${known.length} inspected pages: ${indexed} indexed, ${notIndexed} not indexed${byCoverage.length ? ` (${byCoverage.map((item) => `${item.count} ${item.state}`).join("; ")})` : ""}.${home && homeIndexed !== null ? ` Home page ${home.url}: ${homeIndexed ? "indexed" : `not indexed (${home.status?.coverage ?? home.status?.verdict})`}.` : ""}`, siteWide ? `Site-wide pattern: ${notIndexed} of ${known.length} inspected pages are not in Google's index, but the home page is. This points to the whole site, not single pages. It does not show the cause.` : null] : []).filter(Boolean).join("\n"),
+		data: {
+			inspected: known.length,
+			indexed,
+			notIndexed,
+			byCoverage,
+			homePage: home && homeIndexed !== null ? {
+				url: home.url,
+				indexed: homeIndexed
+			} : null,
+			siteWide: Boolean(siteWide)
+		}
+	};
+}
+const LOST_PAGES_RULE = `Pages that had at least ${MIN_LOST} clicks in the previous 28 days and kept ${LOST_SHARE * 100}% or less of them in the last 28 days, with a live check of the top ${CHECKED} and Google’s index status for the top ${INSPECTED} and the home page.`;
 async function runLostPages(input, deps) {
 	const range = dateWindow(input, 28);
 	const before = earlierRange(range);
@@ -38355,7 +38602,17 @@ async function runLostPages(input, deps) {
 		clicks: current.get(row.keys[0]) ?? 0
 	})).filter((row) => row.clicks <= row.previous_clicks * LOST_SHARE).sort((a, b) => b.previous_clicks - b.clicks - (a.previous_clicks - a.clicks) || a.url.localeCompare(b.url));
 	const top = lost.slice(0, CHECKED);
-	const [facts, indexed] = await Promise.all([deps.checkPages(top.map((row) => row.url)), Promise.all(top.slice(0, INSPECTED).map((row) => deps.inspect(input.site, row.url)))]);
+	const homeUrl = top[0] ? `${new URL(top[0].url).origin}/` : null;
+	const [facts, indexed, homeStatus] = await Promise.all([
+		deps.checkPages(top.map((row) => row.url)),
+		Promise.all(top.slice(0, INSPECTED).map((row) => deps.inspect(input.site, row.url))),
+		homeUrl && !top.slice(0, INSPECTED).some((row) => row.url === homeUrl) ? deps.inspect(input.site, homeUrl).catch(() => null) : null
+	]);
+	const homeIndex = top.slice(0, INSPECTED).findIndex((row) => row.url === homeUrl);
+	const summary = indexSummary(homeIndex >= 0 ? indexed.filter((_, index) => index !== homeIndex) : indexed, homeUrl ? {
+		url: homeUrl,
+		status: homeIndex >= 0 ? indexed[homeIndex] ?? null : homeStatus
+	} : null);
 	const rows = top.map((row, index) => ({
 		...row,
 		status: facts[index]?.status ?? null,
@@ -38371,6 +38628,7 @@ async function runLostPages(input, deps) {
 			`Pages that lost their clicks on ${input.site}: ${range.startDate} to ${range.endDate} against ${before.startDate} to ${before.endDate}.`,
 			`${lost.length} pages kept ${LOST_SHARE * 100}% or less of at least ${MIN_LOST} clicks${lost.length > CHECKED ? `; the top ${CHECKED} by clicks lost are shown` : ""}.`,
 			rows.length ? table(rows, Object.keys(rows[0] ?? {}), originOf(input.site)) : "No pages lost their clicks.",
+			summary.text,
 			"Live checks are fetched now with no redirects followed. Index status is from URL Inspection; Google allows about 2,000 inspections a day per property.",
 			temporaryRedirectNote(rows),
 			`Next: ${deps.call("page")} for one URL; ${deps.call("report", {
@@ -38384,6 +38642,7 @@ async function runLostPages(input, deps) {
 			comparisonRange: before,
 			rule: LOST_PAGES_RULE,
 			lostPages: lost.length,
+			index: summary.data,
 			pages: rows
 		}
 	};
@@ -38436,9 +38695,9 @@ const detail = {
 const DATA_SOURCES = [
 	"search_console",
 	"google_analytics",
-	"bing"
+	"bing",
+	"clicky"
 ];
-const LOCAL_ANALYTICS = "Clicky and other analytics run on the person’s machine with the CLI and a provider package: `npx -y seo providers install @seoskill/clicky-provider`, connect it once with `seo providers connect clicky`, then `npx -y seo analytics clicky report --json`. `seo providers list` shows installed providers.";
 function tool(spec) {
 	return spec;
 }
@@ -38452,6 +38711,7 @@ const SHARED_TOOLS = [
 		run: async (surface) => runSites({
 			accounts: await surface.accounts(),
 			keys: await surface.keys(),
+			clicky: clickySites(await surface.keys()).map(clickyLabel),
 			signIn: surface.signIn,
 			bing: surface.deps.bing ? await surface.deps.bing() : void 0,
 			connect: surface.connect
@@ -38549,10 +38809,10 @@ const SHARED_TOOLS = [
 		name: "seo_data",
 		command: "data",
 		title: "Raw rows",
-		description: `Raw rows for questions the report does not answer. search_console (default): rows for any dimensions, each with the previous period and the change; page and query narrow to rows whose URL or query contains that text. google_analytics: landing pages for visits from search, with Google Analytics’ own metric names. bing: Bing Webmaster query or page rows (first dimension) for the same site, by week. ${LOCAL_ANALYTICS}`,
+		description: `Raw rows for questions the report does not answer. search_console (default): rows for any dimensions, each with the previous period and the change; page and query narrow to rows whose URL or query contains that text. google_analytics: landing pages for visits from search, with Google Analytics’ own metric names. bing: Bing Webmaster query or page rows (first dimension) for the same site, by week. clicky: landing-page visits, traffic sources and search engines from a Clicky site the person saved (site is its domain or Clicky site ID; at most 31 days).`,
 		input: z.object({
 			source: z.enum(DATA_SOURCES).default("search_console"),
-			site: z.string().min(1).describe("search_console and bing: the property or site. google_analytics: numeric property id from seo_sites."),
+			site: z.string().min(1).describe("search_console and bing: the property or site. google_analytics: numeric property id from seo_sites. clicky: the site or its Clicky site ID."),
 			dimensions: z.array(z.enum(DIMENSIONS)).max(4).default(["query"]).describe("search_console; bing uses the first, query or page."),
 			page: z.string().min(1).optional().describe("search_console only: URL text, such as /blog/."),
 			query: z.string().min(1).optional().describe("search_console only: query text."),
@@ -38560,6 +38820,17 @@ const SHARED_TOOLS = [
 			...detail
 		}),
 		run: async (surface, input) => {
+			if (input.source === "clicky") return runClickyRows({
+				site: input.site,
+				startDate: input.start_date,
+				endDate: input.end_date,
+				detail: input.detail,
+				offset: input.offset
+			}, await surface.keys(), {
+				connect: surface.connect,
+				call: (offset) => `seo_data with source "clicky", site "${input.site}", detail "rows", offset ${offset}`,
+				refresh: surface.refreshClicky
+			});
 			if (input.source === "bing") return runBingRows({
 				site: input.site,
 				dimension: input.dimensions[0] === "page" ? "page" : "query",
@@ -38603,10 +38874,10 @@ async function runSharedTool(tool, surface, input) {
 	if (!parsed.success) throw new CommandError("INVALID_INPUT", parsed.error.issues.map((issue) => `${issue.path.join(".") || "input"}: ${issue.message}`).join("; "));
 	return tool.run(surface, parsed.data);
 }
-const MCP_INSTRUCTIONS = `SEO Skill reads the person's own Search Console, Google Analytics, Bing Webmaster Tools and optional keyword and analytics accounts, and returns facts with their dates and limits. It gives no advice.
+const MCP_INSTRUCTIONS = `SEO Skill reads the person's own Search Console, Google Analytics, Bing Webmaster Tools, Clicky and optional keyword accounts, and returns facts with their dates and limits. It gives no advice.
 1. seo_sites: the properties the connected accounts can read.
 2. seo_report: the main report. Run it without a section first; it shows the overview and every section's count and top rows. Then ask for the one section you need.
-3. seo_page for one URL, seo_compare for before and after a date, seo_index for pages that lost their clicks, seo_research for keyword, competitor and backlink data from the DataForSEO or Ahrefs key the person saved, seo_data for raw rows.
+3. seo_page for one URL, seo_compare for before and after a date, seo_index for pages that lost their clicks, seo_research for keyword, competitor and backlink data from the DataForSEO or Ahrefs key the person saved, seo_data for raw rows, including Google Analytics, Bing and Clicky.
 Show the person the facts that matter, for example in a table or a small dashboard, and decide with them what to change. Do not edit pages without their approval.`;
 const mcpCall = (command, args) => {
 	const name = `seo_${command.replace("-", "_")}`;
@@ -38833,12 +39104,17 @@ async function localAccounts() {
 	}));
 }
 async function localResearchKeys() {
-	const [dataForSeo, ahrefs, saved] = await Promise.all([
+	const [dataForSeo, ahrefs, clicky, saved] = await Promise.all([
 		readDataForSeoCredentials().catch(() => void 0),
 		readAhrefsApiKey().catch(() => void 0),
+		readClickySiteKeys().catch(() => ({})),
 		cloudLinked() ? cloudKeys().catch(() => ({})) : {}
 	]);
 	const keys = new Headers(saved);
+	for (const [siteId, sitekey] of Object.entries(clicky)) {
+		const name = `${CLICKY_KEY_PREFIX}${siteId}`;
+		if (!keys.has(name)) keys.set(name, sitekey);
+	}
 	if (dataForSeo) {
 		keys.set("x-dataforseo-login", dataForSeo.login);
 		keys.set("x-dataforseo-password", dataForSeo.password);
@@ -38846,6 +39122,11 @@ async function localResearchKeys() {
 	if (ahrefs?.apiKey) keys.set("x-ahrefs-key", ahrefs.apiKey);
 	return keys;
 }
+async function localRefreshClicky() {
+	if (!cloudLinked()) return null;
+	await cloudCredentials({ refreshClicky: true });
+	return localResearchKeys();
+}
 async function resolveLocalSite(site, options = {}) {
 	const found = matchProperty((await listSites(options.refresh, options.account)).map((entry) => entry.siteUrl), site);
 	if (!found) throw new CommandError("NO_ACCESS", `This Google login has no Search Console property for ${site}. Run \`seo sites\` to list the properties it can read.`);
@@ -42362,6 +42643,7 @@ function registerSharedTools(server, options = {}) {
 		deps: nodeCommandDeps({ call: mcpCall }),
 		resolveSite: (site) => resolveLocalSite(site),
 		keys: localResearchKeys,
+		refreshClicky: localRefreshClicky,
 		drKey: null,
 		accounts: localAccounts,
 		signIn: LOCAL_SIGN_IN.signIn,