@serpstat/serpstat-mcp-server 1.0.2 → 1.0.4

package/.env.example

@@ -7,4 +7,4 @@ LOG_LEVEL=info
 
 # Request Configuration
 MAX_RETRIES=3
-REQUEST_TIMEOUT=30000
+REQUEST_TIMEOUT=60000

package/CHANGELOG.md

@@ -0,0 +1,33 @@
+# Changelog
+
+## [1.0.4] - 2025-09-16
+### Added
+- Added `get_keyword_full_top` method to show Google's top-100 search results for analyzed keywords
+- Added `get_keywords_info` method to get keyword overview with volume, CPC, competition level, difficulty, and additional metrics for multiple keywords
+- Added `get_keyword_suggestions` method to show search suggestions for keywords found by full-text search with geographic names information
+- Added `get_keyword_top_urls` method to return website pages that rank for the largest amount of analyzed keyword variations with highest traffic
+- Added `get_keyword_competitors` method to list domains that rank for the given keyword in Google top-20 results with detailed competitor analysis
+- Added `get_keyword_top` method to show Google's top-100 search results for analyzed keyword with position, URL, domain and SERP features (deprecated method)
+- Added `get_anchors` method to analyze anchor text distribution in backlinks with metrics on referring domains, total backlinks, and nofollow counts
+
+## [1.0.3] - 2025-09-09
+### Fixed
+- Error then LLM's is unable to manage `size` parameters in query.
+
+## [1.0.2] - 2025-08-28
+- Added new API methods for domain and keyword analysis.
+- Improved error handling.
+
+### Fixed
+- Fixed input validation errors.
+
+## [1.0.1] - 2024-08-24
+### Added
+- Added logging support via Winston.
+- Improved project structure.
+
+## [1.0.0] - 2024-08-23
+### Added
+- Initial release: basic implementation of MCP Server for Serpstat API.
+- Core features for SEO analysis, working with domains, keywords, and backlinks.
+

package/README.md

@@ -1,26 +1,47 @@
 # Serpstat MCP Server
 
-[![npm version](https://badge.fury.io/js/serpstat-mcp-server.svg)](https://badge.fury.io/js/serpstat-mcp-server)
+[![npm version](https://badge.fury.io/js/@serpstat%2Fserpstat-mcp-server.svg)](https://badge.fury.io/js/@serpstat%2Fserpstat-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).
+A TypeScript server that integrates Serpstat SEO API with Anthropic's Model Context Protocol (MCP), enabling AI assistants like Claude to access comprehensive SEO data and analysis tools.
+
+## Table of Contents
+
+- [About MCP](#about-mcp)
+- [Prerequisites](#prerequisites)
+- [Installation](#installation)
+- [Configuration](#configuration)
+- [Usage Examples](#usage-examples)
+- [MCP Tools](#mcp-tools)
+- [Troubleshooting](#troubleshooting)
+- [Development](#development)
+- [API Rate Limits](#api-rate-limits)
+- [Contributing](#contributing)
+- [Support](#support)
+- [License](#license)
+
+## About MCP
+
+The Model Context Protocol (MCP) is an open standard developed by Anthropic that enables AI assistants to securely connect to external data sources and tools. This server implements MCP to provide Claude and other compatible AI assistants with access to Serpstat's powerful SEO analytics API.
 
 ## 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.
+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 SEO analysis 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
+- 🔍 **Comprehensive SEO Analysis**: Access domain info, keyword research, competitor analysis, and backlink data
+- ✅ **Input Validation**: Robust parameter validation using Zod schemas
+- 📊 **Event Logging**: Detailed logging with Winston for debugging and monitoring
+- ⚙️ **Flexible Configuration**: Environment-based configuration with sensible defaults
+- 🧪 **Well Tested**: Jest tests for parameter validation and business logic
+- 🚀 **TypeScript**: Full type safety throughout the codebase
 
-## Requirements
+## Prerequisites
 
-- Node.js 18.0.0 or higher
-- Valid Serpstat API token
+- **Node.js 18.0.0 or higher** ([Download Node.js](https://nodejs.org/en/download/current))
+- **Valid Serpstat API token** (get one from [Serpstat](https://serpstat.com/api/))
+- **Compatible AI Assistant**: Claude Desktop, Gemini CLI, or any MCP-compatible client
 
 ## Installation
 
@@ -46,12 +67,17 @@ Set the following environment variables (can be in .env file):
 - `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
+### Claude Desktop & Gemini CLI Configuration
 
 Add to your Claude Desktop config file:
 
-**MacOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`  
+**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
 **Windows**: `%APPDATA%/Claude/claude_desktop_config.json`
+**Linux**: `~/.config/Claude/claude_desktop_config.json`
+
+Add to your Gemini CLI config:
+
+**Linux**: `~/.gemini/settings.json`
 
 ```json
 {
@@ -60,7 +86,7 @@ Add to your Claude Desktop config file:
          "command": "npx",
          "args": ["-y", "@serpstat/serpstat-mcp-server"],
          "env": {
-            "SERPSTAT_API_TOKEN": "XXXXXXXXXXXPLACETOKENHEREXXXXXXXXXXXXX",
+            "SERPSTAT_API_TOKEN": "YOUR_SERPSTAT_API_TOKEN_HERE",
             "LANG": "en_US.UTF-8",
             "LC_ALL": "en_US.UTF-8"
          }
@@ -89,12 +115,119 @@ For local development, use the full path:
 
 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"
+### Domain Analysis
+- "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"
+
+### Keyword Research
+- "Find related keywords to **'digital marketing'**"
+- "Get keyword suggestions for **'iphone 15'** excluding **'rent'** keywords"
+- "Get comprehensive keyword data for **[ `iphone`, `samsung`, `googel pixel` ]** including search volume, CPC, and difficulty"
+
+### Competitor Analysis
+- "Show me competitor domains ranking for **`pizza delivery`** keyword with visibility metrics"
+- "Get top search results for **`laptop computers`** keyword showing positions, domains and SERP features"
+- "Get unique keywords for **domain1.com** vs **domain2.com**"
+
+### Backlink Analysis
+- "Analyze backlinks summary for **domain.com**"
+- "Get anchor text analysis for **domain.com** backlinks"
+
+## 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_keyword_suggestions  | Get search suggestions for a keyword using full-text search with geographic names info                         | keyword, se, filters            |
+| get_keywords_info        | Get keyword overview with volume, CPC, competition, difficulty, and SERP features                              | keywords, se, withIntents       |
+| get_keyword_full_top     | Get Google's top-100 search results for analyzed keywords                                                      | keyword, se, size               |
+| get_keyword_top_urls     | Get website pages that rank for the largest amount of analyzed keyword variations with highest traffic         | keyword, se, page, page_size    |
+| get_keyword_competitors  | Get domains that rank for the given keyword in Google top-20 results with competitor analysis                  | keyword, se, filters, sort      |
+| get_keyword_top          | Get Google's top-100 search results for the analyzed keyword with position, URL, domain and SERP features      | keyword, se, filters, size      |
+| get_backlinks_summary    | Get comprehensive backlinks summary with referring domains, quality metrics, and changes                       | domain, subdomain               |
+| get_anchors              | Get anchor text analysis for backlinks with metrics on referring domains, total backlinks, and nofollow counts | query, searchType, anchor, sort |
+| 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 USA
+- `g_uk` - Google United Kingdom
+- `g_ca` - Google Canada
+- `g_au` - Google Australia
+- `g_de` - Germany
+- `g_fr` - Google France
+- `g_es` - Google Spain
+- `g_it` - Google Italy
+- `g_pl` - Google Poland
+- `g_ua` - Google Ukraine
+
+See a full list of [Search Engines Short Names](https://api-docs.serpstat.com/docs/serpstat-public-api/ba97ni814ao9p-search-engine-short-names)
+
+## 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/serpstat-mcp-server && npm install -g @serpstat/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
+
+**"Can't find npx"**
+- You need to install Node.js - [download and install Node.js](https://nodejs.org/en/download/current)
+
+**Rate limit errors**
+- Most Serpstat plans have 1 RPS (1 request per second) limit
+- Wait between requests or contact Serpstat support for higher limits
+- Check your API usage in the Serpstat dashboard
+
+### Debug Mode
+
+Enable debug logging by setting:
+
+```bash
+export LOG_LEVEL=debug
+```
+
+Or in your Claude Desktop config:
+
+```json
+{
+   "mcpServers": {
+      "serpstat": {
+         "command": "npx",
+         "args": ["-y", "@serpstat/serpstat-mcp-server"],
+         "env": {
+            "SERPSTAT_API_TOKEN": "YOUR_TOKEN_HERE",
+            "LANG": "en_US.UTF-8",
+            "LC_ALL": "en_US.UTF-8",
+            "LOG_LEVEL": "debug"
+         }
+      }
+   }
+}
+```
 
 ## Development
 
@@ -102,8 +235,8 @@ After installation and configuration in Claude Desktop, you can ask Claude:
 
 1. Clone the repository:
    ```bash
-   git clone <repository-url>
-   cd serpstat-mcp-server
+   git clone git@github.com:SerpstatGlobal/serpstat-mcp-server-js.git
+   cd serpstat-mcp-server-js
    ```
 
 2. Install dependencies:
@@ -135,10 +268,23 @@ After installation and configuration in Claude Desktop, you can ask Claude:
 ### Testing
 
 To run tests:
+
 ```bash
 npm test
 ```
 
+Run specific test file:
+
+```bash
+npx jest src/__tests__/services/keyword_tools.test.ts
+```
+
+Run specific test by name:
+
+```bash
+npx jest --testNamePattern="methodName"
+```
+
 ### Scripts
 
 - `npm run build` — Compile TypeScript sources to JavaScript (output in `dist/`)
@@ -167,86 +313,11 @@ serpstat-mcp-server/
 └── .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
+By default, most Serpstat plans have **1 RPS (1 request per second)** - this is sufficient for most tasks. If you need higher throughput, contact Serpstat support to discuss plan upgrades.
+
+**Important**: The server respects rate limits automatically. If you encounter rate limit errors, wait before making additional requests.
 
 ## Contributing
 
@@ -267,6 +338,7 @@ We welcome contributions! Please follow these steps:
 - Add tests for new features
 - Update documentation as needed
 - Use conventional commit messages
+- Ensure all linting passes: `npm run lint`
 
 ## Changelog
 
@@ -274,15 +346,25 @@ 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
+- 📖 [Serpstat API Documentation](https://api-docs.serpstat.com/docs/serpstat-public-api/jenasqbwtxdlr-introduction-to-serpstat-api)
+- 🐛 [Report Issues](https://github.com/SerpstatGlobal/serpstat-mcp-server-js/issues)
 
-This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+The most effective way to receive support from Serpstat is to use their live chat feature directly within the platform. Alternatively, you can email them at support@serpstat.com.
 
 ## Acknowledgments
 
 - [Model Context Protocol](https://github.com/modelcontextprotocol) by Anthropic
-- [Serpstat API](https://serpstat.com/api/) for SEO data services
+- [Serpstat API](https://serpstat.com/api/) for SEO data services
+
+## License
+
+MIT License
+
+This project is under MIT license, which means you can copy, use, modify, and even sell any part of this code without any hassle.
+
+- See the [LICENSE](LICENSE) file for details
+- Want to grab a chunk for your project? Go for it
+- Want to rewrite half of it and ship a commercial product? Be my guest
+- The only thing you need to do is not delete the copyright and the license itself from the files you take, and remember the Serpstat team with a kind word when you get that paycheck
+
+_With love, Serpstat R&D Team_

package/dist/handlers/backlinks_tools.d.ts

@@ -8,4 +8,12 @@ export declare class BacklinksSummaryHandler extends BaseHandler {
     getInputSchema(): object;
     handle(call: MCPToolCall): Promise<MCPToolResponse>;
 }
+export declare class GetAnchorsHandler 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

@@ -1 +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"}
+{"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;AAM/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;AAED,qBAAa,iBAAkB,SAAQ,WAAW;IAC9C,OAAO,CAAC,gBAAgB,CAAmB;;IAQ3C,OAAO,IAAI,MAAM;IAIjB,cAAc,IAAI,MAAM;IAIxB,cAAc,IAAI,MAAM;IAuDlB,MAAM,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC;CAY5D"}

package/dist/handlers/backlinks_tools.js

@@ -1,11 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.BacklinksSummaryHandler = void 0;
+exports.GetAnchorsHandler = 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");
+const constants_js_1 = require("../utils/constants.js");
 class BacklinksSummaryHandler extends base_js_1.BaseHandler {
     backlinksService;
     constructor() {
@@ -25,14 +26,14 @@ class BacklinksSummaryHandler extends base_js_1.BaseHandler {
             properties: {
                 query: {
                     type: "string",
-                    pattern: "^([a-zA-Z0-9]([a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?\\.)+[a-zA-Z]{2,}$",
+                    pattern: constants_js_1.DOMAIN_NAME_REGEX,
                     minLength: 4,
                     maxLength: 253,
                     description: "Domain or subdomain to analyze"
                 },
                 searchType: {
                     type: "string",
-                    enum: ["domain", "domain_with_subdomains"],
+                    enum: constants_js_1.SEARCH_TYPES,
                     default: "domain",
                     description: "Type of search query"
                 }
@@ -56,4 +57,86 @@ class BacklinksSummaryHandler extends base_js_1.BaseHandler {
     }
 }
 exports.BacklinksSummaryHandler = BacklinksSummaryHandler;
+class GetAnchorsHandler 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_anchors';
+    }
+    getDescription() {
+        return 'Get anchor text analysis for backlinks using Serpstat API. Returns anchor texts used in backlinks, with metrics including referring domains, total backlinks, and nofollow counts for domain or URL analysis.';
+    }
+    getInputSchema() {
+        return {
+            type: "object",
+            properties: {
+                query: {
+                    type: "string",
+                    pattern: constants_js_1.DOMAIN_NAME_REGEX,
+                    minLength: 4,
+                    maxLength: 253,
+                    description: "Domain, subdomain, or URL to analyze"
+                },
+                searchType: {
+                    type: "string",
+                    enum: constants_js_1.SEARCH_TYPES_URL,
+                    description: "Type of search query"
+                },
+                anchor: {
+                    type: "string",
+                    description: "Filter by specific anchor text"
+                },
+                count: {
+                    type: "string",
+                    description: "Number of words in anchor text filter"
+                },
+                sort: {
+                    type: "string",
+                    enum: constants_js_1.ANCHORS_SORT_FIELDS,
+                    default: "lastupdate",
+                    description: "Sort results by field (total, refDomains, nofollow, anchor, lastupdate)"
+                },
+                order: {
+                    type: "string",
+                    enum: constants_js_1.SORT_ORDER,
+                    default: "desc",
+                    description: "Sort order (asc, desc)"
+                },
+                page: {
+                    type: "integer",
+                    minimum: constants_js_1.MIN_PAGE,
+                    default: 1,
+                    description: "Page number for pagination"
+                },
+                size: {
+                    type: "integer",
+                    minimum: 1,
+                    maximum: constants_js_1.MAX_PAGE_SIZE,
+                    default: constants_js_1.DEFAULT_PAGE_SIZE,
+                    description: "Number of results per page"
+                }
+            },
+            required: ["query", "searchType"],
+            additionalProperties: false
+        };
+    }
+    async handle(call) {
+        try {
+            const params = validation_js_1.anchorsSchema.parse(call.arguments);
+            const result = await this.backlinksService.getAnchors(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.GetAnchorsHandler = GetAnchorsHandler;
 //# sourceMappingURL=backlinks_tools.js.map

package/dist/handlers/backlinks_tools.js.map

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

package/dist/handlers/base.js

@@ -7,7 +7,7 @@ class BaseHandler {
         return {
             content: [{
                     type: "text",
-                    text: JSON.stringify(data, null, 2)
+                    text: JSON.stringify(data, null, 1)
                 }]
         };
     }

package/dist/handlers/domain_base.d.ts

@@ -0,0 +1,10 @@
+import { BaseHandler } from './base.js';
+import { DomainService } from '../services/domain_tools.js';
+import { z } from 'zod';
+import { MCPToolCall, MCPToolResponse } from '../types/mcp.js';
+export declare abstract class DomainBaseHandler extends BaseHandler {
+    protected domainService: DomainService;
+    constructor();
+    protected safeHandle<T>(schema: z.ZodTypeAny, call: MCPToolCall, handler: (params: T) => Promise<any>, defaultSize?: number): Promise<MCPToolResponse>;
+}
+//# sourceMappingURL=domain_base.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"domain_base.d.ts","sourceRoot":"","sources":["../../src/handlers/domain_base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAE5D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAE/D,8BAAsB,iBAAkB,SAAQ,WAAW;IACvD,SAAS,CAAC,aAAa,EAAE,aAAa,CAAC;;cAevB,UAAU,CAAC,CAAC,EACxB,MAAM,EAAE,CAAC,CAAC,UAAU,EACpB,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC,GAAG,CAAC,EACpC,WAAW,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,eAAe,CAAC;CAe9B"}

package/dist/handlers/domain_base.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DomainBaseHandler = void 0;
+const base_js_1 = require("./base.js");
+const domain_tools_js_1 = require("../services/domain_tools.js");
+const config_js_1 = require("../utils/config.js");
+const zod_1 = require("zod");
+class DomainBaseHandler extends base_js_1.BaseHandler {
+    domainService;
+    constructor() {
+        super();
+        const config = (0, config_js_1.loadConfig)();
+        this.domainService = new domain_tools_js_1.DomainService(config);
+    }
+    async safeHandle(schema, call, handler, defaultSize) {
+        try {
+            const params = schema.parse(call.arguments);
+            if (defaultSize !== undefined && params.size === undefined) {
+                params.size = defaultSize;
+            }
+            const result = await handler(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.DomainBaseHandler = DomainBaseHandler;
+//# sourceMappingURL=domain_base.js.map

package/dist/handlers/domain_base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain_base.js","sourceRoot":"","sources":["../../src/handlers/domain_base.ts"],"names":[],"mappings":";;;AAAA,uCAAwC;AACxC,iEAA4D;AAC5D,kDAAgD;AAChD,6BAAwB;AAGxB,MAAsB,iBAAkB,SAAQ,qBAAW;IAC7C,aAAa,CAAgB;IAEvC;QACI,KAAK,EAAE,CAAC;QACR,MAAM,MAAM,GAAG,IAAA,sBAAU,GAAE,CAAC;QAC5B,IAAI,CAAC,aAAa,GAAG,IAAI,+BAAa,CAAC,MAAM,CAAC,CAAC;IACnD,CAAC;IASS,KAAK,CAAC,UAAU,CACtB,MAAoB,EACpB,IAAiB,EACjB,OAAoC,EACpC,WAAoB;QAEpB,IAAI,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAM,CAAC;YACjD,IAAI,WAAW,KAAK,SAAS,IAAK,MAAc,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;gBACjE,MAAc,CAAC,IAAI,GAAG,WAAW,CAAC;YACvC,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;YACrC,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;AApCD,8CAoCC"}

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

@@ -1 +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"}
+{"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;AAwC/D,qBAAa,kBAAmB,SAAQ,WAAW;IAC/C,OAAO,CAAC,aAAa,CAAgB;;IAQrC,OAAO,IAAI,MAAM;IAIjB,cAAc,IAAI,MAAM;IAIxB,cAAc,IAAI,MAAM;IAwClB,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;IAiDlB,MAAM,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC;CAgB5D;AAED,qBAAa,qBAAsB,SAAQ,WAAW;IAClD,OAAO,CAAC,aAAa,CAAgB;;IAQrC,OAAO,IAAI,MAAM;IAIjB,cAAc,IAAI,MAAM;IAIxB,cAAc,IAAI,MAAM;IAyFlB,MAAM,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC;CAe5D;AAED,qBAAa,iBAAkB,SAAQ,WAAW;IAC9C,OAAO,CAAC,aAAa,CAAgB;;IAQrC,OAAO,IAAI,MAAM;IAIjB,cAAc,IAAI,MAAM;IAIxB,cAAc,IAAI,MAAM;IA2ClB,MAAM,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC;CAe5D;AAED,qBAAa,yBAA0B,SAAQ,WAAW;IACtD,OAAO,CAAC,aAAa,CAAgB;;IAQrC,OAAO,IAAI,MAAM;IAIjB,cAAc,IAAI,MAAM;IAKxB,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;IAiGlB,MAAM,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC;CAe5D"}