@disruptorganic/mcp-google-search-console 1.0.0

package/dist/utils/validators.js

@@ -0,0 +1,358 @@
+import { z } from 'zod';
+export const dateSchema = z.string()
+    .regex(/^\d{4}-\d{2}-\d{2}$/, 'Date must be in ISO 8601 format (YYYY-MM-DD)')
+    .refine((date) => {
+    const d = new Date(date);
+    return !isNaN(d.getTime());
+}, 'Invalid date value')
+    .refine((date) => {
+    const d = new Date(date);
+    d.setHours(0, 0, 0, 0);
+    const today = new Date();
+    today.setHours(0, 0, 0, 0);
+    return d <= today;
+}, 'Date cannot be in the future')
+    .refine((date) => {
+    const d = new Date(date);
+    d.setHours(0, 0, 0, 0);
+    const sixteenMonthsAgo = new Date();
+    sixteenMonthsAgo.setMonth(sixteenMonthsAgo.getMonth() - 16);
+    sixteenMonthsAgo.setHours(0, 0, 0, 0);
+    return d >= sixteenMonthsAgo;
+}, 'Date cannot be more than 16 months in the past (GSC API limit)');
+export const dateRangeSchema = z.object({
+    startDate: dateSchema,
+    endDate: dateSchema,
+}).refine((data) => new Date(data.startDate) <= new Date(data.endDate), {
+    message: 'startDate must be before or equal to endDate',
+    path: ['endDate'],
+});
+export const propertyUrlSchema = z.string()
+    .min(1, 'Property URL is required')
+    .refine((url) => {
+    if (url.startsWith('sc-domain:')) {
+        return /^sc-domain:[a-z0-9.-]+\.[a-z]{2,}$/i.test(url);
+    }
+    return /^https?:\/\/.+/.test(url);
+}, 'Property URL must be a domain property (sc-domain:example.com) or URL prefix (https://example.com/)');
+export const dimensionSchema = z.enum([
+    'query',
+    'page',
+    'country',
+    'device',
+    'searchAppearance',
+    'date'
+], {
+    errorMap: () => ({ message: 'Invalid dimension. Must be one of: query, page, country, device, searchAppearance, date' })
+});
+export const dimensionsSchema = z.array(dimensionSchema)
+    .min(1, 'At least one dimension is required')
+    .max(3, 'Maximum 3 dimensions allowed per query (GSC API limit)');
+export const searchTypeSchema = z.enum([
+    'web',
+    'image',
+    'video',
+    'news',
+    'discover',
+    'googleNews'
+], {
+    errorMap: () => ({ message: 'Invalid search type. Must be one of: web, image, video, news, discover, googleNews' })
+}).default('web');
+export const filterOperatorSchema = z.enum([
+    'equals',
+    'notEquals',
+    'contains',
+    'notContains',
+    'includingRegex',
+    'excludingRegex'
+], {
+    errorMap: () => ({ message: 'Invalid filter operator' })
+});
+export const filterSchema = z.object({
+    dimension: dimensionSchema,
+    operator: filterOperatorSchema,
+    expression: z.string().min(1, 'Filter expression cannot be empty'),
+});
+export const filterGroupSchema = z.object({
+    filters: z.array(filterSchema).min(1, 'Filter group must contain at least one filter'),
+    groupType: z.literal('and').optional(),
+});
+export const rowLimitSchema = z.number()
+    .int('Row limit must be an integer')
+    .min(1, 'Row limit must be at least 1')
+    .max(25000, 'Row limit cannot exceed 25,000 (GSC API limit)');
+export const deviceTypeSchema = z.enum([
+    'desktop',
+    'mobile',
+    'tablet'
+], {
+    errorMap: () => ({ message: 'Invalid device type. Must be one of: desktop, mobile, tablet' })
+});
+export const countryCodeSchema = z.string()
+    .length(3, 'Country code must be exactly 3 letters')
+    .regex(/^[a-zA-Z]{3}$/, 'Country code must be 3 letters (ISO 3166-1 alpha-3)')
+    .transform((val) => val.toLowerCase());
+export const aggregationTypeSchema = z.enum([
+    'auto',
+    'byProperty',
+    'byPage'
+], {
+    errorMap: () => ({ message: 'Invalid aggregation type. Must be one of: auto, byProperty, byPage' })
+});
+export const sortOrderSchema = z.enum(['asc', 'desc'], {
+    errorMap: () => ({ message: 'Sort order must be "asc" or "desc"' })
+});
+export const sortByMetricSchema = z.enum([
+    'clicks',
+    'impressions',
+    'ctr',
+    'position'
+], {
+    errorMap: () => ({ message: 'Invalid sort metric. Must be one of: clicks, impressions, ctr, position' })
+});
+export const baseQueryParamsSchema = z.object({
+    property: propertyUrlSchema,
+    startDate: dateSchema,
+    endDate: dateSchema,
+    searchType: searchTypeSchema.optional(),
+    deviceType: deviceTypeSchema.optional(),
+    country: countryCodeSchema.optional(),
+}).refine((data) => new Date(data.startDate) <= new Date(data.endDate), {
+    message: 'startDate must be before or equal to endDate',
+    path: ['endDate'],
+});
+export const keywordSchema = z.string()
+    .min(1, 'Keyword cannot be empty')
+    .max(500, 'Keyword too long (max 500 characters)');
+export const keywordsSchema = z.array(keywordSchema)
+    .min(1, 'At least one keyword is required')
+    .max(100, 'Maximum 100 keywords per request (to respect rate limits)');
+export const pageUrlSchema = z.string()
+    .min(1, 'Page URL is required')
+    .url('Must be a valid URL')
+    .refine((url) => {
+    return url.startsWith('http://') || url.startsWith('https://');
+}, 'URL must start with http:// or https://');
+export function validateDateRange(startDate, endDate) {
+    return new Date(startDate) <= new Date(endDate);
+}
+export function validateDateRangeStrict(startDate, endDate) {
+    const start = new Date(startDate);
+    const end = new Date(endDate);
+    const now = new Date();
+    now.setHours(0, 0, 0, 0);
+    if (isNaN(start.getTime()) || isNaN(end.getTime())) {
+        throw new Error('Invalid date format. Use YYYY-MM-DD.');
+    }
+    if (start > now || end > now) {
+        throw new Error('Future dates are not allowed.');
+    }
+    if (start > end) {
+        throw new Error('startDate must be before or equal to endDate.');
+    }
+    const monthsDiff = (end.getFullYear() - start.getFullYear()) * 12 + (end.getMonth() - start.getMonth());
+    if (monthsDiff > 16) {
+        throw new Error(`Date range exceeds 16 months maximum. Requested: ${monthsDiff} months.`);
+    }
+}
+export function validateDimensions(dimensions, maxDimensions = 3) {
+    if (dimensions.length > maxDimensions) {
+        throw new Error(`Maximum ${maxDimensions} dimensions allowed. Provided: ${dimensions.length}.`);
+    }
+}
+export function isWithin16Months(date) {
+    const d = new Date(date);
+    d.setHours(0, 0, 0, 0);
+    const sixteenMonthsAgo = new Date();
+    sixteenMonthsAgo.setMonth(sixteenMonthsAgo.getMonth() - 16);
+    sixteenMonthsAgo.setHours(0, 0, 0, 0);
+    return d >= sixteenMonthsAgo;
+}
+export function isValidPropertyUrl(url) {
+    if (url.startsWith('sc-domain:')) {
+        return /^sc-domain:[a-z0-9.-]+\.[a-z]{2,}$/i.test(url);
+    }
+    return /^https?:\/\/.+/.test(url);
+}
+export function formatDate(date) {
+    return date.toISOString().split('T')[0];
+}
+export function getDaysAgo(days) {
+    const date = new Date();
+    date.setDate(date.getDate() - days);
+    return formatDate(date);
+}
+export function getSixteenMonthsAgo() {
+    const date = new Date();
+    date.setMonth(date.getMonth() - 16);
+    return formatDate(date);
+}
+export function getToday() {
+    return formatDate(new Date());
+}
+export function formatValidationErrors(error) {
+    return error.issues.map(issue => {
+        const path = issue.path.length > 0 ? `${issue.path.join('.')}: ` : '';
+        return `${path}${issue.message}`;
+    }).join('; ');
+}
+export function safeValidate(schema, data) {
+    const result = schema.safeParse(data);
+    if (result.success) {
+        return { success: true, data: result.data };
+    }
+    return {
+        success: false,
+        error: formatValidationErrors(result.error),
+    };
+}
+export const comparisonSortBySchema = z.enum([
+    'clicks',
+    'impressions',
+    'ctr',
+    'position',
+    'clicks_change',
+    'clicks_percent_change',
+    'impressions_change',
+    'impressions_percent_change',
+    'position_change'
+], {
+    errorMap: () => ({ message: 'Invalid comparison sort metric' })
+});
+export const positionRangeSchema = z.object({
+    min: z.number()
+        .positive('Minimum position must be positive')
+        .min(1, 'Minimum position must be at least 1'),
+    max: z.number()
+        .positive('Maximum position must be positive')
+        .min(1, 'Maximum position must be at least 1'),
+}).refine((data) => data.min <= data.max, {
+    message: 'Minimum position must be less than or equal to maximum position',
+    path: ['max'],
+});
+export const topNLimitSchema = z.number()
+    .int('Limit must be an integer')
+    .min(1, 'Limit must be at least 1')
+    .max(1000, 'Limit cannot exceed 1,000')
+    .default(20);
+export const minClicksSchema = z.number()
+    .int('Minimum clicks must be an integer')
+    .min(0, 'Minimum clicks cannot be negative')
+    .optional();
+export const minImpressionsSchema = z.number()
+    .int('Minimum impressions must be an integer')
+    .min(0, 'Minimum impressions cannot be negative')
+    .optional();
+export const queryAdvancedParamsSchema = z.object({
+    property: propertyUrlSchema,
+    startDate: dateSchema,
+    endDate: dateSchema,
+    dimensions: dimensionsSchema,
+    filters: z.array(filterSchema).optional(),
+    rowLimit: rowLimitSchema.default(25000),
+    sortBy: sortByMetricSchema.default('clicks'),
+    sortOrder: sortOrderSchema.default('desc'),
+    searchType: searchTypeSchema.optional(),
+    offset: z.number().int().min(0).optional().default(0),
+    limit: z.number().int().min(1).max(25000).optional(),
+}).refine((data) => new Date(data.startDate) <= new Date(data.endDate), {
+    message: 'startDate must be before or equal to endDate',
+    path: ['endDate'],
+});
+export const getTopQueriesParamsSchema = z.object({
+    property: propertyUrlSchema,
+    startDate: dateSchema,
+    endDate: dateSchema,
+    limit: topNLimitSchema,
+    sortBy: sortByMetricSchema.default('clicks'),
+    sortOrder: sortOrderSchema.default('desc'),
+    searchType: searchTypeSchema.optional(),
+    deviceType: deviceTypeSchema.optional(),
+    country: countryCodeSchema.optional(),
+    minClicks: minClicksSchema,
+    minImpressions: minImpressionsSchema,
+    positionRange: positionRangeSchema.optional(),
+}).refine((data) => new Date(data.startDate) <= new Date(data.endDate), {
+    message: 'startDate must be before or equal to endDate',
+    path: ['endDate'],
+});
+export const getTopPagesParamsSchema = z.object({
+    property: propertyUrlSchema,
+    startDate: dateSchema,
+    endDate: dateSchema,
+    limit: topNLimitSchema,
+    sortBy: sortByMetricSchema.default('clicks'),
+    sortOrder: sortOrderSchema.default('desc'),
+    searchType: searchTypeSchema.optional(),
+    deviceType: deviceTypeSchema.optional(),
+    country: countryCodeSchema.optional(),
+    minClicks: minClicksSchema,
+    minImpressions: minImpressionsSchema,
+    positionRange: positionRangeSchema.optional(),
+}).refine((data) => new Date(data.startDate) <= new Date(data.endDate), {
+    message: 'startDate must be before or equal to endDate',
+    path: ['endDate'],
+});
+export const compareDateRangesParamsSchema = z.object({
+    property: propertyUrlSchema,
+    dimension: z.enum(['query', 'page'], {
+        errorMap: () => ({ message: 'Dimension must be either "query" or "page"' })
+    }),
+    currentStartDate: dateSchema,
+    currentEndDate: dateSchema,
+    previousStartDate: dateSchema,
+    previousEndDate: dateSchema,
+    limit: topNLimitSchema.default(50),
+    sortBy: comparisonSortBySchema.default('clicks_change'),
+    searchType: searchTypeSchema.optional(),
+    minCurrentClicks: minClicksSchema,
+    deviceType: deviceTypeSchema.optional(),
+    country: countryCodeSchema.optional(),
+}).refine((data) => new Date(data.currentStartDate) <= new Date(data.currentEndDate), {
+    message: 'currentStartDate must be before or equal to currentEndDate',
+    path: ['currentEndDate'],
+}).refine((data) => new Date(data.previousStartDate) <= new Date(data.previousEndDate), {
+    message: 'previousStartDate must be before or equal to previousEndDate',
+    path: ['previousEndDate'],
+}).refine((data) => new Date(data.currentEndDate) < new Date(data.previousStartDate) ||
+    new Date(data.previousEndDate) < new Date(data.currentStartDate), {
+    message: 'Date ranges should not overlap for meaningful comparison',
+    path: ['currentStartDate'],
+});
+export const getPropertyInfoParamsSchema = z.object({
+    propertyUrl: propertyUrlSchema,
+});
+export const VALID_GSC_DIMENSIONS = [
+    'query',
+    'page',
+    'country',
+    'device',
+    'searchAppearance',
+    'date'
+];
+export const VALID_FILTER_OPERATORS = [
+    'equals',
+    'notEquals',
+    'contains',
+    'notContains',
+    'includingRegex',
+    'excludingRegex'
+];
+export const VALID_SORT_METRICS = [
+    'clicks',
+    'impressions',
+    'ctr',
+    'position'
+];
+export const VALID_COMPARISON_SORT_METRICS = [
+    'clicks',
+    'impressions',
+    'ctr',
+    'position',
+    'clicks_change',
+    'clicks_percent_change',
+    'impressions_change',
+    'impressions_percent_change',
+    'position_change'
+];
+//# sourceMappingURL=validators.js.map

package/dist/utils/validators.js.map

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

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "@disruptorganic/mcp-google-search-console",
+  "version": "1.0.0",
+  "description": "Google Search Console MCP server for Claude Code - Query GSC data with AI",
+  "main": "dist/index.js",
+  "type": "module",
+  "bin": {
+    "mcp-gsc": "./dist/index.js"
+  },
+  "files": [
+    "dist/**/*",
+    "README.md",
+    "LICENSE",
+    ".env.example"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "prepare": "npm run build",
+    "_prepublishOnly": "npm run test && npm run build",
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "clean": "rm -rf dist",
+    "rebuild": "npm run clean && npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "google-search-console",
+    "gsc",
+    "claude",
+    "claude-code",
+    "ai",
+    "search-analytics",
+    "seo",
+    "webmaster-tools"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/The-SEO-Hustler/mcp-google-search-console.git"
+  },
+  "homepage": "https://github.com/The-SEO-Hustler/mcp-google-search-console#readme",
+  "bugs": {
+    "url": "https://github.com/The-SEO-Hustler/mcp-google-search-console/issues"
+  },
+  "author": "Zac Almeida <zac@disruptorganic.com>",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "google-auth-library": "^9.0.0",
+    "googleapis": "^143.0.0",
+    "node-cache": "^5.1.0",
+    "winston": "^3.11.0",
+    "zod": "^3.22.0"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.0.0",
+    "@types/node": "^20.19.25",
+    "@types/node-cache": "^4.1.3",
+    "jest": "^29.0.0",
+    "ts-jest": "^29.0.0",
+    "tsx": "^4.20.6",
+    "typescript": "^5.0.0"
+  }
+}