keywordgraph-mcp-server 1.6.1

package/dist/tools/generateContextualHint.js.map

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

package/dist/tools/generateDifferenceGraphFromTexts.d.ts

@@ -0,0 +1,52 @@
+import { z } from "zod";
+import { GenerateDifferenceGraphFromTextsSchema } from "../schemas/index.js";
+export declare const generateDifferenceGraphFromTextsTool: {
+    name: string;
+    definition: {
+        title: string;
+        description: string;
+        inputSchema: {
+            contexts: z.ZodArray<z.ZodUnion<[z.ZodObject<{
+                text: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                text: string;
+            }, {
+                text: string;
+            }>, z.ZodObject<{
+                url: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                url: string;
+            }, {
+                url: string;
+            }>, z.ZodObject<{
+                graphName: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                graphName: string;
+            }, {
+                graphName: string;
+            }>]>, "many">;
+            modifyAnalyzedText: z.ZodDefault<z.ZodEnum<["none", "detectEntities", "extractEntitiesOnly"]>>;
+            includeStatements: z.ZodDefault<z.ZodBoolean>;
+            includeGraph: z.ZodDefault<z.ZodBoolean>;
+            addNodesAndEdges: z.ZodDefault<z.ZodBoolean>;
+        };
+        annotations: {
+            readOnlyHint: boolean;
+            idempotentHint: boolean;
+            destructiveHint: boolean;
+        };
+    };
+    handler: (params: z.infer<typeof GenerateDifferenceGraphFromTextsSchema>) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+        isError: boolean;
+    } | {
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};
+//# sourceMappingURL=generateDifferenceGraphFromTexts.d.ts.map

package/dist/tools/generateDifferenceGraphFromTexts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateDifferenceGraphFromTexts.d.ts","sourceRoot":"","sources":["../../src/tools/generateDifferenceGraphFromTexts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EACN,sCAAsC,EAEtC,MAAM,qBAAqB,CAAC;AA2D7B,eAAO,MAAM,oCAAoC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAcvC,CAAC,CAAC,KAAK,CAAC,OAAO,sCAAsC,CAAC;;;;;;;;;;;;CA+G/D,CAAC"}

package/dist/tools/generateDifferenceGraphFromTexts.js

@@ -0,0 +1,160 @@
+import { brand } from "../config/brand.js";
+import { GenerateDifferenceGraphFromTextsSchemaBase, } from "../schemas/index.js";
+import { makeInfraNodusRequest } from "../api/client.js";
+import { fetchUrlContentAsText } from "../utils/urlContent.js";
+import { transformToStructuredOutput } from "../utils/transformers.js";
+function errorContent(message) {
+    return {
+        content: [
+            { type: "text", text: JSON.stringify({ error: message }) },
+        ],
+        isError: true,
+    };
+}
+/** Fetches an existing graph by name with includeStatements and returns its statements joined as text. */
+async function fetchGraphTextByName(graphName) {
+    const queryParams = new URLSearchParams({
+        doNotSave: "true",
+        addStats: "true",
+        includeStatements: "true",
+        includeGraphSummary: "false",
+        extendedGraphSummary: "false",
+        includeGraph: "false",
+        compactGraph: "true",
+        compactStatements: "true",
+        aiTopics: "false",
+        optimize: "develop",
+    });
+    const endpoint = `/graphAndStatements?${queryParams.toString()}`;
+    const requestBody = { name: graphName, aiTopics: "false" };
+    let response;
+    try {
+        response = await makeInfraNodusRequest(endpoint, requestBody);
+    }
+    catch (err) {
+        return {
+            ok: false,
+            error: err instanceof Error ? err.message : String(err),
+        };
+    }
+    if (response.error) {
+        return { ok: false, error: response.error };
+    }
+    const statements = response.statements ?? [];
+    const text = statements
+        .map((s) => s.content?.trim())
+        .filter(Boolean)
+        .join("\n");
+    if (!text.trim()) {
+        return {
+            ok: false,
+            error: `Graph "${graphName}" returned no statement content`,
+        };
+    }
+    return { ok: true, text };
+}
+export const generateDifferenceGraphFromTextsTool = {
+    name: "difference_between_texts",
+    definition: {
+        title: "Generate Difference Knowledge Graph from Texts",
+        description: `Extract the conceptial relations that are missing in the first text, url, or ${brand.name} graph but are present in the other texts`,
+        inputSchema: GenerateDifferenceGraphFromTextsSchemaBase.shape,
+        annotations: {
+            readOnlyHint: true,
+            idempotentHint: true,
+            destructiveHint: false,
+        },
+    },
+    handler: async (params) => {
+        try {
+            const modifyAnalyzedText = params.modifyAnalyzedText ?? "none";
+            const resolvedTexts = [];
+            for (let i = 0; i < params.contexts.length; i++) {
+                const item = params.contexts[i];
+                if ("text" in item) {
+                    if (!item.text.trim())
+                        return errorContent(`Context at index ${i} has empty text.`);
+                    resolvedTexts.push(item.text);
+                    continue;
+                }
+                if ("url" in item) {
+                    const result = await fetchUrlContentAsText(item.url);
+                    if (!result.ok)
+                        return errorContent(`URL at context index ${i} failed: ${result.error}`);
+                    if (!result.contentText?.trim())
+                        return errorContent(`URL at context index ${i} did not return any text content`);
+                    resolvedTexts.push(result.contentText);
+                    continue;
+                }
+                if ("graphName" in item) {
+                    const result = await fetchGraphTextByName(item.graphName);
+                    if (!result.ok)
+                        return errorContent(`Graph at context index ${i} failed: ${result.error}`);
+                    resolvedTexts.push(result.text);
+                    continue;
+                }
+                return errorContent(`Context at index ${i} must be { text }, { url }, or { graphName }.`);
+            }
+            const contexts = resolvedTexts.map((text) => ({
+                text,
+                modifyAnalyzedText,
+            }));
+            const includeNodesAndEdges = params.addNodesAndEdges;
+            const includeGraph = params.includeGraph;
+            // Build query parameters
+            const queryParams = new URLSearchParams({
+                doNotSave: "true",
+                addStats: "true",
+                includeStatements: params.includeStatements ? "true" : "false",
+                includeGraphSummary: "false",
+                extendedGraphSummary: "true",
+                includeGraph: includeGraph ? "true" : "false",
+                compactGraph: "true",
+                compactStatements: "true",
+                aiTopics: "true",
+                optimize: "develop",
+                compareMode: "difference",
+            });
+            const endpoint = `/graphsAndStatements?${queryParams.toString()}`;
+            const requestBody = {
+                contexts,
+                aiTopics: "true",
+            };
+            const response = await makeInfraNodusRequest(endpoint, requestBody);
+            if (response.error) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Error: ${response.error}`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            const structuredOutput = transformToStructuredOutput(response, includeGraph, includeNodesAndEdges);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(structuredOutput, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            error: error instanceof Error ? error.message : String(error),
+                        }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    },
+};
+//# sourceMappingURL=generateDifferenceGraphFromTexts.js.map

package/dist/tools/generateDifferenceGraphFromTexts.js.map

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

package/dist/tools/generateGoogleResultsVsQueriesGraph.d.ts

@@ -0,0 +1,37 @@
+import { z } from "zod";
+import { GenerateGoogleResultsVsQueriesGraphSchema } from "../schemas/index.js";
+export declare const generateGoogleResultsVsQueriesGraphTool: {
+    name: string;
+    definition: {
+        title: string;
+        description: string;
+        inputSchema: {
+            queries: z.ZodArray<z.ZodString, "many">;
+            includeGraph: z.ZodDefault<z.ZodBoolean>;
+            showExtendedGraphInfo: z.ZodDefault<z.ZodBoolean>;
+            includeSearchQueries: z.ZodDefault<z.ZodBoolean>;
+            includeSearchQueriesOnly: z.ZodDefault<z.ZodBoolean>;
+            importLanguage: z.ZodDefault<z.ZodEnum<["EN", "DE", "FR", "ES", "IT", "PT", "RU", "CN", "JP", "NL", "TW", "KO", "AR", "HE"]>>;
+            importCountry: z.ZodDefault<z.ZodEnum<["AR", "AU", "BR", "CA", "CH", "CN", "DE", "ES", "FR", "GB", "HK", "IN", "IT", "JP", "MX", "NL", "NO", "NZ", "PT", "RU", "SV", "TW", "US", "SG", "SA", "AE", "EG", "IR", "IL", "KR"]>>;
+        };
+        annotations: {
+            readOnlyHint: boolean;
+            idempotentHint: boolean;
+            destructiveHint: boolean;
+        };
+    };
+    handler: (params: z.infer<typeof GenerateGoogleResultsVsQueriesGraphSchema>) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+        isError: boolean;
+    } | {
+        content: {
+            type: "text";
+            text: string;
+        }[];
+        isError?: undefined;
+    }>;
+};
+//# sourceMappingURL=generateGoogleResultsVsQueriesGraph.d.ts.map

package/dist/tools/generateGoogleResultsVsQueriesGraph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateGoogleResultsVsQueriesGraph.d.ts","sourceRoot":"","sources":["../../src/tools/generateGoogleResultsVsQueriesGraph.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,yCAAyC,EAAE,MAAM,qBAAqB,CAAC;AAIhF,eAAO,MAAM,uCAAuC;;;;;;;;;;;;;;;;;;;;sBAc1C,CAAC,CAAC,KAAK,CAAC,OAAO,yCAAyC,CAAC;;;;;;;;;;;;;CA8ElE,CAAC"}

package/dist/tools/generateGoogleResultsVsQueriesGraph.js

@@ -0,0 +1,84 @@
+import { GenerateGoogleResultsVsQueriesGraphSchema } from "../schemas/index.js";
+import { makeInfraNodusRequest } from "../api/client.js";
+import { transformToStructuredOutput } from "../utils/transformers.js";
+export const generateGoogleResultsVsQueriesGraphTool = {
+    name: "search_queries_vs_search_results",
+    definition: {
+        title: "Generate a Knowledge Graph of Search Queries vs Search Results",
+        description: "Find the combinations of keywords and topics people search for that don't appear in the search results for the same queries",
+        inputSchema: GenerateGoogleResultsVsQueriesGraphSchema.shape,
+        annotations: {
+            readOnlyHint: true,
+            idempotentHint: true,
+            destructiveHint: false,
+        },
+    },
+    handler: async (params) => {
+        try {
+            const showExtendedGraphInfo = params.showExtendedGraphInfo ? true : false;
+            const includeGraph = showExtendedGraphInfo ? true : false;
+            const includeStatements = params.includeSearchQueries ? true : false;
+            const includeSearchQueriesOnly = params.includeSearchQueriesOnly
+                ? true
+                : false;
+            const queryParams = new URLSearchParams({
+                doNotSave: "true",
+                addStats: "true",
+                includeGraphSummary: "true",
+                extendedGraphSummary: showExtendedGraphInfo ? "true" : "false",
+                includeGraph: includeGraph ? "true" : "false",
+                includeStatements: includeStatements || includeSearchQueriesOnly ? "true" : "false",
+                compactGraph: "true",
+                compactStatements: "true",
+                aiTopics: "true",
+            });
+            const endpoint = `/import/googleSearchVsIntentGraph?${queryParams.toString()}`;
+            const response = await makeInfraNodusRequest(endpoint, {
+                searchQuery: params.queries.join(","),
+                aiTopics: "true",
+                importLanguage: params.importLanguage || "EN",
+                importCountry: params.importCountry || "US",
+            });
+            if (response.error) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({ error: response.error }),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            const textOverview = transformToStructuredOutput(response, includeGraph, false);
+            if (!includeStatements && !includeSearchQueriesOnly) {
+                delete textOverview.statements;
+            }
+            if (showExtendedGraphInfo || includeGraph) {
+                delete textOverview.graphSummary;
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(textOverview, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            error: error instanceof Error ? error.message : String(error),
+                        }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    },
+};
+//# sourceMappingURL=generateGoogleResultsVsQueriesGraph.js.map

package/dist/tools/generateGoogleResultsVsQueriesGraph.js.map

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

package/dist/tools/generateGoogleSearchQueriesGraph.d.ts

@@ -0,0 +1,39 @@
+import { z } from "zod";
+import { GenerateGoogleSearchQueriesGraphSchema } from "../schemas/index.js";
+export declare const generateGoogleSearchQueriesGraphTool: {
+    name: string;
+    definition: {
+        title: string;
+        description: string;
+        inputSchema: {
+            queries: z.ZodArray<z.ZodString, "many">;
+            includeSearchQueries: z.ZodDefault<z.ZodBoolean>;
+            includeSearchQueriesOnly: z.ZodDefault<z.ZodBoolean>;
+            keywordsSource: z.ZodDefault<z.ZodEnum<["related", "adwords"]>>;
+            includeGraph: z.ZodDefault<z.ZodBoolean>;
+            showExtendedGraphInfo: z.ZodDefault<z.ZodBoolean>;
+            includeNodesAndEdges: z.ZodDefault<z.ZodBoolean>;
+            importLanguage: z.ZodDefault<z.ZodEnum<["EN", "DE", "FR", "ES", "IT", "PT", "RU", "CN", "JP", "NL", "TW", "KO", "AR", "HE"]>>;
+            importCountry: z.ZodDefault<z.ZodEnum<["AR", "AU", "BR", "CA", "CH", "CN", "DE", "ES", "FR", "GB", "HK", "IN", "IT", "JP", "MX", "NL", "NO", "NZ", "PT", "RU", "SV", "TW", "US", "SG", "SA", "AE", "EG", "IR", "IL", "KR"]>>;
+        };
+        annotations: {
+            readOnlyHint: boolean;
+            idempotentHint: boolean;
+            destructiveHint: boolean;
+        };
+    };
+    handler: (params: z.infer<typeof GenerateGoogleSearchQueriesGraphSchema>) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+        isError: boolean;
+    } | {
+        content: {
+            type: "text";
+            text: string;
+        }[];
+        isError?: undefined;
+    }>;
+};
+//# sourceMappingURL=generateGoogleSearchQueriesGraph.d.ts.map

package/dist/tools/generateGoogleSearchQueriesGraph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateGoogleSearchQueriesGraph.d.ts","sourceRoot":"","sources":["../../src/tools/generateGoogleSearchQueriesGraph.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,sCAAsC,EAAE,MAAM,qBAAqB,CAAC;AAI7E,eAAO,MAAM,oCAAoC;;;;;;;;;;;;;;;;;;;;;;sBAcvC,CAAC,CAAC,KAAK,CAAC,OAAO,sCAAsC,CAAC;;;;;;;;;;;;;CAqF/D,CAAC"}

package/dist/tools/generateGoogleSearchQueriesGraph.js

@@ -0,0 +1,88 @@
+import { GenerateGoogleSearchQueriesGraphSchema } from "../schemas/index.js";
+import { makeInfraNodusRequest } from "../api/client.js";
+import { transformToStructuredOutput } from "../utils/transformers.js";
+export const generateGoogleSearchQueriesGraphTool = {
+    name: "analyze_related_search_queries",
+    definition: {
+        title: "Analyze Google Search Intent Related to Given Queries",
+        description: "Generate a knowledge graph and identifymain topical clusters in the search requests related to the search queries provided",
+        inputSchema: GenerateGoogleSearchQueriesGraphSchema.shape,
+        annotations: {
+            readOnlyHint: true,
+            idempotentHint: true,
+            destructiveHint: false,
+        },
+    },
+    handler: async (params) => {
+        try {
+            const includeGraph = params.includeGraph ? true : false;
+            const includeStatements = params.includeSearchQueries ? true : false;
+            const showExtendedGraphInfo = params.showExtendedGraphInfo ? true : false;
+            const includeNodesAndEdges = params.includeNodesAndEdges ? true : false;
+            const includeSearchQueriesOnly = params.includeSearchQueriesOnly
+                ? true
+                : false;
+            // First generate the graph with focus on insights
+            const queryParams = new URLSearchParams({
+                doNotSave: "true",
+                addStats: "true",
+                includeGraphSummary: "true",
+                extendedGraphSummary: showExtendedGraphInfo ? "true" : "false",
+                includeGraph: includeGraph ? "true" : "false",
+                includeStatements: includeStatements || includeSearchQueriesOnly ? "true" : "false",
+                compactGraph: "true",
+                compactStatements: "true",
+                aiTopics: "true",
+            });
+            const endpoint = `/import/googleSearchIntentGraph?${queryParams.toString()}`;
+            const response = await makeInfraNodusRequest(endpoint, {
+                searchQuery: params.queries.join(","),
+                includeSearchQueriesOnly: includeSearchQueriesOnly ? "true" : "false",
+                keywordsSource: params.keywordsSource == "adwords" ? "adwords" : "related",
+                aiTopics: "true",
+                importLanguage: params.importLanguage || "EN",
+                importCountry: params.importCountry || "US",
+            });
+            if (response.error) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({ error: response.error }),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            const textOverview = transformToStructuredOutput(response, includeGraph, includeNodesAndEdges);
+            if (!includeStatements && !includeSearchQueriesOnly) {
+                delete textOverview.statements;
+            }
+            if (showExtendedGraphInfo || includeGraph) {
+                delete textOverview.graphSummary;
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(textOverview, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            error: error instanceof Error ? error.message : String(error),
+                        }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    },
+};
+//# sourceMappingURL=generateGoogleSearchQueriesGraph.js.map

package/dist/tools/generateGoogleSearchQueriesGraph.js.map

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

package/dist/tools/generateGoogleSearchResultsGraph.d.ts

@@ -0,0 +1,38 @@
+import { z } from "zod";
+import { GenerateGoogleSearchResultsGraphSchema } from "../schemas/index.js";
+export declare const generateGoogleSearchResultsGraphTool: {
+    name: string;
+    definition: {
+        title: string;
+        description: string;
+        inputSchema: {
+            queries: z.ZodArray<z.ZodString, "many">;
+            includeSearchResults: z.ZodDefault<z.ZodBoolean>;
+            includeGraph: z.ZodDefault<z.ZodBoolean>;
+            showExtendedGraphInfo: z.ZodDefault<z.ZodBoolean>;
+            includeSearchResultsOnly: z.ZodDefault<z.ZodBoolean>;
+            includeNodesAndEdges: z.ZodDefault<z.ZodBoolean>;
+            importLanguage: z.ZodDefault<z.ZodEnum<["EN", "DE", "FR", "ES", "IT", "PT", "RU", "CN", "JP", "NL", "TW", "KO", "AR", "HE"]>>;
+            importCountry: z.ZodDefault<z.ZodEnum<["AR", "AU", "BR", "CA", "CH", "CN", "DE", "ES", "FR", "GB", "HK", "IN", "IT", "JP", "MX", "NL", "NO", "NZ", "PT", "RU", "SV", "TW", "US", "SG", "SA", "AE", "EG", "IR", "IL", "KR"]>>;
+        };
+        annotations: {
+            readOnlyHint: boolean;
+            idempotentHint: boolean;
+            destructiveHint: boolean;
+        };
+    };
+    handler: (params: z.infer<typeof GenerateGoogleSearchResultsGraphSchema>) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+        isError: boolean;
+    } | {
+        content: {
+            type: "text";
+            text: string;
+        }[];
+        isError?: undefined;
+    }>;
+};
+//# sourceMappingURL=generateGoogleSearchResultsGraph.d.ts.map

package/dist/tools/generateGoogleSearchResultsGraph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateGoogleSearchResultsGraph.d.ts","sourceRoot":"","sources":["../../src/tools/generateGoogleSearchResultsGraph.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,sCAAsC,EAAE,MAAM,qBAAqB,CAAC;AAI7E,eAAO,MAAM,oCAAoC;;;;;;;;;;;;;;;;;;;;;sBAcvC,CAAC,CAAC,KAAK,CAAC,OAAO,sCAAsC,CAAC;;;;;;;;;;;;;CAmF/D,CAAC"}

package/dist/tools/generateGoogleSearchResultsGraph.js

@@ -0,0 +1,88 @@
+import { GenerateGoogleSearchResultsGraphSchema } from "../schemas/index.js";
+import { makeInfraNodusRequest } from "../api/client.js";
+import { transformToStructuredOutput } from "../utils/transformers.js";
+export const generateGoogleSearchResultsGraphTool = {
+    name: "analyze_google_search_results",
+    definition: {
+        title: "Analyze the Main Topics in Google Search Results ",
+        description: "Generate a knowledge graph and topical clusters from Google search results for provided search queries",
+        inputSchema: GenerateGoogleSearchResultsGraphSchema.shape,
+        annotations: {
+            readOnlyHint: true,
+            idempotentHint: true,
+            destructiveHint: false,
+        },
+    },
+    handler: async (params) => {
+        try {
+            const includeGraph = params.includeGraph ? true : false;
+            const includeStatements = params.includeSearchResults ? true : false;
+            const showExtendedGraphInfo = params.showExtendedGraphInfo ? true : false;
+            const includeNodesAndEdges = params.includeNodesAndEdges ? true : false;
+            const includeSearchResultsOnly = params.includeSearchResultsOnly
+                ? true
+                : false;
+            // First generate the graph with focus on insights
+            const queryParams = new URLSearchParams({
+                doNotSave: "true",
+                addStats: "true",
+                includeGraphSummary: "true",
+                extendedGraphSummary: showExtendedGraphInfo ? "true" : "false",
+                includeGraph: includeGraph ? "true" : "false",
+                includeStatements: includeStatements || includeSearchResultsOnly ? "true" : "false",
+                compactGraph: "true",
+                compactStatements: "true",
+                aiTopics: "true",
+            });
+            const endpoint = `/import/googleSearchResultsGraph?${queryParams.toString()}`;
+            const response = await makeInfraNodusRequest(endpoint, {
+                searchQuery: params.queries.join(","),
+                includeGraph: includeGraph ? "true" : "false",
+                aiTopics: "true",
+                includeSearchResultsOnly: includeSearchResultsOnly ? "true" : "false",
+                importLanguage: params.importLanguage || "EN",
+                importCountry: params.importCountry || "US",
+            });
+            if (response.error) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({ error: response.error }),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            const textOverview = transformToStructuredOutput(response, includeGraph, includeNodesAndEdges);
+            if (!includeStatements && !includeSearchResultsOnly) {
+                delete textOverview.statements;
+            }
+            if (showExtendedGraphInfo || includeGraph) {
+                delete textOverview.graphSummary;
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(textOverview, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            error: error instanceof Error ? error.message : String(error),
+                        }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    },
+};
+//# sourceMappingURL=generateGoogleSearchResultsGraph.js.map

package/dist/tools/generateGoogleSearchResultsGraph.js.map

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