@serpstat/serpstat-mcp-server 1.0.5 → 1.0.7

package/CHANGELOG.md

@@ -1,9 +1,24 @@
 # Changelog
+## [1.0.7] - 2025-09-30
+
+### Fixed
+- **Gemini API Compatibility**: Removed `complexFilter` parameter from backlinks methods (get_lost_backlinks, get_active_backlinks, get_threat_backlinks, etc.) to resolve JSON schema nesting depth error
+    - Standard filtering via `sort`, `order`, `size` fully supported
+    - Breaking change: users with `complexFilter` usage must migrate to client-side filtering
+
+## [1.0.6] - 2025-09-29
+- Added `get_top_pages_by_backlinks` method to retrieve a list of top pages by backlinks with various filtering and sorting parameters
+- Added `get_backlinks_intersection` method to get backlinks from domains that link to multiple analyzed sites simultaneously, useful for competitive backlink analysis and identifying potential link sources
+- Added `get_active_outlinks` method to get active outbound links from a domain or URL, including target URLs, anchor text, link attributes (nofollow/dofollow), link types, and discovery dates for analyzing linking strategies and partnership opportunities
+- Added `get_active_outlink_domains` method to get external domains that receive outbound links from the analyzed domain, revealing partnership networks, referenced sources, and linking patterns for identifying collaboration opportunities
+- Added `get_threat_backlinks` method to identify malicious backlinks pointing to the analyzed domain, including links from sites flagged for threats like social engineering, malware, or unwanted software, with detailed threat classification and platform information
+
 
 ## [1.0.5] - 2025-09-18
 - Added `get_active_backlinks` method to retrieve a list of active backlinks showing linking pages, target pages, link attributes, link types, external links count, anchor text, and discovery dates for domain or URL analysis
 - Added `get_referring_domains` method to retrieve a list of referring domains that link to the analyzed site with domain rank metrics, referring pages count, and filtering options for comprehensive backlink analysis
 - Added `get_lost_backlinks` method to retrieve a list of lost backlinks showing linking pages, target pages, link attributes, and deletion dates for domain or URL analysis
+- Added `get_top10_anchors` method to retrieve TOP-10 anchors with the number of backlinks and referring domains for domain analysis
 
 ## [1.0.4] - 2025-09-16
 ### Added

package/README.md

@@ -136,30 +136,39 @@ After installation and configuration in Claude Desktop, you can ask Claude:
 - "Get active backlinks for **domain.com** showing linking pages and target URLs"
 - "Get referring domains for **domain.com** with domain authority metrics"
 - "Get lost backlinks for **domain.com** showing removed links and deletion dates"
+- "Get top 10 anchors for **domain.com** with backlink counts and referring domains"
+- "Get backlinks intersection for **domain.com** vs **competitor1.com** and **competitor2.com** showing shared referring domains"
+- "Get threat backlinks for **domain.com** showing malicious links from sites flagged for security threats"
 
 ## 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_active_backlinks     | Get a list of active backlinks showing linking pages, target pages, link attributes, and discovery dates       | query, searchType, sort, page   |
-| get_referring_domains    | Get a list of referring domains with domain rank metrics, referring pages count, and filtering options         | query, searchType, sort, page   |
-| get_lost_backlinks       | Get a list of lost backlinks showing linking pages, target pages, link attributes, and deletion dates          | query, searchType, sort, page   |
-| get_related_keywords     | Get semantically related keywords with frequency, CPC, competition, and difficulty data                        | keyword, se, filters, sort      |
+| 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_active_backlinks       | Get a list of active backlinks showing linking pages, target pages, link attributes, and discovery dates       | query, searchType, sort, page   |
+| get_referring_domains      | Get a list of referring domains with domain rank metrics, referring pages count, and filtering options         | query, searchType, sort, page   |
+| get_lost_backlinks         | Get a list of lost backlinks showing linking pages, target pages, link attributes, and deletion dates          | query, searchType, sort, page   |
+| get_top_pages_by_backlinks | Get a list of top pages by backlinks with various filtering and sorting parameters                             | query, searchType, sort, size   |
+| get_top10_anchors          | Get TOP-10 anchors with the number of backlinks and referring domains for domain analysis                      | query, searchType               |
+| get_backlinks_intersection | Get backlinks from domains that link to multiple analyzed sites simultaneously for competitive analysis        | query, intersect, sort, page    |
+| get_active_outlinks       | Get active outbound links from a domain or URL with target URLs, anchor text, and link attributes             | query, searchType, sort, filters |
+| get_active_outlink_domains | Get external domains that receive outbound links from analyzed domain revealing partnership networks          | query, searchType, sort, filters |
+| get_threat_backlinks       | Get malicious backlinks pointing to analyzed domain from sites flagged for security threats                    | query, searchType, sort, filters |
+| get_related_keywords       | Get semantically related keywords with frequency, CPC, competition, and difficulty data                        | keyword, se, filters, sort      |
 
 ### Search Engines (se parameter)
 

package/dist/handlers/backlinks_tools.d.ts

@@ -40,4 +40,52 @@ export declare class GetLostBacklinksHandler extends BaseHandler {
     getInputSchema(): Record<string, any>;
     handle(call: MCPToolCall): Promise<MCPToolResponse>;
 }
+export declare class GetTopAnchorsHandler extends BaseHandler {
+    private backlinksService;
+    constructor();
+    getName(): string;
+    getDescription(): string;
+    getInputSchema(): Record<string, any>;
+    handle(call: MCPToolCall): Promise<MCPToolResponse>;
+}
+export declare class GetTopPagesByBacklinksHandler extends BaseHandler {
+    private backlinksService;
+    constructor();
+    getName(): string;
+    getDescription(): string;
+    getInputSchema(): Record<string, any>;
+    handle(call: MCPToolCall): Promise<MCPToolResponse>;
+}
+export declare class GetBacklinksIntersectionHandler extends BaseHandler {
+    private backlinksService;
+    constructor();
+    getName(): string;
+    getDescription(): string;
+    getInputSchema(): Record<string, any>;
+    handle(call: MCPToolCall): Promise<MCPToolResponse>;
+}
+export declare class GetActiveOutlinksHandler extends BaseHandler {
+    private backlinksService;
+    constructor();
+    getName(): string;
+    getDescription(): string;
+    getInputSchema(): Record<string, any>;
+    handle(call: MCPToolCall): Promise<MCPToolResponse>;
+}
+export declare class GetActiveOutlinkDomainsHandler extends BaseHandler {
+    private backlinksService;
+    constructor();
+    getName(): string;
+    getDescription(): string;
+    getInputSchema(): Record<string, any>;
+    handle(call: MCPToolCall): Promise<MCPToolResponse>;
+}
+export declare class GetThreatBacklinksHandler extends BaseHandler {
+    private backlinksService;
+    constructor();
+    getName(): string;
+    getDescription(): string;
+    getInputSchema(): Record<string, any>;
+    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;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;AAED,qBAAa,yBAA0B,SAAQ,WAAW;IACtD,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;AAED,qBAAa,0BAA2B,SAAQ,WAAW;IACvD,OAAO,CAAC,gBAAgB,CAAmB;;IAQ3C,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,uBAAwB,SAAQ,WAAW;IACpD,OAAO,CAAC,gBAAgB,CAAmB;;IAQ3C,OAAO,IAAI,MAAM;IAIjB,cAAc,IAAI,MAAM;IAIxB,cAAc,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAmF/B,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":"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"}

package/dist/handlers/backlinks_tools.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.GetLostBacklinksHandler = exports.GetReferringDomainsHandler = exports.GetActiveBacklinksHandler = exports.GetAnchorsHandler = exports.BacklinksSummaryHandler = void 0;
+exports.GetThreatBacklinksHandler = exports.GetActiveOutlinkDomainsHandler = exports.GetActiveOutlinksHandler = exports.GetBacklinksIntersectionHandler = exports.GetTopPagesByBacklinksHandler = exports.GetTopAnchorsHandler = exports.GetLostBacklinksHandler = exports.GetReferringDomainsHandler = exports.GetActiveBacklinksHandler = 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");
@@ -306,7 +306,7 @@ class GetLostBacklinksHandler extends base_js_1.BaseHandler {
         return 'get_lost_backlinks';
     }
     getDescription() {
-        return 'Get a list of lost backlinks showing linking pages, target pages, link attributes, and deletion dates for domain or URL analysis';
+        return 'Get a list of lost backlinks showing linking pages, target pages, link attributes, and deletion dates for domain or URL analysis, **use sort by check desc** to get recently lost backlinks';
     }
     getInputSchema() {
         return {
@@ -335,35 +335,6 @@ class GetLostBacklinksHandler extends base_js_1.BaseHandler {
                     enum: constants_js_1.SORT_ORDER,
                     description: "Sort order: asc or desc"
                 },
-                complexFilter: {
-                    type: "array",
-                    items: {
-                        type: "array",
-                        items: {
-                            type: "object",
-                            properties: {
-                                name: {
-                                    type: "string",
-                                    enum: constants_js_1.LOST_BACKLINKS_COMPLEX_FILTER_FIELDS
-                                },
-                                operator: {
-                                    type: "string",
-                                    enum: constants_js_1.COMPLEX_FILTER_COMPARE_TYPES
-                                },
-                                value: {
-                                    oneOf: [
-                                        { type: "string" },
-                                        { type: "number" },
-                                        { type: "array", items: { oneOf: [{ type: "string" }, { type: "number" }] } }
-                                    ]
-                                }
-                            },
-                            required: ["name", "operator", "value"],
-                            additionalProperties: false
-                        }
-                    },
-                    description: "Complex filters for advanced filtering"
-                },
                 additionalFilters: {
                     type: "array",
                     items: {
@@ -405,4 +376,438 @@ class GetLostBacklinksHandler extends base_js_1.BaseHandler {
     }
 }
 exports.GetLostBacklinksHandler = GetLostBacklinksHandler;
+class GetTopAnchorsHandler 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_top10_anchors';
+    }
+    getDescription() {
+        return 'Get TOP-10 anchors with the number of backlinks and referring domains for domain analysis, use this method is you need a fast brief way to get info about top 10 anchors';
+    }
+    getInputSchema() {
+        return {
+            type: "object",
+            properties: {
+                query: {
+                    type: "string",
+                    minLength: constants_js_1.MIN_DOMAIN_LENGTH,
+                    maxLength: constants_js_1.MAX_DOMAIN_LENGTH,
+                    description: "Domain name to analyze"
+                },
+                searchType: {
+                    type: "string",
+                    enum: constants_js_1.SEARCH_TYPES,
+                    default: "domain",
+                    description: "Type of search: domain or domain_with_subdomains"
+                }
+            },
+            required: ["query"],
+            additionalProperties: false
+        };
+    }
+    async handle(call) {
+        try {
+            const params = validation_js_1.getTopAnchorsSchema.parse(call.arguments);
+            const result = await this.backlinksService.getTopAnchors(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.GetTopAnchorsHandler = GetTopAnchorsHandler;
+class GetTopPagesByBacklinksHandler 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_top_pages_by_backlinks';
+    }
+    getDescription() {
+        return 'Get leading pages by backlinks using Serpstat API. Returns pages with the highest number of referring pages, domains, and IP addresses for comprehensive backlink analysis.';
+    }
+    getInputSchema() {
+        return {
+            type: "object",
+            properties: {
+                query: {
+                    type: "string",
+                    minLength: constants_js_1.MIN_DOMAIN_LENGTH,
+                    maxLength: constants_js_1.MAX_DOMAIN_LENGTH,
+                    description: "Domain name to analyze"
+                },
+                searchType: {
+                    type: "string",
+                    enum: constants_js_1.SEARCH_TYPES,
+                    default: "domain",
+                    description: "Type of search: domain or domain_with_subdomains"
+                },
+                sort: {
+                    type: "string",
+                    enum: constants_js_1.TOP_PAGES_SORT_FIELDS,
+                    default: "lastupdate",
+                    description: "Field to sort results by"
+                },
+                order: {
+                    type: "string",
+                    enum: constants_js_1.SORT_ORDER,
+                    description: "Sort order: asc or 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"],
+            additionalProperties: false
+        };
+    }
+    async handle(call) {
+        try {
+            const params = validation_js_1.getTopPagesByBacklinksSchema.parse(call.arguments);
+            const result = await this.backlinksService.getTopPagesByBacklinks(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.GetTopPagesByBacklinksHandler = GetTopPagesByBacklinksHandler;
+class GetBacklinksIntersectionHandler 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_intersection';
+    }
+    getDescription() {
+        return 'Get backlinks from domains that link to multiple analyzed sites simultaneously. This method reveals shared referring domains between your target domain and competitors, useful for competitive backlink analysis and identifying potential link sources. Returns intersection data showing which donors link to multiple domains in your analysis set, including link metrics, anchor texts, and domain authority scores.';
+    }
+    getInputSchema() {
+        return {
+            type: "object",
+            properties: {
+                query: {
+                    type: "string",
+                    minLength: constants_js_1.MIN_DOMAIN_LENGTH,
+                    maxLength: constants_js_1.MAX_DOMAIN_LENGTH,
+                    description: "Main domain to analyze for backlinks intersection"
+                },
+                intersect: {
+                    type: "array",
+                    items: {
+                        type: "string",
+                        minLength: constants_js_1.MIN_DOMAIN_LENGTH,
+                        maxLength: constants_js_1.MAX_DOMAIN_LENGTH
+                    },
+                    minItems: 1,
+                    maxItems: constants_js_1.MAX_INTERSECT_DOMAINS,
+                    description: "Array of competitor domains for intersection analysis"
+                },
+                sort: {
+                    type: "string",
+                    enum: constants_js_1.BACKLINKS_INTERSECTION_SORT_FIELDS,
+                    default: "domain_rank",
+                    description: "Field to sort results by (domain_rank, links_count1, links_count2, links_count3)"
+                },
+                order: {
+                    type: "string",
+                    enum: constants_js_1.SORT_ORDER,
+                    default: "desc",
+                    description: "Sort order: asc or 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", "intersect"],
+            additionalProperties: false
+        };
+    }
+    async handle(call) {
+        try {
+            const params = validation_js_1.getBacklinksIntersectionSchema.parse(call.arguments);
+            const result = await this.backlinksService.getBacklinksIntersection(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.GetBacklinksIntersectionHandler = GetBacklinksIntersectionHandler;
+class GetActiveOutlinksHandler 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_active_outlinks';
+    }
+    getDescription() {
+        return 'Get active outbound links from a domain or URL. Returns external links the site points to, including target URLs, anchor text, link attributes (nofollow/dofollow), link types, and discovery dates. Useful for analyzing linking strategies, finding partnership opportunities, and auditing outbound link profiles.';
+    }
+    getInputSchema() {
+        return {
+            type: "object",
+            properties: {
+                query: {
+                    type: "string",
+                    minLength: constants_js_1.MIN_DOMAIN_LENGTH,
+                    maxLength: constants_js_1.MAX_DOMAIN_LENGTH,
+                    description: "Domain name or URL to analyze for outbound links"
+                },
+                searchType: {
+                    type: "string",
+                    enum: constants_js_1.SEARCH_TYPES_URL,
+                    default: "domain",
+                    description: "Type of search: domain, domain_with_subdomains, url, or part_url"
+                },
+                sort: {
+                    type: "string",
+                    enum: constants_js_1.ACTIVE_OUTLINKS_SORT_FIELDS,
+                    default: "check",
+                    description: "Field to sort results by"
+                },
+                order: {
+                    type: "string",
+                    enum: constants_js_1.SORT_ORDER,
+                    default: "desc",
+                    description: "Sort order: asc or desc"
+                },
+                linkPerDomain: {
+                    type: "integer",
+                    minimum: 1,
+                    description: "Maximum number of links to return per domain"
+                },
+                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.getActiveOutlinksSchema.parse(call.arguments);
+            const result = await this.backlinksService.getActiveOutlinks(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.GetActiveOutlinksHandler = GetActiveOutlinksHandler;
+class GetActiveOutlinkDomainsHandler 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_active_outlink_domains';
+    }
+    getDescription() {
+        return 'Get external domains that receive outbound links from the analyzed domain. Returns target domains with total link counts, revealing partnership networks, referenced sources, and linking patterns. Helps identify collaboration opportunities by analyzing which domains competitors link to.';
+    }
+    getInputSchema() {
+        return {
+            type: "object",
+            properties: {
+                query: {
+                    type: "string",
+                    description: "Domain name to analyze outbound link destinations",
+                    minLength: constants_js_1.MIN_DOMAIN_LENGTH,
+                    maxLength: constants_js_1.MAX_DOMAIN_LENGTH
+                },
+                searchType: {
+                    type: "string",
+                    enum: constants_js_1.SEARCH_TYPES_URL,
+                    description: "Search type for analysis",
+                    default: "domain"
+                },
+                sort: {
+                    type: "string",
+                    enum: constants_js_1.ACTIVE_OUTLINK_DOMAINS_SORT_FIELDS,
+                    description: "Field to sort results by",
+                    default: "domain_rank"
+                },
+                order: {
+                    type: "string",
+                    enum: constants_js_1.SORT_ORDER,
+                    description: "Sort order",
+                    default: "desc"
+                },
+                page: {
+                    type: "integer",
+                    description: "Page number for pagination",
+                    minimum: constants_js_1.MIN_PAGE,
+                    default: 1
+                },
+                size: {
+                    type: "integer",
+                    description: "Number of results per page",
+                    minimum: 1,
+                    maximum: constants_js_1.MAX_PAGE_SIZE,
+                    default: constants_js_1.DEFAULT_PAGE_SIZE
+                }
+            },
+            required: ["query", "searchType"],
+            additionalProperties: false
+        };
+    }
+    async handle(call) {
+        try {
+            const params = validation_js_1.getActiveOutlinkDomainsSchema.parse(call.arguments);
+            const result = await this.backlinksService.getActiveOutlinkDomains(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.GetActiveOutlinkDomainsHandler = GetActiveOutlinkDomainsHandler;
+class GetThreatBacklinksHandler 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_threat_backlinks';
+    }
+    getDescription() {
+        return 'Get malicious backlinks pointing to the analyzed domain. Returns links from sites flagged for threats like social engineering, malware, or unwanted software. Shows referring domain, source URL, target URL, platform type, threat type, and last update date. Essential for identifying and removing harmful backlinks that could damage domain reputation and SEO rankings.';
+    }
+    getInputSchema() {
+        return {
+            type: "object",
+            properties: {
+                query: {
+                    type: "string",
+                    pattern: constants_js_1.DOMAIN_NAME_REGEX,
+                    minLength: constants_js_1.MIN_DOMAIN_LENGTH,
+                    maxLength: constants_js_1.MAX_DOMAIN_LENGTH,
+                    description: "Domain to analyze for threat backlinks"
+                },
+                searchType: {
+                    type: "string",
+                    enum: constants_js_1.SEARCH_TYPES,
+                    default: "domain",
+                    description: "Search type: 'domain' (exact domain) or 'domain_with_subdomains' (includes subdomains)"
+                },
+                sort: {
+                    type: "string",
+                    enum: constants_js_1.BACKLINKS_THREAT_SORT_FIELDS,
+                    default: "lastupdate",
+                    description: "Field to sort by: lastupdate, url_from, url_to, platform_type, threat_type"
+                },
+                order: {
+                    type: "string",
+                    enum: constants_js_1.SORT_ORDER,
+                    default: "desc",
+                    description: "Sort order: asc or desc"
+                },
+                linkPerDomain: {
+                    type: "integer",
+                    minimum: 1,
+                    description: "Maximum number of links per domain to return"
+                },
+                page: {
+                    type: "integer",
+                    description: "Page number for pagination",
+                    minimum: constants_js_1.MIN_PAGE,
+                    default: 1
+                },
+                size: {
+                    type: "integer",
+                    description: "Number of results per page",
+                    minimum: 1,
+                    maximum: constants_js_1.MAX_PAGE_SIZE,
+                    default: constants_js_1.DEFAULT_PAGE_SIZE
+                }
+            },
+            required: ["query"],
+            additionalProperties: false
+        };
+    }
+    async handle(call) {
+        try {
+            const params = validation_js_1.getThreatBacklinksSchema.parse(call.arguments);
+            const result = await this.backlinksService.getThreatBacklinks(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.GetThreatBacklinksHandler = GetThreatBacklinksHandler;
 //# sourceMappingURL=backlinks_tools.js.map