@serpstat/serpstat-mcp-server 1.0.2

package/dist/handlers/keyword_tools.js

@@ -0,0 +1,251 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetRelatedKeywordsHandler = exports.GetKeywordsHandler = void 0;
+const base_js_1 = require("./base.js");
+const keyword_tools_js_1 = require("../services/keyword_tools.js");
+const validation_js_1 = require("../utils/validation.js");
+const config_js_1 = require("../utils/config.js");
+const zod_1 = require("zod");
+class GetKeywordsHandler extends base_js_1.BaseHandler {
+    keywordService;
+    constructor() {
+        super();
+        const config = (0, config_js_1.loadConfig)();
+        this.keywordService = new keyword_tools_js_1.KeywordService(config);
+    }
+    getName() {
+        return 'get_keywords';
+    }
+    getDescription() {
+        return 'Shows organic keywords related to the researched keyword for which domains rank in Google top 100. For each found keyword, displays its search volume, CPC, and competition level.';
+    }
+    getInputSchema() {
+        return {
+            type: 'object',
+            properties: {
+                keyword: {
+                    type: 'string',
+                    minLength: 1,
+                    maxLength: 100,
+                    description: 'Keyword for finding related keywords'
+                },
+                se: {
+                    type: 'string',
+                    enum: [
+                        'g_us', 'g_uk', 'g_au', 'g_ca', 'g_de',
+                        'g_fr', 'g_br', 'g_mx', 'g_es', 'g_bg',
+                        'g_it', 'g_nl', 'g_pl', 'g_ua'
+                    ],
+                    default: 'g_us',
+                    description: 'Search database ID'
+                },
+                minusKeywords: {
+                    type: 'array',
+                    items: { type: 'string', minLength: 1, maxLength: 100 },
+                    maxItems: 50,
+                    description: 'Keywords to exclude from search'
+                },
+                withIntents: {
+                    type: 'boolean',
+                    default: false,
+                    description: 'Whether to include keyword intents'
+                },
+                page: {
+                    type: 'integer',
+                    minimum: 1,
+                    default: 1,
+                    description: 'page number'
+                },
+                size: {
+                    type: 'integer',
+                    minimum: 1,
+                    maximum: 1000,
+                    default: 100,
+                    description: 'results per page'
+                },
+                sort: {
+                    type: 'object',
+                    properties: {
+                        region_queries_count: { type: 'string', enum: ['asc', 'desc'] },
+                        cost: { type: 'string', enum: ['asc', 'desc'] },
+                        difficulty: { type: 'string', enum: ['asc', 'desc'] },
+                        concurrency: { type: 'string', enum: ['asc', 'desc'] },
+                        found_results: { type: 'string', enum: ['asc', 'desc'] },
+                        keyword_length: { type: 'string', enum: ['asc', 'desc'] }
+                    },
+                    additionalProperties: false,
+                    description: 'Sorting parameters for results'
+                },
+                filters: {
+                    type: 'object',
+                    properties: {
+                        cost: { type: 'number', minimum: 0, maximum: 200 },
+                        cost_from: { type: 'number', minimum: 0, maximum: 200 },
+                        cost_to: { type: 'number', minimum: 0, maximum: 200 },
+                        region_queries_count: { type: 'integer', minimum: 0, maximum: 100000000 },
+                        region_queries_count_from: { type: 'integer', minimum: 0, maximum: 100000000 },
+                        region_queries_count_to: { type: 'integer', minimum: 0, maximum: 100000000 },
+                        keyword_length: { type: 'integer', minimum: 1 },
+                        keyword_length_from: { type: 'integer', minimum: 1 },
+                        keyword_length_to: { type: 'integer', minimum: 1 },
+                        difficulty: { type: 'integer', minimum: 0, maximum: 100 },
+                        difficulty_from: { type: 'integer', minimum: 0, maximum: 100 },
+                        difficulty_to: { type: 'integer', minimum: 0, maximum: 100 },
+                        concurrency: { type: 'integer', minimum: 1, maximum: 100 },
+                        concurrency_from: { type: 'integer', minimum: 1, maximum: 100 },
+                        concurrency_to: { type: 'integer', minimum: 1, maximum: 100 },
+                        right_spelling: { type: 'boolean', description: 'Filter by correct spelling' },
+                        keyword_contain: { type: 'array', items: { type: 'string' }, description: 'Keywords must contain all of these terms (exact match)' },
+                        keyword_not_contain: { type: 'array', items: { type: 'string' }, description: 'Keywords must not contain these terms (exact match)' },
+                        keyword_contain_one_of: { type: 'array', items: { type: 'string' }, description: 'Keywords must contain at least one of these terms' },
+                        keyword_not_contain_one_of: { type: 'array', items: { type: 'string' }, description: 'Keywords must not contain any of these terms' },
+                        keyword_contain_broad_match: { type: 'array', items: { type: 'string' }, description: 'Keywords must contain all of these terms (broad match)' },
+                        keyword_not_contain_broad_match: { type: 'array', items: { type: 'string' }, description: 'Keywords must not contain these terms (broad match)' },
+                        keyword_contain_one_of_broad_match: { type: 'array', items: { type: 'string' }, description: 'Keywords must contain at least one of these terms (broad match)' },
+                        keyword_not_contain_one_of_broad_match: { type: 'array', items: { type: 'string' }, description: 'Keywords must not contain any of these terms (broad match)' },
+                        geo_names: { type: 'string', enum: ['contain', 'not_contain'], description: 'Filter by presence of geographic names' },
+                        types: { type: 'array', items: { type: 'string' }, description: 'Filter by SERP feature types' },
+                        intents_contain: { type: 'array', items: { type: 'string', enum: ['informational', 'navigational', 'commercial', 'transactional'] }, description: 'Keywords must contain these search intents' }
+                    },
+                    additionalProperties: false,
+                    description: 'Results filters'
+                }
+            },
+            required: ['keyword', 'se'],
+            additionalProperties: false
+        };
+    }
+    async handle(call) {
+        try {
+            const params = validation_js_1.keywordGetSchema.parse(call.arguments);
+            const result = await this.keywordService.getKeywords(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.GetKeywordsHandler = GetKeywordsHandler;
+class GetRelatedKeywordsHandler extends base_js_1.BaseHandler {
+    keywordService;
+    constructor() {
+        super();
+        const config = (0, config_js_1.loadConfig)();
+        this.keywordService = new keyword_tools_js_1.KeywordService(config);
+    }
+    getName() {
+        return 'get_related_keywords';
+    }
+    getDescription() {
+        return 'Shows all search queries semantically related to the researched keyword. For each found keyword, displays its search volume, CPC, competition, difficulty, weight, intents, and more.';
+    }
+    getInputSchema() {
+        return {
+            type: 'object',
+            properties: {
+                keyword: {
+                    type: 'string',
+                    minLength: 1,
+                    maxLength: 200,
+                    description: 'Keyword for finding related keywords'
+                },
+                se: {
+                    type: 'string',
+                    enum: [
+                        'g_us', 'g_uk', 'g_au', 'g_ca', 'g_de',
+                        'g_fr', 'g_br', 'g_mx', 'g_es', 'g_bg',
+                        'g_it', 'g_nl', 'g_pl', 'g_ua'
+                    ],
+                    default: 'g_us',
+                    description: 'Search database ID'
+                },
+                withIntents: {
+                    type: 'boolean',
+                    default: false,
+                    description: 'Whether to include keyword intents (works only for g_ua and g_us)'
+                },
+                page: {
+                    type: 'integer',
+                    minimum: 1,
+                    default: 1,
+                    description: 'Page number'
+                },
+                size: {
+                    type: 'integer',
+                    minimum: 1,
+                    maximum: 1000,
+                    default: 100,
+                    description: 'results per page'
+                },
+                sort: {
+                    type: 'object',
+                    properties: {
+                        region_queries_count: { type: 'string', enum: ['asc', 'desc'] },
+                        cost: { type: 'string', enum: ['asc', 'desc'] },
+                        difficulty: { type: 'string', enum: ['asc', 'desc'] },
+                        concurrency: { type: 'string', enum: ['asc', 'desc'] },
+                        weight: { type: 'string', enum: ['asc', 'desc'] },
+                        keyword: { type: 'string', enum: ['asc', 'desc'] }
+                    },
+                    additionalProperties: false,
+                    description: 'Sorting parameters for results'
+                },
+                filters: {
+                    type: 'object',
+                    properties: {
+                        cost: { type: 'number', minimum: 0, maximum: 200 },
+                        cost_from: { type: 'number', minimum: 0, maximum: 200 },
+                        cost_to: { type: 'number', minimum: 0, maximum: 200 },
+                        region_queries_count: { type: 'integer', minimum: 0, maximum: 100000000 },
+                        region_queries_count_from: { type: 'integer', minimum: 0, maximum: 100000000 },
+                        region_queries_count_to: { type: 'integer', minimum: 0, maximum: 100000000 },
+                        keyword_length: { type: 'integer', minimum: 1 },
+                        keyword_length_from: { type: 'integer', minimum: 1 },
+                        keyword_length_to: { type: 'integer', minimum: 1 },
+                        difficulty: { type: 'integer', minimum: 0, maximum: 100 },
+                        difficulty_from: { type: 'integer', minimum: 0, maximum: 100 },
+                        difficulty_to: { type: 'integer', minimum: 0, maximum: 100 },
+                        concurrency: { type: 'integer', minimum: 1, maximum: 100 },
+                        concurrency_from: { type: 'integer', minimum: 1, maximum: 100 },
+                        concurrency_to: { type: 'integer', minimum: 1, maximum: 100 },
+                        weight: { type: 'integer', minimum: 1 },
+                        weight_from: { type: 'number', minimum: 1 },
+                        weight_to: { type: 'number', minimum: 1 },
+                        right_spelling: { type: 'boolean', description: 'Filter by correct spelling' },
+                        keyword_contain: { type: 'array', items: { type: 'string' }, description: 'Keywords must contain all of these terms (exact match)' },
+                        keyword_not_contain: { type: 'array', items: { type: 'string' }, description: 'Keywords must not contain these terms (exact match)' },
+                        keyword_contain_one_of: { type: 'array', items: { type: 'string' }, description: 'Keywords must contain at least one of these terms' },
+                        keyword_not_contain_one_of: { type: 'array', items: { type: 'string' }, description: 'Keywords must not contain any of these terms' },
+                        keyword_contain_broad_match: { type: 'array', items: { type: 'string' }, description: 'Keywords must contain all of these terms (broad match)' },
+                        keyword_not_contain_broad_match: { type: 'array', items: { type: 'string' }, description: 'Keywords must not contain these terms (broad match)' },
+                        keyword_contain_one_of_broad_match: { type: 'array', items: { type: 'string' }, description: 'Keywords must contain at least one of these terms (broad match)' },
+                        keyword_not_contain_one_of_broad_match: { type: 'array', items: { type: 'string' }, description: 'Keywords must not contain any of these terms (broad match)' },
+                        geo_names: { type: 'string', enum: ['contain', 'not_contain'], description: 'Filter by presence of geographic names' },
+                        types: { type: 'array', items: { type: 'string' }, description: 'Filter by SERP feature types' },
+                        intents_contain: { type: 'array', items: { type: 'string', enum: ['informational', 'navigational', 'commercial', 'transactional'] }, description: 'Keywords must contain these search intents' }
+                    },
+                    additionalProperties: false,
+                    description: 'Results filters'
+                }
+            },
+            required: ['keyword', 'se'],
+            additionalProperties: false
+        };
+    }
+    async handle(call) {
+        try {
+            const parsed = validation_js_1.getRelatedKeywordsSchema.parse(call.arguments);
+            const result = await this.keywordService.getRelatedKeywords(parsed);
+            return this.createSuccessResponse(result);
+        }
+        catch (error) {
+            return this.createErrorResponse(error);
+        }
+    }
+}
+exports.GetRelatedKeywordsHandler = GetRelatedKeywordsHandler;
+//# sourceMappingURL=keyword_tools.js.map

package/dist/handlers/keyword_tools.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,31 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const server_js_1 = require("./server.js");
+const logger_js_1 = require("./utils/logger.js");
+const config_js_1 = require("./utils/config.js");
+async function main() {
+    try {
+        (0, config_js_1.loadConfig)();
+        logger_js_1.logger.info('Configuration loaded successfully');
+        const server = new server_js_1.SerpstatMCPServer();
+        await server.start();
+    }
+    catch (error) {
+        logger_js_1.logger.error('Failed to start server:', error);
+        process.exit(1);
+    }
+}
+process.on('SIGINT', () => {
+    logger_js_1.logger.info('Received SIGINT, shutting down gracefully');
+    process.exit(0);
+});
+process.on('SIGTERM', () => {
+    logger_js_1.logger.info('Received SIGTERM, shutting down gracefully');
+    process.exit(0);
+});
+main().catch((error) => {
+    logger_js_1.logger.error('Unhandled error:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AACA,2CAAgD;AAChD,iDAA2C;AAC3C,iDAA+C;AAE/C,KAAK,UAAU,IAAI;IACf,IAAI,CAAC;QAED,IAAA,sBAAU,GAAE,CAAC;QACb,kBAAM,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;QAEjD,MAAM,MAAM,GAAG,IAAI,6BAAiB,EAAE,CAAC;QACvC,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,kBAAM,CAAC,KAAK,CAAC,yBAAyB,EAAE,KAAK,CAAC,CAAC;QAC/C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;AACL,CAAC;AAGD,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;IACtB,kBAAM,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAC;IACzD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC,CAAC,CAAC;AAEH,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;IACvB,kBAAM,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC;IAC1D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC,CAAC,CAAC;AAEH,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACnB,kBAAM,CAAC,KAAK,CAAC,kBAAkB,EAAE,KAAK,CAAC,CAAC;IACxC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC,CAAC,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,9 @@
+export declare class SerpstatMCPServer {
+    private server;
+    private handlers;
+    constructor();
+    private setupHandlers;
+    private setupRoutes;
+    start(): Promise<void>;
+}
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAYA,qBAAa,iBAAiB;IAC1B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAA2B;;IAoB3C,OAAO,CAAC,aAAa;IAqBrB,OAAO,CAAC,WAAW;IAmCb,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAK/B"}

package/dist/server.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SerpstatMCPServer = void 0;
+const index_js_1 = require("@modelcontextprotocol/sdk/server/index.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
+const domain_tools_js_1 = require("./handlers/domain_tools.js");
+const backlinks_tools_js_1 = require("./handlers/backlinks_tools.js");
+const keyword_tools_js_1 = require("./handlers/keyword_tools.js");
+const logger_js_1 = require("./utils/logger.js");
+class SerpstatMCPServer {
+    server;
+    handlers;
+    constructor() {
+        this.server = new index_js_1.Server({
+            name: 'serpstat-mcp-server',
+            version: '1.0.0',
+        }, {
+            capabilities: {
+                tools: {},
+            },
+        });
+        this.handlers = new Map();
+        this.setupHandlers();
+        this.setupRoutes();
+    }
+    setupHandlers() {
+        const handlers = [
+            new domain_tools_js_1.DomainsInfoHandler(),
+            new domain_tools_js_1.CompetitorsHandler(),
+            new domain_tools_js_1.DomainKeywordsHandler(),
+            new domain_tools_js_1.DomainUrlsHandler(),
+            new backlinks_tools_js_1.BacklinksSummaryHandler(),
+            new domain_tools_js_1.DomainRegionsCountHandler(),
+            new domain_tools_js_1.GetDomainUniqKeywordsHandler(),
+            new keyword_tools_js_1.GetKeywordsHandler(),
+            new keyword_tools_js_1.GetRelatedKeywordsHandler(),
+        ];
+        for (const handler of handlers) {
+            this.handlers.set(handler.getName(), handler);
+        }
+        logger_js_1.logger.info(`Registered ${handlers.length} tool handlers`);
+    }
+    setupRoutes() {
+        this.server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => {
+            const tools = Array.from(this.handlers.values()).map(handler => ({
+                name: handler.getName(),
+                description: handler.getDescription(),
+                inputSchema: handler.getInputSchema(),
+            }));
+            logger_js_1.logger.debug(`Listing ${tools.length} available tools`);
+            return { tools };
+        });
+        this.server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
+            const { name, arguments: args } = request.params;
+            logger_js_1.logger.info(`Tool call received: ${name}`, { arguments: args });
+            const handler = this.handlers.get(name);
+            if (!handler) {
+                throw new Error(`Unknown tool: ${name}`);
+            }
+            const result = await handler.handle({ name, arguments: args ?? {} });
+            logger_js_1.logger.info(`Tool call completed: ${name}`, {
+                success: !result.isError,
+                responseLength: result.content?.[0]?.text?.length
+            });
+            return { ...result };
+        });
+    }
+    async start() {
+        const transport = new stdio_js_1.StdioServerTransport();
+        await this.server.connect(transport);
+        logger_js_1.logger.info('Serpstat MCP Server started and listening on stdio');
+    }
+}
+exports.SerpstatMCPServer = SerpstatMCPServer;
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/services/backlinks_tools.d.ts

@@ -0,0 +1,7 @@
+import { BaseService } from './base.js';
+import { BacklinksSummaryParams } from '../utils/validation.js';
+import { BacklinksSummaryResponse } from '../types/serpstat.js';
+export declare class BacklinksService extends BaseService {
+    getBacklinksSummary(params: BacklinksSummaryParams): Promise<BacklinksSummaryResponse>;
+}
+//# sourceMappingURL=backlinks_tools.d.ts.map

package/dist/services/backlinks_tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backlinks_tools.d.ts","sourceRoot":"","sources":["../../src/services/backlinks_tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,wBAAwB,EAAmB,MAAM,sBAAsB,CAAC;AAGjF,qBAAa,gBAAiB,SAAQ,WAAW;IACvC,mBAAmB,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,wBAAwB,CAAC;CAqB/F"}

package/dist/services/backlinks_tools.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BacklinksService = void 0;
+const base_js_1 = require("./base.js");
+const logger_js_1 = require("../utils/logger.js");
+class BacklinksService extends base_js_1.BaseService {
+    async getBacklinksSummary(params) {
+        logger_js_1.logger.info('Getting backlinks summary', { query: params.query, searchType: params.searchType });
+        const request = {
+            id: `backlinks_summary_${Date.now()}`,
+            method: 'SerpstatBacklinksProcedure.getSummaryV2',
+            params,
+        };
+        const response = await this.makeRequest(request);
+        if (!response.result) {
+            throw new Error('No result data received from Serpstat API');
+        }
+        logger_js_1.logger.info('Successfully retrieved backlinks summary', {
+            leftLines: response.result.summary_info.left_lines
+        });
+        return response.result;
+    }
+}
+exports.BacklinksService = BacklinksService;
+//# sourceMappingURL=backlinks_tools.js.map

package/dist/services/backlinks_tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backlinks_tools.js","sourceRoot":"","sources":["../../src/services/backlinks_tools.ts"],"names":[],"mappings":";;;AAAA,uCAAwC;AAGxC,kDAA4C;AAE5C,MAAa,gBAAiB,SAAQ,qBAAW;IAC7C,KAAK,CAAC,mBAAmB,CAAC,MAA8B;QACpD,kBAAM,CAAC,IAAI,CAAC,2BAA2B,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;QAEjG,MAAM,OAAO,GAAoB;YAC7B,EAAE,EAAE,qBAAqB,IAAI,CAAC,GAAG,EAAE,EAAE;YACrC,MAAM,EAAE,yCAAyC;YACjD,MAAM;SACT,CAAC;QAEF,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,CAA2B,OAAO,CAAC,CAAC;QAE3E,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;QACjE,CAAC;QAED,kBAAM,CAAC,IAAI,CAAC,0CAA0C,EAAE;YACpD,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,YAAY,CAAC,UAAU;SACrD,CAAC,CAAC;QAEH,OAAO,QAAQ,CAAC,MAAM,CAAC;IAC3B,CAAC;CACJ;AAtBD,4CAsBC"}

package/dist/services/base.d.ts

@@ -0,0 +1,13 @@
+import { AxiosInstance } from 'axios';
+import { SerpstatRequest, SerpstatResponse } from '../types/serpstat.js';
+import { Config } from '../utils/config.js';
+export declare abstract class BaseService {
+    protected readonly client: AxiosInstance;
+    protected readonly config: Config;
+    constructor(config: Config);
+    private setupInterceptors;
+    makeRequest<T>(request: SerpstatRequest, retries?: number): Promise<SerpstatResponse<T>>;
+    private isRetryableError;
+    private delay;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/services/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/services/base.ts"],"names":[],"mappings":"AAAA,OAAc,EAAE,aAAa,EAAsB,MAAM,OAAO,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACzE,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAG5C,8BAAsB,WAAW;IAC7B,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IACzC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEtB,MAAM,EAAE,MAAM;IAa1B,OAAO,CAAC,iBAAiB;IAmCnB,WAAW,CAAC,CAAC,EACf,OAAO,EAAE,eAAe,EACxB,OAAO,GAAE,MAA+B,GACzC,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC;IA2B/B,OAAO,CAAC,gBAAgB;IAQxB,OAAO,CAAC,KAAK;CAGhB"}

package/dist/services/base.js

@@ -0,0 +1,83 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseService = void 0;
+const axios_1 = __importDefault(require("axios"));
+const logger_js_1 = require("../utils/logger.js");
+class BaseService {
+    client;
+    config;
+    constructor(config) {
+        this.config = config;
+        this.client = axios_1.default.create({
+            baseURL: config.serpstatApiUrl,
+            timeout: config.requestTimeout,
+            headers: {
+                'Content-Type': 'application/json',
+            },
+        });
+        this.setupInterceptors();
+    }
+    setupInterceptors() {
+        this.client.interceptors.request.use((config) => {
+            logger_js_1.logger.debug('Making API request', {
+                url: config.url,
+                method: config.method,
+                data: config.data
+            });
+            return config;
+        }, (error) => {
+            logger_js_1.logger.error('Request interceptor error', error);
+            return Promise.reject(error);
+        });
+        this.client.interceptors.response.use((response) => {
+            logger_js_1.logger.debug('API response received', {
+                status: response.status,
+                data: response.data
+            });
+            return response;
+        }, (error) => {
+            logger_js_1.logger.error('Response interceptor error', {
+                status: error.response?.status,
+                data: error.response?.data,
+                message: error.message
+            });
+            return Promise.reject(error);
+        });
+    }
+    async makeRequest(request, retries = this.config.maxRetries) {
+        const requestConfig = {
+            method: 'POST',
+            url: '/',
+            params: { token: this.config.serpstatApiToken },
+            data: request,
+        };
+        try {
+            const response = await this.client.request(requestConfig);
+            if (response.data.error) {
+                throw new Error(`Serpstat API error: ${response.data.error.message} (code: ${response.data.error.code})`);
+            }
+            return response.data;
+        }
+        catch (error) {
+            if (retries > 0 && this.isRetryableError(error)) {
+                logger_js_1.logger.warn(`Request failed, retrying... (${retries} retries left)`, { error: error.message });
+                await this.delay(1000);
+                return this.makeRequest(request, retries - 1);
+            }
+            throw error;
+        }
+    }
+    isRetryableError(error) {
+        return (error.code === 'ECONNRESET' ||
+            error.code === 'ETIMEDOUT' ||
+            (error.response && error.response.status >= 500));
+    }
+    delay(ms) {
+        return new Promise(resolve => setTimeout(resolve, ms));
+    }
+}
+exports.BaseService = BaseService;
+//# sourceMappingURL=base.js.map

package/dist/services/base.js.map

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

package/dist/services/domain.d.ts

@@ -0,0 +1,7 @@
+import { BaseService } from './base';
+import { DomainsInfoResponse } from '../types/serpstat';
+import { DomainsInfoParams } from '../utils/validation';
+export declare class DomainService extends BaseService {
+    getDomainsInfo(params: DomainsInfoParams): Promise<DomainsInfoResponse>;
+}
+//# sourceMappingURL=domain.d.ts.map

package/dist/services/domain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain.d.ts","sourceRoot":"","sources":["../../src/services/domain.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,EAAE,mBAAmB,EAAmB,MAAM,mBAAmB,CAAC;AACzE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAGxD,qBAAa,aAAc,SAAQ,WAAW;IACpC,cAAc,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAsBhF"}

package/dist/services/domain.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DomainService = void 0;
+const base_1 = require("./base");
+const logger_1 = require("../utils/logger");
+class DomainService extends base_1.BaseService {
+    async getDomainsInfo(params) {
+        logger_1.logger.info('Getting domains info', { domains: params.domains, se: params.se });
+        const request = {
+            id: `domains_info_${Date.now()}`,
+            method: 'SerpstatDomainProcedure.getDomainsInfo',
+            params,
+        };
+        const response = await this.makeRequest(request);
+        if (!response.result) {
+            throw new Error('No result data received from Serpstat API');
+        }
+        logger_1.logger.info('Successfully retrieved domains info', {
+            domainsCount: response.result.data.length,
+            leftLines: response.result.summary_info.left_lines
+        });
+        return response.result;
+    }
+}
+exports.DomainService = DomainService;
+//# sourceMappingURL=domain.js.map

package/dist/services/domain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain.js","sourceRoot":"","sources":["../../src/services/domain.ts"],"names":[],"mappings":";;;AAAA,iCAAqC;AAGrC,4CAAyC;AAEzC,MAAa,aAAc,SAAQ,kBAAW;IAC1C,KAAK,CAAC,cAAc,CAAC,MAAyB;QAC1C,eAAM,CAAC,IAAI,CAAC,sBAAsB,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;QAEhF,MAAM,OAAO,GAAoB;YAC7B,EAAE,EAAE,gBAAgB,IAAI,CAAC,GAAG,EAAE,EAAE;YAChC,MAAM,EAAE,wCAAwC;YAChD,MAAM;SACT,CAAC;QAEF,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,CAAsB,OAAO,CAAC,CAAC;QAEtE,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;QACjE,CAAC;QAED,eAAM,CAAC,IAAI,CAAC,qCAAqC,EAAE;YAC/C,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM;YACzC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,YAAY,CAAC,UAAU;SACrD,CAAC,CAAC;QAEH,OAAO,QAAQ,CAAC,MAAM,CAAC;IAC3B,CAAC;CACJ;AAvBD,sCAuBC"}

package/dist/services/domain_tools.d.ts

@@ -0,0 +1,13 @@
+import { BaseService } from './base.js';
+import { DomainsInfoResponse } from '../types/serpstat.js';
+import { DomainsInfoParams, CompetitorsGetParams, DomainKeywordsParams, DomainUrlsParams, DomainRegionsCountParams, DomainUniqKeywordsParams } from '../utils/validation.js';
+import { CompetitorsResponse, DomainKeywordsResponse, DomainUrlsResponse, DomainRegionsCountResponse, DomainUniqKeywordsResponse } from '../types/serpstat.js';
+export declare class DomainService extends BaseService {
+    getDomainsInfo(params: DomainsInfoParams): Promise<DomainsInfoResponse>;
+    getCompetitors(params: CompetitorsGetParams): Promise<CompetitorsResponse>;
+    getDomainKeywords(params: DomainKeywordsParams): Promise<DomainKeywordsResponse>;
+    getDomainUrls(params: DomainUrlsParams): Promise<DomainUrlsResponse>;
+    getDomainRegionsCount(params: DomainRegionsCountParams): Promise<DomainRegionsCountResponse>;
+    getDomainUniqKeywords(params: DomainUniqKeywordsParams): Promise<DomainUniqKeywordsResponse>;
+}
+//# sourceMappingURL=domain_tools.d.ts.map

package/dist/services/domain_tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain_tools.d.ts","sourceRoot":"","sources":["../../src/services/domain_tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,mBAAmB,EAAmB,MAAM,sBAAsB,CAAC;AAC5E,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAE7K,OAAO,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,0BAA0B,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAE/J,qBAAa,aAAc,SAAQ,WAAW;IACpC,cAAc,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAuBvE,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAuB1E,iBAAiB,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAuBhF,aAAa,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAuBpE,qBAAqB,CAAC,MAAM,EAAE,wBAAwB,GAAG,OAAO,CAAC,0BAA0B,CAAC;IAuB5F,qBAAqB,CAAC,MAAM,EAAE,wBAAwB,GAAG,OAAO,CAAC,0BAA0B,CAAC;CAsBrG"}