@disruptorganic/mcp-google-search-console 1.0.0

package/dist/gsc/properties.js

@@ -0,0 +1,393 @@
+import { propertyCache, CACHE_KEYS } from '../utils/cache.js';
+import { logger } from '../utils/logger.js';
+export function detectPropertyType(propertyUrl) {
+    if (!propertyUrl || typeof propertyUrl !== 'string') {
+        logger.warn('Invalid property URL format', { propertyUrl });
+        return 'unknown';
+    }
+    const trimmedUrl = propertyUrl.trim();
+    if (trimmedUrl.startsWith('sc-domain:')) {
+        return 'domain';
+    }
+    if (trimmedUrl.startsWith('https://') || trimmedUrl.startsWith('http://')) {
+        return 'url_prefix';
+    }
+    logger.warn('Unrecognized property URL format', { propertyUrl: trimmedUrl });
+    return 'unknown';
+}
+function extractDomain(propertyUrl) {
+    if (!propertyUrl.startsWith('sc-domain:')) {
+        return undefined;
+    }
+    const domain = propertyUrl.substring(10);
+    return domain || undefined;
+}
+function extractUrlInfo(propertyUrl) {
+    let protocol;
+    if (propertyUrl.startsWith('https://')) {
+        protocol = 'https';
+    }
+    else if (propertyUrl.startsWith('http://')) {
+        protocol = 'http';
+    }
+    else {
+        return undefined;
+    }
+    const baseUrl = propertyUrl.endsWith('/') ? propertyUrl.slice(0, -1) : propertyUrl;
+    return { baseUrl, protocol };
+}
+export function formatProperties(rawProperties) {
+    if (!Array.isArray(rawProperties) || rawProperties.length === 0) {
+        logger.debug('No properties to format');
+        return [];
+    }
+    logger.debug('Formatting properties', { count: rawProperties.length });
+    const formatted = rawProperties.map((raw) => {
+        const propertyUrl = raw.siteUrl || raw.propertyUrl || '';
+        const propertyType = detectPropertyType(propertyUrl);
+        const permissionLevel = raw.permissionLevel || 'unknown';
+        const property = {
+            propertyUrl,
+            propertyType,
+            permissionLevel,
+        };
+        if (propertyType === 'domain') {
+            property.domain = extractDomain(propertyUrl);
+        }
+        else if (propertyType === 'url_prefix') {
+            const urlInfo = extractUrlInfo(propertyUrl);
+            if (urlInfo) {
+                property.baseUrl = urlInfo.baseUrl;
+                property.protocol = urlInfo.protocol;
+            }
+        }
+        return property;
+    });
+    const sorted = formatted.sort((a, b) => {
+        const typePriority = { domain: 1, url_prefix: 2, unknown: 3 };
+        const aTypePriority = typePriority[a.propertyType];
+        const bTypePriority = typePriority[b.propertyType];
+        if (aTypePriority !== bTypePriority) {
+            return aTypePriority - bTypePriority;
+        }
+        if (a.propertyType === 'url_prefix' && b.propertyType === 'url_prefix') {
+            const aProtocolPriority = a.protocol === 'https' ? 1 : 2;
+            const bProtocolPriority = b.protocol === 'https' ? 1 : 2;
+            if (aProtocolPriority !== bProtocolPriority) {
+                return aProtocolPriority - bProtocolPriority;
+            }
+        }
+        return a.propertyUrl.localeCompare(b.propertyUrl);
+    });
+    logger.debug('Properties formatted and sorted', {
+        count: sorted.length,
+        byType: {
+            domain: sorted.filter(p => p.propertyType === 'domain').length,
+            url_prefix: sorted.filter(p => p.propertyType === 'url_prefix').length,
+            unknown: sorted.filter(p => p.propertyType === 'unknown').length,
+        },
+    });
+    return sorted;
+}
+export function groupPropertiesByType(properties) {
+    const domain = properties.filter(p => p.propertyType === 'domain');
+    const url_prefix = properties.filter(p => p.propertyType === 'url_prefix');
+    const result = {
+        domain,
+        url_prefix,
+        counts: {
+            domain: domain.length,
+            url_prefix: url_prefix.length,
+            total: properties.length,
+        },
+    };
+    logger.debug('Properties grouped by type', result.counts);
+    return result;
+}
+function normalizePropertyUrl(input) {
+    if (!input || typeof input !== 'string') {
+        return '';
+    }
+    return input.trim().toLowerCase();
+}
+function normalizeToDomainProperty(input) {
+    const normalized = normalizePropertyUrl(input);
+    if (normalized.startsWith('sc-domain:')) {
+        return normalized;
+    }
+    return `sc-domain:${normalized}`;
+}
+function normalizeToUrlProperty(input, protocol = 'https') {
+    let normalized = normalizePropertyUrl(input);
+    if (normalized.startsWith('sc-domain:')) {
+        normalized = normalized.substring(10);
+    }
+    if (!normalized.startsWith('https://') && !normalized.startsWith('http://')) {
+        normalized = `${protocol}://${normalized}`;
+    }
+    if (!normalized.endsWith('/')) {
+        normalized = `${normalized}/`;
+    }
+    return normalized;
+}
+export function matchProperty(searchInput, availableProperties) {
+    if (!searchInput || typeof searchInput !== 'string') {
+        logger.warn('Invalid search input for property matching', { searchInput });
+        return {
+            matched: null,
+            matchType: 'none',
+            alternatives: [],
+            normalizedInput: '',
+            searchInput: searchInput || '',
+        };
+    }
+    if (!availableProperties || availableProperties.length === 0) {
+        logger.warn('No properties available for matching', { searchInput });
+        return {
+            matched: null,
+            matchType: 'none',
+            alternatives: [],
+            normalizedInput: normalizePropertyUrl(searchInput),
+            searchInput,
+        };
+    }
+    const normalizedInput = normalizePropertyUrl(searchInput);
+    logger.debug('Starting property match', {
+        searchInput,
+        normalizedInput,
+        availableCount: availableProperties.length,
+    });
+    const domainPropertyUrl = normalizeToDomainProperty(normalizedInput);
+    const exactDomainMatch = availableProperties.find(p => normalizePropertyUrl(p.propertyUrl) === domainPropertyUrl);
+    if (exactDomainMatch) {
+        logger.info('Property matched: exact domain', {
+            searchInput,
+            matched: exactDomainMatch.propertyUrl,
+            matchType: 'exact_domain',
+        });
+        return {
+            matched: exactDomainMatch,
+            matchType: 'exact_domain',
+            normalizedInput: domainPropertyUrl,
+            searchInput,
+        };
+    }
+    if (!normalizedInput.startsWith('http://')) {
+        const httpsPropertyUrl = normalizeToUrlProperty(normalizedInput, 'https');
+        const exactHttpsMatch = availableProperties.find(p => normalizePropertyUrl(p.propertyUrl) === httpsPropertyUrl);
+        if (exactHttpsMatch) {
+            logger.info('Property matched: exact HTTPS URL', {
+                searchInput,
+                matched: exactHttpsMatch.propertyUrl,
+                matchType: 'exact_url_https',
+            });
+            return {
+                matched: exactHttpsMatch,
+                matchType: 'exact_url_https',
+                normalizedInput: httpsPropertyUrl,
+                searchInput,
+            };
+        }
+    }
+    const httpPropertyUrl = normalizeToUrlProperty(normalizedInput, 'http');
+    const exactHttpMatch = availableProperties.find(p => normalizePropertyUrl(p.propertyUrl) === httpPropertyUrl);
+    if (exactHttpMatch) {
+        logger.info('Property matched: exact HTTP URL', {
+            searchInput,
+            matched: exactHttpMatch.propertyUrl,
+            matchType: 'exact_url_http',
+        });
+        return {
+            matched: exactHttpMatch,
+            matchType: 'exact_url_http',
+            normalizedInput: httpPropertyUrl,
+            searchInput,
+        };
+    }
+    const fuzzyDomainMatches = availableProperties.filter(p => {
+        if (p.propertyType !== 'domain') {
+            return false;
+        }
+        const propertyUrlLower = normalizePropertyUrl(p.propertyUrl);
+        const domainLower = p.domain?.toLowerCase() || '';
+        return propertyUrlLower.includes(normalizedInput) ||
+            domainLower.includes(normalizedInput) ||
+            normalizedInput.includes(propertyUrlLower);
+    });
+    if (fuzzyDomainMatches.length > 0) {
+        const fuzzyUrlMatchesForAmbiguity = availableProperties.filter(p => {
+            if (p.propertyType !== 'url_prefix') {
+                return false;
+            }
+            const propertyUrlLower = normalizePropertyUrl(p.propertyUrl);
+            const baseUrlLower = p.baseUrl?.toLowerCase() || '';
+            return propertyUrlLower.includes(normalizedInput) ||
+                baseUrlLower.includes(normalizedInput) ||
+                normalizedInput.includes(propertyUrlLower);
+        });
+        const allFuzzyMatches = [...fuzzyDomainMatches, ...fuzzyUrlMatchesForAmbiguity];
+        logger.info('Property matched: fuzzy domain', {
+            searchInput,
+            domainMatchCount: fuzzyDomainMatches.length,
+            urlMatchCount: fuzzyUrlMatchesForAmbiguity.length,
+            totalMatchCount: allFuzzyMatches.length,
+            matches: allFuzzyMatches.map(p => p.propertyUrl),
+            matchType: 'fuzzy_domain',
+        });
+        return {
+            matched: allFuzzyMatches.length === 1 ? (allFuzzyMatches[0] ?? null) : null,
+            matchType: 'fuzzy_domain',
+            alternatives: allFuzzyMatches,
+            normalizedInput,
+            searchInput,
+        };
+    }
+    const fuzzyUrlMatches = availableProperties.filter(p => {
+        if (p.propertyType !== 'url_prefix') {
+            return false;
+        }
+        const propertyUrlLower = normalizePropertyUrl(p.propertyUrl);
+        const baseUrlLower = p.baseUrl?.toLowerCase() || '';
+        return propertyUrlLower.includes(normalizedInput) ||
+            baseUrlLower.includes(normalizedInput) ||
+            normalizedInput.includes(propertyUrlLower);
+    });
+    if (fuzzyUrlMatches.length > 0) {
+        logger.info('Property matched: fuzzy URL', {
+            searchInput,
+            matchCount: fuzzyUrlMatches.length,
+            matches: fuzzyUrlMatches.map(p => p.propertyUrl),
+            matchType: 'fuzzy_url',
+        });
+        return {
+            matched: fuzzyUrlMatches.length === 1 ? (fuzzyUrlMatches[0] ?? null) : null,
+            matchType: 'fuzzy_url',
+            alternatives: fuzzyUrlMatches,
+            normalizedInput,
+            searchInput,
+        };
+    }
+    logger.warn('No property match found', {
+        searchInput,
+        normalizedInput,
+        availableCount: availableProperties.length,
+    });
+    return {
+        matched: null,
+        matchType: 'none',
+        alternatives: [],
+        normalizedInput,
+        searchInput,
+    };
+}
+export function generatePropertyMatchError(result, availableProperties) {
+    const { searchInput, matchType, alternatives } = result;
+    if (matchType !== 'none' && alternatives && alternatives.length > 1) {
+        const matchList = alternatives
+            .map(p => `  - ${p.propertyUrl} (${p.propertyType})`)
+            .join('\n');
+        return `Property '${searchInput}' is ambiguous. Multiple matches found:\n${matchList}\n\nPlease provide a more specific property identifier.`;
+    }
+    if (matchType === 'none') {
+        const propertyList = availableProperties
+            .slice(0, 10)
+            .map(p => `  - ${p.propertyUrl} (${p.propertyType})`)
+            .join('\n');
+        const moreText = availableProperties.length > 10
+            ? `\n  ... and ${availableProperties.length - 10} more`
+            : '';
+        const suggestions = getPropertySuggestions(availableProperties, searchInput, 3);
+        const suggestionText = suggestions.length > 0
+            ? `\n\nDid you mean one of these?\n${suggestions.map(p => `  - ${p.propertyUrl}`).join('\n')}`
+            : '';
+        return `Property '${searchInput}' not found.\n\nAvailable properties:\n${propertyList}${moreText}${suggestionText}\n\nTip: Use the list_properties tool to see all available properties.`;
+    }
+    return `Property '${searchInput}' matched successfully as ${result.matched?.propertyUrl}`;
+}
+export async function listProperties(client, forceRefresh = false) {
+    const cacheKey = CACHE_KEYS.PROPERTIES;
+    if (!forceRefresh) {
+        const cached = propertyCache.get(cacheKey);
+        if (cached !== undefined) {
+            logger.info('Returning cached properties', {
+                count: cached.length,
+                source: 'cache',
+            });
+            return cached;
+        }
+    }
+    else {
+        logger.info('Force refresh requested, bypassing cache');
+    }
+    logger.info('Fetching properties from GSC API');
+    try {
+        const rawProperties = await client.listProperties();
+        if (!rawProperties || rawProperties.length === 0) {
+            logger.warn('No properties found for this account');
+            return [];
+        }
+        const properties = formatProperties(rawProperties);
+        propertyCache.set(cacheKey, properties);
+        logger.info('Properties fetched and cached', {
+            count: properties.length,
+            source: 'api',
+            byType: {
+                domain: properties.filter(p => p.propertyType === 'domain').length,
+                url_prefix: properties.filter(p => p.propertyType === 'url_prefix').length,
+            },
+        });
+        return properties;
+    }
+    catch (error) {
+        logger.error('Failed to fetch properties', {
+            error: error instanceof Error ? error.message : String(error),
+            forceRefresh,
+        });
+        throw error;
+    }
+}
+export function findProperty(properties, searchUrl) {
+    if (!searchUrl || !properties || properties.length === 0) {
+        return undefined;
+    }
+    const search = searchUrl.trim();
+    let found = properties.find(p => p.propertyUrl === search);
+    if (found)
+        return found;
+    found = properties.find(p => p.propertyUrl.toLowerCase() === search.toLowerCase());
+    if (found)
+        return found;
+    found = properties.find(p => p.propertyUrl.includes(search) || search.includes(p.propertyUrl));
+    if (found)
+        return found;
+    return undefined;
+}
+export function getPropertySuggestions(properties, partialUrl, limit = 5) {
+    if (!partialUrl || !properties || properties.length === 0) {
+        return [];
+    }
+    const search = partialUrl.toLowerCase().trim();
+    const matches = properties.filter(p => p.propertyUrl.toLowerCase().includes(search) ||
+        p.domain?.toLowerCase().includes(search) ||
+        p.baseUrl?.toLowerCase().includes(search));
+    return matches.slice(0, limit);
+}
+export function invalidatePropertiesCache() {
+    propertyCache.invalidate(CACHE_KEYS.PROPERTIES);
+    logger.info('Properties cache invalidated');
+}
+export function getPropertiesCacheInfo() {
+    const cacheKey = CACHE_KEYS.PROPERTIES;
+    const isCached = propertyCache.has(cacheKey);
+    if (!isCached) {
+        return { isCached: false };
+    }
+    const cached = propertyCache.get(cacheKey);
+    const ttl = propertyCache.getTtl(cacheKey);
+    return {
+        isCached: true,
+        ttl,
+        cachedCount: cached?.length,
+    };
+}
+//# sourceMappingURL=properties.js.map

package/dist/gsc/properties.js.map

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

package/dist/gsc/queries.d.ts

@@ -0,0 +1,73 @@
+import { GSCClient, QueryResponse, FilterGroup } from './client.js';
+import { TokenBucketRateLimiter } from '../utils/rate-limiter.js';
+export interface QueryRequest {
+    propertyUrl: string;
+    startDate: string;
+    endDate: string;
+    dimensions?: string[];
+    filters?: FilterGroup[];
+    rowLimit?: number;
+    startRow?: number;
+    searchType?: 'web' | 'image' | 'video' | 'news' | 'discover' | 'googleNews';
+    aggregationType?: 'auto' | 'byProperty' | 'byPage';
+    dataState?: 'final' | 'all';
+}
+export interface GSCRow {
+    keys: string[];
+    clicks: number;
+    impressions: number;
+    ctr: number;
+    position: number;
+}
+export interface QueryError {
+    identifier: string;
+    error: string;
+    errorCode?: string;
+    statusCode?: number;
+    retried: boolean;
+    attempts: number;
+}
+export interface AggregatedQueryResults {
+    rows: GSCRow[];
+    totalRows: number;
+    queryCounts: {
+        successful: number;
+        failed: number;
+        total: number;
+    };
+    errors?: QueryError[];
+}
+export declare function executeParallelQueries(client: GSCClient, queries: QueryRequest[], rateLimiter: TokenBucketRateLimiter): Promise<QueryResponse[]>;
+export declare function queryMultipleKeywords(client: GSCClient, propertyUrl: string, keywords: string[], baseQuery: Omit<QueryRequest, 'propertyUrl' | 'filters'>, rateLimiter: TokenBucketRateLimiter): Promise<AggregatedQueryResults>;
+export declare function aggregateResults(results: QueryResponse[]): AggregatedQueryResults;
+export declare function sortResults(rows: GSCRow[], sortBy: 'clicks' | 'impressions' | 'ctr' | 'position', order?: 'asc' | 'desc'): GSCRow[];
+export declare function filterResults(rows: GSCRow[], thresholds: {
+    clicks?: number;
+    impressions?: number;
+    ctr?: number;
+    position?: number;
+}): GSCRow[];
+export declare function getResultStatistics(rows: GSCRow[]): {
+    totalRows: number;
+    totalClicks: number;
+    totalImpressions: number;
+    averageCtr: number;
+    averagePosition: number;
+    weightedAveragePosition: number;
+};
+export interface TopNQueryOptions {
+    limit?: number;
+    sortBy?: 'clicks' | 'impressions' | 'ctr' | 'position';
+    sortOrder?: 'asc' | 'desc';
+    searchType?: string;
+    minClicks?: number;
+    minImpressions?: number;
+    positionRange?: {
+        min: number;
+        max: number;
+    };
+    deviceType?: string;
+    country?: string;
+}
+export declare function executeTopNQuery(client: GSCClient, property: string, startDate: string, endDate: string, dimension: 'query' | 'page', options?: TopNQueryOptions): Promise<GSCRow[]>;
+//# sourceMappingURL=queries.d.ts.map

package/dist/gsc/queries.d.ts.map

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