@serpstat/serpstat-mcp-server 1.0.4 → 1.0.6

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [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
 - Added `get_keyword_full_top` method to show Google's top-100 search results for analyzed keywords

package/README.md

@@ -133,27 +133,42 @@ After installation and configuration in Claude Desktop, you can ask Claude:
 ### Backlink Analysis
 - "Analyze backlinks summary for **domain.com**"
 - "Get anchor text analysis for **domain.com** backlinks"
+- "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_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

@@ -16,4 +16,76 @@ export declare class GetAnchorsHandler extends BaseHandler {
     getInputSchema(): object;
     handle(call: MCPToolCall): Promise<MCPToolResponse>;
 }
+export declare class GetActiveBacklinksHandler extends BaseHandler {
+    private backlinksService;
+    constructor();
+    getName(): string;
+    getDescription(): string;
+    getInputSchema(): object;
+    handle(call: MCPToolCall): Promise<MCPToolResponse>;
+}
+export declare class GetReferringDomainsHandler extends BaseHandler {
+    private backlinksService;
+    constructor();
+    getName(): string;
+    getDescription(): string;
+    getInputSchema(): object;
+    handle(call: MCPToolCall): Promise<MCPToolResponse>;
+}
+export declare class GetLostBacklinksHandler extends BaseHandler {
+    private backlinksService;
+    constructor();
+    getName(): string;
+    getDescription(): string;
+    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"}
+{"version":3,"file":"backlinks_tools.d.ts","sourceRoot":"","sources":["../../src/handlers/backlinks_tools.ts"],"names":[],"mappings":"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"}