@disruptorganic/mcp-google-search-console 1.0.0

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

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

package/dist/tools/index.js

@@ -0,0 +1,70 @@
+export { listPropertiesTool, handleListProperties, ListPropertiesSchema, } from './list-properties.js';
+export { queryByKeywordTool, handleQueryByKeyword, QueryByKeywordSchema, } from './query-by-keyword.js';
+export { queryByUrlTool, handleQueryByUrl, QueryByUrlSchema, } from './query-by-url.js';
+export { healthCheckTool, handleHealthCheck, } from './health-check.js';
+export { queryAdvancedTool, handleQueryAdvanced, } from './query-advanced.js';
+export { getTopQueriesTool, handleGetTopQueries, } from './get-top-queries.js';
+export { getTopPagesTool, handleGetTopPages, } from './get-top-pages.js';
+export { compareDateRangesTool, handleCompareDateRanges, } from './compare-date-ranges.js';
+export { getPropertyInfoTool, handleGetPropertyInfo, } from './get-property-info.js';
+import { listPropertiesTool, handleListProperties } from './list-properties.js';
+import { queryByKeywordTool, handleQueryByKeyword } from './query-by-keyword.js';
+import { queryByUrlTool, handleQueryByUrl } from './query-by-url.js';
+import { healthCheckTool, handleHealthCheck } from './health-check.js';
+import { queryAdvancedTool, handleQueryAdvanced } from './query-advanced.js';
+import { getTopQueriesTool, handleGetTopQueries } from './get-top-queries.js';
+import { getTopPagesTool, handleGetTopPages } from './get-top-pages.js';
+import { compareDateRangesTool, handleCompareDateRanges } from './compare-date-ranges.js';
+import { getPropertyInfoTool, handleGetPropertyInfo } from './get-property-info.js';
+export const allTools = [
+    listPropertiesTool,
+    queryByKeywordTool,
+    queryByUrlTool,
+    queryAdvancedTool,
+    getTopQueriesTool,
+    getTopPagesTool,
+    compareDateRangesTool,
+    getPropertyInfoTool,
+    healthCheckTool,
+];
+export const toolHandlers = {
+    list_properties: handleListProperties,
+    query_by_keyword: handleQueryByKeyword,
+    query_by_url: handleQueryByUrl,
+    query_advanced: handleQueryAdvanced,
+    get_top_queries: handleGetTopQueries,
+    get_top_pages: handleGetTopPages,
+    compare_date_ranges: handleCompareDateRanges,
+    get_property_info: handleGetPropertyInfo,
+    health_check: handleHealthCheck,
+};
+export function getToolByName(name) {
+    return allTools.find(tool => tool.name === name);
+}
+export function getToolHandler(name) {
+    return toolHandlers[name];
+}
+export function hasToolHandler(name) {
+    return name in toolHandlers;
+}
+export function getToolNames() {
+    return Object.keys(toolHandlers);
+}
+export function getToolStats() {
+    return {
+        total: allTools.length,
+        names: getToolNames(),
+        tools: allTools.map(tool => {
+            const requiredParams = tool.inputSchema.required || [];
+            const allParams = Object.keys(tool.inputSchema.properties || {});
+            const optionalParams = allParams.filter(key => !requiredParams.includes(key));
+            return {
+                name: tool.name,
+                description: tool.description,
+                requiredParams,
+                optionalParams,
+            };
+        }),
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

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

package/dist/tools/list-properties.d.ts

@@ -0,0 +1,50 @@
+import { z } from 'zod';
+import { GSCClient } from '../gsc/client.js';
+export interface ToolResponse {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}
+export declare const ListPropertiesSchema: z.ZodObject<{
+    forceRefresh: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    groupByType: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    includeMetadata: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    forceRefresh: boolean;
+    groupByType: boolean;
+    includeMetadata: boolean;
+}, {
+    forceRefresh?: boolean | undefined;
+    groupByType?: boolean | undefined;
+    includeMetadata?: boolean | undefined;
+}>;
+export type ListPropertiesParams = z.infer<typeof ListPropertiesSchema>;
+export declare const listPropertiesTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            forceRefresh: {
+                type: string;
+                description: string;
+                default: boolean;
+            };
+            groupByType: {
+                type: string;
+                description: string;
+                default: boolean;
+            };
+            includeMetadata: {
+                type: string;
+                description: string;
+                default: boolean;
+            };
+        };
+        required: never[];
+    };
+};
+export declare function handleListProperties(params: any, client: GSCClient): Promise<ToolResponse>;
+//# sourceMappingURL=list-properties.d.ts.map

package/dist/tools/list-properties.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-properties.d.ts","sourceRoot":"","sources":["../../src/tools/list-properties.ts"],"names":[],"mappings":"AA4BA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAY7C,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAWD,eAAO,MAAM,oBAAoB;;;;;;;;;;;;EAe/B,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAcxE,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;CAwB9B,CAAC;AAgNF,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,GAAG,EACX,MAAM,EAAE,SAAS,GAChB,OAAO,CAAC,YAAY,CAAC,CAkJvB"}

package/dist/tools/list-properties.js

@@ -0,0 +1,234 @@
+import { z } from 'zod';
+import { listProperties, groupPropertiesByType } from '../gsc/properties.js';
+import { propertyCache, CACHE_KEYS } from '../utils/cache.js';
+import { logger } from '../utils/logger.js';
+export const ListPropertiesSchema = z.object({
+    forceRefresh: z.boolean()
+        .optional()
+        .default(false)
+        .describe('Force refresh from API, bypassing 24h cache (default: false)'),
+    groupByType: z.boolean()
+        .optional()
+        .default(true)
+        .describe('Group properties by type (domain vs url_prefix) for better organization (default: true)'),
+    includeMetadata: z.boolean()
+        .optional()
+        .default(true)
+        .describe('Include cache statistics, property counts, and usage recommendations (default: true)'),
+});
+export const listPropertiesTool = {
+    name: 'list_properties',
+    description: 'Lists all Google Search Console properties accessible to the authenticated account. Returns domain properties (sc-domain:*) and URL prefix properties (https://*, http://*). MUST be called before any query tool to identify the correct property identifier. Prefer domain properties over URL prefix when both exist for the same site, as domain properties provide more comprehensive data covering all protocols and subdomains. Results are cached for 24 hours by default.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            forceRefresh: {
+                type: 'boolean',
+                description: 'Force refresh from API, bypassing 24h cache (default: false)',
+                default: false,
+            },
+            groupByType: {
+                type: 'boolean',
+                description: 'Group properties by type (domain vs url_prefix) for better organization (default: true)',
+                default: true,
+            },
+            includeMetadata: {
+                type: 'boolean',
+                description: 'Include cache statistics, property counts, and usage recommendations (default: true)',
+                default: true,
+            },
+        },
+        required: [],
+    },
+};
+function formatDuration(seconds) {
+    if (seconds < 0) {
+        return '0 seconds';
+    }
+    const hours = Math.floor(seconds / 3600);
+    const minutes = Math.floor((seconds % 3600) / 60);
+    const secs = Math.floor(seconds % 60);
+    if (hours > 0) {
+        if (minutes > 0) {
+            return `${hours} hour${hours !== 1 ? 's' : ''}, ${minutes} minute${minutes !== 1 ? 's' : ''}`;
+        }
+        return `${hours} hour${hours !== 1 ? 's' : ''}`;
+    }
+    if (minutes > 0) {
+        return `${minutes} minute${minutes !== 1 ? 's' : ''}`;
+    }
+    return `${secs} second${secs !== 1 ? 's' : ''}`;
+}
+function generateRecommendation(grouped) {
+    const { counts } = grouped;
+    if (counts.domain > 0 && counts.url_prefix > 0) {
+        return 'Multiple property types found. Prefer domain properties (sc-domain:*) as they provide more comprehensive data covering all protocols and subdomains. URL prefix properties only cover specific protocol and path combinations.';
+    }
+    if (counts.domain > 0) {
+        return 'Domain properties found. These provide comprehensive coverage across all protocols (HTTP/HTTPS) and subdomains. Use these property identifiers for query tools.';
+    }
+    if (counts.url_prefix > 0) {
+        return 'URL prefix properties found. Note: these only cover specific protocol and path combinations. Consider setting up domain properties in Google Search Console for more comprehensive data.';
+    }
+    return 'No properties found. Ensure your Google account has access to at least one Search Console property. Visit https://search.google.com/search-console to add properties.';
+}
+function getCacheMetadata(forceRefresh) {
+    const cacheKey = CACHE_KEYS.PROPERTIES;
+    if (forceRefresh) {
+        return {
+            cacheStatus: 'bypassed',
+        };
+    }
+    const hasCached = propertyCache.has(cacheKey);
+    if (!hasCached) {
+        return {
+            cacheStatus: 'miss',
+        };
+    }
+    const ttlMs = propertyCache.getTtl(cacheKey);
+    const ttl = ttlMs ? Math.floor(ttlMs / 1000) : undefined;
+    const maxTtl = 86400;
+    const age = ttl !== undefined ? maxTtl - ttl : undefined;
+    return {
+        cacheStatus: 'hit',
+        cacheAge: age !== undefined ? formatDuration(age) : undefined,
+        cacheTtlRemaining: ttl !== undefined ? formatDuration(ttl) : undefined,
+    };
+}
+function createResponse(properties, params) {
+    const { groupByType, includeMetadata, forceRefresh } = params;
+    const grouped = groupPropertiesByType(properties);
+    const response = {
+        properties: groupByType
+            ? { domain: grouped.domain, url_prefix: grouped.url_prefix }
+            : properties,
+        counts: groupByType
+            ? {
+                domain: grouped.counts.domain,
+                url_prefix: grouped.counts.url_prefix,
+                total: grouped.counts.total,
+            }
+            : { total: properties.length },
+    };
+    if (includeMetadata) {
+        const cacheMetadata = getCacheMetadata(forceRefresh);
+        response.metadata = {
+            ...cacheMetadata,
+            recommendation: generateRecommendation(grouped),
+        };
+    }
+    return response;
+}
+export async function handleListProperties(params, client) {
+    try {
+        logger.info('Handling list_properties request', {
+            forceRefresh: params.forceRefresh,
+            groupByType: params.groupByType,
+            includeMetadata: params.includeMetadata,
+        });
+        const validationResult = ListPropertiesSchema.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;
+        logger.info('Fetching properties', {
+            forceRefresh: validated.forceRefresh,
+            source: validated.forceRefresh ? 'api' : 'cache-or-api',
+        });
+        let properties;
+        try {
+            properties = await listProperties(client, validated.forceRefresh);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            logger.error('Failed to fetch properties', {
+                error: errorMessage,
+                forceRefresh: validated.forceRefresh,
+            });
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: 'Failed to fetch properties',
+                            details: errorMessage,
+                            suggestion: 'Ensure you are authenticated with Google Search Console. Try running the authentication flow again.',
+                        }, null, 2),
+                    }],
+                isError: true,
+            };
+        }
+        if (!properties || properties.length === 0) {
+            logger.warn('No properties found for this account');
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            properties: validated.groupByType
+                                ? { domain: [], url_prefix: [] }
+                                : [],
+                            counts: validated.groupByType
+                                ? { domain: 0, url_prefix: 0, total: 0 }
+                                : { total: 0 },
+                            metadata: validated.includeMetadata
+                                ? {
+                                    cacheStatus: getCacheMetadata(validated.forceRefresh).cacheStatus,
+                                    recommendation: 'No properties found. Ensure your Google account has access to at least one Search Console property. Visit https://search.google.com/search-console to add properties.',
+                                }
+                                : undefined,
+                        }, null, 2),
+                    }],
+            };
+        }
+        const response = createResponse(properties, validated);
+        logger.info('Properties listed successfully', {
+            total: response.counts.total,
+            domain: response.counts.domain,
+            url_prefix: response.counts.url_prefix,
+            grouped: validated.groupByType,
+            cacheStatus: response.metadata?.cacheStatus,
+        });
+        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('Unexpected error in handleListProperties', {
+            error: errorMessage,
+            stack: errorStack,
+            params,
+        });
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        error: 'Unexpected error occurred',
+                        details: errorMessage,
+                    }, null, 2),
+                }],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=list-properties.js.map

package/dist/tools/list-properties.js.map

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

package/dist/tools/query-advanced.d.ts

@@ -0,0 +1,109 @@
+import { GSCClient } from '../gsc/client.js';
+export interface ToolResponse {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}
+export interface AdvancedQueryResultRow {
+    [dimension: string]: string | number;
+    clicks: number;
+    impressions: number;
+    ctr: number;
+    position: number;
+}
+export declare const queryAdvancedTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            property: {
+                type: string;
+                description: string;
+            };
+            startDate: {
+                type: string;
+                description: string;
+                pattern: string;
+            };
+            endDate: {
+                type: string;
+                description: string;
+                pattern: string;
+            };
+            dimensions: {
+                type: string;
+                items: {
+                    type: string;
+                    enum: string[];
+                };
+                description: string;
+                minItems: number;
+                maxItems: number;
+            };
+            filters: {
+                type: string;
+                items: {
+                    type: string;
+                    properties: {
+                        dimension: {
+                            type: string;
+                            enum: string[];
+                        };
+                        operator: {
+                            type: string;
+                            enum: string[];
+                        };
+                        expression: {
+                            type: string;
+                        };
+                    };
+                    required: string[];
+                };
+                description: string;
+            };
+            searchType: {
+                type: string;
+                enum: string[];
+                description: string;
+                default: string;
+            };
+            rowLimit: {
+                type: string;
+                description: string;
+                minimum: number;
+                maximum: number;
+                default: number;
+            };
+            sortBy: {
+                type: string;
+                enum: string[];
+                description: string;
+                default: string;
+            };
+            sortOrder: {
+                type: string;
+                enum: string[];
+                description: string;
+                default: string;
+            };
+            offset: {
+                type: string;
+                description: string;
+                default: number;
+                minimum: number;
+            };
+            limit: {
+                type: string;
+                description: string;
+                minimum: number;
+                maximum: number;
+            };
+        };
+        required: string[];
+    };
+};
+export declare function handleQueryAdvanced(params: any, client: GSCClient): Promise<ToolResponse>;
+//# sourceMappingURL=query-advanced.d.ts.map

package/dist/tools/query-advanced.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-advanced.d.ts","sourceRoot":"","sources":["../../src/tools/query-advanced.ts"],"names":[],"mappings":"AA4BA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAc7C,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAQD,MAAM,WAAW,sBAAsB;IACrC,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;CAClB;AAiCD,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2F7B,CAAC;AAkNF,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,GAAG,EACX,MAAM,EAAE,SAAS,GAChB,OAAO,CAAC,YAAY,CAAC,CA6SvB"}