dataforseo-mcp-server/build/main/core/modules/ai-optimization/tools/llm-mentions/llm-mentions-top-pages.js

A Model Context Protocol (MCP) server for the DataForSEO API, enabling modular and extensible integration of DataForSEO endpoints with support for both HTTP and SSE transports.

import z from "zod";
import { BaseTool } from "../../../base.tool.js";
export class AiOptimizationLlmMentionsTopPagesTool extends BaseTool {
    constructor(dataForSEOClient) {
        super(dataForSEOClient);
    }
    getName() {
        return "ai_opt_llm_ment_top_pages";
    }
    getDescription() {
        return "This endpoint provides aggregated LLM mentions metrics grouped by the most frequently mentioned pages for the specified target";
    }
    getParams() {
        return {
            target: z.array(z.union([
                z.object({
                    domain: z.string().describe("Target domain to search for LLM mentions"),
                    search_filter: z.enum(['include', 'exclude']).optional().describe("Search filter to apply (include or exclude)"),
                    search_scope: z.array(z.enum(['any', 'question', 'answer'])).optional().describe("Target search scope for LLM mentions"),
                }),
                z.object({
                    keyword: z.string().describe("Target keyword to search for LLM mentions"),
                    match_type: z.enum(['word_match', 'partial_match']).optional().describe("Match type for the keyword"),
                    search_filter: z.enum(['include', 'exclude']).optional().describe("Search filter to apply (include or exclude)"),
                    search_scope: z.array(z.enum(['any', 'question', 'answer'])).optional().describe("Target search scope for LLM mentions"),
                })
            ])).describe("Array of target objects to search for LLM mentions. Each object must contain either 'domain' or 'keyword'. Maximum number of targets: 1000"),
            location_name: z.string().optional().describe(`full name of the location, example: 'United Kingdom', 'United States'`),
            language_code: z.string().optional().describe("Search engine language code (e.g., 'en')"),
            platform: z.enum(['chat_gpt', 'google']).optional().describe("Platform to search for LLM mentions"),
            links_scope: z.enum(['sources', 'search_results']).optional().describe("specifies which links will be used to extract domains and aggregation"),
            initial_dataset_filters: this.getFilterExpression().optional().describe(`you can add several filters at once (8 filters maximum)
   you should set a logical operator and, or between the conditions
   the following operators are supported:
   regex, not_regex, <, <=, >, >=, =, <>, in, not_in, match, not_match, ilike, not_ilike, like, not_like
   you can use the % operator with like and not_like, as well as ilike and not_ilike to match any string of zero or more characters
   merge operator must be a string and connect two other arrays, availible values: or, and.
   example:
["ai_search_volume",">","1000"]
The full list of possible filters is available in 'ai_optimization_llm_mentions_filters' tool`),
            items_list_limit: z.number().min(1).max(10).optional().describe("maximum number of results in the items array, min value is 1, max value is 10"),
            internal_list_limit: z.number().min(1).max(10).optional().describe("maximum number of elements within internal arrays, min value is 1, max value is 10"),
        };
    }
    async handle(params) {
        try {
            let payload = {};
            payload['target'] = params.target;
            payload['location_name'] = params.location_name;
            payload['language_code'] = params.language_code;
            if (params.platform) {
                payload['platform'] = params.platform;
            }
            if (params.initial_dataset_filters) {
                payload['initial_dataset_filters'] = params.initial_dataset_filters;
            }
            if (params.links_scope) {
                payload['links_scope'] = params.links_scope;
            }
            if (params.items_list_limit) {
                payload['items_list_limit'] = params.items_list_limit;
            }
            if (params.internal_list_limit) {
                payload['internal_list_limit'] = params.internal_list_limit;
            }
            const response = await this.dataForSEOClient.makeRequest(`/v3/ai_optimization/llm_mentions/top_pages/live`, 'POST', [payload]);
            return this.validateAndFormatResponse(response);
        }
        catch (error) {
            return this.formatErrorResponse(error);
        }
    }
}
//# sourceMappingURL=llm-mentions-top-pages.js.map