seo 0.8.3 → 0.9.0

package/dist/index.d.ts

@@ -21332,6 +21332,12 @@ declare function finishCloudLogin(): Promise<'linked' | 'pending' | 'expired'>;
 declare function cloudLogout(): Promise<boolean>;
 declare function openCloudLink(url: string): Promise<void>;
 //#endregion
+//#region packages/core/src/commands/sites.d.ts
+type GoogleAccount = {
+  email: string | null;
+  google: GoogleFetch;
+};
+//#endregion
 //#region packages/core/src/commands/analytics-site.d.ts
 type AnalyticsAccess = {
   accounts: () => Promise<GoogleAccount[]>;
@@ -21358,7 +21364,7 @@ declare const COMMANDS: {
   };
   readonly research: {
     readonly where: "anywhere";
-    readonly summary: "Keyword metrics, ranked keywords, SERPs, competitors and backlinks from DataForSEO or Ahrefs.";
+    readonly summary: "Keyword metrics, ranked keywords, SERPs, competitors and backlinks from DataForSEO or Ahrefs, and whether AI answers cite the site.";
   };
   readonly data: {
     readonly where: "anywhere";
@@ -21413,12 +21419,6 @@ type PageMarkdown = {
   error: string;
 };
 //#endregion
-//#region packages/core/src/commands/sites.d.ts
-type GoogleAccount = {
-  email: string | null;
-  google: GoogleFetch;
-};
-//#endregion
 //#region packages/core/src/storage/config.d.ts
 type TokenStorageMode = 'keychain' | 'file';
 type TokenStorageStatus = {

package/dist/index.js

@@ -1,5 +1,5 @@
 import { createRequire as __seoCreateRequire } from 'node:module'; const require = __seoCreateRequire(import.meta.url);
-import { n as version, t as load } from "./esm-BZhSLbcQ.js";
+import { n as version, t as load } from "./esm-gP6ovS6b.js";
 import { SEO_PROVIDER_API_VERSION } from "./provider-sdk.js";
 import crypto, { createHash, randomUUID, sign } from "node:crypto";
 import { z } from "zod";
@@ -27559,6 +27559,30 @@ async function detectBrandTerms(input) {
 		candidates: ranked
 	};
 }
+//#endregion
+//#region packages/core/src/analyze/ai-queries.ts
+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+$"]
+];
+RULES.map(([kind, pattern]) => [kind, new RegExp(pattern)]);
+RULES.map(([, pattern]) => `(?:${pattern})`).join("|");
+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(" "));
+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(":")));
 const DIMENSIONS = [
 	"query",
 	"page",
@@ -27746,20 +27770,6 @@ function checkPages(urls) {
 	return Promise.all(urls.slice(0, MAX_PAGES).map(facts));
 }
 //#endregion
-//#region packages/core/src/analyze/ai-queries.ts
-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+$"]
-];
-RULES.map(([kind, pattern]) => [kind, new RegExp(pattern)]);
-RULES.map(([, pattern]) => `(?:${pattern})`).join("|");
-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(" "));
-//#endregion
 //#region packages/core/src/commands/report.ts
 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.",
@@ -27774,16 +27784,6 @@ const SECTIONS = {
 	bing: "Bing’s top queries from Bing Webmaster Tools with Google’s clicks, impressions and position for the same query beside them, and the same for pages."
 };
 const SECTION_IDS = Object.keys(SECTIONS);
-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(":")));
 //#endregion
 //#region packages/core/src/commands/research.ts
 const RESEARCH_ACTIONS = [
@@ -27791,9 +27791,11 @@ const RESEARCH_ACTIONS = [
 	"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), 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.`;
 //#endregion
 //#region packages/core/src/commands/site.ts
 function indexStatusFrom(result) {
@@ -27846,7 +27848,7 @@ z.object({}), `${Object.entries(SECTIONS).map(([id, text]) => `- ${id}: ${text}`
 }), `${LOST_PAGES_RULE}`, z.object({
 	site,
 	...dates
-}), z.object({
+}), `${RESEARCH_HELP}`, z.object({
 	provider: z.enum(RESEARCH_PROVIDERS),
 	action: z.enum(RESEARCH_ACTIONS),
 	keywords: z.array(z.string().min(1)).max(100).default([]),