@disruptorganic/mcp-google-search-console 1.0.0

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

@@ -0,0 +1,339 @@
+import { z } from 'zod';
+import { listProperties, matchProperty, generatePropertyMatchError } from '../gsc/properties.js';
+import { queryMultipleKeywords } 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 QueryByKeywordSchema = z.object({
+    property: z.string()
+        .min(1, 'Property identifier is required')
+        .describe('Property identifier from list_properties (e.g., "sc-domain:example.com")'),
+    keywords: z.array(z.string().min(1, 'Keyword cannot be empty'))
+        .min(1, 'At least one keyword is required')
+        .max(50, 'Maximum 50 keywords allowed per request')
+        .describe('Array of keyword strings to query (1-50 keywords)'),
+    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(['page', 'device', 'country', 'searchAppearance', 'date']))
+        .optional()
+        .describe('Additional dimensions beyond query (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 queryByKeywordTool = {
+    name: 'query_by_keyword',
+    description: 'Retrieves search performance data for one or more keywords/queries from Google Search Console. Returns clicks, impressions, CTR, average position, and ranking URLs for each keyword. 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")',
+            },
+            keywords: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Array of keyword strings to query (1-50 keywords)',
+                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: ['page', 'device', 'country', 'searchAppearance', 'date'],
+                },
+                description: 'Additional dimensions beyond query (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', 'keywords', '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;
+}
+export async function handleQueryByKeyword(params, client) {
+    try {
+        logger.info('Handling query_by_keyword request', {
+            propertyInput: params.property,
+            keywordCount: params.keywords?.length,
+            dateRange: params.startDate && params.endDate ? `${params.startDate} to ${params.endDate}` : 'not provided',
+        });
+        const validationResult = QueryByKeywordSchema.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 = ['query', ...(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 additionalFilters = [];
+        if (validated.deviceType) {
+            additionalFilters.push({
+                dimension: 'device',
+                operator: 'equals',
+                expression: validated.deviceType,
+            });
+        }
+        if (validated.country) {
+            additionalFilters.push({
+                dimension: 'country',
+                operator: 'equals',
+                expression: validated.country.toLowerCase(),
+            });
+        }
+        logger.info('Executing multi-keyword query', {
+            property: matchedProperty.propertyUrl,
+            keywordCount: validated.keywords.length,
+            dateRange: `${validated.startDate} to ${validated.endDate}`,
+            dimensions: allDimensions,
+            searchType: validated.searchType,
+        });
+        const rateLimiter = client.getRateLimiter();
+        const aggregatedResults = await queryMultipleKeywords(client, matchedProperty.propertyUrl, validated.keywords, {
+            startDate: validated.startDate,
+            endDate: validated.endDate,
+            dimensions: allDimensions,
+            searchType: validated.searchType,
+            rowLimit: 25000,
+            startRow: 0,
+        }, rateLimiter);
+        logger.info('Multi-keyword query completed', {
+            totalRows: aggregatedResults.totalRows,
+            successful: aggregatedResults.queryCounts.successful,
+            failed: aggregatedResults.queryCounts.failed,
+        });
+        const formattedResults = aggregatedResults.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,
+            keywords: validated.keywords,
+            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: aggregatedResults.queryCounts,
+                errors: aggregatedResults.errors?.map(err => ({
+                    keyword: err.identifier,
+                    error: err.error,
+                })),
+            },
+        };
+        logger.info('Query by keyword completed successfully', {
+            property: matchedProperty.propertyUrl,
+            keywordCount: validated.keywords.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 keyword 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-keyword.js.map

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

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

package/dist/tools/query-by-url.d.ts

@@ -0,0 +1,116 @@
+import { z } from 'zod';
+import { GSCClient } from '../gsc/client.js';
+export interface ToolResponse {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}
+export declare const QueryByUrlSchema: z.ZodObject<{
+    property: z.ZodString;
+    urls: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
+    startDate: z.ZodString;
+    endDate: z.ZodString;
+    searchType: z.ZodDefault<z.ZodOptional<z.ZodEnum<["web", "image", "video", "news", "discover", "googleNews"]>>>;
+    dimensions: z.ZodOptional<z.ZodArray<z.ZodEnum<["query", "device", "country", "searchAppearance", "date"]>, "many">>;
+    deviceType: z.ZodOptional<z.ZodEnum<["desktop", "mobile", "tablet"]>>;
+    country: z.ZodOptional<z.ZodString>;
+    offset: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    startDate: string;
+    endDate: string;
+    searchType: "web" | "image" | "video" | "news" | "discover" | "googleNews";
+    property: string;
+    offset: number;
+    urls: string[];
+    dimensions?: ("query" | "country" | "device" | "searchAppearance" | "date")[] | undefined;
+    limit?: number | undefined;
+    deviceType?: "desktop" | "mobile" | "tablet" | undefined;
+    country?: string | undefined;
+}, {
+    startDate: string;
+    endDate: string;
+    property: string;
+    urls: string[];
+    dimensions?: ("query" | "country" | "device" | "searchAppearance" | "date")[] | undefined;
+    searchType?: "web" | "image" | "video" | "news" | "discover" | "googleNews" | undefined;
+    limit?: number | undefined;
+    deviceType?: "desktop" | "mobile" | "tablet" | undefined;
+    country?: string | undefined;
+    offset?: number | undefined;
+}>;
+export type QueryByUrlParams = z.infer<typeof QueryByUrlSchema>;
+export declare const queryByUrlTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            property: {
+                type: string;
+                description: string;
+            };
+            urls: {
+                type: string;
+                items: {
+                    type: string;
+                    format: string;
+                };
+                description: string;
+                minItems: number;
+                maxItems: number;
+            };
+            startDate: {
+                type: string;
+                description: string;
+                pattern: string;
+            };
+            endDate: {
+                type: string;
+                description: string;
+                pattern: string;
+            };
+            searchType: {
+                type: string;
+                enum: string[];
+                description: string;
+                default: string;
+            };
+            dimensions: {
+                type: string;
+                items: {
+                    type: string;
+                    enum: string[];
+                };
+                description: string;
+            };
+            deviceType: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            country: {
+                type: string;
+                description: string;
+                pattern: string;
+            };
+            offset: {
+                type: string;
+                description: string;
+                default: number;
+                minimum: number;
+            };
+            limit: {
+                type: string;
+                description: string;
+                minimum: number;
+                maximum: number;
+            };
+        };
+        required: string[];
+    };
+};
+export declare function handleQueryByUrl(params: any, client: GSCClient): Promise<ToolResponse>;
+//# sourceMappingURL=query-by-url.d.ts.map

package/dist/tools/query-by-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-by-url.d.ts","sourceRoot":"","sources":["../../src/tools/query-by-url.ts"],"names":[],"mappings":"AA8BA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,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;AAYD,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqD3B,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAchE,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkE1B,CAAC;AA4GF,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,GAAG,EACX,MAAM,EAAE,SAAS,GAChB,OAAO,CAAC,YAAY,CAAC,CA2TvB"}