@disruptorganic/mcp-google-search-console 1.0.0

package/dist/gsc/queries.js

@@ -0,0 +1,390 @@
+import { withExponentialBackoff } from '../utils/rate-limiter.js';
+import { logger } from '../utils/logger.js';
+function convertToGSCRow(row) {
+    return {
+        keys: row.keys || [],
+        clicks: row.clicks || 0,
+        impressions: row.impressions || 0,
+        ctr: row.ctr || 0,
+        position: row.position || 0,
+    };
+}
+function getRowKey(row) {
+    return row.keys.join('|');
+}
+function createKeywordFilter(keyword) {
+    return {
+        filters: [
+            {
+                dimension: 'query',
+                operator: 'equals',
+                expression: keyword,
+            },
+        ],
+    };
+}
+function mergeFilters(keywordFilter, additionalFilters) {
+    if (!additionalFilters || additionalFilters.length === 0) {
+        return [keywordFilter];
+    }
+    return [keywordFilter, ...additionalFilters];
+}
+export async function executeParallelQueries(client, queries, rateLimiter) {
+    if (!queries || queries.length === 0) {
+        logger.debug('No queries to execute');
+        return [];
+    }
+    logger.info('Executing parallel queries', {
+        queryCount: queries.length,
+        availableTokens: rateLimiter.getAvailableTokens().toFixed(2),
+    });
+    const startTime = Date.now();
+    const results = await Promise.all(queries.map(async (query, index) => {
+        try {
+            await rateLimiter.acquire();
+            logger.debug('Executing query', {
+                index: index + 1,
+                total: queries.length,
+                propertyUrl: query.propertyUrl,
+                dateRange: `${query.startDate} to ${query.endDate}`,
+                dimensions: query.dimensions,
+            });
+            const result = await withExponentialBackoff(async () => await client.query(query), {
+                maxRetries: 3,
+                initialDelay: 1000,
+                maxDelay: 30000,
+                factor: 2,
+            });
+            logger.debug('Query succeeded', {
+                index: index + 1,
+                total: queries.length,
+                rowCount: result.rows?.length || 0,
+            });
+            return result;
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            logger.error('Query failed after retries', {
+                index: index + 1,
+                total: queries.length,
+                error: errorMessage,
+                propertyUrl: query.propertyUrl,
+                dateRange: `${query.startDate} to ${query.endDate}`,
+            });
+            return { rows: [] };
+        }
+    }));
+    const duration = Date.now() - startTime;
+    const successCount = results.filter(r => r.rows && r.rows.length > 0).length;
+    const failedCount = queries.length - successCount;
+    logger.info('Parallel queries completed', {
+        total: queries.length,
+        successful: successCount,
+        failed: failedCount,
+        durationMs: duration,
+        queriesPerSecond: (queries.length / (duration / 1000)).toFixed(2),
+    });
+    return results;
+}
+export async function queryMultipleKeywords(client, propertyUrl, keywords, baseQuery, rateLimiter) {
+    if (!keywords || keywords.length === 0) {
+        logger.warn('No keywords provided for multi-keyword query');
+        return {
+            rows: [],
+            totalRows: 0,
+            queryCounts: { successful: 0, failed: 0, total: 0 },
+        };
+    }
+    logger.info('Executing multi-keyword query', {
+        propertyUrl,
+        keywordCount: keywords.length,
+        dateRange: `${baseQuery.startDate} to ${baseQuery.endDate}`,
+        dimensions: baseQuery.dimensions,
+    });
+    const queries = keywords.map(keyword => ({
+        propertyUrl,
+        startDate: baseQuery.startDate,
+        endDate: baseQuery.endDate,
+        dimensions: baseQuery.dimensions,
+        filters: [createKeywordFilter(keyword)],
+        rowLimit: baseQuery.rowLimit,
+        startRow: baseQuery.startRow,
+        searchType: baseQuery.searchType,
+        aggregationType: baseQuery.aggregationType,
+        dataState: baseQuery.dataState,
+    }));
+    const results = await executeParallelQueries(client, queries, rateLimiter);
+    const errors = [];
+    let successfulQueries = 0;
+    let failedQueries = 0;
+    results.forEach((result, index) => {
+        if (result.rows && result.rows.length > 0) {
+            successfulQueries++;
+        }
+        else {
+            failedQueries++;
+            errors.push({
+                identifier: keywords[index] || `query-${index}`,
+                error: 'Query returned no results or failed',
+                retried: true,
+                attempts: 3,
+            });
+        }
+    });
+    const aggregated = aggregateResults(results);
+    logger.info('Multi-keyword query completed', {
+        keywordCount: keywords.length,
+        successful: successfulQueries,
+        failed: failedQueries,
+        totalRows: aggregated.totalRows,
+    });
+    return {
+        rows: aggregated.rows,
+        totalRows: aggregated.totalRows,
+        queryCounts: {
+            successful: successfulQueries,
+            failed: failedQueries,
+            total: keywords.length,
+        },
+        errors: errors.length > 0 ? errors : undefined,
+    };
+}
+export function aggregateResults(results) {
+    if (!results || results.length === 0) {
+        return {
+            rows: [],
+            totalRows: 0,
+            queryCounts: { successful: 0, failed: 0, total: 0 },
+        };
+    }
+    logger.debug('Aggregating query results', {
+        resultCount: results.length,
+    });
+    const rowMap = new Map();
+    let totalInputRows = 0;
+    for (const result of results) {
+        if (!result.rows || result.rows.length === 0) {
+            continue;
+        }
+        totalInputRows += result.rows.length;
+        for (const rawRow of result.rows) {
+            const row = convertToGSCRow(rawRow);
+            const key = getRowKey(row);
+            const existing = rowMap.get(key);
+            if (existing) {
+                existing.clicks += row.clicks;
+                existing.impressions += row.impressions;
+                existing.weightedPositionSum += row.position * row.impressions;
+                logger.debug('Merged duplicate row', {
+                    key,
+                    clicks: existing.clicks,
+                    impressions: existing.impressions,
+                });
+            }
+            else {
+                rowMap.set(key, {
+                    keys: row.keys,
+                    clicks: row.clicks,
+                    impressions: row.impressions,
+                    weightedPositionSum: row.position * row.impressions,
+                });
+            }
+        }
+    }
+    const aggregatedRows = Array.from(rowMap.values()).map(row => ({
+        keys: row.keys,
+        clicks: row.clicks,
+        impressions: row.impressions,
+        ctr: row.impressions > 0 ? row.clicks / row.impressions : 0,
+        position: row.impressions > 0 ? row.weightedPositionSum / row.impressions : 0,
+    }));
+    logger.info('Results aggregated', {
+        inputRows: totalInputRows,
+        outputRows: aggregatedRows.length,
+        deduplicationRate: totalInputRows > 0
+            ? ((1 - aggregatedRows.length / totalInputRows) * 100).toFixed(1) + '%'
+            : '0%',
+    });
+    return {
+        rows: aggregatedRows,
+        totalRows: aggregatedRows.length,
+        queryCounts: {
+            successful: results.filter(r => r.rows && r.rows.length > 0).length,
+            failed: results.filter(r => !r.rows || r.rows.length === 0).length,
+            total: results.length,
+        },
+    };
+}
+export function sortResults(rows, sortBy, order = 'desc') {
+    const multiplier = order === 'desc' ? -1 : 1;
+    rows.sort((a, b) => {
+        const aValue = a[sortBy];
+        const bValue = b[sortBy];
+        return (aValue - bValue) * multiplier;
+    });
+    logger.debug('Results sorted', {
+        sortBy,
+        order,
+        rowCount: rows.length,
+    });
+    return rows;
+}
+export function filterResults(rows, thresholds) {
+    let filtered = rows;
+    if (thresholds.clicks !== undefined) {
+        filtered = filtered.filter(row => row.clicks >= thresholds.clicks);
+    }
+    if (thresholds.impressions !== undefined) {
+        filtered = filtered.filter(row => row.impressions >= thresholds.impressions);
+    }
+    if (thresholds.ctr !== undefined) {
+        filtered = filtered.filter(row => row.ctr >= thresholds.ctr);
+    }
+    if (thresholds.position !== undefined) {
+        filtered = filtered.filter(row => row.position <= thresholds.position);
+    }
+    logger.debug('Results filtered', {
+        inputRows: rows.length,
+        outputRows: filtered.length,
+        thresholds,
+    });
+    return filtered;
+}
+export function getResultStatistics(rows) {
+    if (!rows || rows.length === 0) {
+        return {
+            totalRows: 0,
+            totalClicks: 0,
+            totalImpressions: 0,
+            averageCtr: 0,
+            averagePosition: 0,
+            weightedAveragePosition: 0,
+        };
+    }
+    const totalClicks = rows.reduce((sum, row) => sum + row.clicks, 0);
+    const totalImpressions = rows.reduce((sum, row) => sum + row.impressions, 0);
+    const averageCtr = totalImpressions > 0 ? totalClicks / totalImpressions : 0;
+    const averagePosition = rows.reduce((sum, row) => sum + row.position, 0) / rows.length;
+    const weightedPositionSum = rows.reduce((sum, row) => sum + row.position * row.impressions, 0);
+    const weightedAveragePosition = totalImpressions > 0
+        ? weightedPositionSum / totalImpressions
+        : 0;
+    return {
+        totalRows: rows.length,
+        totalClicks,
+        totalImpressions,
+        averageCtr,
+        averagePosition,
+        weightedAveragePosition,
+    };
+}
+export async function executeTopNQuery(client, property, startDate, endDate, dimension, options = {}) {
+    const { limit = 20, sortBy = 'clicks', sortOrder = 'desc', searchType = 'web', minClicks, minImpressions, positionRange, deviceType, country, } = options;
+    logger.debug('Executing top-N query', {
+        property,
+        dimension,
+        limit,
+        sortBy,
+        sortOrder,
+        dateRange: `${startDate} to ${endDate}`,
+    });
+    const dimensionFilters = [];
+    if (deviceType) {
+        dimensionFilters.push({
+            dimension: 'device',
+            operator: 'equals',
+            expression: deviceType.toLowerCase(),
+        });
+    }
+    if (country) {
+        dimensionFilters.push({
+            dimension: 'country',
+            operator: 'equals',
+            expression: country.toLowerCase(),
+        });
+    }
+    const queryParams = {
+        propertyUrl: property,
+        startDate,
+        endDate,
+        dimensions: [dimension],
+        searchType: searchType,
+        dataState: 'final',
+        rowLimit: Math.min(limit * 10, 25000),
+    };
+    if (dimensionFilters.length > 0) {
+        queryParams.filters = [{ filters: dimensionFilters }];
+    }
+    logger.debug('GSC API request prepared', {
+        dimensions: queryParams.dimensions,
+        filters: dimensionFilters.length,
+        rowLimit: queryParams.rowLimit,
+    });
+    const rateLimiter = client.getRateLimiter();
+    await rateLimiter.acquire();
+    const response = await withExponentialBackoff(async () => await client.query(queryParams), {
+        maxRetries: 3,
+        initialDelay: 1000,
+        maxDelay: 30000,
+        factor: 2,
+    });
+    if (!response || !response.rows || response.rows.length === 0) {
+        logger.info('Top-N query returned no results', {
+            property,
+            dimension,
+            dateRange: `${startDate} to ${endDate}`,
+        });
+        return [];
+    }
+    logger.debug('Query returned results', {
+        rowCount: response.rows.length,
+    });
+    let results = response.rows.map((row) => convertToGSCRow(row));
+    logger.debug('Results transformed', {
+        rowCount: results.length,
+    });
+    const originalCount = results.length;
+    if (minClicks !== undefined) {
+        results = results.filter((row) => row.clicks >= minClicks);
+        logger.debug('Filtered by minClicks', {
+            threshold: minClicks,
+            before: originalCount,
+            after: results.length,
+        });
+    }
+    if (minImpressions !== undefined) {
+        results = results.filter((row) => row.impressions >= minImpressions);
+        logger.debug('Filtered by minImpressions', {
+            threshold: minImpressions,
+            after: results.length,
+        });
+    }
+    if (positionRange) {
+        results = results.filter((row) => row.position >= positionRange.min && row.position <= positionRange.max);
+        logger.debug('Filtered by positionRange', {
+            range: positionRange,
+            after: results.length,
+        });
+    }
+    const multiplier = sortOrder === 'desc' ? -1 : 1;
+    results.sort((a, b) => {
+        const aVal = a[sortBy];
+        const bVal = b[sortBy];
+        return multiplier * (aVal - bVal);
+    });
+    logger.debug('Results sorted', {
+        sortBy,
+        sortOrder,
+        rowCount: results.length,
+    });
+    const limitedResults = results.slice(0, limit);
+    logger.info('Top-N query completed', {
+        property,
+        dimension,
+        totalFiltered: results.length,
+        returned: limitedResults.length,
+        limit,
+    });
+    return limitedResults;
+}
+//# sourceMappingURL=queries.js.map

package/dist/gsc/queries.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,186 @@
+#!/usr/bin/env node
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { GSCAuth } from './auth/oauth2.js';
+import { GSCClient } from './gsc/client.js';
+import { allTools, toolHandlers, getToolStats } from './tools/index.js';
+import { logger } from './utils/logger.js';
+import { getEnvironment } from './config/index.js';
+const SERVER_VERSION = '1.0.0';
+const SERVER_NAME = 'google-search-console-mcp';
+let gscClient = null;
+let clientInitializationPromise = null;
+const server = new Server({
+    name: SERVER_NAME,
+    version: SERVER_VERSION,
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+async function initializeClient() {
+    if (gscClient) {
+        logger.debug('Returning existing GSC client');
+        return gscClient;
+    }
+    if (clientInitializationPromise) {
+        logger.debug('Waiting for ongoing client initialization');
+        return clientInitializationPromise;
+    }
+    logger.info('Initializing Google Search Console client...');
+    clientInitializationPromise = (async () => {
+        try {
+            const authManager = new GSCAuth();
+            const oauth2Client = await authManager.getAuthenticatedClient();
+            logger.info('Using cached OAuth2 tokens (auto-refresh enabled)');
+            gscClient = new GSCClient(oauth2Client);
+            const isValid = await gscClient.validateConnection();
+            if (!isValid) {
+                throw new Error('Failed to validate GSC API connection');
+            }
+            logger.info('GSC client initialized and validated successfully');
+            return gscClient;
+        }
+        catch (error) {
+            clientInitializationPromise = null;
+            logger.error('Failed to initialize GSC client', {
+                error: error instanceof Error ? error.message : String(error),
+            });
+            if (error instanceof Error && error.message.includes('not authenticated')) {
+                throw new Error('Authentication required. Please run authentication setup first. See docs/AUTHENTICATION_SETUP.md');
+            }
+            throw error;
+        }
+    })();
+    return clientInitializationPromise;
+}
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    logger.debug('Listing available tools', { count: allTools.length });
+    return {
+        tools: allTools,
+    };
+});
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: params } = request.params;
+    logger.info('Tool called', {
+        tool: name,
+        hasParams: !!params,
+        paramKeys: params ? Object.keys(params) : [],
+    });
+    try {
+        const handler = toolHandlers[name];
+        if (!handler) {
+            const availableTools = Object.keys(toolHandlers).join(', ');
+            logger.error('Tool not found', { tool: name, availableTools });
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Unknown tool: ${name}\n\nAvailable tools: ${availableTools}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const client = await initializeClient();
+        logger.debug('Executing tool handler', { tool: name });
+        const result = await handler(params || {}, client);
+        logger.info('Tool executed successfully', {
+            tool: name,
+            hasError: result.isError || false,
+        });
+        return result;
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        const errorStack = error instanceof Error ? error.stack : undefined;
+        logger.error('Tool execution failed', {
+            tool: name,
+            error: errorMessage,
+            stack: errorStack,
+        });
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Error executing ${name}: ${errorMessage}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+async function shutdown(signal) {
+    logger.info(`Received ${signal}, shutting down gracefully...`);
+    try {
+        if (gscClient) {
+            const rateLimitStatus = gscClient.getRateLimitStatus();
+            logger.info('Final rate limiter statistics', rateLimitStatus);
+            const toolStats = getToolStats();
+            logger.info('Tool statistics', toolStats);
+        }
+        await server.close();
+        logger.info('Server shut down successfully');
+        process.exit(0);
+    }
+    catch (error) {
+        logger.error('Error during shutdown', {
+            error: error instanceof Error ? error.message : String(error),
+        });
+        process.exit(1);
+    }
+}
+async function main() {
+    try {
+        logger.info('Starting Google Search Console MCP Server...', {
+            name: SERVER_NAME,
+            version: SERVER_VERSION,
+            nodeVersion: process.version,
+            platform: process.platform,
+            environment: getEnvironment(),
+        });
+        const toolStats = getToolStats();
+        logger.info('Server configuration', {
+            totalTools: toolStats.total,
+            tools: toolStats.names,
+        });
+        logger.debug('Tool details', {
+            tools: toolStats.tools.map((t) => ({
+                name: t.name,
+                description: t.description,
+                requiredParams: t.requiredParams,
+                optionalParams: t.optionalParams,
+            })),
+        });
+        process.on('SIGINT', () => shutdown('SIGINT'));
+        process.on('SIGTERM', () => shutdown('SIGTERM'));
+        process.on('uncaughtException', (error) => {
+            logger.error('Uncaught exception', {
+                error: error.message,
+                stack: error.stack,
+            });
+            shutdown('uncaughtException');
+        });
+        process.on('unhandledRejection', (reason) => {
+            logger.error('Unhandled rejection', {
+                reason: reason instanceof Error ? reason.message : String(reason),
+            });
+            shutdown('unhandledRejection');
+        });
+        const transport = new StdioServerTransport();
+        await server.connect(transport);
+        logger.info('MCP Server started successfully and listening on stdio');
+        logger.info(`Available tools: ${toolStats.names.join(', ')}`);
+        logger.info('Client will be initialized on first tool call (lazy initialization)');
+    }
+    catch (error) {
+        logger.error('Failed to start server', {
+            error: error instanceof Error ? error.message : String(error),
+            stack: error instanceof Error ? error.stack : undefined,
+        });
+        process.exit(1);
+    }
+}
+main();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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