@digestseo/mcp-gsc 0.4.26 → 0.4.27

package/CHANGELOG.md

@@ -7,6 +7,15 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.4.27] - 2026-09-23
+
+### Added
+- GitHub Copilot CLI can now install this repository directly as a plugin, bundling the existing `gsc-weekly-review`, `gsc-indexing-triage`, and `gsc-search-opportunities` Agent Skills with the verified local loopback MCP configuration.
+
+### Fixed
+- Direct Search Analytics-backed pagination in `analytics.query` and `indexing.list_pages` now treats short non-empty provider pages as potentially continuable and advances `next_start_row` by Google's requested page size, stopping only after an explicit empty provider page when no local response truncation remains.
+- Idempotent Google read calls now apply the existing bounded retry policy when Search Console returns documented transient 403 rate-limit reasons, while permission/configuration 403 responses and write calls remain non-retried.
+
 ## [0.4.26] - 2026-09-23
 
 ### Fixed

package/README.md

@@ -58,11 +58,19 @@ claude mcp add --transport http gsc http://127.0.0.1:8080/mcp
 
 When this repository is installed as a Cursor plugin, Cursor also auto-discovers three bundled Agent Skills that compose the MCP tools into evidence-safe workflows: `gsc-weekly-review`, `gsc-indexing-triage`, and `gsc-search-opportunities`. The **Add to Cursor** button above installs the MCP connection only; the bundled skills are part of the repository's Cursor plugin package.
 
+**GitHub Copilot CLI**
+
+```bash
+copilot plugin install AKzar1el/mcp-gsc
+```
+
+The Copilot plugin bundles the same three Agent Skills plus the local loopback MCP configuration. Start the npm launcher before using the plugin's MCP server; the plugin does not start or deploy mcp-gsc for you.
+
 **Kiro**
 
 [![Add to Kiro](https://kiro.dev/images/add-to-kiro.svg)](https://kiro.dev/launch/mcp/add?name=mcp-gsc&config=%7B%22url%22%3A%22http%3A%2F%2F127.0.0.1%3A8080%2Fmcp%22%2C%22disabled%22%3Afalse%2C%22autoApprove%22%3A%5B%5D%7D)
 
-Start the npm launcher before using either install button. Complete its Google OAuth flow on first use.
+Start the npm launcher before using either install button or the Copilot plugin. Complete its Google OAuth flow on first use.
 
 **ChatGPT** — ChatGPT cannot connect directly to this loopback `127.0.0.1` endpoint. Use OpenAI's **Secure MCP Tunnel** for the local launcher, or deploy your own remote Cloudflare Worker and add that `/mcp` URL as a custom MCP app in Developer mode; see [Connect in your AI client](#connect-in-your-ai-client) below.
 

package/package.json

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

package/src/google.ts

@@ -52,10 +52,34 @@ export class GoogleRefreshTokenRevokedError extends Error {
 }
 
 const GOOGLE_READ_RETRYABLE_STATUSES = new Set([408, 429, 500, 502, 503, 504]);
+const GOOGLE_READ_RETRYABLE_403_REASONS = new Set([
+  'concurrentLimitExceeded',
+  'rateLimitExceeded',
+  'servingLimitExceeded',
+  'userRateLimitExceeded',
+]);
 const GOOGLE_READ_MAX_ATTEMPTS = 3;
 const GOOGLE_READ_BASE_DELAY_MS = 1_000;
 const GOOGLE_READ_MAX_DELAY_MS = 5_000;
 
+async function isGoogleReadRetryableResponse(response: Response): Promise<boolean> {
+  if (GOOGLE_READ_RETRYABLE_STATUSES.has(response.status)) return true;
+  if (response.status !== 403) return false;
+
+  try {
+    const data = (await response.clone().json()) as {
+      error?: { errors?: Array<{ reason?: unknown }> };
+    };
+    return data.error?.errors?.some(
+      (entry) =>
+        typeof entry.reason === 'string' &&
+        GOOGLE_READ_RETRYABLE_403_REASONS.has(entry.reason),
+    ) ?? false;
+  } catch {
+    return false;
+  }
+}
+
 function googleReadRetryDelayMs(response: Response, retryNumber: number): number | null {
   const retryAfter = response.headers.get('retry-after')?.trim();
   if (retryAfter) {
@@ -79,10 +103,8 @@ async function fetchGoogleRead(url: string, init?: RequestInit): Promise<Respons
   for (let attempt = 1; attempt <= GOOGLE_READ_MAX_ATTEMPTS; attempt += 1) {
     try {
       const response = await fetch(url, init);
-      if (
-        !GOOGLE_READ_RETRYABLE_STATUSES.has(response.status) ||
-        attempt === GOOGLE_READ_MAX_ATTEMPTS
-      ) {
+      const retryable = await isGoogleReadRetryableResponse(response);
+      if (!retryable || attempt === GOOGLE_READ_MAX_ATTEMPTS) {
         return response;
       }
 

package/src/index.ts

@@ -611,22 +611,30 @@ function windowSourceRows<T>(
   sourceStartRow: number,
   requestedLimit: number,
   sourceMayHaveMore: boolean,
+  sourceNextStartRow?: number,
 ) {
   const bounded = takeBoundedItems(items, requestedLimit);
   const returnedCount = bounded.items.length;
-  const hasMore =
-    bounded.byteLimitReached ||
-    returnedCount < items.length ||
-    sourceMayHaveMore;
+  const localContinuation =
+    bounded.byteLimitReached || returnedCount < items.length;
+  const hasMore = localContinuation || sourceMayHaveMore;
+  const resultPage = resultPageMetadata({
+    startRow: sourceStartRow,
+    limit: requestedLimit,
+    returnedCount,
+    hasMore,
+    byteLimitReached: bounded.byteLimitReached,
+  });
+  if (
+    !localContinuation &&
+    sourceMayHaveMore &&
+    sourceNextStartRow !== undefined
+  ) {
+    resultPage.next_start_row = sourceNextStartRow;
+  }
   return {
     items: bounded.items,
-    resultPage: resultPageMetadata({
-      startRow: sourceStartRow,
-      limit: requestedLimit,
-      returnedCount,
-      hasMore,
-      byteLimitReached: bounded.byteLimitReached,
-    }),
+    resultPage,
   };
 }
 
@@ -1268,13 +1276,17 @@ class GscMcpRuntime {
             ? { dimensionFilterGroups: dimension_filter_groups }
             : {}),
         });
+        // Search Analytics pagination is complete only after Google returns an
+        // explicit empty page. A short non-empty page can still be followed by
+        // later rows, so preserve a continuation for dimensioned queries.
         const sourceMayHaveMore =
-          dimensions.length > 0 && response.rows.length === sourceRowLimit;
+          dimensions.length > 0 && response.rows.length > 0;
         const bounded = windowSourceRows(
           response.rows,
           start_row,
           row_limit,
           sourceMayHaveMore,
+          start_row + sourceRowLimit,
         );
         const payload: Record<string, unknown> = {
           row_count: bounded.items.length,
@@ -1961,7 +1973,8 @@ class GscMcpRuntime {
           pages,
           start_row,
           row_limit,
-          response.rows.length === sourceRowLimit,
+          response.rows.length > 0,
+          start_row + sourceRowLimit,
         );
 
         const payload = {