seo 0.8.3 → 0.9.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 version, r as __commonJSMin, t as load } from "./esm-BZhSLbcQ.js";
+import { i as __toESM, n as version, r as __commonJSMin, t as load } from "./esm-gP6ovS6b.js";
 import { createHash, randomUUID, sign } from "node:crypto";
 import { ZodOptional, z } from "zod";
 import { arch, homedir, platform, totalmem } from "node:os";
@@ -13912,12 +13912,12 @@ function day(value) {
 	return Number.isNaN(date.getTime()) ? null : date.toISOString().slice(0, 10);
 }
 const count$1 = (value) => typeof value === "number" && Number.isFinite(value) && value >= 0 ? value : null;
-function list(data, label) {
+function list$1(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");
 }
 async function listBingSites(call) {
-	return list(await call("GetUserSites"), "site list").filter((row) => typeof row.Url === "string").map((row) => ({
+	return list$1(await call("GetUserSites"), "site list").filter((row) => typeof row.Url === "string").map((row) => ({
 		url: row.Url,
 		verified: row.IsVerified === true
 	})).sort((a, b) => a.url.localeCompare(b.url, "en"));
@@ -13925,7 +13925,7 @@ async function listBingSites(call) {
 async function bingTraffic(call, site) {
 	const rows = [];
 	let invalidRows = 0;
-	for (const row of list(await call("GetRankAndTrafficStats", { siteUrl: site }), "traffic list")) {
+	for (const row of list$1(await call("GetRankAndTrafficStats", { siteUrl: site }), "traffic list")) {
 		const date = day(row.Date);
 		const clicks = count$1(row.Clicks);
 		const impressions = count$1(row.Impressions);
@@ -13948,7 +13948,7 @@ async function bingTraffic(call, site) {
 async function keyed(call, method, params) {
 	const rows = [];
 	let invalidRows = 0;
-	for (const row of list(await call(method, params), "row list")) {
+	for (const row of list$1(await call(method, params), "row list")) {
 		const date = day(row.Date);
 		const key = typeof row.Query === "string" ? row.Query.trim() : "";
 		const clicks = count$1(row.Clicks);
@@ -38264,6 +38264,482 @@ async function clickyDomain(site) {
 		return null;
 	}
 }
+//#endregion
+//#region packages/core/dist/analyze/ai-queries.js
+const RULES = [
+	["agent_prompt", "^(search the web for|browse the web|find sources)|do not invent|return the [0-9]+ most relevant|include source urls|context: location|do not include location|question: |reply only with|the model you are using"],
+	["tracker", "\\. ?my location is |\\?\\. ?my( |$)|^evaluate the .+ on "],
+	["reply", "^(yes|yeah|yep|ok|okay|sure|yes please|go on|continue|keep going|tell me more|why not|how so|really|exactly|show me|and then|thanks|thank you|got it|what else|anything else)[?!.,]*$"],
+	["follow_up", "^(what|how) about .{1,40}$|^(and|so|ok so|okay so|but) (what|which|how|why) "],
+	["operator", "(^|\\s)-?(site|before|after|intitle|inurl|intext|filetype):|\"[^\"]*\" or \""],
+	["chat", "\\b(please|can you|could you|give me|show me|tell me|i want|i need|i have|i am|should i|do i need|is it worth|help me|walk me through)\\b|^(what|how|why|is|does|can|will|would) (it|that|this|they)\\b"],
+	["long", "^(\\S+\\s+){9,}\\S+$"]
+];
+const AI_QUERY_KINDS = {
+	agent_prompt: "text from an agent prompt, such as \"search the web for\"",
+	tracker: "a visibility-tool probe, such as \"my location is\"",
+	reply: "a bare reply, such as \"yes\" or \"tell me more\"",
+	follow_up: "a follow-up, such as \"what about …\"",
+	operator: "search operators, such as site:, before: or \"a\" or \"b\"",
+	chat: "chat phrasing, such as \"can you\" or \"should i\"",
+	long: "ten or more words with no other sign"
+};
+const MATCHERS = RULES.map(([kind, pattern]) => [kind, new RegExp(pattern)]);
+const AI_QUERY_PATTERN = RULES.map(([, pattern]) => `(?:${pattern})`).join("|");
+const NOISE = [
+	["spaced_letters", /(^|\s)(\S\s){3,}\S(\s|$)/u],
+	["broken_encoding", /^(яю|ÿþ|þÿ)|&#[0-9]+;?|&[a-z]+;|[âÃÂ][\u0080-\u00bf€™œ“”]|\ufffd/u],
+	["pasted_text", /^(p [a-z]{3,} |here (are|is) (all )?the |here's the |done[,.!]? (you|here) |current state: )/u]
+];
+function aiQueryNoise(query) {
+	const text = query.trim().toLowerCase();
+	return NOISE.find(([, pattern]) => pattern.test(text))?.[0] ?? null;
+}
+const QUESTION = /^(how|what|what's|whats|which|why|when|where|who|is|are|can|could|does|do|should|would|will|i need|i want|i have|i'm looking|we need|we want)\b|\?$/u;
+const ASKABLE_KINDS = /* @__PURE__ */ new Set(["chat", "long"]);
+const PROMPT_CHARACTERS = 500;
+function askable(query, kind) {
+	const text = query.trim().toLowerCase().replace(/^["'“]+/u, "");
+	return Boolean(kind && ASKABLE_KINDS.has(kind)) && text.length <= PROMPT_CHARACTERS && QUESTION.test(text);
+}
+function aiQueryKind(query) {
+	const text = query.trim().toLowerCase();
+	return MATCHERS.find(([, pattern]) => pattern.test(text))?.[0] ?? null;
+}
+const STOP = new Set("the and for with that this what which who how why when where are is was can does do did you your our from about into than then them they their there have has had will would should could not but its it’s me my i am of to in on at by or an as be if so".split(" "));
+function words(query) {
+	return new Set(query.toLowerCase().split(/[^\p{L}\p{N}]+/u).filter((word) => word.length >= 3 && !STOP.has(word)).map((word) => word.length > 4 && word.endsWith("s") ? word.slice(0, -1) : word));
+}
+const SAME_QUESTION = .6;
+const MAX_ROWS = 25e3;
+const EXAMPLES = 3;
+const CANDIDATES = 200;
+const overlap = (a, b, weight) => {
+	let shared = 0;
+	let union = 0;
+	for (const word of a) {
+		union += weight(word);
+		if (b.has(word)) shared += weight(word);
+	}
+	for (const word of b) if (!a.has(word)) union += weight(word);
+	return union ? shared / union : 0;
+};
+const round = (value, places) => Math.round(value * 10 ** places) / 10 ** places;
+async function aiQueriesReport(input, searchAnalytics) {
+	const range = {
+		startDate: input.startDate,
+		endDate: input.endDate
+	};
+	const [matched, site] = await Promise.all([searchAnalytics(input.site, {
+		...range,
+		dimensions: ["query", "page"],
+		type: "web",
+		dataState: "final",
+		maxRows: MAX_ROWS,
+		dimensionFilterGroups: [{ filters: [{
+			dimension: "query",
+			operator: "includingRegex",
+			expression: AI_QUERY_PATTERN
+		}] }]
+	}), searchAnalytics(input.site, {
+		...range,
+		dimensions: [],
+		type: "web",
+		dataState: "final"
+	})]);
+	const rows = [...matched.rows].sort((a, b) => b.impressions - a.impressions || String(a.keys[0]).localeCompare(String(b.keys[0])) || String(a.keys[1]).localeCompare(String(b.keys[1])));
+	const usage = /* @__PURE__ */ new Map();
+	const unique = new Set(rows.map((row) => String(row.keys[0] ?? "")));
+	for (const query of unique) for (const word of words(query)) usage.set(word, (usage.get(word) ?? 0) + 1);
+	const weight = (word) => Math.log((unique.size + 1) / (usage.get(word) ?? 1));
+	const groups = [];
+	const byWord = /* @__PURE__ */ new Map();
+	const byText = /* @__PURE__ */ new Map();
+	const kindOf = /* @__PURE__ */ new Map();
+	const noise = /* @__PURE__ */ new Map();
+	for (const row of rows) {
+		const query = String(row.keys[0] ?? "");
+		const page = String(row.keys[1] ?? "");
+		const kind = aiQueryKind(query);
+		if (!kind) continue;
+		const junk = aiQueryNoise(query);
+		if (junk) {
+			const seen = noise.get(junk) ?? /* @__PURE__ */ new Set();
+			seen.add(query.trim().toLowerCase());
+			noise.set(junk, seen);
+			continue;
+		}
+		const text = query.trim().toLowerCase();
+		const own = words(query);
+		let group = byText.get(text);
+		if (!group) {
+			let checked = 0;
+			for (const word of own) {
+				for (const candidate of byWord.get(word) ?? []) {
+					if (++checked > CANDIDATES) break;
+					if (overlap(own, candidate.words, weight) >= SAME_QUESTION) {
+						group = candidate;
+						break;
+					}
+				}
+				if (group || checked > CANDIDATES) break;
+			}
+		}
+		if (!group) {
+			group = {
+				words: own,
+				queries: /* @__PURE__ */ new Map(),
+				pages: /* @__PURE__ */ new Map(),
+				kinds: /* @__PURE__ */ new Map(),
+				clicks: 0,
+				impressions: 0,
+				positionWeight: 0
+			};
+			groups.push(group);
+			for (const word of own) {
+				const list = byWord.get(word) ?? [];
+				list.push(group);
+				byWord.set(word, list);
+			}
+		}
+		byText.set(text, group);
+		if (!kindOf.has(text)) {
+			kindOf.set(text, kind);
+			group.kinds.set(kind, (group.kinds.get(kind) ?? 0) + 1);
+		}
+		group.queries.set(query, (group.queries.get(query) ?? 0) + row.impressions);
+		group.pages.set(page, (group.pages.get(page) ?? 0) + row.impressions);
+		group.clicks += row.clicks;
+		group.impressions += row.impressions;
+		group.positionWeight += row.position * row.impressions;
+	}
+	const byKind = /* @__PURE__ */ new Map();
+	for (const kind of kindOf.values()) {
+		const entry = byKind.get(kind) ?? {
+			queries: 0,
+			impressions: 0
+		};
+		entry.queries += 1;
+		byKind.set(kind, entry);
+	}
+	for (const row of rows) {
+		const kind = kindOf.get(String(row.keys[0] ?? "").trim().toLowerCase());
+		const entry = kind && byKind.get(kind);
+		if (entry) entry.impressions += row.impressions;
+	}
+	const queries = kindOf.size;
+	const impressions = groups.reduce((sum, g) => sum + g.impressions, 0);
+	const clicks = groups.reduce((sum, g) => sum + g.clicks, 0);
+	const total = site.rows[0] ?? {
+		clicks: 0,
+		impressions: 0
+	};
+	const items = groups.map((group) => {
+		const most = (map) => [...map].sort((a, b) => b[1] - a[1] || a[0].localeCompare(b[0])).map(([name]) => name);
+		const [first, ...rest] = most(group.queries);
+		const kind = [...group.kinds].sort((a, b) => b[1] - a[1] || a[0].localeCompare(b[0]))[0]?.[0];
+		return {
+			query: first ?? "",
+			page: most(group.pages)[0] ?? "",
+			askable: askable(first ?? "", kind),
+			pages: group.pages.size,
+			kind,
+			wordings: group.queries.size,
+			impressions: group.impressions,
+			clicks: group.clicks,
+			ctr: group.impressions ? round(group.clicks / group.impressions, 4) : 0,
+			position: group.impressions ? round(group.positionWeight / group.impressions, 1) : 0,
+			otherWordings: rest.slice(0, EXAMPLES)
+		};
+	}).sort((a, b) => b.impressions - a.impressions || b.wordings - a.wordings || a.query.localeCompare(b.query) || a.page.localeCompare(b.page));
+	const pct = (part, whole) => whole ? round(part / whole * 100, 1) : null;
+	const kinds = [...byKind].sort((a, b) => b[1].impressions - a[1].impressions || a[0].localeCompare(b[0])).map(([kind, entry]) => `${kind} ${entry.queries}`).join(", ");
+	const leftOut = [...noise].sort((a, b) => a[0].localeCompare(b[0])).map(([reason, seen]) => `${reason.replace("_", " ")} ${seen.size}`).join(", ");
+	const asked = items.filter((item) => item.askable).length;
+	const capped = matched.rowsFetched >= MAX_ROWS;
+	return {
+		range,
+		verdict: queries ? `${queries} queries in ${groups.length} questions have the shape of AI conversations or agent searches.` : "No queries with the shape of AI conversations or agent searches.",
+		summary: {
+			queries,
+			questions: groups.length,
+			askable: asked,
+			leftOut: leftOut || "none",
+			impressions,
+			clicks,
+			shareOfImpressionsPct: pct(impressions, total.impressions),
+			byKind: kinds || "none",
+			ctr: impressions ? round(clicks / impressions, 4) : 0,
+			siteCtr: total.impressions ? round(total.clicks / total.impressions, 4) : 0
+		},
+		kinds: AI_QUERY_KINDS,
+		items,
+		caveats: [
+			"A heuristic: these queries match the patterns of AI conversations and agent searches. Search Console does not mark AI Mode or AI Overviews, and people type some of these too.",
+			"A minimum: Search Console leaves out rare queries, and these are rare by nature.",
+			"Rewordings of one question are grouped by their shared words; page is the page with the most impressions for it.",
+			"Left out and counted, not shown: letters split by spaces, text broken by a wrong encoding, and text pasted from a tool or an agent’s output.",
+			"askable: a chat or long question that opens with a question word or a request such as \"i need\", or ends with a question mark, so an AI engine can be asked it as it is. ai_answers checks the top askable questions only.",
+			"Search Console’s Generative AI report is not in its API, so it is not here.",
+			...capped ? [`Capped at the first ${MAX_ROWS} matching query and page rows.`] : []
+		]
+	};
+}
+//#endregion
+//#region packages/core/dist/commands/research-providers.js
+function need(headers, provider) {
+	const values = provider === "dataforseo" ? [headers.get("x-dataforseo-login"), headers.get("x-dataforseo-password")] : [headers.get("x-ahrefs-key")];
+	if (values.some((value) => !value)) throw new CommandError("NO_KEY", `No ${provider} key. Hosted MCP: save it at https://seoskill.dev/account#keys. CLI and local MCP: run \`seo login\` to use the account's keys, or \`seo providers ${provider} connect\`.`);
+	return values;
+}
+async function call(provider, request) {
+	const response = await fetch(request);
+	if (response.ok) return response;
+	const text = (await response.text()).slice(0, 300);
+	throw new CommandError(response.status === 401 || response.status === 403 ? "NO_KEY" : "PROVIDER_ERROR", `${provider} answered ${response.status}. ${text}`);
+}
+function requireInput(input) {
+	const needsKeywords = input.action === "keyword_metrics" || input.action === "serp";
+	if (needsKeywords && input.keywords.length === 0) throw new CommandError("INVALID_INPUT", `${input.action} needs keywords.`);
+	if (!needsKeywords && !input.target) throw new CommandError("INVALID_INPUT", `${input.action} needs a target domain or URL.`);
+}
+async function research(provider, headers, input) {
+	requireInput(input);
+	const keys = need(headers, provider);
+	if (provider === "dataforseo") return dataForSeo(keys, input);
+	return {
+		rows: await ahrefs(keys[0] ?? "", input),
+		costUsd: null,
+		partial: false
+	};
+}
+function countryName(code) {
+	return new Intl.DisplayNames("en", { type: "region" }).of(code.toUpperCase()) ?? "United States";
+}
+function mainLanguage(country) {
+	try {
+		return new Intl.Locale(`und-${country.toUpperCase()}`).maximize().language;
+	} catch {
+		return "en";
+	}
+}
+const LABS_LANGUAGES = new Map(`
+  ae:ar al:sq am:hy ao:pt ar:es at:de au:en az:az ba:bs bd:bn be:nl bf:fr
+  bg:bg bh:ar bo:es br:pt ca:en ch:de ci:fr cl:es cm:fr co:es cr:es cy:el
+  cz:cs de:de dk:da dz:ar ec:es ee:et eg:ar es:es fi:fi fr:fr gb:en gh:en
+  gr:el gt:es hk:en hr:hr hu:hu id:id ie:en il:he in:en it:it jo:ar jp:ja
+  ke:en kh:en kr:ko kz:ru lk:en lt:lt lv:lv ma:ar mc:fr md:ro mk:mk mm:en
+  mt:en mx:es my:en ng:en ni:es nl:nl no:nb nz:en pa:es pe:es ph:en pk:en
+  pl:pl pt:pt py:es ro:ro rs:sr sa:ar se:sv sg:en si:sl sk:sk sn:fr sv:es
+  th:th tn:ar tr:tr tw:zh-TW ua:uk us:en uy:es ve:es vn:vi za:en
+`.trim().split(/\s+/).map((pair) => pair.split(":")));
+function dataForSeoLanguage(country) {
+	return LABS_LANGUAGES.get(country.toLowerCase()) ?? null;
+}
+function dataForSeoMarket(country, language) {
+	return {
+		location_name: countryName(country),
+		language_code: language ?? mainLanguage(country)
+	};
+}
+function dataForSeoKeys(headers) {
+	return need(headers, "dataforseo");
+}
+async function dataForSeoList([login, password], path) {
+	const task = (await readJson(await call("dataforseo", new Request(`https://api.dataforseo.com/${path}`, { headers: { authorization: `Basic ${btoa(`${login}:${password}`)}` } })), "DataForSEO")).tasks?.[0];
+	if (!task || task.status_code >= 4e4) throw new CommandError("PROVIDER_ERROR", `dataforseo: no list at ${path}`);
+	return task.result ?? [];
+}
+async function dataForSeoTask([login, password], path, task) {
+	const result = (await readJson(await call("dataforseo", new Request(`https://api.dataforseo.com/${path}`, {
+		method: "POST",
+		headers: {
+			authorization: `Basic ${btoa(`${login}:${password}`)}`,
+			"content-type": "application/json"
+		},
+		body: JSON.stringify([task])
+	})), "DataForSEO")).tasks?.[0];
+	if (result?.status_code === NO_RESULTS) return {
+		cost: result.cost ?? 0,
+		result: null,
+		partial: false
+	};
+	if (!result || result.status_code >= 4e4 && result.status_code !== PARTIAL) throw Object.assign(new CommandError("PROVIDER_ERROR", `dataforseo: ${result?.status_message ?? "no task result"}`), { cost: result?.cost ?? 0 });
+	return {
+		cost: result.cost ?? 0,
+		result: result.result?.[0] ?? null,
+		partial: result.status_code === PARTIAL
+	};
+}
+const NO_RESULTS = 40102;
+const PARTIAL = 40106;
+async function dataForSeo(keys, input) {
+	const spent = {
+		cost: 0,
+		partial: false
+	};
+	return {
+		rows: await dataForSeoRows(keys, input, spent),
+		costUsd: Math.round(spent.cost * 1e4) / 1e4,
+		partial: spent.partial
+	};
+}
+async function dataForSeoRows(keys, input, spent) {
+	const language = dataForSeoLanguage(input.country);
+	if (!language && input.action !== "serp" && input.action !== "backlinks") throw new CommandError("INVALID_INPUT", `DataForSEO has no ${input.action} data for country "${input.country}".`);
+	const market = dataForSeoMarket(input.country, language);
+	const post = async (path, task) => {
+		const done = await dataForSeoTask(keys, path, {
+			...market,
+			...task
+		}).catch((error) => {
+			spent.cost += error.cost ?? 0;
+			throw error;
+		});
+		spent.cost += done.cost;
+		spent.partial ||= done.partial;
+		return done.result?.items ?? [];
+	};
+	const get = (value, path) => path.split(".").reduce((current, key) => current && typeof current === "object" ? current[key] : void 0, value);
+	const pick = (item, fields) => Object.fromEntries(Object.entries(fields).map(([name, path]) => [name, get(item, path) ?? null]));
+	if (input.action === "keyword_metrics") return (await post("v3/dataforseo_labs/google/keyword_overview/live", { keywords: input.keywords.slice(0, 700) })).map((item) => pick(item, {
+		keyword: "keyword",
+		search_volume: "keyword_info.search_volume",
+		keyword_difficulty: "keyword_properties.keyword_difficulty",
+		cpc: "keyword_info.cpc",
+		competition: "keyword_info.competition",
+		main_intent: "search_intent_info.main_intent"
+	}));
+	if (input.action === "ranked_keywords") return (await post("v3/dataforseo_labs/google/ranked_keywords/live", {
+		target: bareTarget(input.target),
+		limit: input.limit,
+		order_by: ["ranked_serp_element.serp_item.etv,desc"]
+	})).map((item) => pick(item, {
+		keyword: "keyword_data.keyword",
+		position: "ranked_serp_element.serp_item.rank_absolute",
+		url: "ranked_serp_element.serp_item.url",
+		search_volume: "keyword_data.keyword_info.search_volume",
+		etv: "ranked_serp_element.serp_item.etv",
+		keyword_difficulty: "keyword_data.keyword_properties.keyword_difficulty",
+		main_intent: "keyword_data.search_intent_info.main_intent"
+	}));
+	if (input.action === "serp") {
+		const rows = [];
+		for (const keyword of input.keywords.slice(0, 5)) {
+			const items = await post("v3/serp/google/organic/live/advanced", {
+				keyword,
+				depth: Math.min(input.limit, 100)
+			});
+			for (const item of items) {
+				if (item.type !== "organic") continue;
+				rows.push({
+					keyword,
+					...pick(item, {
+						position: "rank_absolute",
+						url: "url",
+						domain: "domain",
+						title: "title"
+					})
+				});
+			}
+		}
+		return rows;
+	}
+	if (input.action === "backlinks") return (await post("v3/backlinks/referring_domains/live", {
+		target: bareTarget(input.target),
+		limit: input.limit,
+		order_by: ["rank,desc"]
+	})).map((item) => pick(item, {
+		domain: "domain",
+		rank: "rank",
+		backlinks: "backlinks",
+		referring_pages: "referring_pages",
+		first_seen: "first_seen"
+	}));
+	return (await post("v3/dataforseo_labs/google/competitors_domain/live", {
+		target: bareTarget(input.target),
+		limit: input.limit
+	})).map((item) => pick(item, {
+		domain: "domain",
+		shared_keywords: "intersections",
+		avg_position: "avg_position",
+		organic_keywords: "full_domain_metrics.organic.count",
+		organic_etv: "full_domain_metrics.organic.etv"
+	}));
+}
+function isPage(target) {
+	return /\/./.test(bareTarget(target));
+}
+function bareTarget(target) {
+	return target.replace(/^https?:\/\//, "").replace(/\/$/, "");
+}
+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 readJson(await call("ahrefs", new Request(url, { headers: {
+			authorization: `Bearer ${key}`,
+			accept: "application/json"
+		} })), "Ahrefs");
+	};
+	const today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+	if (input.action === "keyword_metrics") return ((await get("keywords-explorer/overview", {
+		select: "keyword,volume,difficulty,cpc,traffic_potential,intents",
+		country: input.country,
+		keywords: input.keywords.slice(0, 100).join(",")
+	})).keywords ?? []).map(flattenIntents);
+	if (input.action === "ranked_keywords") return (await get("site-explorer/organic-keywords", {
+		select: "keyword,best_position,best_position_url,volume,sum_traffic,keyword_difficulty,cpc",
+		target: input.target,
+		country: input.country,
+		date: today,
+		mode: isPage(input.target) ? "exact" : "subdomains",
+		limit: String(input.limit),
+		order_by: "sum_traffic:desc"
+	})).keywords ?? [];
+	if (input.action === "serp") {
+		const rows = [];
+		for (const keyword of input.keywords.slice(0, 5)) {
+			const data = await get("serp-overview/serp-overview", {
+				select: "position,type,url,title,domain_rating,traffic,keywords",
+				keyword,
+				country: input.country,
+				top_positions: String(Math.min(input.limit, 100))
+			});
+			for (const row of data.positions ?? []) rows.push({
+				keyword,
+				...row
+			});
+		}
+		return rows;
+	}
+	if (input.action === "backlinks") return (await get("site-explorer/refdomains", {
+		select: "domain,domain_rating,links_to_target,dofollow_links,first_seen,last_seen",
+		target: input.target,
+		mode: isPage(input.target) ? "exact" : "subdomains",
+		history: "live",
+		limit: String(input.limit),
+		order_by: "domain_rating:desc"
+	})).refdomains ?? [];
+	return (await get("site-explorer/organic-competitors", {
+		select: "competitor_domain,keywords_common,keywords_competitor,keywords_target,share,traffic,domain_rating",
+		target: input.target,
+		country: input.country,
+		date: today,
+		mode: "subdomains",
+		limit: String(input.limit),
+		order_by: "keywords_common:desc"
+	})).competitors ?? [];
+}
+function flattenIntents(row) {
+	const intents = row.intents;
+	if (!intents || typeof intents !== "object") return row;
+	const names = Object.entries(intents).filter(([, value]) => value === true).map(([name]) => name.replace(/^is_/, ""));
+	return {
+		...row,
+		intents: names.join(" ") || 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))}`;
@@ -38382,6 +38858,198 @@ async function runRows(input, deps) {
 		}
 	};
 }
+const QUESTION_DAYS = 90;
+const list = (value) => Array.isArray(value) ? value : [];
+const urls = (items) => items.map((item) => item.url).filter((url) => typeof url === "string");
+const overview = (result) => {
+	const block = list(result.items).find((item) => item.type === "ai_overview");
+	if (!block) return null;
+	const parts = list(block.items);
+	return {
+		markdown: typeof block.markdown === "string" ? block.markdown : parts.map((part) => String(part.markdown ?? "")).join("\n"),
+		sources: urls([...list(block.references), ...parts.flatMap((part) => list(part.references))]),
+		model: null
+	};
+};
+const ENGINES = [
+	{
+		name: "chatgpt",
+		means: "a ChatGPT search, read by DataForSEO",
+		path: "v3/ai_optimization/chat_gpt/llm_scraper/live/advanced",
+		languages: "v3/ai_optimization/chat_gpt/llm_scraper/languages",
+		task: (question, market) => ({
+			keyword: question,
+			...market
+		}),
+		shown: (result) => {
+			const markdown = typeof result.markdown === "string" ? result.markdown : "";
+			const sources = urls(list(result.sources));
+			if (!markdown && !sources.length) return null;
+			return {
+				markdown,
+				sources,
+				model: typeof result.model === "string" ? result.model : null
+			};
+		}
+	},
+	{
+		name: "google_ai_mode",
+		means: "Google AI Mode",
+		path: "v3/serp/google/ai_mode/live/advanced",
+		languages: "v3/serp/google/ai_mode/languages",
+		task: (question, market) => ({
+			keyword: question,
+			...market
+		}),
+		shown: overview
+	},
+	{
+		name: "google_ai_overview",
+		means: "the AI Overview on a Google search",
+		path: "v3/serp/google/organic/live/advanced",
+		languages: "v3/serp/google/languages",
+		task: (question, market) => ({
+			keyword: question,
+			depth: 10,
+			load_async_ai_overview: true,
+			...market
+		}),
+		shown: overview
+	}
+];
+function prose(markdown) {
+	return markdown.replace(/\[([^\]]*)\]\(https?:\/\/[^)]*\)/g, (_, label) => /^\s*(\d+|[\w-]+(\.[\w-]+)+)\s*$/.test(label) ? " " : label).replace(/https?:\/\/\S+/g, " ");
+}
+function onSite(url, domain) {
+	try {
+		const host = new URL(url).hostname.toLowerCase();
+		return host === domain || host.endsWith(`.${domain}`);
+	} catch {
+		return false;
+	}
+}
+async function ask(keys, engine, question, market, site) {
+	if (typeof market === "string") return {
+		result: "unavailable",
+		model: null,
+		cited_url: null,
+		answered_at: null,
+		cost_usd: 0,
+		error: market
+	};
+	try {
+		const done = await dataForSeoTask(keys, engine.path, engine.task(question, market));
+		const answered = {
+			answered_at: String(done.result?.datetime ?? "").slice(0, 10) || null,
+			cost_usd: done.cost
+		};
+		const shown = done.result && engine.shown(done.result);
+		if (!shown) return {
+			result: "no_answer",
+			model: null,
+			cited_url: null,
+			...answered
+		};
+		const base = {
+			model: shown.model,
+			...answered
+		};
+		const linked = shown.markdown.match(/https?:\/\/[^\s)\]]+/g) ?? [];
+		const cited = [...shown.sources, ...linked].find((url) => onSite(url, site.domain));
+		if (cited) return {
+			result: "cited",
+			cited_url: cited,
+			...base
+		};
+		const text = prose(shown.markdown);
+		return {
+			result: text.toLowerCase().includes(site.domain) || isBrandQuery(text, site.terms) ? "mentioned" : "neither",
+			cited_url: null,
+			...base
+		};
+	} catch (error) {
+		if (error instanceof CommandError && error.code === "NO_KEY") throw error;
+		return {
+			result: "unavailable",
+			model: null,
+			cited_url: null,
+			answered_at: null,
+			cost_usd: error.cost ?? 0,
+			error: error instanceof Error ? error.message.slice(0, 200) : "failed"
+		};
+	}
+}
+async function marketsFor(keys, country) {
+	const code = country.toUpperCase();
+	const language = dataForSeoLanguage(country) ?? dataForSeoMarket(country, null).language_code;
+	const [locations, ...languages] = await Promise.all([dataForSeoList(keys, "v3/ai_optimization/chat_gpt/llm_scraper/locations"), ...ENGINES.map((engine) => dataForSeoList(keys, engine.languages))]);
+	const place = locations.find((row) => row.location_type === "Country" && row.country_iso_code === code);
+	const where = place ? { location_code: Number(place.location_code) } : { location_name: dataForSeoMarket(country, null).location_name };
+	return new Map(ENGINES.map((engine, index) => {
+		if (engine.name === "chatgpt" && !place) return [engine.name, `DataForSEO's ChatGPT search has no data for country "${country}".`];
+		const known = (languages[index] ?? []).some((row) => row.language_code === language);
+		return [engine.name, known ? {
+			...where,
+			language_code: language
+		} : `DataForSEO's ${engine.name} has no "${language}" language, the language used for country "${country}".`];
+	}));
+}
+const usd = (value) => Math.round(value * 1e4) / 1e4;
+async function runAiAnswers(input, headers, deps, more) {
+	const keys = dataForSeoKeys(headers);
+	const domain = registrableDomain(input.site)?.domain;
+	if (!domain) throw new CommandError("INVALID_INPUT", `ai_answers needs a site with a domain, not "${input.site}".`);
+	const range = dateWindow({}, QUESTION_DAYS);
+	const questions = ((await aiQueriesReport({
+		site: input.site,
+		...range
+	}, deps.searchAnalytics)).items ?? []).filter((item) => item.askable).slice(0, 10);
+	const site = {
+		domain,
+		terms: deriveBrandTerms({ siteUrl: input.site })
+	};
+	const markets = questions.length ? await marketsFor(keys, input.country) : /* @__PURE__ */ new Map();
+	const answers = await Promise.all(questions.flatMap((question) => ENGINES.map(async (engine) => ({
+		question: question.query,
+		impressions: question.impressions,
+		engine: engine.name,
+		...await ask(keys, engine, question.query, markets.get(engine.name) ?? "no market", site)
+	}))));
+	const cost = usd(answers.reduce((sum, row) => sum + row.cost_usd, 0));
+	const count = (result) => answers.filter((row) => row.result === result).length;
+	const notes = [questions.length ? `The top ${questions.length} askable questions in Search Console’s AI-shaped queries for ${range.startDate} to ${range.endDate}, by impressions. No calls were made for other questions.` : `No askable questions in Search Console’s AI-shaped queries for ${range.startDate} to ${range.endDate}, so no answers were checked and nothing was spent.`, ...questions.length ? [
+		`Cited ${count("cited")}, mentioned ${count("mentioned")}, neither ${count("neither")}, no answer shown ${count("no_answer")}, unavailable ${count("unavailable")}. DataForSEO cost: $${cost}.`,
+		"Each row is one sample of an answer that changes from run to run, not a ranking.",
+		`cited: the answer lists or links a page on ${domain} or a subdomain. mentioned: no such source, but the answer text names ${[domain, ...site.terms].join(" or ")}, a text match. no_answer: the engine showed no AI answer for the question. model: the model DataForSEO reports for the answer, when it reports one.`,
+		`Engines: ${ENGINES.map((engine) => `${engine.name} is ${engine.means}`).join("; ")}.`
+	] : []];
+	return {
+		text: rowsText({
+			title: `AI answers for ${input.site}, ${input.country}.`,
+			rows: answers,
+			offset: input.offset,
+			limit: 50,
+			detail: input.detail,
+			notes,
+			more
+		}),
+		data: {
+			provider: "dataforseo",
+			action: "ai_answers",
+			site: input.site,
+			country: input.country,
+			questionsFrom: {
+				section: "ai-queries",
+				...range
+			},
+			questions: questions.map((question) => question.query),
+			costUsd: cost,
+			total: answers.length,
+			offset: input.offset,
+			rows: answers.slice(input.offset, input.offset + 50)
+		}
+	};
+}
 //#endregion
 //#region packages/core/dist/commands/analytics.js
 async function analyticsSignIn(accounts, property, signIn) {
@@ -39446,196 +40114,6 @@ function temporaryRedirectNote(pages) {
 	return `Note: 302 and 307 are temporary redirects; a permanent move usually uses 301 or 308. Temporary redirects here: ${temporary.map((page) => `${page.url} (${page.status} to ${page.redirects_to})`).join("; ")}.`;
 }
 //#endregion
-//#region packages/core/dist/analyze/ai-queries.js
-const RULES = [
-	["agent_prompt", "^(search the web for|browse the web|find sources)|do not invent|return the [0-9]+ most relevant|include source urls|context: location|do not include location|question: "],
-	["tracker", "\\. ?my location is |^evaluate the .+ on "],
-	["reply", "^(yes|yeah|yep|ok|okay|sure|yes please|go on|continue|keep going|tell me more|why not|how so|really|exactly|show me|and then|thanks|thank you|got it|what else|anything else)[?!.,]*$"],
-	["follow_up", "^(what|how) about .{1,40}$|^(and|so|ok so|okay so|but) (what|which|how|why) "],
-	["operator", "(^|\\s)-?(site|before|after|intitle|inurl|intext|filetype):|\"[^\"]*\" or \""],
-	["chat", "\\b(please|can you|could you|give me|show me|tell me|i want|i need|i have|i am|should i|do i need|is it worth|help me|walk me through)\\b|^(what|how|why|is|does|can|will|would) (it|that|this|they)\\b"],
-	["long", "^(\\S+\\s+){9,}\\S+$"]
-];
-const AI_QUERY_KINDS = {
-	agent_prompt: "text from an agent prompt, such as \"search the web for\"",
-	tracker: "a visibility-tool probe, such as \"my location is\"",
-	reply: "a bare reply, such as \"yes\" or \"tell me more\"",
-	follow_up: "a follow-up, such as \"what about …\"",
-	operator: "search operators, such as site:, before: or \"a\" or \"b\"",
-	chat: "chat phrasing, such as \"can you\" or \"should i\"",
-	long: "ten or more words with no other sign"
-};
-const MATCHERS = RULES.map(([kind, pattern]) => [kind, new RegExp(pattern)]);
-const AI_QUERY_PATTERN = RULES.map(([, pattern]) => `(?:${pattern})`).join("|");
-function aiQueryKind(query) {
-	const text = query.trim().toLowerCase();
-	return MATCHERS.find(([, pattern]) => pattern.test(text))?.[0] ?? null;
-}
-const STOP = new Set("the and for with that this what which who how why when where are is was can does do did you your our from about into than then them they their there have has had will would should could not but its it’s me my i am of to in on at by or an as be if so".split(" "));
-function words(query) {
-	return new Set(query.toLowerCase().split(/[^\p{L}\p{N}]+/u).filter((word) => word.length >= 3 && !STOP.has(word)).map((word) => word.length > 4 && word.endsWith("s") ? word.slice(0, -1) : word));
-}
-const SAME_QUESTION = .6;
-const MAX_ROWS = 25e3;
-const EXAMPLES = 3;
-const CANDIDATES = 200;
-const overlap = (a, b, weight) => {
-	let shared = 0;
-	let union = 0;
-	for (const word of a) {
-		union += weight(word);
-		if (b.has(word)) shared += weight(word);
-	}
-	for (const word of b) if (!a.has(word)) union += weight(word);
-	return union ? shared / union : 0;
-};
-const round = (value, places) => Math.round(value * 10 ** places) / 10 ** places;
-async function aiQueriesReport(input, searchAnalytics) {
-	const range = {
-		startDate: input.startDate,
-		endDate: input.endDate
-	};
-	const [matched, site] = await Promise.all([searchAnalytics(input.site, {
-		...range,
-		dimensions: ["query", "page"],
-		type: "web",
-		dataState: "final",
-		maxRows: MAX_ROWS,
-		dimensionFilterGroups: [{ filters: [{
-			dimension: "query",
-			operator: "includingRegex",
-			expression: AI_QUERY_PATTERN
-		}] }]
-	}), searchAnalytics(input.site, {
-		...range,
-		dimensions: [],
-		type: "web",
-		dataState: "final"
-	})]);
-	const rows = [...matched.rows].sort((a, b) => b.impressions - a.impressions || String(a.keys[0]).localeCompare(String(b.keys[0])) || String(a.keys[1]).localeCompare(String(b.keys[1])));
-	const usage = /* @__PURE__ */ new Map();
-	const unique = new Set(rows.map((row) => String(row.keys[0] ?? "")));
-	for (const query of unique) for (const word of words(query)) usage.set(word, (usage.get(word) ?? 0) + 1);
-	const weight = (word) => Math.log((unique.size + 1) / (usage.get(word) ?? 1));
-	const groups = [];
-	const byWord = /* @__PURE__ */ new Map();
-	const byText = /* @__PURE__ */ new Map();
-	const kindOf = /* @__PURE__ */ new Map();
-	for (const row of rows) {
-		const query = String(row.keys[0] ?? "");
-		const page = String(row.keys[1] ?? "");
-		const kind = aiQueryKind(query);
-		if (!kind) continue;
-		const text = query.trim().toLowerCase();
-		const own = words(query);
-		let group = byText.get(text);
-		if (!group) {
-			let checked = 0;
-			for (const word of own) {
-				for (const candidate of byWord.get(word) ?? []) {
-					if (++checked > CANDIDATES) break;
-					if (overlap(own, candidate.words, weight) >= SAME_QUESTION) {
-						group = candidate;
-						break;
-					}
-				}
-				if (group || checked > CANDIDATES) break;
-			}
-		}
-		if (!group) {
-			group = {
-				words: own,
-				queries: /* @__PURE__ */ new Map(),
-				pages: /* @__PURE__ */ new Map(),
-				kinds: /* @__PURE__ */ new Map(),
-				clicks: 0,
-				impressions: 0,
-				positionWeight: 0
-			};
-			groups.push(group);
-			for (const word of own) {
-				const list = byWord.get(word) ?? [];
-				list.push(group);
-				byWord.set(word, list);
-			}
-		}
-		byText.set(text, group);
-		if (!kindOf.has(text)) {
-			kindOf.set(text, kind);
-			group.kinds.set(kind, (group.kinds.get(kind) ?? 0) + 1);
-		}
-		group.queries.set(query, (group.queries.get(query) ?? 0) + row.impressions);
-		group.pages.set(page, (group.pages.get(page) ?? 0) + row.impressions);
-		group.clicks += row.clicks;
-		group.impressions += row.impressions;
-		group.positionWeight += row.position * row.impressions;
-	}
-	const byKind = /* @__PURE__ */ new Map();
-	for (const kind of kindOf.values()) {
-		const entry = byKind.get(kind) ?? {
-			queries: 0,
-			impressions: 0
-		};
-		entry.queries += 1;
-		byKind.set(kind, entry);
-	}
-	for (const row of rows) {
-		const kind = kindOf.get(String(row.keys[0] ?? "").trim().toLowerCase());
-		const entry = kind && byKind.get(kind);
-		if (entry) entry.impressions += row.impressions;
-	}
-	const queries = kindOf.size;
-	const impressions = groups.reduce((sum, g) => sum + g.impressions, 0);
-	const clicks = groups.reduce((sum, g) => sum + g.clicks, 0);
-	const total = site.rows[0] ?? {
-		clicks: 0,
-		impressions: 0
-	};
-	const items = groups.map((group) => {
-		const most = (map) => [...map].sort((a, b) => b[1] - a[1] || a[0].localeCompare(b[0])).map(([name]) => name);
-		const [first, ...rest] = most(group.queries);
-		const kind = [...group.kinds].sort((a, b) => b[1] - a[1] || a[0].localeCompare(b[0]))[0]?.[0];
-		return {
-			query: first ?? "",
-			page: most(group.pages)[0] ?? "",
-			pages: group.pages.size,
-			kind,
-			wordings: group.queries.size,
-			impressions: group.impressions,
-			clicks: group.clicks,
-			ctr: group.impressions ? round(group.clicks / group.impressions, 4) : 0,
-			position: group.impressions ? round(group.positionWeight / group.impressions, 1) : 0,
-			otherWordings: rest.slice(0, EXAMPLES)
-		};
-	}).sort((a, b) => b.impressions - a.impressions || b.wordings - a.wordings || a.query.localeCompare(b.query) || a.page.localeCompare(b.page));
-	const pct = (part, whole) => whole ? round(part / whole * 100, 1) : null;
-	const kinds = [...byKind].sort((a, b) => b[1].impressions - a[1].impressions || a[0].localeCompare(b[0])).map(([kind, entry]) => `${kind} ${entry.queries}`).join(", ");
-	const capped = matched.rowsFetched >= MAX_ROWS;
-	return {
-		range,
-		verdict: queries ? `${queries} queries in ${groups.length} questions have the shape of AI conversations or agent searches.` : "No queries with the shape of AI conversations or agent searches.",
-		summary: {
-			queries,
-			questions: groups.length,
-			impressions,
-			clicks,
-			shareOfImpressionsPct: pct(impressions, total.impressions),
-			ctr: impressions ? round(clicks / impressions, 4) : 0,
-			siteCtr: total.impressions ? round(total.clicks / total.impressions, 4) : 0,
-			byKind: kinds || "none"
-		},
-		kinds: AI_QUERY_KINDS,
-		items,
-		caveats: [
-			"A heuristic: these queries match the patterns of AI conversations and agent searches. Search Console does not mark AI Mode or AI Overviews, and people type some of these too.",
-			"A minimum: Search Console leaves out rare queries, and these are rare by nature.",
-			"Rewordings of one question are grouped by their shared words; page is the page with the most impressions for it.",
-			"Search Console’s Generative AI report is not in its API, so it is not here.",
-			...capped ? [`Capped at the first ${MAX_ROWS} matching query and page rows.`] : []
-		]
-	};
-}
-//#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, and Google Analytics sessions for the same dates from the property whose web stream matches the site.",
@@ -39681,7 +40159,7 @@ function nextFor(section, call) {
 		"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; ${call("index")} for pages that lost almost all their clicks and their index status.`,
-		"ai-queries": `Next: ${call("page")} for a page that gets many of these questions, to see whether it answers them.`,
+		"ai-queries": `Next: ${call("page")} for a page that gets many of these questions, to see whether it answers them; ${call("research")} ai_answers with the site as target checks whether AI answers cite it for the top 10 askable questions here (about $0.12 of DataForSEO credit), so show the person those questions and ask first.`,
 		bing: `Next: ${call("data", { source: "bing" })} for every Bing row; ${call("page")} for one page.`
 	}[section];
 }
@@ -40120,225 +40598,17 @@ async function runBingReport(input, deps) {
 	};
 }
 //#endregion
-//#region packages/core/dist/commands/research-providers.js
-function need(headers, provider) {
-	const values = provider === "dataforseo" ? [headers.get("x-dataforseo-login"), headers.get("x-dataforseo-password")] : [headers.get("x-ahrefs-key")];
-	if (values.some((value) => !value)) throw new CommandError("NO_KEY", `No ${provider} key. Hosted MCP: save it at https://seoskill.dev/account#keys. CLI and local MCP: run \`seo login\` to use the account's keys, or \`seo providers ${provider} connect\`.`);
-	return values;
-}
-async function call(provider, request) {
-	const response = await fetch(request);
-	if (response.ok) return response;
-	const text = (await response.text()).slice(0, 300);
-	throw new CommandError(response.status === 401 || response.status === 403 ? "NO_KEY" : "PROVIDER_ERROR", `${provider} answered ${response.status}. ${text}`);
-}
-function requireInput(input) {
-	const needsKeywords = input.action === "keyword_metrics" || input.action === "serp";
-	if (needsKeywords && input.keywords.length === 0) throw new CommandError("INVALID_INPUT", `${input.action} needs keywords.`);
-	if (!needsKeywords && !input.target) throw new CommandError("INVALID_INPUT", `${input.action} needs a target domain or URL.`);
-}
-async function research(provider, headers, input) {
-	requireInput(input);
-	const keys = need(headers, provider);
-	if (provider === "dataforseo") return dataForSeo(keys, input);
-	return ahrefs(keys[0] ?? "", input);
-}
-function countryName(code) {
-	return new Intl.DisplayNames("en", { type: "region" }).of(code.toUpperCase()) ?? "United States";
-}
-function mainLanguage(country) {
-	try {
-		return new Intl.Locale(`und-${country.toUpperCase()}`).maximize().language;
-	} catch {
-		return "en";
-	}
-}
-const LABS_LANGUAGES = new Map(`
-  ae:ar al:sq am:hy ao:pt ar:es at:de au:en az:az ba:bs bd:bn be:nl bf:fr
-  bg:bg bh:ar bo:es br:pt ca:en ch:de ci:fr cl:es cm:fr co:es cr:es cy:el
-  cz:cs de:de dk:da dz:ar ec:es ee:et eg:ar es:es fi:fi fr:fr gb:en gh:en
-  gr:el gt:es hk:en hr:hr hu:hu id:id ie:en il:he in:en it:it jo:ar jp:ja
-  ke:en kh:en kr:ko kz:ru lk:en lt:lt lv:lv ma:ar mc:fr md:ro mk:mk mm:en
-  mt:en mx:es my:en ng:en ni:es nl:nl no:nb nz:en pa:es pe:es ph:en pk:en
-  pl:pl pt:pt py:es ro:ro rs:sr sa:ar se:sv sg:en si:sl sk:sk sn:fr sv:es
-  th:th tn:ar tr:tr tw:zh-TW ua:uk us:en uy:es ve:es vn:vi za:en
-`.trim().split(/\s+/).map((pair) => pair.split(":")));
-function dataForSeoLanguage(country) {
-	return LABS_LANGUAGES.get(country.toLowerCase()) ?? null;
-}
-async function dataForSeo([login, password], input) {
-	const language = dataForSeoLanguage(input.country);
-	if (!language && input.action !== "serp" && input.action !== "backlinks") throw new CommandError("INVALID_INPUT", `DataForSEO has no ${input.action} data for country "${input.country}".`);
-	const market = {
-		location_name: countryName(input.country),
-		language_code: language ?? mainLanguage(input.country)
-	};
-	const post = async (path, task) => {
-		const result = (await readJson(await call("dataforseo", new Request(`https://api.dataforseo.com/${path}`, {
-			method: "POST",
-			headers: {
-				authorization: `Basic ${btoa(`${login}:${password}`)}`,
-				"content-type": "application/json"
-			},
-			body: JSON.stringify([{
-				...market,
-				...task
-			}])
-		})), "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 ?? [];
-	};
-	const get = (value, path) => path.split(".").reduce((current, key) => current && typeof current === "object" ? current[key] : void 0, value);
-	const pick = (item, fields) => Object.fromEntries(Object.entries(fields).map(([name, path]) => [name, get(item, path) ?? null]));
-	if (input.action === "keyword_metrics") return (await post("v3/dataforseo_labs/google/keyword_overview/live", { keywords: input.keywords.slice(0, 700) })).map((item) => pick(item, {
-		keyword: "keyword",
-		search_volume: "keyword_info.search_volume",
-		keyword_difficulty: "keyword_properties.keyword_difficulty",
-		cpc: "keyword_info.cpc",
-		competition: "keyword_info.competition",
-		main_intent: "search_intent_info.main_intent"
-	}));
-	if (input.action === "ranked_keywords") return (await post("v3/dataforseo_labs/google/ranked_keywords/live", {
-		target: bareTarget(input.target),
-		limit: input.limit,
-		order_by: ["ranked_serp_element.serp_item.etv,desc"]
-	})).map((item) => pick(item, {
-		keyword: "keyword_data.keyword",
-		position: "ranked_serp_element.serp_item.rank_absolute",
-		url: "ranked_serp_element.serp_item.url",
-		search_volume: "keyword_data.keyword_info.search_volume",
-		etv: "ranked_serp_element.serp_item.etv",
-		keyword_difficulty: "keyword_data.keyword_properties.keyword_difficulty",
-		main_intent: "keyword_data.search_intent_info.main_intent"
-	}));
-	if (input.action === "serp") {
-		const rows = [];
-		for (const keyword of input.keywords.slice(0, 5)) {
-			const items = await post("v3/serp/google/organic/live/advanced", {
-				keyword,
-				depth: Math.min(input.limit, 100)
-			});
-			for (const item of items) {
-				if (item.type !== "organic") continue;
-				rows.push({
-					keyword,
-					...pick(item, {
-						position: "rank_absolute",
-						url: "url",
-						domain: "domain",
-						title: "title"
-					})
-				});
-			}
-		}
-		return rows;
-	}
-	if (input.action === "backlinks") return (await post("v3/backlinks/referring_domains/live", {
-		target: bareTarget(input.target),
-		limit: input.limit,
-		order_by: ["rank,desc"]
-	})).map((item) => pick(item, {
-		domain: "domain",
-		rank: "rank",
-		backlinks: "backlinks",
-		referring_pages: "referring_pages",
-		first_seen: "first_seen"
-	}));
-	return (await post("v3/dataforseo_labs/google/competitors_domain/live", {
-		target: bareTarget(input.target),
-		limit: input.limit
-	})).map((item) => pick(item, {
-		domain: "domain",
-		shared_keywords: "intersections",
-		avg_position: "avg_position",
-		organic_keywords: "full_domain_metrics.organic.count",
-		organic_etv: "full_domain_metrics.organic.etv"
-	}));
-}
-function isPage(target) {
-	return /\/./.test(bareTarget(target));
-}
-function bareTarget(target) {
-	return target.replace(/^https?:\/\//, "").replace(/\/$/, "");
-}
-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 readJson(await call("ahrefs", new Request(url, { headers: {
-			authorization: `Bearer ${key}`,
-			accept: "application/json"
-		} })), "Ahrefs");
-	};
-	const today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
-	if (input.action === "keyword_metrics") return ((await get("keywords-explorer/overview", {
-		select: "keyword,volume,difficulty,cpc,traffic_potential,intents",
-		country: input.country,
-		keywords: input.keywords.slice(0, 100).join(",")
-	})).keywords ?? []).map(flattenIntents);
-	if (input.action === "ranked_keywords") return (await get("site-explorer/organic-keywords", {
-		select: "keyword,best_position,best_position_url,volume,sum_traffic,keyword_difficulty,cpc",
-		target: input.target,
-		country: input.country,
-		date: today,
-		mode: isPage(input.target) ? "exact" : "subdomains",
-		limit: String(input.limit),
-		order_by: "sum_traffic:desc"
-	})).keywords ?? [];
-	if (input.action === "serp") {
-		const rows = [];
-		for (const keyword of input.keywords.slice(0, 5)) {
-			const data = await get("serp-overview/serp-overview", {
-				select: "position,type,url,title,domain_rating,traffic,keywords",
-				keyword,
-				country: input.country,
-				top_positions: String(Math.min(input.limit, 100))
-			});
-			for (const row of data.positions ?? []) rows.push({
-				keyword,
-				...row
-			});
-		}
-		return rows;
-	}
-	if (input.action === "backlinks") return (await get("site-explorer/refdomains", {
-		select: "domain,domain_rating,links_to_target,dofollow_links,first_seen,last_seen",
-		target: input.target,
-		mode: isPage(input.target) ? "exact" : "subdomains",
-		history: "live",
-		limit: String(input.limit),
-		order_by: "domain_rating:desc"
-	})).refdomains ?? [];
-	return (await get("site-explorer/organic-competitors", {
-		select: "competitor_domain,keywords_common,keywords_competitor,keywords_target,share,traffic,domain_rating",
-		target: input.target,
-		country: input.country,
-		date: today,
-		mode: "subdomains",
-		limit: String(input.limit),
-		order_by: "keywords_common:desc"
-	})).competitors ?? [];
-}
-function flattenIntents(row) {
-	const intents = row.intents;
-	if (!intents || typeof intents !== "object") return row;
-	const names = Object.entries(intents).filter(([, value]) => value === true).map(([name]) => name.replace(/^is_/, ""));
-	return {
-		...row,
-		intents: names.join(" ") || null
-	};
-}
-//#endregion
 //#region packages/core/dist/commands/research.js
 const RESEARCH_ACTIONS = [
 	"keyword_metrics",
 	"ranked_keywords",
 	"serp",
 	"competitors",
-	"backlinks"
+	"backlinks",
+	"ai_answers"
 ];
 const RESEARCH_PROVIDERS = ["dataforseo", "ahrefs"];
-const RESEARCH_HELP = "keyword_metrics (keywords: volume, difficulty, CPC), ranked_keywords (target: keywords a domain or URL ranks for), serp (keywords, up to 5: the ranking pages), competitors (target: domains that share keywords), backlinks (target: referring domains). Rows with a domain, and the target, get a free Ahrefs domain_rating column. Numbers are provider estimates, not Search Console data.";
+const RESEARCH_HELP = `keyword_metrics (keywords: volume, difficulty, CPC), ranked_keywords (target: keywords a domain or URL ranks for), serp (keywords, up to 5: the ranking pages), competitors (target: domains that share keywords), backlinks (target: referring domains), ai_answers (DataForSEO only; target: the site. It takes the site’s top 10 chat-style and long questions from Search Console’s AI-shaped queries itself, then asks ChatGPT search, Google AI Mode and Google AI Overviews each one and says whether the answer cites or mentions the site. DataForSEO’s live prices are $0.012 a question, so up to about $0.12 a run: tell the person before running it). Rows with a domain, and the target, get a free Ahrefs domain_rating column. Numbers are provider estimates, not Search Console data.`;
 const GENERIC_PLATFORMS = [
 	"youtube.com",
 	"facebook.com",
@@ -40381,7 +40651,8 @@ async function runResearch(input, keys, options) {
 	const target = input.target ?? "";
 	const offset = input.offset ?? 0;
 	const language = input.provider === "dataforseo" ? dataForSeoLanguage(country) : null;
-	const found = await research(input.provider, keys, {
+	if (input.action === "ai_answers") throw new CommandError("INVALID_INPUT", "ai_answers runs on its own.");
+	const { rows: found, costUsd, partial } = await research(input.provider, keys, {
 		action: input.action,
 		keywords: input.keywords ?? [],
 		target,
@@ -40405,6 +40676,8 @@ async function runResearch(input, keys, options) {
 			detail: input.detail ?? "summary",
 			notes: [
 				`${input.provider} estimates, in the provider’s own units.`,
+				...costUsd !== null ? [`DataForSEO cost: $${costUsd}.`] : [],
+				...partial ? ["Partial: DataForSEO could not fetch some pages of results, so rows may be missing."] : [],
 				...note ? [note] : [],
 				...hasTargetDr ? [`${bareDomain(target)} domain_rating: ${targetDr}.`] : [],
 				...rated.added || hasTargetDr ? [DR_ATTRIBUTION] : []
@@ -40420,6 +40693,8 @@ async function runResearch(input, keys, options) {
 			targetDomainRating: hasTargetDr ? targetDr : null,
 			attribution: rated.added || hasTargetDr ? DR_ATTRIBUTION : null,
 			leftOut: note,
+			costUsd,
+			partial,
 			total: rated.rows.length,
 			offset,
 			rows: rated.rows.slice(offset, offset + 50)
@@ -40832,7 +41107,7 @@ const SHARED_TOOLS = [
 	tool({
 		name: "seo_research",
 		command: "research",
-		title: "Keyword, competitor and backlink data",
+		title: "Keyword, competitor, backlink and AI answer data",
 		description: `Data from the person’s own DataForSEO or Ahrefs account, which costs them credits. It uses the key the person saved on their seoskill.dev account (or on this machine for the CLI). Actions: ${RESEARCH_HELP}`,
 		input: z.object({
 			provider: z.enum(RESEARCH_PROVIDERS),
@@ -40842,10 +41117,22 @@ const SHARED_TOOLS = [
 			country: z.string().regex(/^[a-z]{2}$/).default("us").describe("Two-letter country code."),
 			...detail
 		}),
-		run: async (surface, input) => runResearch(input, await surface.keys(), {
-			drKey: surface.drKey,
-			call: (offset) => `seo_research with the same input, detail "rows", offset ${offset}`
-		})
+		run: async (surface, input) => {
+			const more = (offset) => `seo_research with the same input, detail "rows", offset ${offset}`;
+			if (input.action === "ai_answers") {
+				if (input.provider !== "dataforseo") throw new CommandError("INVALID_INPUT", "ai_answers uses dataforseo.");
+				return runAiAnswers({
+					site: await surface.resolveSite(input.target),
+					country: input.country,
+					detail: input.detail,
+					offset: input.offset
+				}, await surface.keys(), surface.deps, more);
+			}
+			return runResearch(input, await surface.keys(), {
+				drKey: surface.drKey,
+				call: more
+			});
+		}
 	}),
 	tool({
 		name: "seo_data",
@@ -40919,7 +41206,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.`;
+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, and whether AI answers cite the site, 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);