@disruptorganic/mcp-google-search-console 1.0.0

package/dist/config/index.js

@@ -0,0 +1,87 @@
+import { z } from 'zod';
+import * as path from 'path';
+import * as os from 'os';
+const configSchema = z.object({
+    clientId: z.string().min(1, 'GSC_CLIENT_ID is required'),
+    clientSecret: z.string().min(1, 'GSC_CLIENT_SECRET is required'),
+    tokenPath: z.string().default(path.join(os.homedir(), '.mcp-gsc', 'tokens.json')),
+    redirectUri: z.string().default('urn:ietf:wg:oauth:2.0:oob'),
+    logLevel: z.enum(['error', 'warn', 'info', 'debug']).default('info'),
+});
+function loadConfig() {
+    const rawConfig = {
+        clientId: process.env.GSC_CLIENT_ID,
+        clientSecret: process.env.GSC_CLIENT_SECRET,
+        tokenPath: process.env.GSC_TOKEN_PATH,
+        redirectUri: process.env.GSC_REDIRECT_URI,
+        logLevel: process.env.LOG_LEVEL,
+    };
+    try {
+        return configSchema.parse(rawConfig);
+    }
+    catch (error) {
+        if (error instanceof z.ZodError) {
+            const missingFields = error.issues
+                .map(issue => {
+                const field = issue.path.join('.');
+                return `  - ${field}: ${issue.message}`;
+            })
+                .join('\n');
+            const errorMessage = `
+Configuration Error: Missing or invalid environment variables
+
+${missingFields}
+
+Please set the required environment variables:
+  - GSC_CLIENT_ID: Your Google OAuth2 Client ID
+  - GSC_CLIENT_SECRET: Your Google OAuth2 Client Secret
+
+Optional environment variables (with defaults):
+  - GSC_TOKEN_PATH: Token storage path (default: ~/.mcp-gsc/tokens.json)
+  - GSC_REDIRECT_URI: OAuth redirect URI (default: urn:ietf:wg:oauth:2.0:oob)
+  - LOG_LEVEL: Logging level (default: info, options: error, warn, info, debug)
+
+To obtain OAuth2 credentials:
+  1. Go to https://console.cloud.google.com/apis/credentials
+  2. Create a new OAuth 2.0 Client ID (Desktop application type)
+  3. Enable the Google Search Console API for your project
+  4. Copy the Client ID and Client Secret
+
+See .env.example for a complete configuration template.
+`.trim();
+            throw new Error(errorMessage);
+        }
+        throw error;
+    }
+}
+export const config = loadConfig();
+export function getTokenDirectory() {
+    return path.dirname(config.tokenPath);
+}
+export function isDevelopment() {
+    return process.env.NODE_ENV === 'development';
+}
+export function isProduction() {
+    return process.env.NODE_ENV === 'production';
+}
+export function getEnvironment() {
+    return process.env.NODE_ENV || 'development';
+}
+export function getConfigSummary() {
+    return {
+        clientId: config.clientId.substring(0, 8) + '...',
+        clientSecret: '***',
+        tokenPath: config.tokenPath,
+        redirectUri: config.redirectUri,
+        logLevel: config.logLevel,
+        environment: getEnvironment(),
+    };
+}
+export function logConfigSummary() {
+    console.log('Configuration loaded successfully:');
+    const summary = getConfigSummary();
+    Object.entries(summary).forEach(([key, value]) => {
+        console.log(`  ${key}: ${value}`);
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"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"}

package/dist/gsc/client.d.ts

@@ -0,0 +1,72 @@
+import { OAuth2Client } from 'google-auth-library';
+import { TokenBucketRateLimiter } from '../utils/rate-limiter.js';
+export interface PropertyInfo {
+    propertyUrl: string;
+    permissionLevel: string;
+}
+export interface QueryParams {
+    propertyUrl: string;
+    startDate: string;
+    endDate: string;
+    dimensions?: string[];
+    filters?: FilterGroup[];
+    rowLimit?: number;
+    startRow?: number;
+    aggregationType?: 'auto' | 'byProperty' | 'byPage';
+    searchType?: 'web' | 'image' | 'video' | 'news' | 'discover' | 'googleNews';
+    dataState?: 'final' | 'all';
+}
+export interface FilterGroup {
+    filters: Filter[];
+}
+export interface Filter {
+    dimension: string;
+    operator: 'equals' | 'notEquals' | 'contains' | 'notContains' | 'includingRegex' | 'excludingRegex';
+    expression: string;
+}
+export interface QueryResponse {
+    rows?: QueryRow[];
+    responseAggregationType?: string;
+}
+export interface QueryRow {
+    keys?: string[];
+    clicks?: number;
+    impressions?: number;
+    ctr?: number;
+    position?: number;
+}
+export interface PropertyMetadata {
+    propertyUrl: string;
+    permissionLevel: string;
+    siteUrl?: string;
+}
+export declare class GSCApiError extends Error {
+    code: string;
+    statusCode?: number | undefined;
+    retriable: boolean;
+    userMessage?: string | undefined;
+    constructor(message: string, code: string, statusCode?: number | undefined, retriable?: boolean, userMessage?: string | undefined);
+}
+export declare class GSCClient {
+    private webmasters;
+    private rateLimiter;
+    private _oauth2Client;
+    constructor(oauth2Client: OAuth2Client);
+    getOAuth2Client(): OAuth2Client;
+    validateConnection(): Promise<boolean>;
+    listProperties(): Promise<PropertyInfo[]>;
+    getPropertyInfo(propertyUrl: string): Promise<PropertyMetadata>;
+    query(params: QueryParams): Promise<QueryResponse>;
+    queryMultiple(paramsArray: QueryParams[]): Promise<QueryResponse[]>;
+    private validateQueryParams;
+    private mapError;
+    getRateLimitStatus(): {
+        availableTokens: number;
+        maxTokens: number;
+        pendingAcquisitions: number;
+        refillRate: number;
+        queriesPerMinute: number;
+    };
+    getRateLimiter(): TokenBucketRateLimiter;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/gsc/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/gsc/client.ts"],"names":[],"mappings":"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"}

package/dist/gsc/client.js

@@ -0,0 +1,243 @@
+import { google } from 'googleapis';
+import { logger } from '../utils/logger.js';
+import { TokenBucketRateLimiter, withExponentialBackoff } from '../utils/rate-limiter.js';
+export class GSCApiError extends Error {
+    constructor(message, code, statusCode, retriable = false, userMessage) {
+        super(message);
+        this.code = code;
+        this.statusCode = statusCode;
+        this.retriable = retriable;
+        this.userMessage = userMessage;
+        this.name = 'GSCApiError';
+    }
+}
+let sharedRateLimiter = null;
+function getSharedRateLimiter() {
+    if (!sharedRateLimiter) {
+        sharedRateLimiter = new TokenBucketRateLimiter(18, 18);
+        logger.info('Shared rate limiter initialized', {
+            maxTokens: 18,
+            refillRate: 18,
+            queriesPerMinute: 1080,
+            safetyMargin: '90% of official limit',
+        });
+    }
+    return sharedRateLimiter;
+}
+export class GSCClient {
+    constructor(oauth2Client) {
+        this._oauth2Client = oauth2Client;
+        this.webmasters = google.webmasters({ version: 'v3', auth: oauth2Client });
+        this.rateLimiter = getSharedRateLimiter();
+    }
+    getOAuth2Client() {
+        return this._oauth2Client;
+    }
+    async validateConnection() {
+        try {
+            await this.listProperties();
+            return true;
+        }
+        catch (error) {
+            return false;
+        }
+    }
+    async listProperties() {
+        await this.rateLimiter.acquire();
+        return withExponentialBackoff(async () => {
+            try {
+                const response = await this.webmasters.sites.list();
+                if (!response.data.siteEntry) {
+                    return [];
+                }
+                return response.data.siteEntry.map((site) => ({
+                    propertyUrl: site.siteUrl,
+                    permissionLevel: site.permissionLevel
+                }));
+            }
+            catch (error) {
+                throw this.mapError(error, 'Failed to list properties');
+            }
+        }, {
+            maxRetries: 3,
+            initialDelay: 1000,
+            maxDelay: 30000,
+        });
+    }
+    async getPropertyInfo(propertyUrl) {
+        await this.rateLimiter.acquire();
+        return withExponentialBackoff(async () => {
+            try {
+                const response = await this.webmasters.sites.get({
+                    siteUrl: propertyUrl
+                });
+                return {
+                    propertyUrl: response.data.siteUrl,
+                    permissionLevel: response.data.permissionLevel,
+                    siteUrl: response.data.siteUrl
+                };
+            }
+            catch (error) {
+                throw this.mapError(error, `Failed to get property info for: ${propertyUrl}`);
+            }
+        }, {
+            maxRetries: 3,
+            initialDelay: 1000,
+            maxDelay: 30000,
+        });
+    }
+    async query(params) {
+        this.validateQueryParams(params);
+        await this.rateLimiter.acquire();
+        return withExponentialBackoff(async () => {
+            try {
+                const requestBody = {
+                    startDate: params.startDate,
+                    endDate: params.endDate,
+                    dimensions: params.dimensions || [],
+                    rowLimit: params.rowLimit || 25000,
+                    startRow: params.startRow || 0
+                };
+                if (params.filters && params.filters.length > 0) {
+                    requestBody.dimensionFilterGroups = params.filters.map(group => ({
+                        filters: group.filters.map(filter => ({
+                            dimension: filter.dimension,
+                            operator: filter.operator,
+                            expression: filter.expression
+                        }))
+                    }));
+                }
+                if (params.aggregationType) {
+                    requestBody.aggregationType = params.aggregationType;
+                }
+                if (params.searchType) {
+                    requestBody.type = params.searchType;
+                }
+                if (params.dataState) {
+                    requestBody.dataState = params.dataState;
+                }
+                const response = await this.webmasters.searchanalytics.query({
+                    siteUrl: params.propertyUrl,
+                    requestBody
+                });
+                return {
+                    rows: response.data.rows || [],
+                    responseAggregationType: response.data.responseAggregationType
+                };
+            }
+            catch (error) {
+                throw this.mapError(error, 'Query execution failed');
+            }
+        }, {
+            maxRetries: 3,
+            initialDelay: 1000,
+            maxDelay: 30000,
+        });
+    }
+    async queryMultiple(paramsArray) {
+        const results = [];
+        logger.info('Executing multiple queries sequentially', {
+            count: paramsArray.length,
+        });
+        for (let i = 0; i < paramsArray.length; i++) {
+            const params = paramsArray[i];
+            if (!params) {
+                logger.warn('Skipping undefined query params', { index: i + 1 });
+                results.push({ rows: [] });
+                continue;
+            }
+            try {
+                logger.debug('Executing sequential query', {
+                    index: i + 1,
+                    total: paramsArray.length,
+                    propertyUrl: params.propertyUrl,
+                });
+                const result = await this.query(params);
+                results.push(result);
+            }
+            catch (error) {
+                logger.error('Query execution failed in batch', {
+                    error: error instanceof Error ? error.message : String(error),
+                    index: i + 1,
+                    total: paramsArray.length,
+                    params: {
+                        propertyUrl: params.propertyUrl,
+                        startDate: params.startDate,
+                        endDate: params.endDate,
+                        dimensions: params.dimensions,
+                        rowLimit: params.rowLimit
+                    }
+                });
+                results.push({ rows: [] });
+            }
+        }
+        logger.info('Sequential queries completed', {
+            total: paramsArray.length,
+            successful: results.filter(r => r.rows && r.rows.length > 0).length,
+        });
+        return results;
+    }
+    validateQueryParams(params) {
+        const startDate = new Date(params.startDate);
+        const endDate = new Date(params.endDate);
+        const now = new Date();
+        const sixteenMonthsAgo = new Date();
+        sixteenMonthsAgo.setMonth(now.getMonth() - 16);
+        if (startDate < sixteenMonthsAgo) {
+            throw new GSCApiError('Start date exceeds 16-month historical limit', 'INVALID_DATE_RANGE', 400, false, `Start date must be within the last 16 months (after ${sixteenMonthsAgo.toISOString().split('T')[0]})`);
+        }
+        if (startDate > endDate) {
+            throw new GSCApiError('Start date must be before or equal to end date', 'INVALID_DATE_RANGE', 400, false, 'Start date must be before or equal to end date');
+        }
+        if (endDate > now) {
+            throw new GSCApiError('End date cannot be in the future', 'INVALID_DATE_RANGE', 400, false, 'End date cannot be in the future');
+        }
+        if (params.dimensions && params.dimensions.length > 3) {
+            throw new GSCApiError('Maximum 3 dimensions allowed', 'INVALID_DIMENSIONS', 400, false, 'Google Search Console API allows a maximum of 3 dimensions per query');
+        }
+        if (params.rowLimit && (params.rowLimit < 1 || params.rowLimit > 25000)) {
+            throw new GSCApiError('Row limit must be between 1 and 25,000', 'INVALID_ROW_LIMIT', 400, false, 'Row limit must be between 1 and 25,000');
+        }
+        if (!params.propertyUrl || params.propertyUrl.trim() === '') {
+            throw new GSCApiError('Property URL is required', 'MISSING_PROPERTY', 400, false, 'Property URL is required. Use list_properties tool first to get available properties.');
+        }
+    }
+    mapError(error, context) {
+        const statusCode = error.response?.status || error.code;
+        const errorMessage = error.response?.data?.error?.message || error.message || 'Unknown error';
+        switch (statusCode) {
+            case 401:
+                return new GSCApiError(`Authentication failed: ${errorMessage}`, 'AUTHENTICATION_FAILED', 401, false, 'Authentication failed. Please re-authenticate with Google Search Console.');
+            case 403:
+                return new GSCApiError(`Access denied: ${errorMessage}`, 'ACCESS_DENIED', 403, false, 'Access denied. Ensure you have permission to access this property in Google Search Console.');
+            case 404:
+                return new GSCApiError(`Property not found: ${errorMessage}`, 'PROPERTY_NOT_FOUND', 404, false, 'Property not found. Use list_properties tool to see available properties.');
+            case 429:
+                return new GSCApiError(`Rate limit exceeded: ${errorMessage}`, 'RATE_LIMIT_EXCEEDED', 429, true, 'Rate limit exceeded. Please wait a moment and try again.');
+            case 500:
+            case 502:
+            case 503:
+            case 504:
+                return new GSCApiError(`Google API service error: ${errorMessage}`, 'SERVICE_ERROR', statusCode, true, 'Google Search Console API is temporarily unavailable. Please try again in a moment.');
+            case 'ENOTFOUND':
+            case 'ETIMEDOUT':
+            case 'ECONNRESET':
+                return new GSCApiError(`Network error: ${errorMessage}`, 'NETWORK_ERROR', undefined, true, 'Network error occurred. Please check your connection and try again.');
+            default:
+                return new GSCApiError(`${context}: ${errorMessage}`, 'UNKNOWN_ERROR', statusCode, false, `An unexpected error occurred: ${errorMessage}`);
+        }
+    }
+    getRateLimitStatus() {
+        return {
+            availableTokens: this.rateLimiter.getAvailableTokens(),
+            maxTokens: 18,
+            pendingAcquisitions: this.rateLimiter.getPendingAcquisitions(),
+            refillRate: 18,
+            queriesPerMinute: 1200,
+        };
+    }
+    getRateLimiter() {
+        return this.rateLimiter;
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/gsc/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/gsc/client.ts"],"names":[],"mappings":"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"}

package/dist/gsc/index.d.ts

@@ -0,0 +1,3 @@
+export { GSCClient, GSCApiError, type PropertyInfo, type QueryParams, type QueryResponse, type QueryRow, type FilterGroup, type Filter, type PropertyMetadata } from './client.js';
+export { executeParallelQueries, queryMultipleKeywords, aggregateResults, sortResults, filterResults, getResultStatistics, type QueryRequest, type GSCRow, type QueryError, type AggregatedQueryResults } from './queries.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/gsc/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/gsc/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,WAAW,EACX,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,QAAQ,EACb,KAAK,WAAW,EAChB,KAAK,MAAM,EACX,KAAK,gBAAgB,EACtB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,gBAAgB,EAChB,WAAW,EACX,aAAa,EACb,mBAAmB,EACnB,KAAK,YAAY,EACjB,KAAK,MAAM,EACX,KAAK,UAAU,EACf,KAAK,sBAAsB,EAC5B,MAAM,cAAc,CAAC"}

package/dist/gsc/index.js

@@ -0,0 +1,3 @@
+export { GSCClient, GSCApiError } from './client.js';
+export { executeParallelQueries, queryMultipleKeywords, aggregateResults, sortResults, filterResults, getResultStatistics } from './queries.js';
+//# sourceMappingURL=index.js.map

package/dist/gsc/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/gsc/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,WAAW,EAQZ,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,gBAAgB,EAChB,WAAW,EACX,aAAa,EACb,mBAAmB,EAKpB,MAAM,cAAc,CAAC"}

package/dist/gsc/properties.d.ts

@@ -0,0 +1,42 @@
+import { GSCClient } from './client.js';
+export type PropertyType = 'domain' | 'url_prefix' | 'unknown';
+export interface Property {
+    propertyUrl: string;
+    propertyType: PropertyType;
+    permissionLevel: string;
+    domain?: string;
+    baseUrl?: string;
+    protocol?: 'http' | 'https';
+}
+export interface GroupedProperties {
+    domain: Property[];
+    url_prefix: Property[];
+    counts: {
+        domain: number;
+        url_prefix: number;
+        total: number;
+    };
+}
+export type PropertyMatchType = 'exact_domain' | 'exact_url_https' | 'exact_url_http' | 'fuzzy_domain' | 'fuzzy_url' | 'none';
+export interface PropertyMatchResult {
+    matched: Property | null;
+    matchType: PropertyMatchType;
+    alternatives?: Property[];
+    normalizedInput: string;
+    searchInput: string;
+}
+export declare function detectPropertyType(propertyUrl: string): PropertyType;
+export declare function formatProperties(rawProperties: any[]): Property[];
+export declare function groupPropertiesByType(properties: Property[]): GroupedProperties;
+export declare function matchProperty(searchInput: string, availableProperties: Property[]): PropertyMatchResult;
+export declare function generatePropertyMatchError(result: PropertyMatchResult, availableProperties: Property[]): string;
+export declare function listProperties(client: GSCClient, forceRefresh?: boolean): Promise<Property[]>;
+export declare function findProperty(properties: Property[], searchUrl: string): Property | undefined;
+export declare function getPropertySuggestions(properties: Property[], partialUrl: string, limit?: number): Property[];
+export declare function invalidatePropertiesCache(): void;
+export declare function getPropertiesCacheInfo(): {
+    isCached: boolean;
+    ttl?: number;
+    cachedCount?: number;
+};
+//# sourceMappingURL=properties.d.ts.map

package/dist/gsc/properties.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"properties.d.ts","sourceRoot":"","sources":["../../src/gsc/properties.ts"],"names":[],"mappings":"AA+BA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAcxC,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,YAAY,GAAG,SAAS,CAAC;AAK/D,MAAM,WAAW,QAAQ;IAEvB,WAAW,EAAE,MAAM,CAAC;IAEpB,YAAY,EAAE,YAAY,CAAC;IAE3B,eAAe,EAAE,MAAM,CAAC;IAExB,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CAC7B;AAKD,MAAM,WAAW,iBAAiB;IAEhC,MAAM,EAAE,QAAQ,EAAE,CAAC;IAEnB,UAAU,EAAE,QAAQ,EAAE,CAAC;IAEvB,MAAM,EAAE;QACN,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;CACH;AAKD,MAAM,MAAM,iBAAiB,GACzB,cAAc,GACd,iBAAiB,GACjB,gBAAgB,GAChB,cAAc,GACd,WAAW,GACX,MAAM,CAAC;AAWX,MAAM,WAAW,mBAAmB;IAElC,OAAO,EAAE,QAAQ,GAAG,IAAI,CAAC;IAEzB,SAAS,EAAE,iBAAiB,CAAC;IAE7B,YAAY,CAAC,EAAE,QAAQ,EAAE,CAAC;IAE1B,eAAe,EAAE,MAAM,CAAC;IAExB,WAAW,EAAE,MAAM,CAAC;CACrB;AAqBD,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,YAAY,CAqBpE;AA4DD,wBAAgB,gBAAgB,CAAC,aAAa,EAAE,GAAG,EAAE,GAAG,QAAQ,EAAE,CAoEjE;AAqBD,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,QAAQ,EAAE,GAAG,iBAAiB,CAiB/E;AAqID,wBAAgB,aAAa,CAC3B,WAAW,EAAE,MAAM,EACnB,mBAAmB,EAAE,QAAQ,EAAE,GAC9B,mBAAmB,CAuNrB;AAsBD,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,mBAAmB,EAC3B,mBAAmB,EAAE,QAAQ,EAAE,GAC9B,MAAM,CAmCR;AAmCD,wBAAsB,cAAc,CAClC,MAAM,EAAE,SAAS,EACjB,YAAY,GAAE,OAAe,GAC5B,OAAO,CAAC,QAAQ,EAAE,CAAC,CAoDrB;AAiBD,wBAAgB,YAAY,CAAC,UAAU,EAAE,QAAQ,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAoB5F;AAYD,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,QAAQ,EAAE,EACtB,UAAU,EAAE,MAAM,EAClB,KAAK,GAAE,MAAU,GAChB,QAAQ,EAAE,CAeZ;AAQD,wBAAgB,yBAAyB,IAAI,IAAI,CAGhD;AAOD,wBAAgB,sBAAsB,IAAI;IACxC,QAAQ,EAAE,OAAO,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAgBA"}