seo 0.13.1 → 0.13.2

package/dist/index.d.ts

@@ -3742,10 +3742,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>>;
@@ -4379,15 +4379,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";
     }>;
@@ -4545,15 +4545,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";
       }>;
@@ -4925,10 +4925,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>>;
@@ -5850,15 +5850,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";
       }>;
@@ -6230,10 +6230,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>>;
@@ -7155,15 +7155,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";
       }>;
@@ -7535,10 +7535,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>>;
@@ -8462,15 +8462,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";
         }>;
@@ -8842,10 +8842,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>>;
@@ -9767,15 +9767,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";
         }>;
@@ -10147,10 +10147,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>>;
@@ -11072,15 +11072,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";
         }>;
@@ -11452,10 +11452,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>>;
@@ -12881,10 +12881,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>>;
@@ -13305,15 +13305,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";
         }>;
@@ -13685,10 +13685,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>>;
@@ -14610,15 +14610,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";
         }>;
@@ -14990,10 +14990,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>>;
@@ -15915,15 +15915,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";
         }>;
@@ -16295,10 +16295,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>>;
@@ -17724,10 +17724,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>>;
@@ -18046,12 +18046,12 @@ export declare const providerPackageNameSchema: z.ZodString;
 export declare const providerExactVersionSchema: z.ZodString;
 export declare const providerIntegritySchema: z.ZodString;
 export declare const providerKindSchema: z.ZodEnum<{
-  "local-search": "local-search";
   "traffic-analytics": "traffic-analytics";
   "search-results": "search-results";
   "keyword-data": "keyword-data";
   "domain-data": "domain-data";
   "link-data": "link-data";
+  "local-search": "local-search";
   "ai-data": "ai-data";
   other: "other";
 }>;
@@ -18094,12 +18094,12 @@ export declare const providerRegistrationSchema: z.ZodObject<{
   displayName: z.ZodString;
   description: z.ZodString;
   kinds: z.ZodArray<z.ZodEnum<{
-    "local-search": "local-search";
     "traffic-analytics": "traffic-analytics";
     "search-results": "search-results";
     "keyword-data": "keyword-data";
     "domain-data": "domain-data";
     "link-data": "link-data";
+    "local-search": "local-search";
     "ai-data": "ai-data";
     other: "other";
   }>>;
@@ -18172,6 +18172,7 @@ export declare const providerIdSchema: z.ZodString;
 export type ProviderId = z.infer<typeof providerIdSchema>;
 export type ExternalServiceId = string;
 export declare const providerCapabilitySchema: z.ZodEnum<{
+  "local-search": "local-search";
   "serp-snapshot": "serp-snapshot";
   "keyword-metrics": "keyword-metrics";
   "keyword-discovery": "keyword-discovery";
@@ -18183,7 +18184,6 @@ export declare const providerCapabilitySchema: z.ZodEnum<{
   "referring-domains": "referring-domains";
   backlinks: "backlinks";
   "domain-rating": "domain-rating";
-  "local-search": "local-search";
   "ai-mentions": "ai-mentions";
   "ai-prompt-observation": "ai-prompt-observation";
 }>;

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-BIXGSxFJ.js";
+import { n as version, t as load } from "./esm-Dmtr8qrP.js";
 import { SEO_PROVIDER_API_VERSION } from "./provider-sdk.js";
 import crypto, { createHash, randomUUID, sign } from "node:crypto";
 import { z } from "zod";
@@ -29357,25 +29357,64 @@ function need(headers, provider) {
 	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;
 }
+const TASK_TIMEOUT_MS = 6e4;
+const READ_TIMEOUT_MS = 3e4;
+const RETRY_DELAY_MS = 250;
+const retryStatus = (status) => status === 429 || status >= 500;
 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}`);
+	const read = request.method === "GET";
+	const timeoutMs = read ? READ_TIMEOUT_MS : TASK_TIMEOUT_MS;
+	for (let attempt = 1;; attempt += 1) {
+		const last = attempt === 2;
+		let response;
+		try {
+			response = await fetch(request.clone(), { signal: AbortSignal.timeout(timeoutMs) });
+		} catch (error) {
+			if (read && !last) {
+				await wait(RETRY_DELAY_MS);
+				continue;
+			}
+			throw new CommandError("PROVIDER_ERROR", error.name === "TimeoutError" ? `${provider} did not answer within ${timeoutMs / 1e3} seconds.` : `${provider} could not be reached: ${error.message}`);
+		}
+		if (response.ok) return response;
+		if (retryStatus(response.status) && !last) {
+			await response.body?.cancel();
+			await wait(RETRY_DELAY_MS);
+			continue;
+		}
+		const text = (await response.text()).slice(0, 300);
+		throw new CommandError(response.status === 401 || response.status === 403 ? "NO_KEY" : response.status === 429 ? "RATE_LIMITED" : "PROVIDER_ERROR", `${provider} answered ${response.status}. ${text}`);
+	}
 }
+const wait = (ms) => new Promise((done) => setTimeout(done, ms));
 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 eachKeyword(keywords, missed, rowsFor) {
+	const rows = [];
+	let failure;
+	for (const keyword of keywords) try {
+		rows.push(...await rowsFor(keyword));
+	} catch (error) {
+		if (error instanceof CommandError && error.code === "NO_KEY") throw error;
+		failure ??= error;
+		missed.push(keyword);
+	}
+	if (missed.length === keywords.length) throw failure;
+	return rows;
+}
 async function research(provider, headers, input) {
 	requireInput(input);
 	const keys = need(headers, provider);
 	if (provider === "dataforseo") return dataForSeo(keys, input);
+	const missed = [];
 	return {
-		rows: await ahrefs(keys[0] ?? "", input),
+		rows: await ahrefs(keys[0] ?? "", input, missed),
 		costUsd: null,
-		partial: false
+		partial: false,
+		missed
 	};
 }
 function countryName(code) {
@@ -29441,12 +29480,14 @@ const PARTIAL = 40106;
 async function dataForSeo(keys, input) {
 	const spent = {
 		cost: 0,
-		partial: false
+		partial: false,
+		missed: []
 	};
 	return {
 		rows: await dataForSeoRows(keys, input, spent),
 		costUsd: Math.round(spent.cost * 1e4) / 1e4,
-		partial: spent.partial
+		partial: spent.partial,
+		missed: spent.missed
 	};
 }
 async function dataForSeoRows(keys, input, spent) {
@@ -29488,28 +29529,20 @@ async function dataForSeoRows(keys, input, spent) {
 		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 === "serp") return eachKeyword(input.keywords.slice(0, 5), spent.missed, async (keyword) => {
+		return (await post("v3/serp/google/organic/live/advanced", {
+			keyword,
+			depth: Math.min(input.limit, 100)
+		})).filter((item) => item.type === "organic").map((item) => ({
+			keyword,
+			...pick(item, {
+				position: "rank_absolute",
+				url: "url",
+				domain: "domain",
+				title: "title"
+			})
+		}));
+	});
 	if (input.action === "backlinks") return (await post("v3/backlinks/referring_domains/live", {
 		target: bareTarget(input.target),
 		limit: input.limit,
@@ -29538,7 +29571,7 @@ function isPage(target) {
 function bareTarget(target) {
 	return target.replace(/^https?:\/\//, "").replace(/\/$/, "");
 }
-async function ahrefs(key, input) {
+async function ahrefs(key, input, missed) {
 	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);
@@ -29562,22 +29595,17 @@ async function ahrefs(key, input) {
 		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 === "serp") return eachKeyword(input.keywords.slice(0, 5), missed, async (keyword) => {
+		return ((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))
+		})).positions ?? []).map((row) => ({
+			keyword,
+			...row
+		}));
+	});
 	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,
@@ -32245,7 +32273,7 @@ async function runResearch(input, keys, options) {
 	const offset = input.offset ?? 0;
 	const language = input.provider === "dataforseo" ? dataForSeoLanguage(country) : null;
 	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, {
+	const { rows: found, costUsd, partial, missed } = await research(input.provider, keys, {
 		action: input.action,
 		keywords: input.keywords ?? [],
 		target,
@@ -32271,6 +32299,7 @@ async function runResearch(input, keys, options) {
 				`${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."] : [],
+				...missed.length ? [`Partial: ${input.provider} failed for ${missed.join(", ")}, so those keywords have no rows. Ask for them again.`] : [],
 				...note ? [note] : [],
 				...hasTargetDr ? [`${bareDomain(target)} domain_rating: ${targetDr}.`] : [],
 				...rated.added || hasTargetDr ? [DR_ATTRIBUTION] : []
@@ -32288,6 +32317,7 @@ async function runResearch(input, keys, options) {
 			leftOut: note,
 			costUsd,
 			partial,
+			missedKeywords: missed,
 			total: rated.rows.length,
 			offset,
 			rows: rated.rows.slice(offset, offset + 50)