@serpstat/serpstat-mcp-server 1.0.2

package/.env.example

@@ -0,0 +1,10 @@
+# Serpstat API Configuration
+SERPSTAT_API_TOKEN=your_serpstat_api_token_here
+SERPSTAT_API_URL=https://api.serpstat.com/v4
+
+# Logging Configuration
+LOG_LEVEL=info
+
+# Request Configuration
+MAX_RETRIES=3
+REQUEST_TIMEOUT=30000

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Serpstat Global Limited
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,288 @@
+# Serpstat MCP Server
+
+[![npm version](https://badge.fury.io/js/serpstat-mcp-server.svg)](https://badge.fury.io/js/serpstat-mcp-server)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+Server for integrating Serpstat with Model Context Protocol (MCP).
+
+## Description
+
+This project implements a TypeScript server that provides an API interface for working with Serpstat tools via the MCP protocol. The server supports request handling, parameter validation, logging, and working with multiple tools.
+
+## Features
+
+- Retrieve domain information via Serpstat API
+- Input parameter validation using Zod
+- Event logging with Winston
+- Flexible configuration via environment variables
+- Jest tests for parameter and logic validation
+
+## Requirements
+
+- Node.js 18.0.0 or higher
+- Valid Serpstat API token
+
+## Installation
+
+### Global Installation (Recommended)
+
+```bash
+npm install -g @serpstat/serpstat-mcp-server
+```
+
+### Local Installation
+
+```bash
+npm install @serpstat/serpstat-mcp-server
+```
+
+## Configuration
+
+### Environment Variables
+
+Set the following environment variables (can be in .env file):
+
+- `SERPSTAT_API_TOKEN` — Your Serpstat API token (required)
+- `SERPSTAT_API_URL` — Serpstat API URL (default: https://api.serpstat.com/v4)
+- `LOG_LEVEL` — Logging level: error, warn, info, debug (default: info)
+
+### Claude Desktop Configuration
+
+Add to your Claude Desktop config file:
+
+**MacOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`  
+**Windows**: `%APPDATA%/Claude/claude_desktop_config.json`
+
+```json
+{
+   "mcpServers": {
+      "serpstat": {
+         "command": "npx",
+         "args": ["-y", "@serpstat/serpstat-mcp-server"],
+         "env": {
+            "SERPSTAT_API_TOKEN": "XXXXXXXXXXXPLACETOKENHEREXXXXXXXXXXXXX",
+            "LANG": "en_US.UTF-8",
+            "LC_ALL": "en_US.UTF-8"
+         }
+      }
+   }
+}
+```
+
+For local development, use the full path:
+
+```json
+{
+  "mcpServers": {
+    "serpstat": {
+      "command": "node",
+      "args": ["/path/to/node_modules/serpstat-mcp-server/dist/index.js"],
+      "env": {
+        "SERPSTAT_API_TOKEN": "your_serpstat_api_token_here"
+      }
+    }
+  }
+}
+```
+
+## Usage Examples
+
+After installation and configuration in Claude Desktop, you can ask Claude:
+
+- "Show me domain info for example.com"
+- "Find competitors for my-site.com in Google US"
+- "Get top 50 keywords that example.com ranks for"
+- "Analyze backlinks summary for domain.com"
+- "Find related keywords to 'digital marketing'"
+- "Get unique keywords for domain1.com vs domain2.com"
+
+## Development
+
+### Getting Started
+
+1. Clone the repository:
+   ```bash
+   git clone <repository-url>
+   cd serpstat-mcp-server
+   ```
+
+2. Install dependencies:
+   ```bash
+   npm install
+   ```
+
+3. Set environment variables:
+   ```bash
+   cp .env.example .env
+   # Edit .env with your Serpstat API token
+   ```
+
+4. Build the project:
+   ```bash
+   npm run build
+   ```
+
+5. Start the server:
+   ```bash
+   npm start
+   ```
+
+6. For development mode (auto-reload):
+   ```bash
+   npm run dev
+   ```
+
+### Testing
+
+To run tests:
+```bash
+npm test
+```
+
+### Scripts
+
+- `npm run build` — Compile TypeScript sources to JavaScript (output in `dist/`)
+- `npm start` — Run the compiled server from `dist/`
+- `npm run dev` — Run the server in development mode with hot-reload
+- `npm test` — Run all tests
+- `npm run lint` — Run linting
+- `npm run clean` — Clean build directory
+
+## Project Structure
+
+```
+serpstat-mcp-server/
+├── src/
+│   ├── index.ts          # Entry point
+│   ├── server.ts         # Main MCP server
+│   ├── handlers/         # Tool handlers
+│   ├── services/         # Services for Serpstat API
+│   ├── types/            # Data types
+│   ├── utils/            # Utilities (config, logger, validation)
+│   └── __tests__/        # Tests
+├── dist/                 # Compiled JavaScript (after build)
+├── package.json
+├── tsconfig.json
+├── README.md
+└── .env.example
+```
+
+## MCP Tools
+
+| Tool Name                 | Description                                                                                   | Key Parameters              |
+|---------------------------|-----------------------------------------------------------------------------------------------|-----------------------------|
+| get_domains_info          | Get SEO information for multiple domains                                                      | domains, se, filters        |
+| get_domain_competitors    | Get list of competitor domains                                                                | domain, se, size, filters   |
+| get_domain_keywords       | Get keywords that domain ranks for                                                            | domain, se, page, size      |
+| get_domain_urls           | Get URLs within a domain and their keyword counts                                             | domain, se, page, size      |
+| get_domain_regions_count  | Get keyword count by region for a domain                                                      | domain, sort, order         |
+| get_domain_uniq_keywords  | Get unique keywords for two domains not ranked by a third domain                             | se, domains, minusDomain    |
+| get_keywords              | Get related organic keywords for a given keyword                                              | keyword, se, filters        |
+| get_backlinks_summary     | Get comprehensive backlinks summary with referring domains, quality metrics, and changes     | domain, subdomain           |
+| get_related_keywords      | Get semantically related keywords with frequency, CPC, competition, and difficulty data      | keyword, se, filters, sort  |
+
+### Search Engines (se parameter)
+
+Common search engine codes:
+- `g_us` - Google US
+- `g_uk` - Google UK
+- `g_ca` - Google Canada
+- `g_au` - Google Australia
+- `g_de` - Google Germany
+- `g_fr` - Google France
+- `g_es` - Google Spain
+- `g_it` - Google Italy
+
+
+## Troubleshooting
+
+### Common Issues
+
+**"Command not found: serpstat-mcp-server"**
+- Make sure you installed the package globally with `-g` flag
+- Verify your PATH includes npm global binaries: `npm config get prefix`
+- Try reinstalling: `npm uninstall -g serpstat-mcp-server && npm install -g serpstat-mcp-server`
+
+**"API token error" or "Unauthorized"**
+- Check that `SERPSTAT_API_TOKEN` is set correctly in your environment
+- Verify your token is valid and active in your Serpstat account
+- Ensure your token has sufficient API credits and permissions
+
+**"Module not found" errors**
+- Make sure all dependencies are installed: `npm install`
+- Try rebuilding: `npm run clean && npm run build`
+
+**Claude Desktop doesn't recognize the server**
+- Restart Claude Desktop after configuration changes
+- Check the config file path and JSON syntax
+- Verify the server starts correctly: run `serpstat-mcp-server` in terminal
+
+### Debug Mode
+
+Enable debug logging by setting:
+```bash
+export LOG_LEVEL=debug
+```
+
+Or in your Claude Desktop config for linux:
+```json
+{
+   "mcpServers": {
+      "serpstat": {
+         "command": "npx",
+         "args": ["-y", "@serpstat/serpstat-mcp-server"],
+         "env": {
+            "SERPSTAT_API_TOKEN": "XXXXXXXXXXXPLACETOKENHEREXXXXXXXXXXXXX",
+            "LANG": "en_US.UTF-8",
+            "LC_ALL": "en_US.UTF-8"
+         }
+      }
+   }
+}
+```
+
+## API Rate Limits
+
+Serpstat API has rate limits. The server includes:
+- Automatic retry logic with exponential backoff
+- Request queuing to prevent rate limit violations
+- Detailed error messages for quota exceeded scenarios
+
+## Contributing
+
+We welcome contributions! Please follow these steps:
+
+1. Fork the repository
+2. Create a feature branch: `git checkout -b feature/amazing-feature`
+3. Make your changes
+4. Add tests for new functionality
+5. Ensure tests pass: `npm test`
+6. Commit your changes: `git commit -m 'Add amazing feature'`
+7. Push to the branch: `git push origin feature/amazing-feature`
+8. Submit a pull request
+
+### Development Guidelines
+
+- Follow existing code style and TypeScript conventions
+- Add tests for new features
+- Update documentation as needed
+- Use conventional commit messages
+
+## Changelog
+
+See [CHANGELOG.md](CHANGELOG.md) for details about changes in each version.
+
+## Support
+
+- 📖 [Serpstat API Documentation](https://serpstat.com/api/)
+- 🐛 [Report Issues](https://github.com/your-username/serpstat-mcp-server/issues)
+- 💬 [Discussions](https://github.com/your-username/serpstat-mcp-server/discussions)
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## Acknowledgments
+
+- [Model Context Protocol](https://github.com/modelcontextprotocol) by Anthropic
+- [Serpstat API](https://serpstat.com/api/) for SEO data services

package/dist/handlers/backlinks_tools.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"backlinks_tools.d.ts","sourceRoot":"","sources":["../../src/handlers/backlinks_tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAK/D,qBAAa,uBAAwB,SAAQ,WAAW;IACpD,OAAO,CAAC,gBAAgB,CAAmB;;IAQ3C,OAAO,IAAI,MAAM;IAIjB,cAAc,IAAI,MAAM;IAIxB,cAAc,IAAI,MAAM;IAuBlB,MAAM,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC;CAY5D"}

package/dist/handlers/backlinks_tools.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BacklinksSummaryHandler = void 0;
+const base_js_1 = require("./base.js");
+const backlinks_tools_js_1 = require("../services/backlinks_tools.js");
+const validation_js_1 = require("../utils/validation.js");
+const config_js_1 = require("../utils/config.js");
+const zod_1 = require("zod");
+class BacklinksSummaryHandler extends base_js_1.BaseHandler {
+    backlinksService;
+    constructor() {
+        super();
+        const config = (0, config_js_1.loadConfig)();
+        this.backlinksService = new backlinks_tools_js_1.BacklinksService(config);
+    }
+    getName() {
+        return 'get_backlinks_summary';
+    }
+    getDescription() {
+        return 'Get comprehensive backlinks summary using Serpstat API. Returns referring domains, backlinks count, link types, quality metrics and recent changes for domain or subdomain.';
+    }
+    getInputSchema() {
+        return {
+            type: "object",
+            properties: {
+                query: {
+                    type: "string",
+                    pattern: "^([a-zA-Z0-9]([a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?\\.)+[a-zA-Z]{2,}$",
+                    minLength: 4,
+                    maxLength: 253,
+                    description: "Domain or subdomain to analyze"
+                },
+                searchType: {
+                    type: "string",
+                    enum: ["domain", "domain_with_subdomains"],
+                    default: "domain",
+                    description: "Type of search query"
+                }
+            },
+            required: ["query"],
+            additionalProperties: false
+        };
+    }
+    async handle(call) {
+        try {
+            const params = validation_js_1.backlinksSummarySchema.parse(call.arguments);
+            const result = await this.backlinksService.getBacklinksSummary(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.BacklinksSummaryHandler = BacklinksSummaryHandler;
+//# sourceMappingURL=backlinks_tools.js.map

package/dist/handlers/backlinks_tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backlinks_tools.js","sourceRoot":"","sources":["../../src/handlers/backlinks_tools.ts"],"names":[],"mappings":";;;AAAA,uCAAwC;AACxC,uEAAkE;AAElE,0DAAwF;AACxF,kDAAgD;AAChD,6BAAwB;AAExB,MAAa,uBAAwB,SAAQ,qBAAW;IAC5C,gBAAgB,CAAmB;IAE3C;QACI,KAAK,EAAE,CAAC;QACR,MAAM,MAAM,GAAG,IAAA,sBAAU,GAAE,CAAC;QAC5B,IAAI,CAAC,gBAAgB,GAAG,IAAI,qCAAgB,CAAC,MAAM,CAAC,CAAC;IACzD,CAAC;IAED,OAAO;QACH,OAAO,uBAAuB,CAAC;IACnC,CAAC;IAED,cAAc;QACV,OAAO,6KAA6K,CAAC;IACzL,CAAC;IAED,cAAc;QACV,OAAO;YACH,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACR,KAAK,EAAE;oBACH,IAAI,EAAE,QAAQ;oBACd,OAAO,EAAE,iEAAiE;oBAC1E,SAAS,EAAE,CAAC;oBACZ,SAAS,EAAE,GAAG;oBACd,WAAW,EAAE,gCAAgC;iBAChD;gBACD,UAAU,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,QAAQ,EAAE,wBAAwB,CAAC;oBAC1C,OAAO,EAAE,QAAQ;oBACjB,WAAW,EAAE,sBAAsB;iBACtC;aACJ;YACD,QAAQ,EAAE,CAAC,OAAO,CAAC;YACnB,oBAAoB,EAAE,KAAK;SAC9B,CAAC;IACN,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,IAAiB;QAC1B,IAAI,CAAC;YACD,MAAM,MAAM,GAAG,sCAAsB,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAA2B,CAAC;YACtF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC;YACvE,OAAO,IAAI,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC;QAC9C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,IAAI,KAAK,YAAY,OAAC,CAAC,QAAQ,EAAE,CAAC;gBAC9B,OAAO,IAAI,CAAC,mBAAmB,CAAC,IAAI,KAAK,CAAC,uBAAuB,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;YAC/I,CAAC;YACD,OAAO,IAAI,CAAC,mBAAmB,CAAC,KAAc,CAAC,CAAC;QACpD,CAAC;IACL,CAAC;CACJ;AApDD,0DAoDC"}

package/dist/handlers/base.d.ts

@@ -0,0 +1,10 @@
+import { MCPToolCall, MCPToolResponse } from '../types/mcp.js';
+export declare abstract class BaseHandler {
+    abstract getName(): string;
+    abstract getDescription(): string;
+    abstract getInputSchema(): object;
+    abstract handle(call: MCPToolCall): Promise<MCPToolResponse>;
+    protected createSuccessResponse(data: any): MCPToolResponse;
+    protected createErrorResponse(error: Error): MCPToolResponse;
+}
+//# sourceMappingURL=base.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/handlers/base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAG/D,8BAAsB,WAAW;IAC7B,QAAQ,CAAC,OAAO,IAAI,MAAM;IAC1B,QAAQ,CAAC,cAAc,IAAI,MAAM;IACjC,QAAQ,CAAC,cAAc,IAAI,MAAM;IACjC,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC;IAE5D,SAAS,CAAC,qBAAqB,CAAC,IAAI,EAAE,GAAG,GAAG,eAAe;IAS3D,SAAS,CAAC,mBAAmB,CAAC,KAAK,EAAE,KAAK,GAAG,eAAe;CAU/D"}

package/dist/handlers/base.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseHandler = void 0;
+const logger_js_1 = require("../utils/logger.js");
+class BaseHandler {
+    createSuccessResponse(data) {
+        return {
+            content: [{
+                    type: "text",
+                    text: JSON.stringify(data, null, 2)
+                }]
+        };
+    }
+    createErrorResponse(error) {
+        logger_js_1.logger.error(`Tool ${this.getName()} error:`, error);
+        return {
+            content: [{
+                    type: "text",
+                    text: `Error: ${error.message}`
+                }],
+            isError: true
+        };
+    }
+}
+exports.BaseHandler = BaseHandler;
+//# sourceMappingURL=base.js.map

package/dist/handlers/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/handlers/base.ts"],"names":[],"mappings":";;;AACA,kDAA4C;AAE5C,MAAsB,WAAW;IAMnB,qBAAqB,CAAC,IAAS;QACrC,OAAO;YACH,OAAO,EAAE,CAAC;oBACN,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;iBACtC,CAAC;SACL,CAAC;IACN,CAAC;IAES,mBAAmB,CAAC,KAAY;QACtC,kBAAM,CAAC,KAAK,CAAC,QAAQ,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;QACrD,OAAO;YACH,OAAO,EAAE,CAAC;oBACN,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,UAAU,KAAK,CAAC,OAAO,EAAE;iBAClC,CAAC;YACF,OAAO,EAAE,IAAI;SAChB,CAAC;IACN,CAAC;CACJ;AAzBD,kCAyBC"}

package/dist/handlers/domain.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"domain.d.ts","sourceRoot":"","sources":["../../src/handlers/domain.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAK/D,qBAAa,kBAAmB,SAAQ,WAAW;IAC/C,OAAO,CAAC,aAAa,CAAgB;;IAQrC,OAAO,IAAI,MAAM;IAIjB,cAAc,IAAI,MAAM;IAIxB,cAAc,IAAI,MAAM;IAuClB,MAAM,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC;CAY5D"}

package/dist/handlers/domain.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DomainsInfoHandler = void 0;
+const base_js_1 = require("./base.js");
+const domain_js_1 = require("../services/domain.js");
+const validation_js_1 = require("../utils/validation.js");
+const config_js_1 = require("../utils/config.js");
+const zod_1 = require("zod");
+class DomainsInfoHandler extends base_js_1.BaseHandler {
+    domainService;
+    constructor() {
+        super();
+        const config = (0, config_js_1.loadConfig)();
+        this.domainService = new domain_js_1.DomainService(config);
+    }
+    getName() {
+        return 'serpstat_domains_info';
+    }
+    getDescription() {
+        return 'Get comprehensive SEO information for multiple domains including visibility, keywords, traffic, and dynamics';
+    }
+    getInputSchema() {
+        return {
+            type: "object",
+            properties: {
+                domains: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "List of domains to analyze (1-10 domains)",
+                    minItems: 1,
+                    maxItems: 10
+                },
+                se: {
+                    type: "string",
+                    enum: [
+                        'g_us', 'g_uk', 'g_de', 'g_fr', 'g_es', 'g_it', 'g_ca', 'g_au',
+                        'g_nl', 'g_be', 'g_dk', 'g_se', 'g_no', 'g_fi', 'g_pl', 'g_cz',
+                        'g_ua', 'g_ru', 'bing_us'
+                    ],
+                    description: "Search engine database (e.g., g_us for Google US)"
+                },
+                filters: {
+                    type: "object",
+                    properties: {
+                        traff: { type: "number", description: "Exact traffic value" },
+                        traff_from: { type: "number", description: "Minimum traffic value" },
+                        traff_to: { type: "number", description: "Maximum traffic value" },
+                        visible: { type: "number", description: "Exact visibility value" },
+                        visible_from: { type: "number", description: "Minimum visibility value" },
+                        visible_to: { type: "number", description: "Maximum visibility value" }
+                    },
+                    additionalProperties: false,
+                    description: "Optional filters for the results"
+                }
+            },
+            required: ["domains", "se"],
+            additionalProperties: false
+        };
+    }
+    async handle(call) {
+        try {
+            const params = validation_js_1.domainsInfoSchema.parse(call.arguments);
+            const result = await this.domainService.getDomainsInfo(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.DomainsInfoHandler = DomainsInfoHandler;
+//# sourceMappingURL=domain.js.map

package/dist/handlers/domain.js.map

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

package/dist/handlers/domain_tools.d.ts

@@ -0,0 +1,51 @@
+import { BaseHandler } from './base.js';
+import { MCPToolCall, MCPToolResponse } from '../types/mcp.js';
+export declare class DomainsInfoHandler extends BaseHandler {
+    private domainService;
+    constructor();
+    getName(): string;
+    getDescription(): string;
+    getInputSchema(): object;
+    handle(call: MCPToolCall): Promise<MCPToolResponse>;
+}
+export declare class CompetitorsHandler extends BaseHandler {
+    private domainService;
+    constructor();
+    getName(): string;
+    getDescription(): string;
+    getInputSchema(): object;
+    handle(call: MCPToolCall): Promise<MCPToolResponse>;
+}
+export declare class DomainKeywordsHandler extends BaseHandler {
+    private domainService;
+    constructor();
+    getName(): string;
+    getDescription(): string;
+    getInputSchema(): object;
+    handle(call: MCPToolCall): Promise<MCPToolResponse>;
+}
+export declare class DomainUrlsHandler extends BaseHandler {
+    private domainService;
+    constructor();
+    getName(): string;
+    getDescription(): string;
+    getInputSchema(): object;
+    handle(call: MCPToolCall): Promise<MCPToolResponse>;
+}
+export declare class DomainRegionsCountHandler extends BaseHandler {
+    private domainService;
+    constructor();
+    getName(): string;
+    getDescription(): string;
+    getInputSchema(): object;
+    handle(call: MCPToolCall): Promise<MCPToolResponse>;
+}
+export declare class GetDomainUniqKeywordsHandler extends BaseHandler {
+    private domainService;
+    constructor();
+    getName(): string;
+    getDescription(): string;
+    getInputSchema(): object;
+    handle(call: MCPToolCall): Promise<MCPToolResponse>;
+}
+//# sourceMappingURL=domain_tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"domain_tools.d.ts","sourceRoot":"","sources":["../../src/handlers/domain_tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAK/D,qBAAa,kBAAmB,SAAQ,WAAW;IAC/C,OAAO,CAAC,aAAa,CAAgB;;IAQrC,OAAO,IAAI,MAAM;IAIjB,cAAc,IAAI,MAAM;IAIxB,cAAc,IAAI,MAAM;IA4ClB,MAAM,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC;CAY5D;AAED,qBAAa,kBAAmB,SAAQ,WAAW;IAC/C,OAAO,CAAC,aAAa,CAAgB;;IAQrC,OAAO,IAAI,MAAM;IAIjB,cAAc,IAAI,MAAM;IAIxB,cAAc,IAAI,MAAM;IAqDlB,MAAM,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC;CAY5D;AAED,qBAAa,qBAAsB,SAAQ,WAAW;IAClD,OAAO,CAAC,aAAa,CAAgB;;IAQrC,OAAO,IAAI,MAAM;IAIjB,cAAc,IAAI,MAAM;IAIxB,cAAc,IAAI,MAAM;IA6FlB,MAAM,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC;CAY5D;AAED,qBAAa,iBAAkB,SAAQ,WAAW;IAC9C,OAAO,CAAC,aAAa,CAAgB;;IAQrC,OAAO,IAAI,MAAM;IAIjB,cAAc,IAAI,MAAM;IAIxB,cAAc,IAAI,MAAM;IA+ClB,MAAM,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC;CAY5D;AAED,qBAAa,yBAA0B,SAAQ,WAAW;IACtD,OAAO,CAAC,aAAa,CAAgB;;IAQrC,OAAO,IAAI,MAAM;IAIjB,cAAc,IAAI,MAAM;IAMxB,cAAc,IAAI,MAAM;IA6BlB,MAAM,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC;CAY5D;AAED,qBAAa,4BAA6B,SAAQ,WAAW;IACzD,OAAO,CAAC,aAAa,CAAgB;;IAQrC,OAAO,IAAI,MAAM;IAIjB,cAAc,IAAI,MAAM;IAIxB,cAAc,IAAI,MAAM;IAmGlB,MAAM,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC;CAY5D"}