@digestseo/mcp-gsc 0.4.32 → 0.4.33

package/CHANGELOG.md

@@ -7,6 +7,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.4.33] - 2026-09-24
+
+### Changed
+- `analytics.query` responses now echo the ordered requested `dimensions` and `search_type`, so `rows[].keys` remain self-describing when responses are saved, forwarded, or consumed outside the original request context.
+
+### Fixed
+- `analytics.query` now rejects duplicate grouping dimensions and mixed `searchAppearance` grouping at MCP input validation, before local rate-limit, Google credential, or provider work.
+
 ## [0.4.32] - 2026-09-24
 
 ### Added

package/package.json

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

package/src/index.ts

@@ -365,6 +365,24 @@ const SEARCH_ANALYTICS_OUTPUT_SCHEMA = {
   row_count: z.number().int().nonnegative(),
   start_row: z.number().int().nonnegative(),
   rows: z.array(z.object(SEARCH_ROW_OUTPUT_SCHEMA)),
+  dimensions: z
+    .array(
+      z.enum([
+        'query',
+        'page',
+        'country',
+        'device',
+        'date',
+        'hour',
+        'searchAppearance',
+      ]),
+    )
+    .describe(
+      'Ordered labels for rows[].keys. Each key position corresponds to the dimension at the same index. Empty for aggregate dimensions: [] queries.',
+    ),
+  search_type: z
+    .enum(['web', 'image', 'video', 'news', 'discover', 'googleNews'])
+    .describe('The Search Analytics search type requested for this response.'),
   data_state: z.enum(['all', 'final', 'hourly_all']).describe(
     'The Search Analytics dataState requested from Google for this response.',
   ),
@@ -1188,10 +1206,13 @@ class GscMcpRuntime {
         title: 'Query search analytics',
         description: [
           'Query Google Search Console search analytics data. Returns',
-          '{ row_count, start_row, rows, provider_exhaustiveness_guaranteed,',
-          '  provider_note, has_more, truncated, byte_limit_reached }',
+          '{ row_count, start_row, rows, dimensions, search_type,',
+          '  provider_exhaustiveness_guaranteed, provider_note, has_more,',
+          '  truncated, byte_limit_reached }',
           'where dimensioned rows have keys plus clicks, impressions, ctr, and',
-          'position. Aggregate rows from dimensions: [] may omit keys because',
+          'position. The echoed dimensions array labels rows[].keys in order,',
+          'so saved or forwarded responses remain self-describing. Aggregate',
+          'rows from dimensions: [] may omit keys because',
           'Google itself omits that field. When has_more is true, the response',
           'includes next_start_row — pass it back as start_row to fetch the next',
           'safe page. Large requested row_limit values are automatically split',
@@ -1292,6 +1313,20 @@ class GscMcpRuntime {
                 'searchAppearance',
               ]),
             )
+            .superRefine((dimensions, ctx) => {
+              if (new Set(dimensions).size !== dimensions.length) {
+                ctx.addIssue({
+                  code: 'custom',
+                  message: 'Search Analytics dimensions must not contain duplicates.',
+                });
+              }
+              if (dimensions.includes('searchAppearance') && dimensions.length > 1) {
+                ctx.addIssue({
+                  code: 'custom',
+                  message: 'Search Analytics searchAppearance must be the only grouping dimension.',
+                });
+              }
+            })
             .default(['query'])
             .describe(
               "Dimensions to group rows by. Pass [] (empty array) to get a single row of true site-level totals. searchAppearance must be the only grouping dimension; discover an appearance value with ['searchAppearance'], then filter to that value in a separate query when grouping by another dimension. The 'hour' dimension requires data_state 'hourly_all' and an inclusive date range of at most 10 days. Google Discover and Google News do not support the query dimension.",
@@ -1386,6 +1421,8 @@ class GscMcpRuntime {
           row_count: bounded.items.length,
           start_row,
           rows: bounded.items,
+          dimensions,
+          search_type,
           data_state,
           preliminary_data_possible: data_state !== 'final',
           position_supported: