@digestseo/mcp-gsc 0.4.28 → 0.4.29

package/CHANGELOG.md

@@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.4.29] - 2026-09-23
+
+### Fixed
+- `urls.inspect_many` now rejects exact duplicate URLs before reserving local safety-budget units or calling Google, preventing one batch from wasting URL Inspection quota on repeated identical requests.
+- `analytics.query` now rejects explicit `byPage` aggregation when the request also groups or filters by page, returning deterministic local guidance to use `auto` instead of forwarding a provider-invalid aggregation shape to Google.
+
 ## [0.4.28] - 2026-09-23
 
 ### Added

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@digestseo/mcp-gsc",
-  "version": "0.4.28",
+  "version": "0.4.29",
   "private": false,
   "main": "scripts/glama-start.mjs",
   "bin": {

package/src/google.ts

@@ -371,6 +371,12 @@ export function assertSearchAnalyticsQueryCompatible(body: SearchAnalyticsQuery)
     }
   }
 
+  if (body.aggregationType === 'byPage' && hasPageGroupingOrFilter) {
+    throw new Error(
+      'Search Analytics aggregationType byPage cannot be combined with page grouping or filtering; use auto instead.',
+    );
+  }
+
   if (body.aggregationType === 'byProperty') {
     if (hasPageGroupingOrFilter) {
       throw new Error(

package/src/index.ts

@@ -987,8 +987,11 @@ class GscMcpRuntime {
             .array(z.string().url())
             .min(1)
             .max(10)
+            .refine((urls) => new Set(urls).size === urls.length, {
+              message: 'inspection_urls must not contain duplicate URLs.',
+            })
             .describe(
-              'Between 1 and 10 fully-qualified URLs to inspect. Each URL must belong to the site_url property.',
+              'Between 1 and 10 unique fully-qualified URLs to inspect. Each URL must belong to the site_url property.',
             ),
           language_code: z
             .string()
@@ -1216,7 +1219,7 @@ class GscMcpRuntime {
             .enum(['auto', 'byNewsShowcasePanel', 'byPage', 'byProperty'])
             .default('auto')
             .describe(
-              "How Google aggregates metrics. Leave as 'auto' unless specific semantics are needed. 'byProperty' cannot be used with page grouping/filtering or search_type discover/googleNews. 'byNewsShowcasePanel' requires search_type discover/googleNews plus a searchAppearance equals NEWS_SHOWCASE filter, and cannot be combined with page grouping/filtering or another searchAppearance filter.",
+              "How Google aggregates metrics. Leave as 'auto' unless specific semantics are needed. When grouping/filtering by page, use 'auto'; explicit 'byPage' and 'byProperty' are rejected for that request shape. 'byProperty' is also unavailable for search_type discover/googleNews. 'byNewsShowcasePanel' requires search_type discover/googleNews plus a searchAppearance equals NEWS_SHOWCASE filter, and cannot be combined with page grouping/filtering or another searchAppearance filter.",
             ),
           dimension_filter_groups: z
             .array(