seo 0.6.0 → 0.7.0

package/dist/index.d.ts

@@ -3538,10 +3538,10 @@ 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>>;
@@ -4175,15 +4175,15 @@ 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";
     }>;
@@ -4341,15 +4341,15 @@ 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";
       }>;
@@ -4721,10 +4721,10 @@ 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>>;
@@ -5583,15 +5583,15 @@ 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";
       }>;
@@ -5963,10 +5963,10 @@ 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>>;
@@ -6825,15 +6825,15 @@ 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";
       }>;
@@ -7205,10 +7205,10 @@ 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>>;
@@ -8069,15 +8069,15 @@ 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";
         }>;
@@ -8449,10 +8449,10 @@ 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>>;
@@ -9311,15 +9311,15 @@ 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";
         }>;
@@ -9691,10 +9691,10 @@ 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>>;
@@ -10553,15 +10553,15 @@ 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";
         }>;
@@ -10933,10 +10933,10 @@ 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>>;
@@ -12299,10 +12299,10 @@ 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>>;
@@ -12723,15 +12723,15 @@ 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";
         }>;
@@ -13103,10 +13103,10 @@ 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>>;
@@ -13965,15 +13965,15 @@ 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";
         }>;
@@ -14345,10 +14345,10 @@ 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>>;
@@ -15207,15 +15207,15 @@ 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";
         }>;
@@ -15587,10 +15587,10 @@ 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>>;
@@ -16953,10 +16953,10 @@ 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>>;
@@ -19305,6 +19305,17 @@ declare function diagnoseProperty(input: {
   progress?: ProgressReporter;
 }, dependencies?: Partial<DiagnosePropertyDependencies>): Promise<DiagnosePropertyReport>;
 //#endregion
+//#region packages/core/src/analyze/internal-links-placement.d.ts
+interface LinkPlacement {
+  contentSimilarity: number;
+  sentences: Array<{
+    text: string;
+    section: string;
+    match: number;
+    anchors: string[];
+  }>;
+}
+//#endregion
 //#region packages/core/src/analyze/internal-links-types.d.ts
 type InternalLinkMatchKind = 'exact-query' | 'lexical-review';
 interface InternalLinkQueryMatch {
@@ -19343,6 +19354,7 @@ interface InternalLinkOpportunity extends InternalLinkCandidate {
       location: 'main-content' | 'navigation' | 'footer' | 'other';
     }>;
   };
+  placement: LinkPlacement;
   confidence: 'medium' | 'low';
   priority: {
     score: number;
@@ -19435,13 +19447,14 @@ interface InternalLinksReport {
   };
   methodology: {
     id: 'gsc_internal_link_candidates';
-    version: 3;
+    version: 4;
     lexicalTargetLimit: number;
     matchedQueryEvidenceLimit: number;
     observedLinkEvidenceLimit: number;
     matching: 'pairwise_exact_then_precision_lexical';
     ranking: 'exact_matches_then_matched_query_impressions_then_relevance';
     contextualPlacementVerified: true;
+    placement: 'tfidf_sentence_match_then_phrase_anchors';
   };
   filters: {
     minImpressions: number;
@@ -19517,14 +19530,8 @@ type ExtractPage = typeof extractPage;
 interface InternalLinksInput {
   site: string;
   targetUrl: string;
-  days?: number;
-  limit?: number;
-  checkLimit?: number;
-  minImpressions?: number;
-  brandTerms?: string[];
-  includeBrand?: boolean;
-  js?: boolean | 'auto';
-  rate?: FetchRateControls;
+  startDate?: string;
+  endDate?: string;
   refresh?: boolean;
 }
 interface InternalLinksDependencies {
@@ -20671,11 +20678,19 @@ type CommandDeps = {
   searchAnalytics: SearchAnalyticsQuery;
   checkPages: (urls: string[]) => Promise<PageFacts[]>;
   inspect: (site: string, url: string) => Promise<IndexStatus | null>;
+  pageMarkdown?: (url: string) => Promise<PageMarkdown>;
   call: Caller;
   bing?: () => Promise<BingCall | null>;
   bingConnect?: string;
   now?: () => Date;
 };
+type PageMarkdown = {
+  markdown: string;
+  characters: number;
+  truncated: boolean;
+} | {
+  error: string;
+};
 //#endregion
 //#region packages/core/src/commands/sites.d.ts
 type GoogleAccount = {