seo 0.15.0 → 0.15.1

package/dist/index.d.ts

@@ -3668,10 +3668,10 @@ export declare const crawlPageSnapshotSchema: z.ZodObject<{
     raw: z.ZodString;
     resolved: z.ZodOptional<z.ZodString>;
     ignoredReason: z.ZodOptional<z.ZodEnum<{
-      "invalid-url": "invalid-url";
       "outside-head": "outside-head";
       "alternate-qualifier": "alternate-qualifier";
       fragment: "fragment";
+      "invalid-url": "invalid-url";
       "non-http-url": "non-http-url";
     }>>;
     streamedMetadata: z.ZodOptional<z.ZodLiteral<true>>;
@@ -4305,15 +4305,15 @@ export declare const crawlReportSummarySchema: z.ZodObject<{
   skippedUrls: z.ZodNumber;
   skipReasons: z.ZodArray<z.ZodObject<{
     reason: z.ZodEnum<{
+      "invalid-url": "invalid-url";
+      "robots-disallowed": "robots-disallowed";
+      "origin-backpressure": "origin-backpressure";
       "asset-url": "asset-url";
       "configured-exclusion": "configured-exclusion";
       "duplicate-normalization": "duplicate-normalization";
-      "invalid-url": "invalid-url";
       "memory-pressure": "memory-pressure";
       "off-origin": "off-origin";
-      "origin-backpressure": "origin-backpressure";
       "queue-safety-limit": "queue-safety-limit";
-      "robots-disallowed": "robots-disallowed";
       "robots-uncertain": "robots-uncertain";
       "legacy-unclassified": "legacy-unclassified";
     }>;
@@ -4471,15 +4471,15 @@ export declare const crawlReportSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     skippedUrls: z.ZodNumber;
     skipReasons: z.ZodArray<z.ZodObject<{
       reason: z.ZodEnum<{
+        "invalid-url": "invalid-url";
+        "robots-disallowed": "robots-disallowed";
+        "origin-backpressure": "origin-backpressure";
         "asset-url": "asset-url";
         "configured-exclusion": "configured-exclusion";
         "duplicate-normalization": "duplicate-normalization";
-        "invalid-url": "invalid-url";
         "memory-pressure": "memory-pressure";
         "off-origin": "off-origin";
-        "origin-backpressure": "origin-backpressure";
         "queue-safety-limit": "queue-safety-limit";
-        "robots-disallowed": "robots-disallowed";
         "robots-uncertain": "robots-uncertain";
         "legacy-unclassified": "legacy-unclassified";
       }>;
@@ -4851,10 +4851,10 @@ export declare const crawlReportSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
       raw: z.ZodString;
       resolved: z.ZodOptional<z.ZodString>;
       ignoredReason: z.ZodOptional<z.ZodEnum<{
-        "invalid-url": "invalid-url";
         "outside-head": "outside-head";
         "alternate-qualifier": "alternate-qualifier";
         fragment: "fragment";
+        "invalid-url": "invalid-url";
         "non-http-url": "non-http-url";
       }>>;
       streamedMetadata: z.ZodOptional<z.ZodLiteral<true>>;
@@ -5786,15 +5786,15 @@ export declare const crawlReportSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     skippedUrls: z.ZodNumber;
     skipReasons: z.ZodArray<z.ZodObject<{
       reason: z.ZodEnum<{
+        "invalid-url": "invalid-url";
+        "robots-disallowed": "robots-disallowed";
+        "origin-backpressure": "origin-backpressure";
         "asset-url": "asset-url";
         "configured-exclusion": "configured-exclusion";
         "duplicate-normalization": "duplicate-normalization";
-        "invalid-url": "invalid-url";
         "memory-pressure": "memory-pressure";
         "off-origin": "off-origin";
-        "origin-backpressure": "origin-backpressure";
         "queue-safety-limit": "queue-safety-limit";
-        "robots-disallowed": "robots-disallowed";
         "robots-uncertain": "robots-uncertain";
         "legacy-unclassified": "legacy-unclassified";
       }>;
@@ -6166,10 +6166,10 @@ export declare const crawlReportSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
       raw: z.ZodString;
       resolved: z.ZodOptional<z.ZodString>;
       ignoredReason: z.ZodOptional<z.ZodEnum<{
-        "invalid-url": "invalid-url";
         "outside-head": "outside-head";
         "alternate-qualifier": "alternate-qualifier";
         fragment: "fragment";
+        "invalid-url": "invalid-url";
         "non-http-url": "non-http-url";
       }>>;
       streamedMetadata: z.ZodOptional<z.ZodLiteral<true>>;
@@ -7101,15 +7101,15 @@ export declare const crawlReportSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     skippedUrls: z.ZodNumber;
     skipReasons: z.ZodArray<z.ZodObject<{
       reason: z.ZodEnum<{
+        "invalid-url": "invalid-url";
+        "robots-disallowed": "robots-disallowed";
+        "origin-backpressure": "origin-backpressure";
         "asset-url": "asset-url";
         "configured-exclusion": "configured-exclusion";
         "duplicate-normalization": "duplicate-normalization";
-        "invalid-url": "invalid-url";
         "memory-pressure": "memory-pressure";
         "off-origin": "off-origin";
-        "origin-backpressure": "origin-backpressure";
         "queue-safety-limit": "queue-safety-limit";
-        "robots-disallowed": "robots-disallowed";
         "robots-uncertain": "robots-uncertain";
         "legacy-unclassified": "legacy-unclassified";
       }>;
@@ -7481,10 +7481,10 @@ export declare const crawlReportSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
       raw: z.ZodString;
       resolved: z.ZodOptional<z.ZodString>;
       ignoredReason: z.ZodOptional<z.ZodEnum<{
-        "invalid-url": "invalid-url";
         "outside-head": "outside-head";
         "alternate-qualifier": "alternate-qualifier";
         fragment: "fragment";
+        "invalid-url": "invalid-url";
         "non-http-url": "non-http-url";
       }>>;
       streamedMetadata: z.ZodOptional<z.ZodLiteral<true>>;
@@ -8418,15 +8418,15 @@ export declare const crawlerSchemas: {
       skippedUrls: z.ZodNumber;
       skipReasons: z.ZodArray<z.ZodObject<{
         reason: z.ZodEnum<{
+          "invalid-url": "invalid-url";
+          "robots-disallowed": "robots-disallowed";
+          "origin-backpressure": "origin-backpressure";
           "asset-url": "asset-url";
           "configured-exclusion": "configured-exclusion";
           "duplicate-normalization": "duplicate-normalization";
-          "invalid-url": "invalid-url";
           "memory-pressure": "memory-pressure";
           "off-origin": "off-origin";
-          "origin-backpressure": "origin-backpressure";
           "queue-safety-limit": "queue-safety-limit";
-          "robots-disallowed": "robots-disallowed";
           "robots-uncertain": "robots-uncertain";
           "legacy-unclassified": "legacy-unclassified";
         }>;
@@ -8798,10 +8798,10 @@ export declare const crawlerSchemas: {
         raw: z.ZodString;
         resolved: z.ZodOptional<z.ZodString>;
         ignoredReason: z.ZodOptional<z.ZodEnum<{
-          "invalid-url": "invalid-url";
           "outside-head": "outside-head";
           "alternate-qualifier": "alternate-qualifier";
           fragment: "fragment";
+          "invalid-url": "invalid-url";
           "non-http-url": "non-http-url";
         }>>;
         streamedMetadata: z.ZodOptional<z.ZodLiteral<true>>;
@@ -9733,15 +9733,15 @@ export declare const crawlerSchemas: {
       skippedUrls: z.ZodNumber;
       skipReasons: z.ZodArray<z.ZodObject<{
         reason: z.ZodEnum<{
+          "invalid-url": "invalid-url";
+          "robots-disallowed": "robots-disallowed";
+          "origin-backpressure": "origin-backpressure";
           "asset-url": "asset-url";
           "configured-exclusion": "configured-exclusion";
           "duplicate-normalization": "duplicate-normalization";
-          "invalid-url": "invalid-url";
           "memory-pressure": "memory-pressure";
           "off-origin": "off-origin";
-          "origin-backpressure": "origin-backpressure";
           "queue-safety-limit": "queue-safety-limit";
-          "robots-disallowed": "robots-disallowed";
           "robots-uncertain": "robots-uncertain";
           "legacy-unclassified": "legacy-unclassified";
         }>;
@@ -10113,10 +10113,10 @@ export declare const crawlerSchemas: {
         raw: z.ZodString;
         resolved: z.ZodOptional<z.ZodString>;
         ignoredReason: z.ZodOptional<z.ZodEnum<{
-          "invalid-url": "invalid-url";
           "outside-head": "outside-head";
           "alternate-qualifier": "alternate-qualifier";
           fragment: "fragment";
+          "invalid-url": "invalid-url";
           "non-http-url": "non-http-url";
         }>>;
         streamedMetadata: z.ZodOptional<z.ZodLiteral<true>>;
@@ -11048,15 +11048,15 @@ export declare const crawlerSchemas: {
       skippedUrls: z.ZodNumber;
       skipReasons: z.ZodArray<z.ZodObject<{
         reason: z.ZodEnum<{
+          "invalid-url": "invalid-url";
+          "robots-disallowed": "robots-disallowed";
+          "origin-backpressure": "origin-backpressure";
           "asset-url": "asset-url";
           "configured-exclusion": "configured-exclusion";
           "duplicate-normalization": "duplicate-normalization";
-          "invalid-url": "invalid-url";
           "memory-pressure": "memory-pressure";
           "off-origin": "off-origin";
-          "origin-backpressure": "origin-backpressure";
           "queue-safety-limit": "queue-safety-limit";
-          "robots-disallowed": "robots-disallowed";
           "robots-uncertain": "robots-uncertain";
           "legacy-unclassified": "legacy-unclassified";
         }>;
@@ -11428,10 +11428,10 @@ export declare const crawlerSchemas: {
         raw: z.ZodString;
         resolved: z.ZodOptional<z.ZodString>;
         ignoredReason: z.ZodOptional<z.ZodEnum<{
-          "invalid-url": "invalid-url";
           "outside-head": "outside-head";
           "alternate-qualifier": "alternate-qualifier";
           fragment: "fragment";
+          "invalid-url": "invalid-url";
           "non-http-url": "non-http-url";
         }>>;
         streamedMetadata: z.ZodOptional<z.ZodLiteral<true>>;
@@ -12867,10 +12867,10 @@ export declare const crawlerSchemas: {
       raw: z.ZodString;
       resolved: z.ZodOptional<z.ZodString>;
       ignoredReason: z.ZodOptional<z.ZodEnum<{
-        "invalid-url": "invalid-url";
         "outside-head": "outside-head";
         "alternate-qualifier": "alternate-qualifier";
         fragment: "fragment";
+        "invalid-url": "invalid-url";
         "non-http-url": "non-http-url";
       }>>;
       streamedMetadata: z.ZodOptional<z.ZodLiteral<true>>;
@@ -13291,15 +13291,15 @@ export declare const crawlerJsonSchemas: {
       skippedUrls: z.ZodNumber;
       skipReasons: z.ZodArray<z.ZodObject<{
         reason: z.ZodEnum<{
+          "invalid-url": "invalid-url";
+          "robots-disallowed": "robots-disallowed";
+          "origin-backpressure": "origin-backpressure";
           "asset-url": "asset-url";
           "configured-exclusion": "configured-exclusion";
           "duplicate-normalization": "duplicate-normalization";
-          "invalid-url": "invalid-url";
           "memory-pressure": "memory-pressure";
           "off-origin": "off-origin";
-          "origin-backpressure": "origin-backpressure";
           "queue-safety-limit": "queue-safety-limit";
-          "robots-disallowed": "robots-disallowed";
           "robots-uncertain": "robots-uncertain";
           "legacy-unclassified": "legacy-unclassified";
         }>;
@@ -13671,10 +13671,10 @@ export declare const crawlerJsonSchemas: {
         raw: z.ZodString;
         resolved: z.ZodOptional<z.ZodString>;
         ignoredReason: z.ZodOptional<z.ZodEnum<{
-          "invalid-url": "invalid-url";
           "outside-head": "outside-head";
           "alternate-qualifier": "alternate-qualifier";
           fragment: "fragment";
+          "invalid-url": "invalid-url";
           "non-http-url": "non-http-url";
         }>>;
         streamedMetadata: z.ZodOptional<z.ZodLiteral<true>>;
@@ -14606,15 +14606,15 @@ export declare const crawlerJsonSchemas: {
       skippedUrls: z.ZodNumber;
       skipReasons: z.ZodArray<z.ZodObject<{
         reason: z.ZodEnum<{
+          "invalid-url": "invalid-url";
+          "robots-disallowed": "robots-disallowed";
+          "origin-backpressure": "origin-backpressure";
           "asset-url": "asset-url";
           "configured-exclusion": "configured-exclusion";
           "duplicate-normalization": "duplicate-normalization";
-          "invalid-url": "invalid-url";
           "memory-pressure": "memory-pressure";
           "off-origin": "off-origin";
-          "origin-backpressure": "origin-backpressure";
           "queue-safety-limit": "queue-safety-limit";
-          "robots-disallowed": "robots-disallowed";
           "robots-uncertain": "robots-uncertain";
           "legacy-unclassified": "legacy-unclassified";
         }>;
@@ -14986,10 +14986,10 @@ export declare const crawlerJsonSchemas: {
         raw: z.ZodString;
         resolved: z.ZodOptional<z.ZodString>;
         ignoredReason: z.ZodOptional<z.ZodEnum<{
-          "invalid-url": "invalid-url";
           "outside-head": "outside-head";
           "alternate-qualifier": "alternate-qualifier";
           fragment: "fragment";
+          "invalid-url": "invalid-url";
           "non-http-url": "non-http-url";
         }>>;
         streamedMetadata: z.ZodOptional<z.ZodLiteral<true>>;
@@ -15921,15 +15921,15 @@ export declare const crawlerJsonSchemas: {
       skippedUrls: z.ZodNumber;
       skipReasons: z.ZodArray<z.ZodObject<{
         reason: z.ZodEnum<{
+          "invalid-url": "invalid-url";
+          "robots-disallowed": "robots-disallowed";
+          "origin-backpressure": "origin-backpressure";
           "asset-url": "asset-url";
           "configured-exclusion": "configured-exclusion";
           "duplicate-normalization": "duplicate-normalization";
-          "invalid-url": "invalid-url";
           "memory-pressure": "memory-pressure";
           "off-origin": "off-origin";
-          "origin-backpressure": "origin-backpressure";
           "queue-safety-limit": "queue-safety-limit";
-          "robots-disallowed": "robots-disallowed";
           "robots-uncertain": "robots-uncertain";
           "legacy-unclassified": "legacy-unclassified";
         }>;
@@ -16301,10 +16301,10 @@ export declare const crawlerJsonSchemas: {
         raw: z.ZodString;
         resolved: z.ZodOptional<z.ZodString>;
         ignoredReason: z.ZodOptional<z.ZodEnum<{
-          "invalid-url": "invalid-url";
           "outside-head": "outside-head";
           "alternate-qualifier": "alternate-qualifier";
           fragment: "fragment";
+          "invalid-url": "invalid-url";
           "non-http-url": "non-http-url";
         }>>;
         streamedMetadata: z.ZodOptional<z.ZodLiteral<true>>;
@@ -17740,10 +17740,10 @@ export declare const crawlerJsonSchemas: {
       raw: z.ZodString;
       resolved: z.ZodOptional<z.ZodString>;
       ignoredReason: z.ZodOptional<z.ZodEnum<{
-        "invalid-url": "invalid-url";
         "outside-head": "outside-head";
         "alternate-qualifier": "alternate-qualifier";
         fragment: "fragment";
+        "invalid-url": "invalid-url";
         "non-http-url": "non-http-url";
       }>>;
       streamedMetadata: z.ZodOptional<z.ZodLiteral<true>>;

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-DieyhVZ-.js";
+import { n as version, t as load } from "./esm-D12ZCG_1.js";
 import { SEO_PROVIDER_API_VERSION } from "./provider-sdk.js";
 import crypto, { createHash, randomUUID, sign } from "node:crypto";
 import { z } from "zod";
@@ -32299,8 +32299,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);
@@ -32317,7 +32324,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.`,
@@ -32338,7 +32345,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
 			},
@@ -35432,7 +35439,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",
@@ -36359,10 +36366,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(), {