@disruptorganic/mcp-google-search-console 1.0.0

package/dist/tools/query-by-url.js

@@ -0,0 +1,366 @@
+import { z } from 'zod';
+import { listProperties, matchProperty, generatePropertyMatchError } from '../gsc/properties.js';
+import { executeParallelQueries, aggregateResults } from '../gsc/queries.js';
+import { chunkResults } from '../utils/token-estimator.js';
+import { validateDateRangeStrict, validateDimensions } from '../utils/validators.js';
+import { logger } from '../utils/logger.js';
+export const QueryByUrlSchema = z.object({
+    property: z.string()
+        .min(1, 'Property identifier is required')
+        .describe('Property identifier from list_properties (e.g., "sc-domain:example.com")'),
+    urls: z.array(z.string().url('Must be a valid URL').refine(url => url.startsWith('http://') || url.startsWith('https://'), 'URL must start with http:// or https://'))
+        .min(1, 'At least one URL is required')
+        .max(50, 'Maximum 50 URLs allowed per request')
+        .describe('Array of page URLs to query (1-50 URLs)'),
+    startDate: z.string()
+        .regex(/^\d{4}-\d{2}-\d{2}$/, 'Start date must be in ISO 8601 format (YYYY-MM-DD)')
+        .describe('Start date in ISO 8601 format (YYYY-MM-DD)'),
+    endDate: z.string()
+        .regex(/^\d{4}-\d{2}-\d{2}$/, 'End date must be in ISO 8601 format (YYYY-MM-DD)')
+        .describe('End date in ISO 8601 format (YYYY-MM-DD)'),
+    searchType: z.enum(['web', 'image', 'video', 'news', 'discover', 'googleNews'])
+        .optional()
+        .default('web')
+        .describe('Search type filter (default: web)'),
+    dimensions: z.array(z.enum(['query', 'device', 'country', 'searchAppearance', 'date']))
+        .optional()
+        .describe('Additional dimensions beyond page (max 2 additional for total of 3)'),
+    deviceType: z.enum(['desktop', 'mobile', 'tablet'])
+        .optional()
+        .describe('Filter by device type'),
+    country: z.string()
+        .length(3, 'Country code must be 3 letters')
+        .regex(/^[a-z]{3}$/, 'Country code must be 3 lowercase letters (ISO 3166-1 alpha-3)')
+        .optional()
+        .describe('Filter by country code (e.g., "usa", "gbr")'),
+    offset: z.number()
+        .int('Offset must be an integer')
+        .min(0, 'Offset must be non-negative')
+        .optional()
+        .default(0)
+        .describe('Pagination offset for chunked responses (default: 0)'),
+    limit: z.number()
+        .int('Limit must be an integer')
+        .min(1, 'Limit must be at least 1')
+        .max(25000, 'Limit cannot exceed 25,000 (GSC API limit)')
+        .optional()
+        .describe('Max rows per chunk (auto-calculated if not provided)'),
+});
+export const queryByUrlTool = {
+    name: 'query_by_url',
+    description: 'Retrieves search performance data for specific URLs/pages from Google Search Console. Shows which keywords drive traffic to each URL with clicks, impressions, CTR, and position. Supports filtering by date range, search type (web/image/video/news), device, and country. Automatically chunks large results under 20k tokens with pagination. IMPORTANT: Use list_properties first to get the correct property identifier.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            property: {
+                type: 'string',
+                description: 'Property identifier from list_properties (e.g., "sc-domain:example.com")',
+            },
+            urls: {
+                type: 'array',
+                items: { type: 'string', format: 'uri' },
+                description: 'Array of page URLs to query (1-50 URLs)',
+                minItems: 1,
+                maxItems: 50,
+            },
+            startDate: {
+                type: 'string',
+                description: 'Start date in ISO 8601 format (YYYY-MM-DD)',
+                pattern: '^\\d{4}-\\d{2}-\\d{2}$',
+            },
+            endDate: {
+                type: 'string',
+                description: 'End date in ISO 8601 format (YYYY-MM-DD)',
+                pattern: '^\\d{4}-\\d{2}-\\d{2}$',
+            },
+            searchType: {
+                type: 'string',
+                enum: ['web', 'image', 'video', 'news', 'discover', 'googleNews'],
+                description: 'Search type filter (default: web)',
+                default: 'web',
+            },
+            dimensions: {
+                type: 'array',
+                items: {
+                    type: 'string',
+                    enum: ['query', 'device', 'country', 'searchAppearance', 'date'],
+                },
+                description: 'Additional dimensions beyond page (max 2 additional for total of 3)',
+            },
+            deviceType: {
+                type: 'string',
+                enum: ['desktop', 'mobile', 'tablet'],
+                description: 'Filter by device type',
+            },
+            country: {
+                type: 'string',
+                description: 'Filter by country code (e.g., "usa", "gbr")',
+                pattern: '^[a-z]{3}$',
+            },
+            offset: {
+                type: 'number',
+                description: 'Pagination offset for chunked responses (default: 0)',
+                default: 0,
+                minimum: 0,
+            },
+            limit: {
+                type: 'number',
+                description: 'Max rows per chunk (auto-calculated if not provided)',
+                minimum: 1,
+                maximum: 25000,
+            },
+        },
+        required: ['property', 'urls', 'startDate', 'endDate'],
+    },
+};
+function formatResultRow(keys, dimensions, clicks, impressions, ctr, position) {
+    const row = {};
+    dimensions.forEach((dim, index) => {
+        row[dim] = keys[index] || '';
+    });
+    row.clicks = clicks;
+    row.impressions = impressions;
+    row.ctr = parseFloat((ctr * 100).toFixed(2));
+    row.position = parseFloat(position.toFixed(1));
+    return row;
+}
+function createPageFilter(url) {
+    return {
+        dimension: 'page',
+        operator: 'equals',
+        expression: url,
+    };
+}
+export async function handleQueryByUrl(params, client) {
+    try {
+        logger.info('Handling query_by_url request', {
+            propertyInput: params.property,
+            urlCount: params.urls?.length,
+            dateRange: params.startDate && params.endDate ? `${params.startDate} to ${params.endDate}` : 'not provided',
+        });
+        const validationResult = QueryByUrlSchema.safeParse(params);
+        if (!validationResult.success) {
+            const errorMessages = validationResult.error.issues.map(issue => {
+                const path = issue.path.length > 0 ? `${issue.path.join('.')}: ` : '';
+                return `${path}${issue.message}`;
+            }).join('; ');
+            logger.error('Input validation failed', {
+                errors: errorMessages,
+                params,
+            });
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: 'Input validation failed',
+                            details: errorMessages,
+                        }, null, 2),
+                    }],
+                isError: true,
+            };
+        }
+        const validated = validationResult.data;
+        try {
+            validateDateRangeStrict(validated.startDate, validated.endDate);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            logger.error('Date range validation failed', {
+                startDate: validated.startDate,
+                endDate: validated.endDate,
+                error: errorMessage,
+            });
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: 'Invalid date range',
+                            details: errorMessage,
+                        }, null, 2),
+                    }],
+                isError: true,
+            };
+        }
+        const allDimensions = ['page', ...(validated.dimensions || [])];
+        try {
+            validateDimensions(allDimensions, 3);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            logger.error('Dimension validation failed', {
+                dimensions: allDimensions,
+                error: errorMessage,
+            });
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: 'Too many dimensions',
+                            details: errorMessage,
+                        }, null, 2),
+                    }],
+                isError: true,
+            };
+        }
+        logger.debug('Fetching available properties');
+        const availableProperties = await listProperties(client);
+        if (availableProperties.length === 0) {
+            logger.warn('No properties found for this account');
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: 'No properties found',
+                            details: 'No Google Search Console properties are accessible with this account. Please verify your account has access to at least one property.',
+                        }, null, 2),
+                    }],
+                isError: true,
+            };
+        }
+        const matchResult = matchProperty(validated.property, availableProperties);
+        if (!matchResult.matched) {
+            const errorMessage = generatePropertyMatchError(matchResult, availableProperties);
+            logger.error('Property matching failed', {
+                searchInput: validated.property,
+                matchType: matchResult.matchType,
+                alternativeCount: matchResult.alternatives?.length || 0,
+            });
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: 'Property not found or ambiguous',
+                            details: errorMessage,
+                        }, null, 2),
+                    }],
+                isError: true,
+            };
+        }
+        const matchedProperty = matchResult.matched;
+        logger.info('Property matched successfully', {
+            searchInput: validated.property,
+            matched: matchedProperty.propertyUrl,
+            matchType: matchResult.matchType,
+        });
+        const baseFilters = [];
+        if (validated.deviceType) {
+            baseFilters.push({
+                dimension: 'device',
+                operator: 'equals',
+                expression: validated.deviceType,
+            });
+        }
+        if (validated.country) {
+            baseFilters.push({
+                dimension: 'country',
+                operator: 'equals',
+                expression: validated.country.toLowerCase(),
+            });
+        }
+        const queries = validated.urls.map(url => ({
+            propertyUrl: matchedProperty.propertyUrl,
+            startDate: validated.startDate,
+            endDate: validated.endDate,
+            dimensions: allDimensions,
+            filters: [
+                {
+                    filters: [
+                        createPageFilter(url),
+                        ...baseFilters,
+                    ],
+                },
+            ],
+            searchType: validated.searchType,
+            rowLimit: 25000,
+            startRow: 0,
+        }));
+        logger.info('Executing multi-URL query', {
+            property: matchedProperty.propertyUrl,
+            urlCount: validated.urls.length,
+            dateRange: `${validated.startDate} to ${validated.endDate}`,
+            dimensions: allDimensions,
+            searchType: validated.searchType,
+        });
+        const rateLimiter = client.getRateLimiter();
+        const results = await executeParallelQueries(client, queries, rateLimiter);
+        const aggregated = aggregateResults(results);
+        const errors = [];
+        results.forEach((result, index) => {
+            if (!result.rows || result.rows.length === 0) {
+                const url = validated.urls[index];
+                if (url) {
+                    errors.push({
+                        url,
+                        error: 'Query returned no results or failed',
+                    });
+                }
+            }
+        });
+        logger.info('Multi-URL query completed', {
+            totalRows: aggregated.totalRows,
+            successful: aggregated.queryCounts.successful,
+            failed: aggregated.queryCounts.failed,
+        });
+        const formattedResults = aggregated.rows.map(row => formatResultRow(row.keys, allDimensions, row.clicks, row.impressions, row.ctr, row.position));
+        const chunked = chunkResults(formattedResults, validated.offset, validated.limit);
+        logger.info('Results chunked', {
+            totalRows: formattedResults.length,
+            offset: validated.offset,
+            limit: chunked.pagination.limit,
+            currentChunk: chunked.pagination.current_chunk,
+            totalChunks: chunked.pagination.total_chunks,
+            hasMore: chunked.pagination.has_more,
+        });
+        const response = {
+            property: matchedProperty.propertyUrl,
+            urls: validated.urls,
+            dateRange: {
+                start: validated.startDate,
+                end: validated.endDate,
+            },
+            filters: {
+                searchType: validated.searchType,
+                deviceType: validated.deviceType,
+                country: validated.country,
+            },
+            results: chunked.results,
+            pagination: chunked.pagination,
+            metadata: {
+                queryCounts: aggregated.queryCounts,
+                errors: errors.length > 0 ? errors : undefined,
+            },
+        };
+        logger.info('Query by URL completed successfully', {
+            property: matchedProperty.propertyUrl,
+            urlCount: validated.urls.length,
+            resultsReturned: chunked.results.length,
+            hasMore: chunked.pagination.has_more,
+        });
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify(response, null, 2),
+                }],
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        const errorStack = error instanceof Error ? error.stack : undefined;
+        logger.error('Query by URL handler failed', {
+            error: errorMessage,
+            stack: errorStack,
+            params,
+        });
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        error: 'Query execution failed',
+                        details: errorMessage,
+                    }, null, 2),
+                }],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=query-by-url.js.map

package/dist/tools/query-by-url.js.map

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

package/dist/utils/cache.d.ts

@@ -0,0 +1,22 @@
+export declare class PropertyCache {
+    private cache;
+    private readonly defaultTtl;
+    constructor(ttlSeconds?: number);
+    get<T>(key: string): T | undefined;
+    set(key: string, value: unknown, ttl?: number): void;
+    invalidate(key?: string): void;
+    getStats(): {
+        keys: number;
+        hits: number;
+        misses: number;
+        hitRate: number;
+    };
+    has(key: string): boolean;
+    getTtl(key: string): number | undefined;
+    keys(): string[];
+}
+export declare const propertyCache: PropertyCache;
+export declare const CACHE_KEYS: {
+    readonly PROPERTIES: "gsc:properties";
+};
+//# sourceMappingURL=cache.d.ts.map

package/dist/utils/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/utils/cache.ts"],"names":[],"mappings":"AAoCA,qBAAa,aAAa;IACxB,OAAO,CAAC,KAAK,CAAY;IACzB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAOxB,UAAU,GAAE,MAAc;IAoBtC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAmBlC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI;IAoBpD,UAAU,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI;IAe9B,QAAQ,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;IAmB3E,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAUzB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IASvC,IAAI,IAAI,MAAM,EAAE;CAGjB;AAQD,eAAO,MAAM,aAAa,eAA2B,CAAC;AAKtD,eAAO,MAAM,UAAU;;CAEb,CAAC"}

package/dist/utils/cache.js

@@ -0,0 +1,75 @@
+import NodeCache from 'node-cache';
+import { logger } from './logger.js';
+export class PropertyCache {
+    constructor(ttlSeconds = 86400) {
+        this.defaultTtl = ttlSeconds;
+        this.cache = new NodeCache({
+            stdTTL: ttlSeconds,
+            checkperiod: 600,
+            useClones: false,
+        });
+        logger.info('PropertyCache initialized', {
+            defaultTtl: ttlSeconds,
+            defaultTtlHours: ttlSeconds / 3600,
+        });
+    }
+    get(key) {
+        const value = this.cache.get(key);
+        if (value !== undefined) {
+            logger.debug('Cache hit', { key });
+        }
+        else {
+            logger.debug('Cache miss', { key });
+        }
+        return value;
+    }
+    set(key, value, ttl) {
+        const effectiveTtl = ttl ?? this.defaultTtl;
+        const success = this.cache.set(key, value, effectiveTtl);
+        if (success) {
+            logger.debug('Cache set', {
+                key,
+                ttl: effectiveTtl,
+                ttlHours: effectiveTtl / 3600,
+            });
+        }
+        else {
+            logger.warn('Failed to set cache value', { key });
+        }
+    }
+    invalidate(key) {
+        if (key) {
+            const deleted = this.cache.del(key);
+            logger.info('Cache key invalidated', { key, deleted: deleted > 0 });
+        }
+        else {
+            this.cache.flushAll();
+            logger.info('Cache completely invalidated');
+        }
+    }
+    getStats() {
+        const stats = this.cache.getStats();
+        const total = stats.hits + stats.misses;
+        const hitRate = total > 0 ? (stats.hits / total) * 100 : 0;
+        return {
+            keys: this.cache.keys().length,
+            hits: stats.hits,
+            misses: stats.misses,
+            hitRate: parseFloat(hitRate.toFixed(2)),
+        };
+    }
+    has(key) {
+        return this.cache.has(key);
+    }
+    getTtl(key) {
+        return this.cache.getTtl(key);
+    }
+    keys() {
+        return this.cache.keys();
+    }
+}
+export const propertyCache = new PropertyCache(86400);
+export const CACHE_KEYS = {
+    PROPERTIES: 'gsc:properties',
+};
+//# sourceMappingURL=cache.js.map

package/dist/utils/cache.js.map

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

package/dist/utils/index.d.ts

@@ -0,0 +1,8 @@
+export { logger, type LogLevel } from './logger.js';
+export { propertyCache, CACHE_KEYS } from './cache.js';
+export { TokenBucketRateLimiter, withExponentialBackoff, createRateLimitedFunction, type BackoffOptions } from './rate-limiter.js';
+export { estimateTokens, estimateTokensForJson, calculateChunkSize, chunkResults, estimateTotalTokens, needsChunking, generatePaginationMetadata, validatePaginationParams, MAX_SAFE_TOKENS, CHARS_PER_TOKEN, type PaginationMetadata, type ChunkedResponse } from './token-estimator.js';
+export { type DimensionFilter, type GSCDimension, type FilterOperator, type SortMetric, type SortOrder, type PositionRange, type TopQueryResult, type TopPageResult, type PeriodMetrics, type MetricChanges, type MetricComparison, type QueryComparison, type PageComparison, type PropertyInfo, type AdvancedQueryResult, isGSCDimension, isFilterOperator, isSortMetric, isSortOrder } from './types.js';
+export { calculateAbsoluteChange, calculatePercentChange, calculatePositionChange, calculateMetricChanges, formatPercentChange, formatPositionChange, isSignificantChange } from './metrics.js';
+export { comparisonSortBySchema, positionRangeSchema, topNLimitSchema, minClicksSchema, minImpressionsSchema, queryAdvancedParamsSchema, getTopQueriesParamsSchema, getTopPagesParamsSchema, compareDateRangesParamsSchema, getPropertyInfoParamsSchema, VALID_GSC_DIMENSIONS, VALID_FILTER_OPERATORS, VALID_SORT_METRICS, VALID_COMPARISON_SORT_METRICS, type ValidFilterOperator, type ValidSortMetric, type ComparisonSortMetric, type QueryAdvancedParams, type GetTopQueriesParams, type GetTopPagesParams, type CompareDateRangesParams, type GetPropertyInfoParams } from './validators.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,yBAAyB,EACzB,KAAK,cAAc,EACpB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,kBAAkB,EAClB,YAAY,EACZ,mBAAmB,EACnB,aAAa,EACb,0BAA0B,EAC1B,wBAAwB,EACxB,eAAe,EACf,eAAe,EACf,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACrB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACZ,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,uBAAuB,EACvB,sBAAsB,EACtB,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,eAAe,EACf,eAAe,EACf,oBAAoB,EACpB,yBAAyB,EACzB,yBAAyB,EACzB,uBAAuB,EACvB,6BAA6B,EAC7B,2BAA2B,EAC3B,oBAAoB,EACpB,sBAAsB,EACtB,kBAAkB,EAClB,6BAA6B,EAC7B,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC3B,MAAM,iBAAiB,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,8 @@
+export { logger } from './logger.js';
+export { propertyCache, CACHE_KEYS } from './cache.js';
+export { TokenBucketRateLimiter, withExponentialBackoff, createRateLimitedFunction } from './rate-limiter.js';
+export { estimateTokens, estimateTokensForJson, calculateChunkSize, chunkResults, estimateTotalTokens, needsChunking, generatePaginationMetadata, validatePaginationParams, MAX_SAFE_TOKENS, CHARS_PER_TOKEN } from './token-estimator.js';
+export { isGSCDimension, isFilterOperator, isSortMetric, isSortOrder } from './types.js';
+export { calculateAbsoluteChange, calculatePercentChange, calculatePositionChange, calculateMetricChanges, formatPercentChange, formatPositionChange, isSignificantChange } from './metrics.js';
+export { comparisonSortBySchema, positionRangeSchema, topNLimitSchema, minClicksSchema, minImpressionsSchema, queryAdvancedParamsSchema, getTopQueriesParamsSchema, getTopPagesParamsSchema, compareDateRangesParamsSchema, getPropertyInfoParamsSchema, VALID_GSC_DIMENSIONS, VALID_FILTER_OPERATORS, VALID_SORT_METRICS, VALID_COMPARISON_SORT_METRICS } from './validators.js';
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAiB,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,yBAAyB,EAE1B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,kBAAkB,EAClB,YAAY,EACZ,mBAAmB,EACnB,aAAa,EACb,0BAA0B,EAC1B,wBAAwB,EACxB,eAAe,EACf,eAAe,EAGhB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAgBL,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACZ,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,uBAAuB,EACvB,sBAAsB,EACtB,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,eAAe,EACf,eAAe,EACf,oBAAoB,EACpB,yBAAyB,EACzB,yBAAyB,EACzB,uBAAuB,EACvB,6BAA6B,EAC7B,2BAA2B,EAC3B,oBAAoB,EACpB,sBAAsB,EACtB,kBAAkB,EAClB,6BAA6B,EAS9B,MAAM,iBAAiB,CAAC"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,4 @@
+import winston from 'winston';
+export declare const logger: winston.Logger;
+export type LogLevel = 'error' | 'warn' | 'info' | 'debug';
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAuBA,OAAO,OAAO,MAAM,SAAS,CAAC;AAgB9B,eAAO,MAAM,MAAM,gBAmBjB,CAAC;AASH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC"}

package/dist/utils/logger.js

@@ -0,0 +1,15 @@
+import winston from 'winston';
+export const logger = winston.createLogger({
+    level: process.env.LOG_LEVEL || 'info',
+    format: winston.format.combine(winston.format.timestamp(), winston.format.errors({ stack: true }), winston.format.json()),
+    defaultMeta: { service: 'mcp-gsc' },
+    transports: [
+        new winston.transports.Console({
+            format: winston.format.combine(winston.format.colorize(), winston.format.printf(({ timestamp, level, message, ...meta }) => {
+                const metaStr = Object.keys(meta).length ? JSON.stringify(meta, null, 2) : '';
+                return `${timestamp} [${level}]: ${message} ${metaStr}`;
+            })),
+        }),
+    ],
+});
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAuBA,OAAO,OAAO,MAAM,SAAS,CAAC;AAgB9B,MAAM,CAAC,MAAM,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IACzC,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,MAAM;IACtC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,CAC5B,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,EAC1B,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,EACtC,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CACtB;IACD,WAAW,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE;IACnC,UAAU,EAAE;QACV,IAAI,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC;YAC7B,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,CAC5B,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,EACzB,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,EAAE,EAAE;gBAC/D,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC9E,OAAO,GAAG,SAAS,KAAK,KAAK,MAAM,OAAO,IAAI,OAAO,EAAE,CAAC;YAC1D,CAAC,CAAC,CACH;SACF,CAAC;KACH;CACF,CAAC,CAAC"}

package/dist/utils/metrics.d.ts

@@ -0,0 +1,9 @@
+import { MetricChanges, PeriodMetrics } from './types.js';
+export declare function calculateAbsoluteChange(current: number, previous: number): number;
+export declare function calculatePercentChange(current: number, previous: number): number | null;
+export declare function calculatePositionChange(current: number, previous: number): number;
+export declare function calculateMetricChanges(current: PeriodMetrics, previous: PeriodMetrics): MetricChanges;
+export declare function formatPercentChange(percentChange: number | null, precision?: number): string;
+export declare function formatPositionChange(positionChange: number, precision?: number): string;
+export declare function isSignificantChange(absoluteChange: number, percentChange: number | null, absoluteThreshold?: number, percentThreshold?: number): boolean;
+//# sourceMappingURL=metrics.d.ts.map

package/dist/utils/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../src/utils/metrics.ts"],"names":[],"mappings":"AA4BA,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAuB1D,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEjF;AAgCD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAavF;AA6BD,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEjF;AAwCD,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,aAAa,GACtB,aAAa,CAaf;AAuBD,wBAAgB,mBAAmB,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,EAAE,SAAS,GAAE,MAAU,GAAG,MAAM,CAO/F;AAoBD,wBAAgB,oBAAoB,CAAC,cAAc,EAAE,MAAM,EAAE,SAAS,GAAE,MAAU,GAAG,MAAM,CAW1F;AAsBD,wBAAgB,mBAAmB,CACjC,cAAc,EAAE,MAAM,EACtB,aAAa,EAAE,MAAM,GAAG,IAAI,EAC5B,iBAAiB,GAAE,MAAW,EAC9B,gBAAgB,GAAE,MAAW,GAC5B,OAAO,CAYT"}

package/dist/utils/metrics.js

@@ -0,0 +1,54 @@
+export function calculateAbsoluteChange(current, previous) {
+    return current - previous;
+}
+export function calculatePercentChange(current, previous) {
+    if (previous === 0 && current === 0) {
+        return 0;
+    }
+    if (previous === 0) {
+        return null;
+    }
+    return ((current - previous) / previous) * 100;
+}
+export function calculatePositionChange(current, previous) {
+    return current - previous;
+}
+export function calculateMetricChanges(current, previous) {
+    return {
+        clicks: calculateAbsoluteChange(current.clicks, previous.clicks),
+        clicksPercent: calculatePercentChange(current.clicks, previous.clicks),
+        impressions: calculateAbsoluteChange(current.impressions, previous.impressions),
+        impressionsPercent: calculatePercentChange(current.impressions, previous.impressions),
+        position: calculatePositionChange(current.position, previous.position),
+    };
+}
+export function formatPercentChange(percentChange, precision = 1) {
+    if (percentChange === null) {
+        return 'N/A (from zero)';
+    }
+    const sign = percentChange > 0 ? '+' : '';
+    return `${sign}${percentChange.toFixed(precision)}%`;
+}
+export function formatPositionChange(positionChange, precision = 1) {
+    const sign = positionChange > 0 ? '+' : '';
+    const value = `${sign}${positionChange.toFixed(precision)}`;
+    if (positionChange < 0) {
+        return `${value} (improved)`;
+    }
+    else if (positionChange > 0) {
+        return `${value} (declined)`;
+    }
+    else {
+        return `${value} (no change)`;
+    }
+}
+export function isSignificantChange(absoluteChange, percentChange, absoluteThreshold = 10, percentThreshold = 10) {
+    if (Math.abs(absoluteChange) >= absoluteThreshold) {
+        return true;
+    }
+    if (percentChange !== null && Math.abs(percentChange) >= percentThreshold) {
+        return true;
+    }
+    return false;
+}
+//# sourceMappingURL=metrics.js.map

package/dist/utils/metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../../src/utils/metrics.ts"],"names":[],"mappings":"AAmDA,MAAM,UAAU,uBAAuB,CAAC,OAAe,EAAE,QAAgB;IACvE,OAAO,OAAO,GAAG,QAAQ,CAAC;AAC5B,CAAC;AAgCD,MAAM,UAAU,sBAAsB,CAAC,OAAe,EAAE,QAAgB;IAEtE,IAAI,QAAQ,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,EAAE,CAAC;QACpC,OAAO,CAAC,CAAC;IACX,CAAC;IAGD,IAAI,QAAQ,KAAK,CAAC,EAAE,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IAGD,OAAO,CAAC,CAAC,OAAO,GAAG,QAAQ,CAAC,GAAG,QAAQ,CAAC,GAAG,GAAG,CAAC;AACjD,CAAC;AA6BD,MAAM,UAAU,uBAAuB,CAAC,OAAe,EAAE,QAAgB;IACvE,OAAO,OAAO,GAAG,QAAQ,CAAC;AAC5B,CAAC;AAwCD,MAAM,UAAU,sBAAsB,CACpC,OAAsB,EACtB,QAAuB;IAEvB,OAAO;QAEL,MAAM,EAAE,uBAAuB,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC;QAChE,aAAa,EAAE,sBAAsB,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC;QAGtE,WAAW,EAAE,uBAAuB,CAAC,OAAO,CAAC,WAAW,EAAE,QAAQ,CAAC,WAAW,CAAC;QAC/E,kBAAkB,EAAE,sBAAsB,CAAC,OAAO,CAAC,WAAW,EAAE,QAAQ,CAAC,WAAW,CAAC;QAGrF,QAAQ,EAAE,uBAAuB,CAAC,OAAO,CAAC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC;KACvE,CAAC;AACJ,CAAC;AAuBD,MAAM,UAAU,mBAAmB,CAAC,aAA4B,EAAE,YAAoB,CAAC;IACrF,IAAI,aAAa,KAAK,IAAI,EAAE,CAAC;QAC3B,OAAO,iBAAiB,CAAC;IAC3B,CAAC;IAED,MAAM,IAAI,GAAG,aAAa,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1C,OAAO,GAAG,IAAI,GAAG,aAAa,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC;AACvD,CAAC;AAoBD,MAAM,UAAU,oBAAoB,CAAC,cAAsB,EAAE,YAAoB,CAAC;IAChF,MAAM,IAAI,GAAG,cAAc,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3C,MAAM,KAAK,GAAG,GAAG,IAAI,GAAG,cAAc,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;IAE5D,IAAI,cAAc,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,GAAG,KAAK,aAAa,CAAC;IAC/B,CAAC;SAAM,IAAI,cAAc,GAAG,CAAC,EAAE,CAAC;QAC9B,OAAO,GAAG,KAAK,aAAa,CAAC;IAC/B,CAAC;SAAM,CAAC;QACN,OAAO,GAAG,KAAK,cAAc,CAAC;IAChC,CAAC;AACH,CAAC;AAsBD,MAAM,UAAU,mBAAmB,CACjC,cAAsB,EACtB,aAA4B,EAC5B,oBAA4B,EAAE,EAC9B,mBAA2B,EAAE;IAG7B,IAAI,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,iBAAiB,EAAE,CAAC;QAClD,OAAO,IAAI,CAAC;IACd,CAAC;IAGD,IAAI,aAAa,KAAK,IAAI,IAAI,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,gBAAgB,EAAE,CAAC;QAC1E,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}