seo 0.15.0 → 0.15.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 version, r as __commonJSMin, t as load } from "./esm-DieyhVZ-.js";
+import { i as __toESM, n as version, r as __commonJSMin, t as load } from "./esm-D12ZCG_1.js";
 import { createHash, randomUUID, sign } from "node:crypto";
 import { ZodOptional, z } from "zod";
 import { arch, homedir, platform, tmpdir, totalmem } from "node:os";
@@ -42378,8 +42378,15 @@ 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 given = [...new Set((input.questions ?? []).map((q) => q.trim()).filter(Boolean))];
+	if (given.length > 10) throw new CommandError("INVALID_INPUT", `ai_answers takes up to 10 questions, not ${given.length}.`);
 	const range = dateWindow({}, QUESTION_DAYS);
-	const questions = ((await aiQueriesReport({
+	let questions;
+	if (given.length) questions = given.map((query) => ({
+		query,
+		impressions: null
+	}));
+	else questions = ((await aiQueriesReport({
 		site: input.site,
 		...range
 	}, deps.searchAnalytics)).items ?? []).filter((item) => item.askable).slice(0, 10);
@@ -42396,7 +42403,7 @@ async function runAiAnswers(input, headers, deps, more) {
 	}))));
 	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 ? [
+	const notes = [given.length ? `The ${given.length} questions you gave, asked as written. Impressions are blank because they don't come from Search Console.` : 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.`,
@@ -42417,7 +42424,7 @@ async function runAiAnswers(input, headers, deps, more) {
 			action: "ai_answers",
 			site: input.site,
 			country: input.country,
-			questionsFrom: {
+			questionsFrom: given.length ? { section: "given" } : {
 				section: "ai-queries",
 				...range
 			},
@@ -45564,7 +45571,7 @@ const RESEARCH_ACTIONS = [
 	"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), 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 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. Without keywords it takes the site’s top 10 chat-style and long questions from Search Console’s AI-shaped queries itself. With up to 10 questions in keywords it asks those instead, and the target can be any domain, such as a competitor's. It 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",
@@ -46520,10 +46527,11 @@ const SHARED_TOOLS = [
 			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),
+					site: input.keywords.length ? input.target : await surface.resolveSite(input.target),
 					country: input.country,
 					detail: input.detail,
-					offset: input.offset
+					offset: input.offset,
+					questions: input.keywords
 				}, await surface.keys(), surface.deps, more);
 			}
 			return runResearch(input, await surface.keys(), {