@serpstat/serpstat-mcp-server 1.0.7 → 1.0.9

package/dist/handlers/rank_tracking_tools.js

@@ -0,0 +1,335 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetRtProjectUrlSerpHistoryHandler = exports.GetRtProjectKeywordSerpHistoryHandler = exports.GetRtProjectRegionsListHandler = exports.GetRtProjectStatusHandler = exports.GetRtProjectsListHandler = void 0;
+const base_js_1 = require("./base.js");
+const rank_tracking_service_js_1 = require("../services/rank_tracking_service.js");
+const validation_js_1 = require("../utils/validation.js");
+const config_js_1 = require("../utils/config.js");
+const zod_1 = require("zod");
+const constants_js_1 = require("../utils/constants.js");
+class GetRtProjectsListHandler extends base_js_1.BaseHandler {
+    rankTrackingService;
+    constructor() {
+        super();
+        const config = (0, config_js_1.loadConfig)();
+        this.rankTrackingService = new rank_tracking_service_js_1.RankTrackingService(config);
+    }
+    getName() {
+        return 'get_rt_projects_list';
+    }
+    getDescription() {
+        return 'Get a list of rank tracker projects including project ID, name, domain, creation date, and tracking status. This method does not consume API credits.';
+    }
+    getInputSchema() {
+        return {
+            type: "object",
+            properties: {
+                page: {
+                    type: "number",
+                    minimum: constants_js_1.MIN_PAGE,
+                    default: 1,
+                    description: "Page number in the projects list"
+                },
+                pageSize: {
+                    type: "number",
+                    enum: constants_js_1.RT_ALLOWED_PAGE_SIZES,
+                    default: constants_js_1.DEFAULT_RT_PAGE_SIZE,
+                    description: `Number of results per page. Allowed values: ${constants_js_1.RT_ALLOWED_PAGE_SIZES.join(', ')}`
+                }
+            },
+            additionalProperties: false
+        };
+    }
+    async handle(call) {
+        try {
+            const params = validation_js_1.getRtProjectsListSchema.parse(call.arguments);
+            const result = await this.rankTrackingService.getRtProjectsList(params);
+            return this.createSuccessResponse(result);
+        }
+        catch (error) {
+            if (error instanceof zod_1.z.ZodError) {
+                return this.createErrorResponse(new Error(`Invalid parameters: ${error.errors.map(e => `${e.path.join('.')}: ${e.message}`).join(', ')}`));
+            }
+            return this.createErrorResponse(error);
+        }
+    }
+}
+exports.GetRtProjectsListHandler = GetRtProjectsListHandler;
+class GetRtProjectStatusHandler extends base_js_1.BaseHandler {
+    rankTrackingService;
+    constructor() {
+        super();
+        const config = (0, config_js_1.loadConfig)();
+        this.rankTrackingService = new rank_tracking_service_js_1.RankTrackingService(config);
+    }
+    getName() {
+        return 'get_rt_project_status';
+    }
+    getDescription() {
+        return 'Get the current status of position updates (parsing) for a rank tracker project and region. Use this to check if data is ready before requesting results. This method does not consume API credits.';
+    }
+    getInputSchema() {
+        return {
+            type: "object",
+            properties: {
+                projectId: {
+                    type: "number",
+                    minimum: constants_js_1.MIN_RT_PROJECT_ID,
+                    description: "Project identifier"
+                },
+                regionId: {
+                    type: "number",
+                    minimum: constants_js_1.MIN_RT_REGION_ID,
+                    description: "Search region ID (see https://docs.google.com/spreadsheets/d/1LUDtm-L1qWMVpmWuN-nvDyYFfQtfiXUh5LIHE8sjs0k/edit?gid=75443986#gid=75443986)"
+                }
+            },
+            required: ["projectId", "regionId"],
+            additionalProperties: false
+        };
+    }
+    async handle(call) {
+        try {
+            const params = validation_js_1.getRtProjectStatusSchema.parse(call.arguments);
+            const result = await this.rankTrackingService.getRtProjectStatus(params);
+            return this.createSuccessResponse(result);
+        }
+        catch (error) {
+            if (error instanceof zod_1.z.ZodError) {
+                return this.createErrorResponse(new Error(`Invalid parameters: ${error.errors.map(e => `${e.path.join('.')}: ${e.message}`).join(', ')}`));
+            }
+            return this.createErrorResponse(error);
+        }
+    }
+}
+exports.GetRtProjectStatusHandler = GetRtProjectStatusHandler;
+class GetRtProjectRegionsListHandler extends base_js_1.BaseHandler {
+    rankTrackingService;
+    constructor() {
+        super();
+        const config = (0, config_js_1.loadConfig)();
+        this.rankTrackingService = new rank_tracking_service_js_1.RankTrackingService(config);
+    }
+    getName() {
+        return 'get_rt_project_regions_list';
+    }
+    getDescription() {
+        return 'Get the list of regions configured for a rank tracker project, including region ID, status (active/inactive), SERP type (organic/paid), device type (desktop/mobile), search engine, and location details. This method does not consume API credits.';
+    }
+    getInputSchema() {
+        return {
+            type: "object",
+            properties: {
+                projectId: {
+                    type: "number",
+                    minimum: constants_js_1.MIN_RT_PROJECT_ID,
+                    description: "Project identifier"
+                }
+            },
+            required: ["projectId"],
+            additionalProperties: false
+        };
+    }
+    async handle(call) {
+        try {
+            const params = validation_js_1.getRtProjectRegionsListSchema.parse(call.arguments);
+            const result = await this.rankTrackingService.getRtProjectRegionsList(params);
+            return this.createSuccessResponse(result);
+        }
+        catch (error) {
+            if (error instanceof zod_1.z.ZodError) {
+                return this.createErrorResponse(new Error(`Invalid parameters: ${error.errors.map(e => `${e.path.join('.')}: ${e.message}`).join(', ')}`));
+            }
+            return this.createErrorResponse(error);
+        }
+    }
+}
+exports.GetRtProjectRegionsListHandler = GetRtProjectRegionsListHandler;
+class GetRtProjectKeywordSerpHistoryHandler extends base_js_1.BaseHandler {
+    rankTrackingService;
+    constructor() {
+        super();
+        const config = (0, config_js_1.loadConfig)();
+        this.rankTrackingService = new rank_tracking_service_js_1.RankTrackingService(config);
+    }
+    getName() {
+        return 'get_rt_project_keyword_serp_history';
+    }
+    getDescription() {
+        return 'Get complete Google top-100 SERP history for tracked keywords in a rank tracker project. Returns full competitor analysis with historical positions, URLs, domains, and search volumes for each date. WARNING: This method returns large datasets (full top-100 for each keyword/date combination). Recommended pageSize: 20-50 for most use cases. Use date filters and keyword filters to reduce response size. Supports keyword tagging for grouping and filtering. This method does not consume API credits.';
+    }
+    getInputSchema() {
+        return {
+            type: "object",
+            properties: {
+                projectId: {
+                    type: "number",
+                    minimum: constants_js_1.MIN_RT_PROJECT_ID,
+                    description: "Project identifier"
+                },
+                projectRegionId: {
+                    type: "number",
+                    minimum: constants_js_1.MIN_RT_REGION_ID,
+                    description: "Region ID for the project. Required. Get from get_rt_project_regions_list method. Each project can track multiple regions. See region reference: https://docs.google.com/spreadsheets/d/1LUDtm-L1qWMVpmWuN-nvDyYFfQtfiXUh5LIHE8sjs0k/edit?gid=75443986#gid=75443986"
+                },
+                page: {
+                    type: "number",
+                    minimum: constants_js_1.MIN_PAGE,
+                    default: 1,
+                    description: "Page number for pagination. Starts at 1."
+                },
+                pageSize: {
+                    type: "number",
+                    enum: constants_js_1.RT_ALLOWED_PAGE_SIZES,
+                    default: constants_js_1.DEFAULT_RT_PAGE_SIZE,
+                    description: `Number of keywords per page. Allowed values: ${constants_js_1.RT_ALLOWED_PAGE_SIZES.join(', ')}. RECOMMENDED: Use 20 or 50 to avoid response truncation due to large dataset sizes. Each keyword returns full top-100 SERP for all dates.`
+                },
+                dateFrom: {
+                    type: "string",
+                    pattern: "^\\d{4}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])$",
+                    description: "Start date of the period in YYYY-MM-DD format (e.g., '2025-09-01'). Use to filter historical data and reduce response size."
+                },
+                dateTo: {
+                    type: "string",
+                    pattern: "^\\d{4}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])$",
+                    description: "End date of the period in YYYY-MM-DD format (e.g., '2025-09-30'). Use to filter historical data and reduce response size."
+                },
+                sort: {
+                    type: "string",
+                    enum: constants_js_1.RT_SERP_HISTORY_SORT_TYPES,
+                    description: "Sort results by 'keyword' (alphabetically) or 'date' (chronologically). Default is 'date'."
+                },
+                order: {
+                    type: "string",
+                    enum: ["asc", "desc"],
+                    description: "Sorting order: 'asc' (oldest first) or 'desc' (newest first). Default is 'desc'."
+                },
+                keywords: {
+                    type: "array",
+                    items: {
+                        type: "string"
+                    },
+                    maxItems: constants_js_1.MAX_RT_KEYWORDS_FILTER,
+                    description: `Filter by specific keywords (max ${constants_js_1.MAX_RT_KEYWORDS_FILTER} keywords)`
+                },
+                withTags: {
+                    type: "boolean",
+                    default: false,
+                    description: "Include keyword tags in the response. Tags are used to group and categorize keywords in the project. Set to true to receive tag IDs and values for each keyword."
+                }
+            },
+            required: ["projectId", "projectRegionId", "page"],
+            additionalProperties: false
+        };
+    }
+    async handle(call) {
+        try {
+            const params = validation_js_1.getRtProjectKeywordSerpHistorySchema.parse(call.arguments);
+            const result = await this.rankTrackingService.getRtProjectKeywordSerpHistory(params);
+            return this.createSuccessResponse(result);
+        }
+        catch (error) {
+            if (error instanceof zod_1.z.ZodError) {
+                return this.createErrorResponse(new Error(`Invalid parameters: ${error.errors.map(e => `${e.path.join('.')}: ${e.message}`).join(', ')}`));
+            }
+            return this.createErrorResponse(error);
+        }
+    }
+}
+exports.GetRtProjectKeywordSerpHistoryHandler = GetRtProjectKeywordSerpHistoryHandler;
+class GetRtProjectUrlSerpHistoryHandler extends base_js_1.BaseHandler {
+    rankTrackingService;
+    constructor() {
+        super();
+        const config = (0, config_js_1.loadConfig)();
+        this.rankTrackingService = new rank_tracking_service_js_1.RankTrackingService(config);
+    }
+    getName() {
+        return 'get_rt_project_url_serp_history';
+    }
+    getDescription() {
+        return 'Get ranking history showing only YOUR domain\'s positions across all tracked keywords. Unlike get_rt_project_keyword_serp_history (which shows full top-100), this method returns only positions where your specified domain/URL ranks. Perfect for tracking your own performance over time without competitor noise. Returns historical position data, search volumes, and optional keyword tags. This method does not consume API credits.';
+    }
+    getInputSchema() {
+        return {
+            type: "object",
+            properties: {
+                projectId: {
+                    type: "number",
+                    minimum: constants_js_1.MIN_RT_PROJECT_ID,
+                    description: "Rank tracker project ID. Required. Get from get_rt_projects_list method."
+                },
+                projectRegionId: {
+                    type: "number",
+                    minimum: constants_js_1.MIN_RT_REGION_ID,
+                    description: "Region ID for the project. Required. Get from get_rt_project_regions_list method. Each project can track multiple regions. See region reference: https://docs.google.com/spreadsheets/d/1LUDtm-L1qWMVpmWuN-nvDyYFfQtfiXUh5LIHE8sjs0k/edit?gid=75443986#gid=75443986"
+                },
+                page: {
+                    type: "number",
+                    minimum: constants_js_1.MIN_PAGE,
+                    default: 1,
+                    description: "Page number for pagination. Starts at 1."
+                },
+                pageSize: {
+                    type: "number",
+                    enum: constants_js_1.RT_ALLOWED_PAGE_SIZES,
+                    default: constants_js_1.DEFAULT_RT_PAGE_SIZE,
+                    description: "Number of keywords per page. Allowed values: 20, 50, 100, 500. Recommended: 100 for most use cases (response is much smaller than get_rt_project_keyword_serp_history since it only shows your domain's positions)."
+                },
+                dateFrom: {
+                    type: "string",
+                    pattern: "^\\d{4}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])$",
+                    description: "Start date of the period in YYYY-MM-DD format (e.g., '2025-09-01'). Filters historical data to this date range."
+                },
+                dateTo: {
+                    type: "string",
+                    pattern: "^\\d{4}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])$",
+                    description: "End date of the period in YYYY-MM-DD format (e.g., '2025-09-30'). Filters historical data to this date range."
+                },
+                sort: {
+                    type: "string",
+                    enum: constants_js_1.RT_SERP_HISTORY_SORT_TYPES,
+                    description: "Sort results by 'keyword' (alphabetically) or 'date' (chronologically). Default is 'keyword'."
+                },
+                order: {
+                    type: "string",
+                    enum: ["asc", "desc"],
+                    description: "Sorting order: 'asc' (oldest first) or 'desc' (newest first). Default is 'desc'."
+                },
+                keywords: {
+                    type: "array",
+                    items: {
+                        type: "string"
+                    },
+                    maxItems: constants_js_1.MAX_RT_KEYWORDS_FILTER,
+                    description: "Filter results by specific keywords (max 1000 keywords). Returns only data for the specified keywords where your domain ranks."
+                },
+                withTags: {
+                    type: "boolean",
+                    default: false,
+                    description: "Include keyword tags in the response. Tags are used to group and categorize keywords in the project. Set to true to receive tag IDs and values for each keyword."
+                },
+                domain: {
+                    type: "string",
+                    description: "Domain or URL to track. Accepts: 'domain.com' (tracks all URLs from this domain), 'subdomain.domain.com' (tracks specific subdomain), or full URL 'https://domain.com/page' (tracks specific page). Do NOT include protocol for domain-level tracking."
+                }
+            },
+            required: ["projectId", "projectRegionId", "page"],
+            additionalProperties: false
+        };
+    }
+    async handle(call) {
+        try {
+            const params = validation_js_1.getRtProjectUrlSerpHistorySchema.parse(call.arguments);
+            const result = await this.rankTrackingService.getRtProjectUrlSerpHistory(params);
+            return this.createSuccessResponse(result);
+        }
+        catch (error) {
+            if (error instanceof zod_1.z.ZodError) {
+                return this.createErrorResponse(new Error(`Invalid parameters: ${error.errors.map(e => `${e.path.join('.')}: ${e.message}`).join(', ')}`));
+            }
+            return this.createErrorResponse(error);
+        }
+    }
+}
+exports.GetRtProjectUrlSerpHistoryHandler = GetRtProjectUrlSerpHistoryHandler;
+//# sourceMappingURL=rank_tracking_tools.js.map

package/dist/handlers/rank_tracking_tools.js.map

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

package/dist/handlers/url_tools.d.ts

@@ -0,0 +1,35 @@
+import { BaseHandler } from './base.js';
+import { MCPToolCall, MCPToolResponse } from '../types/mcp.js';
+export declare class GetUrlSummaryTrafficHandler extends BaseHandler {
+    private urlService;
+    constructor();
+    getName(): string;
+    getDescription(): string;
+    getInputSchema(): object;
+    handle(call: MCPToolCall): Promise<MCPToolResponse>;
+}
+export declare class GetUrlCompetitorsHandler extends BaseHandler {
+    private urlService;
+    constructor();
+    getName(): string;
+    getDescription(): string;
+    getInputSchema(): object;
+    handle(call: MCPToolCall): Promise<MCPToolResponse>;
+}
+export declare class GetUrlKeywordsHandler extends BaseHandler {
+    private urlService;
+    constructor();
+    getName(): string;
+    getDescription(): string;
+    getInputSchema(): object;
+    handle(call: MCPToolCall): Promise<MCPToolResponse>;
+}
+export declare class GetUrlMissingKeywordsHandler extends BaseHandler {
+    private urlService;
+    constructor();
+    getName(): string;
+    getDescription(): string;
+    getInputSchema(): object;
+    handle(call: MCPToolCall): Promise<MCPToolResponse>;
+}
+//# sourceMappingURL=url_tools.d.ts.map

package/dist/handlers/url_tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url_tools.d.ts","sourceRoot":"","sources":["../../src/handlers/url_tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAwB/D,qBAAa,2BAA4B,SAAQ,WAAW;IACxD,OAAO,CAAC,UAAU,CAAa;;IAQ/B,OAAO,IAAI,MAAM;IAIjB,cAAc,IAAI,MAAM;IAOxB,cAAc,IAAI,MAAM;IA+BlB,MAAM,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC;CAY5D;AAED,qBAAa,wBAAyB,SAAQ,WAAW;IACrD,OAAO,CAAC,UAAU,CAAa;;IAQ/B,OAAO,IAAI,MAAM;IAIjB,cAAc,IAAI,MAAM;IAIxB,cAAc,IAAI,MAAM;IA8ClB,MAAM,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC;CAe5D;AAED,qBAAa,qBAAsB,SAAQ,WAAW;IAClD,OAAO,CAAC,UAAU,CAAa;;IAQ/B,OAAO,IAAI,MAAM;IAIjB,cAAc,IAAI,MAAM;IAIxB,cAAc,IAAI,MAAM;IAoFlB,MAAM,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC;CAe5D;AAED,qBAAa,4BAA6B,SAAQ,WAAW;IACzD,OAAO,CAAC,UAAU,CAAa;;IAQ/B,OAAO,IAAI,MAAM;IAIjB,cAAc,IAAI,MAAM;IAIxB,cAAc,IAAI,MAAM;IAuElB,MAAM,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC;CAe5D"}