@nuxtseo/protocol 0.1.0

package/dist/v1/research.d.ts

@@ -0,0 +1,1173 @@
+import type { z } from 'zod';
+export declare const researchSiteParamsSchema: z.ZodObject<{
+    siteId: z.ZodString;
+}, z.core.$strict>;
+export declare const researchMetricsSchema: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+    readonly organicTraffic: z.ZodNullable<z.ZodNumber>;
+    readonly totalKeywords: z.ZodNullable<z.ZodNumber>;
+    readonly keywordFootprint: z.ZodNullable<z.ZodNumber>;
+    readonly trafficValue: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    readonly organicTraffic: z.ZodNullable<z.ZodNumber>;
+    readonly totalKeywords: z.ZodNullable<z.ZodNumber>;
+    readonly keywordFootprint: z.ZodNullable<z.ZodNumber>;
+    readonly trafficValue: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strip>>;
+export declare const researchRankingKeywordSchema: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+    readonly keyword: z.ZodString;
+    readonly position: z.ZodNullable<z.ZodNumber>;
+    readonly volume: z.ZodNullable<z.ZodNumber>;
+    readonly traffic: z.ZodNullable<z.ZodNumber>;
+    readonly url: z.ZodNullable<z.ZodString>;
+    readonly intent: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    readonly keyword: z.ZodString;
+    readonly position: z.ZodNullable<z.ZodNumber>;
+    readonly volume: z.ZodNullable<z.ZodNumber>;
+    readonly traffic: z.ZodNullable<z.ZodNumber>;
+    readonly url: z.ZodNullable<z.ZodString>;
+    readonly intent: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>>;
+export declare const researchSharedKeywordSchema: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+    readonly keyword: z.ZodString;
+    readonly yourPosition: z.ZodNumber;
+    readonly theirPosition: z.ZodNumber;
+    readonly volume: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    readonly keyword: z.ZodString;
+    readonly yourPosition: z.ZodNumber;
+    readonly theirPosition: z.ZodNumber;
+    readonly volume: z.ZodNumber;
+}, z.core.$strip>>;
+export declare const researchHistoryPointSchema: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+    readonly observedAt: z.ZodNullable<z.ZodString>;
+    readonly metrics: z.ZodObject<{
+        readonly organicTraffic: z.ZodNullable<z.ZodNumber>;
+        readonly totalKeywords: z.ZodNullable<z.ZodNumber>;
+        readonly keywordFootprint: z.ZodNullable<z.ZodNumber>;
+        readonly trafficValue: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    readonly observedAt: z.ZodNullable<z.ZodString>;
+    readonly metrics: z.ZodObject<{
+        readonly organicTraffic: z.ZodNullable<z.ZodNumber>;
+        readonly totalKeywords: z.ZodNullable<z.ZodNumber>;
+        readonly keywordFootprint: z.ZodNullable<z.ZodNumber>;
+        readonly trafficValue: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>;
+}, z.core.$strip>>;
+export declare const researchCompetitorSchema: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+    readonly domain: z.ZodString;
+    readonly discovery: z.ZodEnum<{
+        automatic: "automatic";
+        manual: "manual";
+        unknown: "unknown";
+    }>;
+    readonly metrics: z.ZodObject<{
+        readonly organicTraffic: z.ZodNullable<z.ZodNumber>;
+        readonly totalKeywords: z.ZodNullable<z.ZodNumber>;
+        readonly keywordFootprint: z.ZodNullable<z.ZodNumber>;
+        readonly trafficValue: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>;
+    readonly topKeywords: z.ZodArray<z.ZodObject<{
+        readonly keyword: z.ZodString;
+        readonly position: z.ZodNullable<z.ZodNumber>;
+        readonly volume: z.ZodNullable<z.ZodNumber>;
+        readonly traffic: z.ZodNullable<z.ZodNumber>;
+        readonly url: z.ZodNullable<z.ZodString>;
+        readonly intent: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    readonly sharedKeywords: z.ZodArray<z.ZodObject<{
+        readonly keyword: z.ZodString;
+        readonly yourPosition: z.ZodNumber;
+        readonly theirPosition: z.ZodNumber;
+        readonly volume: z.ZodNumber;
+    }, z.core.$strip>>;
+    readonly keywordGaps: z.ZodArray<z.ZodObject<{
+        readonly keyword: z.ZodString;
+        readonly position: z.ZodNullable<z.ZodNumber>;
+        readonly volume: z.ZodNullable<z.ZodNumber>;
+        readonly traffic: z.ZodNullable<z.ZodNumber>;
+        readonly url: z.ZodNullable<z.ZodString>;
+        readonly intent: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    readonly quickWins: z.ZodArray<z.ZodObject<{
+        readonly keyword: z.ZodString;
+        readonly yourPosition: z.ZodNumber;
+        readonly theirPosition: z.ZodNumber;
+        readonly volume: z.ZodNumber;
+    }, z.core.$strip>>;
+    readonly history: z.ZodArray<z.ZodObject<{
+        readonly observedAt: z.ZodNullable<z.ZodString>;
+        readonly metrics: z.ZodObject<{
+            readonly organicTraffic: z.ZodNullable<z.ZodNumber>;
+            readonly totalKeywords: z.ZodNullable<z.ZodNumber>;
+            readonly keywordFootprint: z.ZodNullable<z.ZodNumber>;
+            readonly trafficValue: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strip>;
+    }, z.core.$strip>>;
+    readonly collectedAt: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    readonly domain: z.ZodString;
+    readonly discovery: z.ZodEnum<{
+        automatic: "automatic";
+        manual: "manual";
+        unknown: "unknown";
+    }>;
+    readonly metrics: z.ZodObject<{
+        readonly organicTraffic: z.ZodNullable<z.ZodNumber>;
+        readonly totalKeywords: z.ZodNullable<z.ZodNumber>;
+        readonly keywordFootprint: z.ZodNullable<z.ZodNumber>;
+        readonly trafficValue: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>;
+    readonly topKeywords: z.ZodArray<z.ZodObject<{
+        readonly keyword: z.ZodString;
+        readonly position: z.ZodNullable<z.ZodNumber>;
+        readonly volume: z.ZodNullable<z.ZodNumber>;
+        readonly traffic: z.ZodNullable<z.ZodNumber>;
+        readonly url: z.ZodNullable<z.ZodString>;
+        readonly intent: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    readonly sharedKeywords: z.ZodArray<z.ZodObject<{
+        readonly keyword: z.ZodString;
+        readonly yourPosition: z.ZodNumber;
+        readonly theirPosition: z.ZodNumber;
+        readonly volume: z.ZodNumber;
+    }, z.core.$strip>>;
+    readonly keywordGaps: z.ZodArray<z.ZodObject<{
+        readonly keyword: z.ZodString;
+        readonly position: z.ZodNullable<z.ZodNumber>;
+        readonly volume: z.ZodNullable<z.ZodNumber>;
+        readonly traffic: z.ZodNullable<z.ZodNumber>;
+        readonly url: z.ZodNullable<z.ZodString>;
+        readonly intent: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    readonly quickWins: z.ZodArray<z.ZodObject<{
+        readonly keyword: z.ZodString;
+        readonly yourPosition: z.ZodNumber;
+        readonly theirPosition: z.ZodNumber;
+        readonly volume: z.ZodNumber;
+    }, z.core.$strip>>;
+    readonly history: z.ZodArray<z.ZodObject<{
+        readonly observedAt: z.ZodNullable<z.ZodString>;
+        readonly metrics: z.ZodObject<{
+            readonly organicTraffic: z.ZodNullable<z.ZodNumber>;
+            readonly totalKeywords: z.ZodNullable<z.ZodNumber>;
+            readonly keywordFootprint: z.ZodNullable<z.ZodNumber>;
+            readonly trafficValue: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strip>;
+    }, z.core.$strip>>;
+    readonly collectedAt: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>>;
+export declare const researchSubjectSchema: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+    readonly domain: z.ZodString;
+    readonly metrics: z.ZodObject<{
+        readonly organicTraffic: z.ZodNullable<z.ZodNumber>;
+        readonly totalKeywords: z.ZodNullable<z.ZodNumber>;
+        readonly keywordFootprint: z.ZodNullable<z.ZodNumber>;
+        readonly trafficValue: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>;
+    readonly history: z.ZodArray<z.ZodObject<{
+        readonly observedAt: z.ZodNullable<z.ZodString>;
+        readonly metrics: z.ZodObject<{
+            readonly organicTraffic: z.ZodNullable<z.ZodNumber>;
+            readonly totalKeywords: z.ZodNullable<z.ZodNumber>;
+            readonly keywordFootprint: z.ZodNullable<z.ZodNumber>;
+            readonly trafficValue: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strip>;
+    }, z.core.$strip>>;
+    readonly collectedAt: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    readonly domain: z.ZodString;
+    readonly metrics: z.ZodObject<{
+        readonly organicTraffic: z.ZodNullable<z.ZodNumber>;
+        readonly totalKeywords: z.ZodNullable<z.ZodNumber>;
+        readonly keywordFootprint: z.ZodNullable<z.ZodNumber>;
+        readonly trafficValue: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>;
+    readonly history: z.ZodArray<z.ZodObject<{
+        readonly observedAt: z.ZodNullable<z.ZodString>;
+        readonly metrics: z.ZodObject<{
+            readonly organicTraffic: z.ZodNullable<z.ZodNumber>;
+            readonly totalKeywords: z.ZodNullable<z.ZodNumber>;
+            readonly keywordFootprint: z.ZodNullable<z.ZodNumber>;
+            readonly trafficValue: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strip>;
+    }, z.core.$strip>>;
+    readonly collectedAt: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>>;
+export declare const storedResearchOverviewDataSchema: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+    readonly evidence: z.ZodObject<{
+        _tag: z.ZodLiteral<"stored">;
+        provider: z.ZodLiteral<"dataforseo">;
+        collectedAt: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>;
+    readonly summary: z.ZodObject<{
+        competitorCount: z.ZodNumber;
+        quickWins: z.ZodNumber;
+        totalSharedKeywords: z.ZodNumber;
+        totalTrafficValue: z.ZodNumber;
+    }, z.core.$strict>;
+    readonly subject: z.ZodNullable<z.ZodObject<{
+        readonly domain: z.ZodString;
+        readonly metrics: z.ZodObject<{
+            readonly organicTraffic: z.ZodNullable<z.ZodNumber>;
+            readonly totalKeywords: z.ZodNullable<z.ZodNumber>;
+            readonly keywordFootprint: z.ZodNullable<z.ZodNumber>;
+            readonly trafficValue: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strip>;
+        readonly history: z.ZodArray<z.ZodObject<{
+            readonly observedAt: z.ZodNullable<z.ZodString>;
+            readonly metrics: z.ZodObject<{
+                readonly organicTraffic: z.ZodNullable<z.ZodNumber>;
+                readonly totalKeywords: z.ZodNullable<z.ZodNumber>;
+                readonly keywordFootprint: z.ZodNullable<z.ZodNumber>;
+                readonly trafficValue: z.ZodNullable<z.ZodNumber>;
+            }, z.core.$strip>;
+        }, z.core.$strip>>;
+        readonly collectedAt: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    readonly competitors: z.ZodArray<z.ZodObject<{
+        readonly domain: z.ZodString;
+        readonly discovery: z.ZodEnum<{
+            automatic: "automatic";
+            manual: "manual";
+            unknown: "unknown";
+        }>;
+        readonly metrics: z.ZodObject<{
+            readonly organicTraffic: z.ZodNullable<z.ZodNumber>;
+            readonly totalKeywords: z.ZodNullable<z.ZodNumber>;
+            readonly keywordFootprint: z.ZodNullable<z.ZodNumber>;
+            readonly trafficValue: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strip>;
+        readonly topKeywords: z.ZodArray<z.ZodObject<{
+            readonly keyword: z.ZodString;
+            readonly position: z.ZodNullable<z.ZodNumber>;
+            readonly volume: z.ZodNullable<z.ZodNumber>;
+            readonly traffic: z.ZodNullable<z.ZodNumber>;
+            readonly url: z.ZodNullable<z.ZodString>;
+            readonly intent: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+        readonly sharedKeywords: z.ZodArray<z.ZodObject<{
+            readonly keyword: z.ZodString;
+            readonly yourPosition: z.ZodNumber;
+            readonly theirPosition: z.ZodNumber;
+            readonly volume: z.ZodNumber;
+        }, z.core.$strip>>;
+        readonly keywordGaps: z.ZodArray<z.ZodObject<{
+            readonly keyword: z.ZodString;
+            readonly position: z.ZodNullable<z.ZodNumber>;
+            readonly volume: z.ZodNullable<z.ZodNumber>;
+            readonly traffic: z.ZodNullable<z.ZodNumber>;
+            readonly url: z.ZodNullable<z.ZodString>;
+            readonly intent: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+        readonly quickWins: z.ZodArray<z.ZodObject<{
+            readonly keyword: z.ZodString;
+            readonly yourPosition: z.ZodNumber;
+            readonly theirPosition: z.ZodNumber;
+            readonly volume: z.ZodNumber;
+        }, z.core.$strip>>;
+        readonly history: z.ZodArray<z.ZodObject<{
+            readonly observedAt: z.ZodNullable<z.ZodString>;
+            readonly metrics: z.ZodObject<{
+                readonly organicTraffic: z.ZodNullable<z.ZodNumber>;
+                readonly totalKeywords: z.ZodNullable<z.ZodNumber>;
+                readonly keywordFootprint: z.ZodNullable<z.ZodNumber>;
+                readonly trafficValue: z.ZodNullable<z.ZodNumber>;
+            }, z.core.$strip>;
+        }, z.core.$strip>>;
+        readonly collectedAt: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>, z.ZodObject<{
+    readonly evidence: z.ZodObject<{
+        _tag: z.ZodLiteral<"stored">;
+        provider: z.ZodLiteral<"dataforseo">;
+        collectedAt: z.ZodNullable<z.ZodString>;
+    }, z.core.$loose>;
+    readonly summary: z.ZodObject<{
+        competitorCount: z.ZodNumber;
+        quickWins: z.ZodNumber;
+        totalSharedKeywords: z.ZodNumber;
+        totalTrafficValue: z.ZodNumber;
+    }, z.core.$loose>;
+    readonly subject: z.ZodNullable<z.ZodObject<{
+        readonly domain: z.ZodString;
+        readonly metrics: z.ZodObject<{
+            readonly organicTraffic: z.ZodNullable<z.ZodNumber>;
+            readonly totalKeywords: z.ZodNullable<z.ZodNumber>;
+            readonly keywordFootprint: z.ZodNullable<z.ZodNumber>;
+            readonly trafficValue: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strip>;
+        readonly history: z.ZodArray<z.ZodObject<{
+            readonly observedAt: z.ZodNullable<z.ZodString>;
+            readonly metrics: z.ZodObject<{
+                readonly organicTraffic: z.ZodNullable<z.ZodNumber>;
+                readonly totalKeywords: z.ZodNullable<z.ZodNumber>;
+                readonly keywordFootprint: z.ZodNullable<z.ZodNumber>;
+                readonly trafficValue: z.ZodNullable<z.ZodNumber>;
+            }, z.core.$strip>;
+        }, z.core.$strip>>;
+        readonly collectedAt: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    readonly competitors: z.ZodArray<z.ZodObject<{
+        readonly domain: z.ZodString;
+        readonly discovery: z.ZodEnum<{
+            automatic: "automatic";
+            manual: "manual";
+            unknown: "unknown";
+        }>;
+        readonly metrics: z.ZodObject<{
+            readonly organicTraffic: z.ZodNullable<z.ZodNumber>;
+            readonly totalKeywords: z.ZodNullable<z.ZodNumber>;
+            readonly keywordFootprint: z.ZodNullable<z.ZodNumber>;
+            readonly trafficValue: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strip>;
+        readonly topKeywords: z.ZodArray<z.ZodObject<{
+            readonly keyword: z.ZodString;
+            readonly position: z.ZodNullable<z.ZodNumber>;
+            readonly volume: z.ZodNullable<z.ZodNumber>;
+            readonly traffic: z.ZodNullable<z.ZodNumber>;
+            readonly url: z.ZodNullable<z.ZodString>;
+            readonly intent: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+        readonly sharedKeywords: z.ZodArray<z.ZodObject<{
+            readonly keyword: z.ZodString;
+            readonly yourPosition: z.ZodNumber;
+            readonly theirPosition: z.ZodNumber;
+            readonly volume: z.ZodNumber;
+        }, z.core.$strip>>;
+        readonly keywordGaps: z.ZodArray<z.ZodObject<{
+            readonly keyword: z.ZodString;
+            readonly position: z.ZodNullable<z.ZodNumber>;
+            readonly volume: z.ZodNullable<z.ZodNumber>;
+            readonly traffic: z.ZodNullable<z.ZodNumber>;
+            readonly url: z.ZodNullable<z.ZodString>;
+            readonly intent: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+        readonly quickWins: z.ZodArray<z.ZodObject<{
+            readonly keyword: z.ZodString;
+            readonly yourPosition: z.ZodNumber;
+            readonly theirPosition: z.ZodNumber;
+            readonly volume: z.ZodNumber;
+        }, z.core.$strip>>;
+        readonly history: z.ZodArray<z.ZodObject<{
+            readonly observedAt: z.ZodNullable<z.ZodString>;
+            readonly metrics: z.ZodObject<{
+                readonly organicTraffic: z.ZodNullable<z.ZodNumber>;
+                readonly totalKeywords: z.ZodNullable<z.ZodNumber>;
+                readonly keywordFootprint: z.ZodNullable<z.ZodNumber>;
+                readonly trafficValue: z.ZodNullable<z.ZodNumber>;
+            }, z.core.$strip>;
+        }, z.core.$strip>>;
+        readonly collectedAt: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>>;
+export declare const storedResearchOverviewResponseSchema: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+    data: z.ZodObject<{
+        readonly evidence: z.ZodObject<{
+            _tag: z.ZodLiteral<"stored">;
+            provider: z.ZodLiteral<"dataforseo">;
+            collectedAt: z.ZodNullable<z.ZodString>;
+        }, z.core.$strict>;
+        readonly summary: z.ZodObject<{
+            competitorCount: z.ZodNumber;
+            quickWins: z.ZodNumber;
+            totalSharedKeywords: z.ZodNumber;
+            totalTrafficValue: z.ZodNumber;
+        }, z.core.$strict>;
+        readonly subject: z.ZodNullable<z.ZodObject<{
+            readonly domain: z.ZodString;
+            readonly metrics: z.ZodObject<{
+                readonly organicTraffic: z.ZodNullable<z.ZodNumber>;
+                readonly totalKeywords: z.ZodNullable<z.ZodNumber>;
+                readonly keywordFootprint: z.ZodNullable<z.ZodNumber>;
+                readonly trafficValue: z.ZodNullable<z.ZodNumber>;
+            }, z.core.$strip>;
+            readonly history: z.ZodArray<z.ZodObject<{
+                readonly observedAt: z.ZodNullable<z.ZodString>;
+                readonly metrics: z.ZodObject<{
+                    readonly organicTraffic: z.ZodNullable<z.ZodNumber>;
+                    readonly totalKeywords: z.ZodNullable<z.ZodNumber>;
+                    readonly keywordFootprint: z.ZodNullable<z.ZodNumber>;
+                    readonly trafficValue: z.ZodNullable<z.ZodNumber>;
+                }, z.core.$strip>;
+            }, z.core.$strip>>;
+            readonly collectedAt: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+        readonly competitors: z.ZodArray<z.ZodObject<{
+            readonly domain: z.ZodString;
+            readonly discovery: z.ZodEnum<{
+                automatic: "automatic";
+                manual: "manual";
+                unknown: "unknown";
+            }>;
+            readonly metrics: z.ZodObject<{
+                readonly organicTraffic: z.ZodNullable<z.ZodNumber>;
+                readonly totalKeywords: z.ZodNullable<z.ZodNumber>;
+                readonly keywordFootprint: z.ZodNullable<z.ZodNumber>;
+                readonly trafficValue: z.ZodNullable<z.ZodNumber>;
+            }, z.core.$strip>;
+            readonly topKeywords: z.ZodArray<z.ZodObject<{
+                readonly keyword: z.ZodString;
+                readonly position: z.ZodNullable<z.ZodNumber>;
+                readonly volume: z.ZodNullable<z.ZodNumber>;
+                readonly traffic: z.ZodNullable<z.ZodNumber>;
+                readonly url: z.ZodNullable<z.ZodString>;
+                readonly intent: z.ZodNullable<z.ZodString>;
+            }, z.core.$strip>>;
+            readonly sharedKeywords: z.ZodArray<z.ZodObject<{
+                readonly keyword: z.ZodString;
+                readonly yourPosition: z.ZodNumber;
+                readonly theirPosition: z.ZodNumber;
+                readonly volume: z.ZodNumber;
+            }, z.core.$strip>>;
+            readonly keywordGaps: z.ZodArray<z.ZodObject<{
+                readonly keyword: z.ZodString;
+                readonly position: z.ZodNullable<z.ZodNumber>;
+                readonly volume: z.ZodNullable<z.ZodNumber>;
+                readonly traffic: z.ZodNullable<z.ZodNumber>;
+                readonly url: z.ZodNullable<z.ZodString>;
+                readonly intent: z.ZodNullable<z.ZodString>;
+            }, z.core.$strip>>;
+            readonly quickWins: z.ZodArray<z.ZodObject<{
+                readonly keyword: z.ZodString;
+                readonly yourPosition: z.ZodNumber;
+                readonly theirPosition: z.ZodNumber;
+                readonly volume: z.ZodNumber;
+            }, z.core.$strip>>;
+            readonly history: z.ZodArray<z.ZodObject<{
+                readonly observedAt: z.ZodNullable<z.ZodString>;
+                readonly metrics: z.ZodObject<{
+                    readonly organicTraffic: z.ZodNullable<z.ZodNumber>;
+                    readonly totalKeywords: z.ZodNullable<z.ZodNumber>;
+                    readonly keywordFootprint: z.ZodNullable<z.ZodNumber>;
+                    readonly trafficValue: z.ZodNullable<z.ZodNumber>;
+                }, z.core.$strip>;
+            }, z.core.$strip>>;
+            readonly collectedAt: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    meta: z.ZodObject<{
+        requestId: z.ZodString;
+        version: z.ZodLiteral<"1.0">;
+    }, z.core.$strict>;
+}, z.core.$strip>, z.ZodObject<{
+    data: z.ZodObject<{
+        readonly evidence: z.ZodObject<{
+            _tag: z.ZodLiteral<"stored">;
+            provider: z.ZodLiteral<"dataforseo">;
+            collectedAt: z.ZodNullable<z.ZodString>;
+        }, z.core.$loose>;
+        readonly summary: z.ZodObject<{
+            competitorCount: z.ZodNumber;
+            quickWins: z.ZodNumber;
+            totalSharedKeywords: z.ZodNumber;
+            totalTrafficValue: z.ZodNumber;
+        }, z.core.$loose>;
+        readonly subject: z.ZodNullable<z.ZodObject<{
+            readonly domain: z.ZodString;
+            readonly metrics: z.ZodObject<{
+                readonly organicTraffic: z.ZodNullable<z.ZodNumber>;
+                readonly totalKeywords: z.ZodNullable<z.ZodNumber>;
+                readonly keywordFootprint: z.ZodNullable<z.ZodNumber>;
+                readonly trafficValue: z.ZodNullable<z.ZodNumber>;
+            }, z.core.$strip>;
+            readonly history: z.ZodArray<z.ZodObject<{
+                readonly observedAt: z.ZodNullable<z.ZodString>;
+                readonly metrics: z.ZodObject<{
+                    readonly organicTraffic: z.ZodNullable<z.ZodNumber>;
+                    readonly totalKeywords: z.ZodNullable<z.ZodNumber>;
+                    readonly keywordFootprint: z.ZodNullable<z.ZodNumber>;
+                    readonly trafficValue: z.ZodNullable<z.ZodNumber>;
+                }, z.core.$strip>;
+            }, z.core.$strip>>;
+            readonly collectedAt: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+        readonly competitors: z.ZodArray<z.ZodObject<{
+            readonly domain: z.ZodString;
+            readonly discovery: z.ZodEnum<{
+                automatic: "automatic";
+                manual: "manual";
+                unknown: "unknown";
+            }>;
+            readonly metrics: z.ZodObject<{
+                readonly organicTraffic: z.ZodNullable<z.ZodNumber>;
+                readonly totalKeywords: z.ZodNullable<z.ZodNumber>;
+                readonly keywordFootprint: z.ZodNullable<z.ZodNumber>;
+                readonly trafficValue: z.ZodNullable<z.ZodNumber>;
+            }, z.core.$strip>;
+            readonly topKeywords: z.ZodArray<z.ZodObject<{
+                readonly keyword: z.ZodString;
+                readonly position: z.ZodNullable<z.ZodNumber>;
+                readonly volume: z.ZodNullable<z.ZodNumber>;
+                readonly traffic: z.ZodNullable<z.ZodNumber>;
+                readonly url: z.ZodNullable<z.ZodString>;
+                readonly intent: z.ZodNullable<z.ZodString>;
+            }, z.core.$strip>>;
+            readonly sharedKeywords: z.ZodArray<z.ZodObject<{
+                readonly keyword: z.ZodString;
+                readonly yourPosition: z.ZodNumber;
+                readonly theirPosition: z.ZodNumber;
+                readonly volume: z.ZodNumber;
+            }, z.core.$strip>>;
+            readonly keywordGaps: z.ZodArray<z.ZodObject<{
+                readonly keyword: z.ZodString;
+                readonly position: z.ZodNullable<z.ZodNumber>;
+                readonly volume: z.ZodNullable<z.ZodNumber>;
+                readonly traffic: z.ZodNullable<z.ZodNumber>;
+                readonly url: z.ZodNullable<z.ZodString>;
+                readonly intent: z.ZodNullable<z.ZodString>;
+            }, z.core.$strip>>;
+            readonly quickWins: z.ZodArray<z.ZodObject<{
+                readonly keyword: z.ZodString;
+                readonly yourPosition: z.ZodNumber;
+                readonly theirPosition: z.ZodNumber;
+                readonly volume: z.ZodNumber;
+            }, z.core.$strip>>;
+            readonly history: z.ZodArray<z.ZodObject<{
+                readonly observedAt: z.ZodNullable<z.ZodString>;
+                readonly metrics: z.ZodObject<{
+                    readonly organicTraffic: z.ZodNullable<z.ZodNumber>;
+                    readonly totalKeywords: z.ZodNullable<z.ZodNumber>;
+                    readonly keywordFootprint: z.ZodNullable<z.ZodNumber>;
+                    readonly trafficValue: z.ZodNullable<z.ZodNumber>;
+                }, z.core.$strip>;
+            }, z.core.$strip>>;
+            readonly collectedAt: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    meta: z.ZodObject<{
+        requestId: z.ZodString;
+        version: z.ZodLiteral<"1.0">;
+    }, z.core.$loose>;
+}, z.core.$strip>>;
+export type StoredResearchOverview = z.output<typeof storedResearchOverviewDataSchema.producer>;
+export declare const storedResearchOverviewOperation: {
+    readonly id: 'research.overview';
+    readonly method: 'GET';
+    readonly path: '/api/v1/sites/{siteId}/research';
+    readonly visibility: 'public';
+    readonly semantics: {
+        readonly kind: 'query';
+        readonly sideEffects: 'none';
+        readonly retry: 'idempotent';
+        readonly readConsistency: 'primary';
+    };
+    readonly auth: {
+        readonly credentials: readonly ["session", "api_token"];
+        readonly scopes: readonly ["research:read"];
+        readonly minimumRole: 'viewer';
+        readonly ownership: 'site';
+    };
+    readonly request: {
+        readonly params: z.ZodObject<{
+            siteId: z.ZodString;
+        }, z.core.$strict>;
+        readonly query: null;
+        readonly headers: null;
+        readonly body: null;
+    };
+    readonly responses: {
+        readonly 200: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+            data: z.ZodObject<{
+                readonly evidence: z.ZodObject<{
+                    _tag: z.ZodLiteral<"stored">;
+                    provider: z.ZodLiteral<"dataforseo">;
+                    collectedAt: z.ZodNullable<z.ZodString>;
+                }, z.core.$strict>;
+                readonly summary: z.ZodObject<{
+                    competitorCount: z.ZodNumber;
+                    quickWins: z.ZodNumber;
+                    totalSharedKeywords: z.ZodNumber;
+                    totalTrafficValue: z.ZodNumber;
+                }, z.core.$strict>;
+                readonly subject: z.ZodNullable<z.ZodObject<{
+                    readonly domain: z.ZodString;
+                    readonly metrics: z.ZodObject<{
+                        readonly organicTraffic: z.ZodNullable<z.ZodNumber>;
+                        readonly totalKeywords: z.ZodNullable<z.ZodNumber>;
+                        readonly keywordFootprint: z.ZodNullable<z.ZodNumber>;
+                        readonly trafficValue: z.ZodNullable<z.ZodNumber>;
+                    }, z.core.$strip>;
+                    readonly history: z.ZodArray<z.ZodObject<{
+                        readonly observedAt: z.ZodNullable<z.ZodString>;
+                        readonly metrics: z.ZodObject<{
+                            readonly organicTraffic: z.ZodNullable<z.ZodNumber>;
+                            readonly totalKeywords: z.ZodNullable<z.ZodNumber>;
+                            readonly keywordFootprint: z.ZodNullable<z.ZodNumber>;
+                            readonly trafficValue: z.ZodNullable<z.ZodNumber>;
+                        }, z.core.$strip>;
+                    }, z.core.$strip>>;
+                    readonly collectedAt: z.ZodNullable<z.ZodString>;
+                }, z.core.$strip>>;
+                readonly competitors: z.ZodArray<z.ZodObject<{
+                    readonly domain: z.ZodString;
+                    readonly discovery: z.ZodEnum<{
+                        automatic: "automatic";
+                        manual: "manual";
+                        unknown: "unknown";
+                    }>;
+                    readonly metrics: z.ZodObject<{
+                        readonly organicTraffic: z.ZodNullable<z.ZodNumber>;
+                        readonly totalKeywords: z.ZodNullable<z.ZodNumber>;
+                        readonly keywordFootprint: z.ZodNullable<z.ZodNumber>;
+                        readonly trafficValue: z.ZodNullable<z.ZodNumber>;
+                    }, z.core.$strip>;
+                    readonly topKeywords: z.ZodArray<z.ZodObject<{
+                        readonly keyword: z.ZodString;
+                        readonly position: z.ZodNullable<z.ZodNumber>;
+                        readonly volume: z.ZodNullable<z.ZodNumber>;
+                        readonly traffic: z.ZodNullable<z.ZodNumber>;
+                        readonly url: z.ZodNullable<z.ZodString>;
+                        readonly intent: z.ZodNullable<z.ZodString>;
+                    }, z.core.$strip>>;
+                    readonly sharedKeywords: z.ZodArray<z.ZodObject<{
+                        readonly keyword: z.ZodString;
+                        readonly yourPosition: z.ZodNumber;
+                        readonly theirPosition: z.ZodNumber;
+                        readonly volume: z.ZodNumber;
+                    }, z.core.$strip>>;
+                    readonly keywordGaps: z.ZodArray<z.ZodObject<{
+                        readonly keyword: z.ZodString;
+                        readonly position: z.ZodNullable<z.ZodNumber>;
+                        readonly volume: z.ZodNullable<z.ZodNumber>;
+                        readonly traffic: z.ZodNullable<z.ZodNumber>;
+                        readonly url: z.ZodNullable<z.ZodString>;
+                        readonly intent: z.ZodNullable<z.ZodString>;
+                    }, z.core.$strip>>;
+                    readonly quickWins: z.ZodArray<z.ZodObject<{
+                        readonly keyword: z.ZodString;
+                        readonly yourPosition: z.ZodNumber;
+                        readonly theirPosition: z.ZodNumber;
+                        readonly volume: z.ZodNumber;
+                    }, z.core.$strip>>;
+                    readonly history: z.ZodArray<z.ZodObject<{
+                        readonly observedAt: z.ZodNullable<z.ZodString>;
+                        readonly metrics: z.ZodObject<{
+                            readonly organicTraffic: z.ZodNullable<z.ZodNumber>;
+                            readonly totalKeywords: z.ZodNullable<z.ZodNumber>;
+                            readonly keywordFootprint: z.ZodNullable<z.ZodNumber>;
+                            readonly trafficValue: z.ZodNullable<z.ZodNumber>;
+                        }, z.core.$strip>;
+                    }, z.core.$strip>>;
+                    readonly collectedAt: z.ZodNullable<z.ZodString>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>;
+            meta: z.ZodObject<{
+                requestId: z.ZodString;
+                version: z.ZodLiteral<"1.0">;
+            }, z.core.$strict>;
+        }, z.core.$strip>, z.ZodObject<{
+            data: z.ZodObject<{
+                readonly evidence: z.ZodObject<{
+                    _tag: z.ZodLiteral<"stored">;
+                    provider: z.ZodLiteral<"dataforseo">;
+                    collectedAt: z.ZodNullable<z.ZodString>;
+                }, z.core.$loose>;
+                readonly summary: z.ZodObject<{
+                    competitorCount: z.ZodNumber;
+                    quickWins: z.ZodNumber;
+                    totalSharedKeywords: z.ZodNumber;
+                    totalTrafficValue: z.ZodNumber;
+                }, z.core.$loose>;
+                readonly subject: z.ZodNullable<z.ZodObject<{
+                    readonly domain: z.ZodString;
+                    readonly metrics: z.ZodObject<{
+                        readonly organicTraffic: z.ZodNullable<z.ZodNumber>;
+                        readonly totalKeywords: z.ZodNullable<z.ZodNumber>;
+                        readonly keywordFootprint: z.ZodNullable<z.ZodNumber>;
+                        readonly trafficValue: z.ZodNullable<z.ZodNumber>;
+                    }, z.core.$strip>;
+                    readonly history: z.ZodArray<z.ZodObject<{
+                        readonly observedAt: z.ZodNullable<z.ZodString>;
+                        readonly metrics: z.ZodObject<{
+                            readonly organicTraffic: z.ZodNullable<z.ZodNumber>;
+                            readonly totalKeywords: z.ZodNullable<z.ZodNumber>;
+                            readonly keywordFootprint: z.ZodNullable<z.ZodNumber>;
+                            readonly trafficValue: z.ZodNullable<z.ZodNumber>;
+                        }, z.core.$strip>;
+                    }, z.core.$strip>>;
+                    readonly collectedAt: z.ZodNullable<z.ZodString>;
+                }, z.core.$strip>>;
+                readonly competitors: z.ZodArray<z.ZodObject<{
+                    readonly domain: z.ZodString;
+                    readonly discovery: z.ZodEnum<{
+                        automatic: "automatic";
+                        manual: "manual";
+                        unknown: "unknown";
+                    }>;
+                    readonly metrics: z.ZodObject<{
+                        readonly organicTraffic: z.ZodNullable<z.ZodNumber>;
+                        readonly totalKeywords: z.ZodNullable<z.ZodNumber>;
+                        readonly keywordFootprint: z.ZodNullable<z.ZodNumber>;
+                        readonly trafficValue: z.ZodNullable<z.ZodNumber>;
+                    }, z.core.$strip>;
+                    readonly topKeywords: z.ZodArray<z.ZodObject<{
+                        readonly keyword: z.ZodString;
+                        readonly position: z.ZodNullable<z.ZodNumber>;
+                        readonly volume: z.ZodNullable<z.ZodNumber>;
+                        readonly traffic: z.ZodNullable<z.ZodNumber>;
+                        readonly url: z.ZodNullable<z.ZodString>;
+                        readonly intent: z.ZodNullable<z.ZodString>;
+                    }, z.core.$strip>>;
+                    readonly sharedKeywords: z.ZodArray<z.ZodObject<{
+                        readonly keyword: z.ZodString;
+                        readonly yourPosition: z.ZodNumber;
+                        readonly theirPosition: z.ZodNumber;
+                        readonly volume: z.ZodNumber;
+                    }, z.core.$strip>>;
+                    readonly keywordGaps: z.ZodArray<z.ZodObject<{
+                        readonly keyword: z.ZodString;
+                        readonly position: z.ZodNullable<z.ZodNumber>;
+                        readonly volume: z.ZodNullable<z.ZodNumber>;
+                        readonly traffic: z.ZodNullable<z.ZodNumber>;
+                        readonly url: z.ZodNullable<z.ZodString>;
+                        readonly intent: z.ZodNullable<z.ZodString>;
+                    }, z.core.$strip>>;
+                    readonly quickWins: z.ZodArray<z.ZodObject<{
+                        readonly keyword: z.ZodString;
+                        readonly yourPosition: z.ZodNumber;
+                        readonly theirPosition: z.ZodNumber;
+                        readonly volume: z.ZodNumber;
+                    }, z.core.$strip>>;
+                    readonly history: z.ZodArray<z.ZodObject<{
+                        readonly observedAt: z.ZodNullable<z.ZodString>;
+                        readonly metrics: z.ZodObject<{
+                            readonly organicTraffic: z.ZodNullable<z.ZodNumber>;
+                            readonly totalKeywords: z.ZodNullable<z.ZodNumber>;
+                            readonly keywordFootprint: z.ZodNullable<z.ZodNumber>;
+                            readonly trafficValue: z.ZodNullable<z.ZodNumber>;
+                        }, z.core.$strip>;
+                    }, z.core.$strip>>;
+                    readonly collectedAt: z.ZodNullable<z.ZodString>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>;
+            meta: z.ZodObject<{
+                requestId: z.ZodString;
+                version: z.ZodLiteral<"1.0">;
+            }, z.core.$loose>;
+        }, z.core.$strip>>;
+    };
+    readonly errors: readonly ["invalid_request", "unauthorized", "auth_expired", "forbidden", "not_found", "rate_limited", "contract_violation", "internal_error"];
+    readonly errorResponse: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+        readonly error: z.ZodObject<{
+            code: z.ZodEnum<{
+                auth_expired: "auth_expired";
+                conflict: "conflict";
+                contract_violation: "contract_violation";
+                entitlement_required: "entitlement_required";
+                forbidden: "forbidden";
+                internal_error: "internal_error";
+                invalid_request: "invalid_request";
+                not_found: "not_found";
+                provider_unavailable: "provider_unavailable";
+                quota_exhausted: "quota_exhausted";
+                rate_limited: "rate_limited";
+                site_ambiguous: "site_ambiguous";
+                stale_evidence: "stale_evidence";
+                unauthorized: "unauthorized";
+            }>;
+            message: z.ZodString;
+            requestId: z.ZodString;
+            retryable: z.ZodBoolean;
+            details: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        }, z.core.$strict>;
+    }, z.core.$strip>, z.ZodObject<{
+        readonly error: z.ZodObject<{
+            code: z.ZodEnum<{
+                auth_expired: "auth_expired";
+                conflict: "conflict";
+                contract_violation: "contract_violation";
+                entitlement_required: "entitlement_required";
+                forbidden: "forbidden";
+                internal_error: "internal_error";
+                invalid_request: "invalid_request";
+                not_found: "not_found";
+                provider_unavailable: "provider_unavailable";
+                quota_exhausted: "quota_exhausted";
+                rate_limited: "rate_limited";
+                site_ambiguous: "site_ambiguous";
+                stale_evidence: "stale_evidence";
+                unauthorized: "unauthorized";
+            }>;
+            message: z.ZodString;
+            requestId: z.ZodString;
+            retryable: z.ZodBoolean;
+            details: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        }, z.core.$loose>;
+    }, z.core.$strip>>;
+    readonly resources: {
+        readonly reads: readonly [{
+            readonly type: 'site.research';
+            readonly idFrom: 'params.siteId';
+        }];
+        readonly changes: readonly [];
+    };
+    readonly policy: {
+        readonly rate: {
+            readonly name: 'public-v1-fixed-window';
+            readonly limit: 50;
+            readonly windowSeconds: 60;
+        };
+        readonly idempotency: {
+            readonly _tag: 'none';
+        };
+        readonly entitlement: null;
+        readonly meter: null;
+    };
+    readonly lifecycle: {
+        readonly introduced: '1.0.0';
+    };
+    readonly docs: {
+        readonly summary: 'Get stored Site Research';
+        readonly description: 'Returns retained competitor and keyword-gap evidence already collected for the Site. It never starts provider work and does not consume metered units.';
+        readonly tags: readonly ["Research"];
+        readonly examples: readonly [{
+            readonly request: {
+                readonly params: {
+                    readonly siteId: 'site_01JXYZ';
+                };
+            };
+            readonly response: {
+                readonly status: 200;
+                readonly body: {
+                    readonly data: {
+                        readonly evidence: {
+                            readonly _tag: 'stored';
+                            readonly provider: 'dataforseo';
+                            readonly collectedAt: null;
+                        };
+                        readonly summary: {
+                            readonly competitorCount: 0;
+                            readonly quickWins: 0;
+                            readonly totalSharedKeywords: 0;
+                            readonly totalTrafficValue: 0;
+                        };
+                        readonly subject: null;
+                        readonly competitors: readonly [];
+                    };
+                    readonly meta: {
+                        readonly requestId: 'req_01JXYZ';
+                        readonly version: '1.0';
+                    };
+                };
+            };
+        }];
+    };
+};
+export declare const researchV1Registry: import("./core.js").PublicV1Registry<{
+    readonly overview: {
+        readonly id: 'research.overview';
+        readonly method: 'GET';
+        readonly path: '/api/v1/sites/{siteId}/research';
+        readonly visibility: 'public';
+        readonly semantics: {
+            readonly kind: 'query';
+            readonly sideEffects: 'none';
+            readonly retry: 'idempotent';
+            readonly readConsistency: 'primary';
+        };
+        readonly auth: {
+            readonly credentials: readonly ["session", "api_token"];
+            readonly scopes: readonly ["research:read"];
+            readonly minimumRole: 'viewer';
+            readonly ownership: 'site';
+        };
+        readonly request: {
+            readonly params: z.ZodObject<{
+                siteId: z.ZodString;
+            }, z.core.$strict>;
+            readonly query: null;
+            readonly headers: null;
+            readonly body: null;
+        };
+        readonly responses: {
+            readonly 200: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+                data: z.ZodObject<{
+                    readonly evidence: z.ZodObject<{
+                        _tag: z.ZodLiteral<"stored">;
+                        provider: z.ZodLiteral<"dataforseo">;
+                        collectedAt: z.ZodNullable<z.ZodString>;
+                    }, z.core.$strict>;
+                    readonly summary: z.ZodObject<{
+                        competitorCount: z.ZodNumber;
+                        quickWins: z.ZodNumber;
+                        totalSharedKeywords: z.ZodNumber;
+                        totalTrafficValue: z.ZodNumber;
+                    }, z.core.$strict>;
+                    readonly subject: z.ZodNullable<z.ZodObject<{
+                        readonly domain: z.ZodString;
+                        readonly metrics: z.ZodObject<{
+                            readonly organicTraffic: z.ZodNullable<z.ZodNumber>;
+                            readonly totalKeywords: z.ZodNullable<z.ZodNumber>;
+                            readonly keywordFootprint: z.ZodNullable<z.ZodNumber>;
+                            readonly trafficValue: z.ZodNullable<z.ZodNumber>;
+                        }, z.core.$strip>;
+                        readonly history: z.ZodArray<z.ZodObject<{
+                            readonly observedAt: z.ZodNullable<z.ZodString>;
+                            readonly metrics: z.ZodObject<{
+                                readonly organicTraffic: z.ZodNullable<z.ZodNumber>;
+                                readonly totalKeywords: z.ZodNullable<z.ZodNumber>;
+                                readonly keywordFootprint: z.ZodNullable<z.ZodNumber>;
+                                readonly trafficValue: z.ZodNullable<z.ZodNumber>;
+                            }, z.core.$strip>;
+                        }, z.core.$strip>>;
+                        readonly collectedAt: z.ZodNullable<z.ZodString>;
+                    }, z.core.$strip>>;
+                    readonly competitors: z.ZodArray<z.ZodObject<{
+                        readonly domain: z.ZodString;
+                        readonly discovery: z.ZodEnum<{
+                            automatic: "automatic";
+                            manual: "manual";
+                            unknown: "unknown";
+                        }>;
+                        readonly metrics: z.ZodObject<{
+                            readonly organicTraffic: z.ZodNullable<z.ZodNumber>;
+                            readonly totalKeywords: z.ZodNullable<z.ZodNumber>;
+                            readonly keywordFootprint: z.ZodNullable<z.ZodNumber>;
+                            readonly trafficValue: z.ZodNullable<z.ZodNumber>;
+                        }, z.core.$strip>;
+                        readonly topKeywords: z.ZodArray<z.ZodObject<{
+                            readonly keyword: z.ZodString;
+                            readonly position: z.ZodNullable<z.ZodNumber>;
+                            readonly volume: z.ZodNullable<z.ZodNumber>;
+                            readonly traffic: z.ZodNullable<z.ZodNumber>;
+                            readonly url: z.ZodNullable<z.ZodString>;
+                            readonly intent: z.ZodNullable<z.ZodString>;
+                        }, z.core.$strip>>;
+                        readonly sharedKeywords: z.ZodArray<z.ZodObject<{
+                            readonly keyword: z.ZodString;
+                            readonly yourPosition: z.ZodNumber;
+                            readonly theirPosition: z.ZodNumber;
+                            readonly volume: z.ZodNumber;
+                        }, z.core.$strip>>;
+                        readonly keywordGaps: z.ZodArray<z.ZodObject<{
+                            readonly keyword: z.ZodString;
+                            readonly position: z.ZodNullable<z.ZodNumber>;
+                            readonly volume: z.ZodNullable<z.ZodNumber>;
+                            readonly traffic: z.ZodNullable<z.ZodNumber>;
+                            readonly url: z.ZodNullable<z.ZodString>;
+                            readonly intent: z.ZodNullable<z.ZodString>;
+                        }, z.core.$strip>>;
+                        readonly quickWins: z.ZodArray<z.ZodObject<{
+                            readonly keyword: z.ZodString;
+                            readonly yourPosition: z.ZodNumber;
+                            readonly theirPosition: z.ZodNumber;
+                            readonly volume: z.ZodNumber;
+                        }, z.core.$strip>>;
+                        readonly history: z.ZodArray<z.ZodObject<{
+                            readonly observedAt: z.ZodNullable<z.ZodString>;
+                            readonly metrics: z.ZodObject<{
+                                readonly organicTraffic: z.ZodNullable<z.ZodNumber>;
+                                readonly totalKeywords: z.ZodNullable<z.ZodNumber>;
+                                readonly keywordFootprint: z.ZodNullable<z.ZodNumber>;
+                                readonly trafficValue: z.ZodNullable<z.ZodNumber>;
+                            }, z.core.$strip>;
+                        }, z.core.$strip>>;
+                        readonly collectedAt: z.ZodNullable<z.ZodString>;
+                    }, z.core.$strip>>;
+                }, z.core.$strip>;
+                meta: z.ZodObject<{
+                    requestId: z.ZodString;
+                    version: z.ZodLiteral<"1.0">;
+                }, z.core.$strict>;
+            }, z.core.$strip>, z.ZodObject<{
+                data: z.ZodObject<{
+                    readonly evidence: z.ZodObject<{
+                        _tag: z.ZodLiteral<"stored">;
+                        provider: z.ZodLiteral<"dataforseo">;
+                        collectedAt: z.ZodNullable<z.ZodString>;
+                    }, z.core.$loose>;
+                    readonly summary: z.ZodObject<{
+                        competitorCount: z.ZodNumber;
+                        quickWins: z.ZodNumber;
+                        totalSharedKeywords: z.ZodNumber;
+                        totalTrafficValue: z.ZodNumber;
+                    }, z.core.$loose>;
+                    readonly subject: z.ZodNullable<z.ZodObject<{
+                        readonly domain: z.ZodString;
+                        readonly metrics: z.ZodObject<{
+                            readonly organicTraffic: z.ZodNullable<z.ZodNumber>;
+                            readonly totalKeywords: z.ZodNullable<z.ZodNumber>;
+                            readonly keywordFootprint: z.ZodNullable<z.ZodNumber>;
+                            readonly trafficValue: z.ZodNullable<z.ZodNumber>;
+                        }, z.core.$strip>;
+                        readonly history: z.ZodArray<z.ZodObject<{
+                            readonly observedAt: z.ZodNullable<z.ZodString>;
+                            readonly metrics: z.ZodObject<{
+                                readonly organicTraffic: z.ZodNullable<z.ZodNumber>;
+                                readonly totalKeywords: z.ZodNullable<z.ZodNumber>;
+                                readonly keywordFootprint: z.ZodNullable<z.ZodNumber>;
+                                readonly trafficValue: z.ZodNullable<z.ZodNumber>;
+                            }, z.core.$strip>;
+                        }, z.core.$strip>>;
+                        readonly collectedAt: z.ZodNullable<z.ZodString>;
+                    }, z.core.$strip>>;
+                    readonly competitors: z.ZodArray<z.ZodObject<{
+                        readonly domain: z.ZodString;
+                        readonly discovery: z.ZodEnum<{
+                            automatic: "automatic";
+                            manual: "manual";
+                            unknown: "unknown";
+                        }>;
+                        readonly metrics: z.ZodObject<{
+                            readonly organicTraffic: z.ZodNullable<z.ZodNumber>;
+                            readonly totalKeywords: z.ZodNullable<z.ZodNumber>;
+                            readonly keywordFootprint: z.ZodNullable<z.ZodNumber>;
+                            readonly trafficValue: z.ZodNullable<z.ZodNumber>;
+                        }, z.core.$strip>;
+                        readonly topKeywords: z.ZodArray<z.ZodObject<{
+                            readonly keyword: z.ZodString;
+                            readonly position: z.ZodNullable<z.ZodNumber>;
+                            readonly volume: z.ZodNullable<z.ZodNumber>;
+                            readonly traffic: z.ZodNullable<z.ZodNumber>;
+                            readonly url: z.ZodNullable<z.ZodString>;
+                            readonly intent: z.ZodNullable<z.ZodString>;
+                        }, z.core.$strip>>;
+                        readonly sharedKeywords: z.ZodArray<z.ZodObject<{
+                            readonly keyword: z.ZodString;
+                            readonly yourPosition: z.ZodNumber;
+                            readonly theirPosition: z.ZodNumber;
+                            readonly volume: z.ZodNumber;
+                        }, z.core.$strip>>;
+                        readonly keywordGaps: z.ZodArray<z.ZodObject<{
+                            readonly keyword: z.ZodString;
+                            readonly position: z.ZodNullable<z.ZodNumber>;
+                            readonly volume: z.ZodNullable<z.ZodNumber>;
+                            readonly traffic: z.ZodNullable<z.ZodNumber>;
+                            readonly url: z.ZodNullable<z.ZodString>;
+                            readonly intent: z.ZodNullable<z.ZodString>;
+                        }, z.core.$strip>>;
+                        readonly quickWins: z.ZodArray<z.ZodObject<{
+                            readonly keyword: z.ZodString;
+                            readonly yourPosition: z.ZodNumber;
+                            readonly theirPosition: z.ZodNumber;
+                            readonly volume: z.ZodNumber;
+                        }, z.core.$strip>>;
+                        readonly history: z.ZodArray<z.ZodObject<{
+                            readonly observedAt: z.ZodNullable<z.ZodString>;
+                            readonly metrics: z.ZodObject<{
+                                readonly organicTraffic: z.ZodNullable<z.ZodNumber>;
+                                readonly totalKeywords: z.ZodNullable<z.ZodNumber>;
+                                readonly keywordFootprint: z.ZodNullable<z.ZodNumber>;
+                                readonly trafficValue: z.ZodNullable<z.ZodNumber>;
+                            }, z.core.$strip>;
+                        }, z.core.$strip>>;
+                        readonly collectedAt: z.ZodNullable<z.ZodString>;
+                    }, z.core.$strip>>;
+                }, z.core.$strip>;
+                meta: z.ZodObject<{
+                    requestId: z.ZodString;
+                    version: z.ZodLiteral<"1.0">;
+                }, z.core.$loose>;
+            }, z.core.$strip>>;
+        };
+        readonly errors: readonly ["invalid_request", "unauthorized", "auth_expired", "forbidden", "not_found", "rate_limited", "contract_violation", "internal_error"];
+        readonly errorResponse: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+            readonly error: z.ZodObject<{
+                code: z.ZodEnum<{
+                    auth_expired: "auth_expired";
+                    conflict: "conflict";
+                    contract_violation: "contract_violation";
+                    entitlement_required: "entitlement_required";
+                    forbidden: "forbidden";
+                    internal_error: "internal_error";
+                    invalid_request: "invalid_request";
+                    not_found: "not_found";
+                    provider_unavailable: "provider_unavailable";
+                    quota_exhausted: "quota_exhausted";
+                    rate_limited: "rate_limited";
+                    site_ambiguous: "site_ambiguous";
+                    stale_evidence: "stale_evidence";
+                    unauthorized: "unauthorized";
+                }>;
+                message: z.ZodString;
+                requestId: z.ZodString;
+                retryable: z.ZodBoolean;
+                details: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            }, z.core.$strict>;
+        }, z.core.$strip>, z.ZodObject<{
+            readonly error: z.ZodObject<{
+                code: z.ZodEnum<{
+                    auth_expired: "auth_expired";
+                    conflict: "conflict";
+                    contract_violation: "contract_violation";
+                    entitlement_required: "entitlement_required";
+                    forbidden: "forbidden";
+                    internal_error: "internal_error";
+                    invalid_request: "invalid_request";
+                    not_found: "not_found";
+                    provider_unavailable: "provider_unavailable";
+                    quota_exhausted: "quota_exhausted";
+                    rate_limited: "rate_limited";
+                    site_ambiguous: "site_ambiguous";
+                    stale_evidence: "stale_evidence";
+                    unauthorized: "unauthorized";
+                }>;
+                message: z.ZodString;
+                requestId: z.ZodString;
+                retryable: z.ZodBoolean;
+                details: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            }, z.core.$loose>;
+        }, z.core.$strip>>;
+        readonly resources: {
+            readonly reads: readonly [{
+                readonly type: 'site.research';
+                readonly idFrom: 'params.siteId';
+            }];
+            readonly changes: readonly [];
+        };
+        readonly policy: {
+            readonly rate: {
+                readonly name: 'public-v1-fixed-window';
+                readonly limit: 50;
+                readonly windowSeconds: 60;
+            };
+            readonly idempotency: {
+                readonly _tag: 'none';
+            };
+            readonly entitlement: null;
+            readonly meter: null;
+        };
+        readonly lifecycle: {
+            readonly introduced: '1.0.0';
+        };
+        readonly docs: {
+            readonly summary: 'Get stored Site Research';
+            readonly description: 'Returns retained competitor and keyword-gap evidence already collected for the Site. It never starts provider work and does not consume metered units.';
+            readonly tags: readonly ["Research"];
+            readonly examples: readonly [{
+                readonly request: {
+                    readonly params: {
+                        readonly siteId: 'site_01JXYZ';
+                    };
+                };
+                readonly response: {
+                    readonly status: 200;
+                    readonly body: {
+                        readonly data: {
+                            readonly evidence: {
+                                readonly _tag: 'stored';
+                                readonly provider: 'dataforseo';
+                                readonly collectedAt: null;
+                            };
+                            readonly summary: {
+                                readonly competitorCount: 0;
+                                readonly quickWins: 0;
+                                readonly totalSharedKeywords: 0;
+                                readonly totalTrafficValue: 0;
+                            };
+                            readonly subject: null;
+                            readonly competitors: readonly [];
+                        };
+                        readonly meta: {
+                            readonly requestId: 'req_01JXYZ';
+                            readonly version: '1.0';
+                        };
+                    };
+                };
+            }];
+        };
+    };
+}>;