@heyseo/mcp-server 0.1.0

package/dist/tools/index.d.ts

@@ -0,0 +1,392 @@
+/**
+ * Tool Registry
+ * Exports all tools for the HeySeo MCP server
+ */
+import { gscTools, queryGSCSchema, topKeywordsSchema, topPagesSchema, executeQueryGSC, executeTopKeywords, executeTopPages } from './gsc.js';
+import { ga4Tools, queryGA4Schema, landingPagesSchema, trafficSourcesSchema, executeQueryGA4, executeLandingPages, executeTrafficSources } from './ga4.js';
+import { pagespeedTools, analyzePageSpeedSchema, bulkPageSpeedSchema, executeAnalyzePageSpeed, executeBulkPageSpeed } from './pagespeed.js';
+import { comparisonTools, comparePeriodSchema, findOpportunitiesSchema, weekOverWeekSchema, executeComparePeriod, executeFindOpportunities, executeWeekOverWeek } from './comparison.js';
+import { taskTools, createTaskSchema, executeCreateTask } from './tasks.js';
+export { gscTools, queryGSCSchema, topKeywordsSchema, topPagesSchema, executeQueryGSC, executeTopKeywords, executeTopPages, ga4Tools, queryGA4Schema, landingPagesSchema, trafficSourcesSchema, executeQueryGA4, executeLandingPages, executeTrafficSources, pagespeedTools, analyzePageSpeedSchema, bulkPageSpeedSchema, executeAnalyzePageSpeed, executeBulkPageSpeed, comparisonTools, comparePeriodSchema, findOpportunitiesSchema, weekOverWeekSchema, executeComparePeriod, executeFindOpportunities, executeWeekOverWeek, taskTools, createTaskSchema, executeCreateTask, };
+/**
+ * All tool definitions for MCP registration
+ */
+export declare const allTools: ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            siteId: {
+                type: string;
+                description: string;
+            };
+            startDate: {
+                type: string;
+                pattern: string;
+                description: string;
+            };
+            endDate: {
+                type: string;
+                pattern: string;
+                description: string;
+            };
+            dimensions: {
+                type: string;
+                items: {
+                    type: string;
+                    enum: string[];
+                };
+                default: string[];
+                description: string;
+            };
+            rowLimit: {
+                type: string;
+                minimum: number;
+                maximum: number;
+                default: number;
+                description: string;
+            };
+            filters: {
+                type: string;
+                items: {
+                    type: string;
+                    properties: {
+                        dimension: {
+                            type: string;
+                            enum: string[];
+                        };
+                        operator: {
+                            type: string;
+                            enum: string[];
+                        };
+                        expression: {
+                            type: string;
+                        };
+                    };
+                    required: string[];
+                };
+                description: string;
+            };
+            limit?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            siteId: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                minimum: number;
+                maximum: number;
+                default: number;
+                description: string;
+            };
+            startDate: {
+                type: string;
+                pattern: string;
+                description: string;
+            };
+            endDate: {
+                type: string;
+                pattern: string;
+                description: string;
+            };
+            dimensions?: undefined;
+            rowLimit?: undefined;
+            filters?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            siteId: {
+                type: string;
+                description: string;
+            };
+            startDate: {
+                type: string;
+                pattern: string;
+                description: string;
+            };
+            endDate: {
+                type: string;
+                pattern: string;
+                description: string;
+            };
+            metrics: {
+                type: string;
+                items: {
+                    type: string;
+                    enum: string[];
+                };
+                default: string[];
+                description: string;
+            };
+            dimensions: {
+                type: string;
+                items: {
+                    type: string;
+                    enum: string[];
+                };
+                description: string;
+            };
+            limit: {
+                type: string;
+                minimum: number;
+                maximum: number;
+                default: number;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            siteId: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                minimum: number;
+                maximum: number;
+                default: number;
+                description: string;
+            };
+            startDate: {
+                type: string;
+                pattern: string;
+                description: string;
+            };
+            endDate: {
+                type: string;
+                pattern: string;
+                description: string;
+            };
+            metrics?: undefined;
+            dimensions?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            siteId: {
+                type: string;
+                description: string;
+            };
+            startDate: {
+                type: string;
+                pattern: string;
+                description: string;
+            };
+            endDate: {
+                type: string;
+                pattern: string;
+                description: string;
+            };
+            metrics?: undefined;
+            dimensions?: undefined;
+            limit?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            url: {
+                type: string;
+                format: string;
+                description: string;
+            };
+            strategy: {
+                type: string;
+                enum: string[];
+                default: string;
+                description: string;
+            };
+            urls?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            urls: {
+                type: string;
+                items: {
+                    type: string;
+                    format: string;
+                };
+                minItems: number;
+                maxItems: number;
+                description: string;
+            };
+            strategy: {
+                type: string;
+                enum: string[];
+                default: string;
+                description: string;
+            };
+            url?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            siteId: {
+                type: string;
+                description: string;
+            };
+            period1Start: {
+                type: string;
+                pattern: string;
+                description: string;
+            };
+            period1End: {
+                type: string;
+                pattern: string;
+                description: string;
+            };
+            period2Start: {
+                type: string;
+                pattern: string;
+                description: string;
+            };
+            period2End: {
+                type: string;
+                pattern: string;
+                description: string;
+            };
+            includeGA4: {
+                type: string;
+                default: boolean;
+                description: string;
+            };
+            weeksBack?: undefined;
+            type?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            siteId: {
+                type: string;
+                description: string;
+            };
+            weeksBack: {
+                type: string;
+                minimum: number;
+                maximum: number;
+                default: number;
+                description: string;
+            };
+            period1Start?: undefined;
+            period1End?: undefined;
+            period2Start?: undefined;
+            period2End?: undefined;
+            includeGA4?: undefined;
+            type?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            siteId: {
+                type: string;
+                description: string;
+            };
+            type: {
+                type: string;
+                enum: string[];
+                default: string;
+                description: string;
+            };
+            period1Start?: undefined;
+            period1End?: undefined;
+            period2Start?: undefined;
+            period2End?: undefined;
+            includeGA4?: undefined;
+            weeksBack?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            siteId: {
+                type: string;
+                description: string;
+            };
+            title: {
+                type: string;
+                minLength: number;
+                maxLength: number;
+                description: string;
+            };
+            description: {
+                type: string;
+                maxLength: number;
+                description: string;
+            };
+            priority: {
+                type: string;
+                enum: string[];
+                default: string;
+                description: string;
+            };
+            category: {
+                type: string;
+                enum: string[];
+                default: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+})[];
+/**
+ * Tool name to category mapping
+ */
+export declare const toolCategories: Record<string, string>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EACL,QAAQ,EACR,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,eAAe,EAChB,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,QAAQ,EACR,cAAc,EACd,kBAAkB,EAClB,oBAAoB,EACpB,eAAe,EACf,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,cAAc,EACd,sBAAsB,EACtB,mBAAmB,EACnB,uBAAuB,EACvB,oBAAoB,EACrB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,uBAAuB,EACvB,kBAAkB,EAClB,oBAAoB,EACpB,wBAAwB,EACxB,mBAAmB,EACpB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAG5E,OAAO,EAEL,QAAQ,EACR,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,eAAe,EAEf,QAAQ,EACR,cAAc,EACd,kBAAkB,EAClB,oBAAoB,EACpB,eAAe,EACf,mBAAmB,EACnB,qBAAqB,EAErB,cAAc,EACd,sBAAsB,EACtB,mBAAmB,EACnB,uBAAuB,EACvB,oBAAoB,EAEpB,eAAe,EACf,mBAAmB,EACnB,uBAAuB,EACvB,kBAAkB,EAClB,oBAAoB,EACpB,wBAAwB,EACxB,mBAAmB,EAEnB,SAAS,EACT,gBAAgB,EAChB,iBAAiB,GAClB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAWpB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAajD,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,59 @@
+/**
+ * Tool Registry
+ * Exports all tools for the HeySeo MCP server
+ */
+// GSC Tools
+import { gscTools, queryGSCSchema, topKeywordsSchema, topPagesSchema, executeQueryGSC, executeTopKeywords, executeTopPages, } from './gsc.js';
+// GA4 Tools
+import { ga4Tools, queryGA4Schema, landingPagesSchema, trafficSourcesSchema, executeQueryGA4, executeLandingPages, executeTrafficSources, } from './ga4.js';
+// PageSpeed Tools
+import { pagespeedTools, analyzePageSpeedSchema, bulkPageSpeedSchema, executeAnalyzePageSpeed, executeBulkPageSpeed, } from './pagespeed.js';
+// Comparison Tools
+import { comparisonTools, comparePeriodSchema, findOpportunitiesSchema, weekOverWeekSchema, executeComparePeriod, executeFindOpportunities, executeWeekOverWeek, } from './comparison.js';
+// Task Tools
+import { taskTools, createTaskSchema, executeCreateTask } from './tasks.js';
+// Re-export everything
+export { 
+// GSC
+gscTools, queryGSCSchema, topKeywordsSchema, topPagesSchema, executeQueryGSC, executeTopKeywords, executeTopPages, 
+// GA4
+ga4Tools, queryGA4Schema, landingPagesSchema, trafficSourcesSchema, executeQueryGA4, executeLandingPages, executeTrafficSources, 
+// PageSpeed
+pagespeedTools, analyzePageSpeedSchema, bulkPageSpeedSchema, executeAnalyzePageSpeed, executeBulkPageSpeed, 
+// Comparison
+comparisonTools, comparePeriodSchema, findOpportunitiesSchema, weekOverWeekSchema, executeComparePeriod, executeFindOpportunities, executeWeekOverWeek, 
+// Tasks
+taskTools, createTaskSchema, executeCreateTask, };
+/**
+ * All tool definitions for MCP registration
+ */
+export const allTools = [
+    // GSC
+    ...gscTools,
+    // GA4
+    ...ga4Tools,
+    // PageSpeed
+    ...pagespeedTools,
+    // Comparison
+    ...comparisonTools,
+    // Tasks
+    ...taskTools,
+];
+/**
+ * Tool name to category mapping
+ */
+export const toolCategories = {
+    heyseo_query_gsc: 'gsc',
+    heyseo_top_keywords: 'gsc',
+    heyseo_top_pages: 'gsc',
+    heyseo_query_ga4: 'ga4',
+    heyseo_landing_pages: 'ga4',
+    heyseo_traffic_sources: 'ga4',
+    heyseo_pagespeed: 'pagespeed',
+    heyseo_pagespeed_bulk: 'pagespeed',
+    heyseo_compare_periods: 'comparison',
+    heyseo_week_over_week: 'comparison',
+    heyseo_find_opportunities: 'comparison',
+    heyseo_create_task: 'tasks',
+};
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,YAAY;AACZ,OAAO,EACL,QAAQ,EACR,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,eAAe,GAChB,MAAM,UAAU,CAAC;AAElB,YAAY;AACZ,OAAO,EACL,QAAQ,EACR,cAAc,EACd,kBAAkB,EAClB,oBAAoB,EACpB,eAAe,EACf,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,UAAU,CAAC;AAElB,kBAAkB;AAClB,OAAO,EACL,cAAc,EACd,sBAAsB,EACtB,mBAAmB,EACnB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AAExB,mBAAmB;AACnB,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,uBAAuB,EACvB,kBAAkB,EAClB,oBAAoB,EACpB,wBAAwB,EACxB,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AAEzB,aAAa;AACb,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE5E,uBAAuB;AACvB,OAAO;AACL,MAAM;AACN,QAAQ,EACR,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,eAAe;AACf,MAAM;AACN,QAAQ,EACR,cAAc,EACd,kBAAkB,EAClB,oBAAoB,EACpB,eAAe,EACf,mBAAmB,EACnB,qBAAqB;AACrB,YAAY;AACZ,cAAc,EACd,sBAAsB,EACtB,mBAAmB,EACnB,uBAAuB,EACvB,oBAAoB;AACpB,aAAa;AACb,eAAe,EACf,mBAAmB,EACnB,uBAAuB,EACvB,kBAAkB,EAClB,oBAAoB,EACpB,wBAAwB,EACxB,mBAAmB;AACnB,QAAQ;AACR,SAAS,EACT,gBAAgB,EAChB,iBAAiB,GAClB,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,MAAM;IACN,GAAG,QAAQ;IACX,MAAM;IACN,GAAG,QAAQ;IACX,YAAY;IACZ,GAAG,cAAc;IACjB,aAAa;IACb,GAAG,eAAe;IAClB,QAAQ;IACR,GAAG,SAAS;CACb,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAA2B;IACpD,gBAAgB,EAAE,KAAK;IACvB,mBAAmB,EAAE,KAAK;IAC1B,gBAAgB,EAAE,KAAK;IACvB,gBAAgB,EAAE,KAAK;IACvB,oBAAoB,EAAE,KAAK;IAC3B,sBAAsB,EAAE,KAAK;IAC7B,gBAAgB,EAAE,WAAW;IAC7B,qBAAqB,EAAE,WAAW;IAClC,sBAAsB,EAAE,YAAY;IACpC,qBAAqB,EAAE,YAAY;IACnC,yBAAyB,EAAE,YAAY;IACvC,kBAAkB,EAAE,OAAO;CAC5B,CAAC"}

package/dist/tools/pagespeed.d.ts

@@ -0,0 +1,88 @@
+/**
+ * PageSpeed Insights Tools
+ * Tools for analyzing page performance and Core Web Vitals
+ */
+import { z } from 'zod';
+import type { HeySeoApiClient } from '../utils/api-client.js';
+export declare const analyzePageSpeedSchema: z.ZodObject<{
+    url: z.ZodString;
+    strategy: z.ZodDefault<z.ZodOptional<z.ZodEnum<["mobile", "desktop"]>>>;
+}, "strip", z.ZodTypeAny, {
+    url: string;
+    strategy: "mobile" | "desktop";
+}, {
+    url: string;
+    strategy?: "mobile" | "desktop" | undefined;
+}>;
+export type AnalyzePageSpeedInput = z.infer<typeof analyzePageSpeedSchema>;
+export declare const bulkPageSpeedSchema: z.ZodObject<{
+    urls: z.ZodArray<z.ZodString, "many">;
+    strategy: z.ZodDefault<z.ZodOptional<z.ZodEnum<["mobile", "desktop"]>>>;
+}, "strip", z.ZodTypeAny, {
+    strategy: "mobile" | "desktop";
+    urls: string[];
+}, {
+    urls: string[];
+    strategy?: "mobile" | "desktop" | undefined;
+}>;
+export type BulkPageSpeedInput = z.infer<typeof bulkPageSpeedSchema>;
+/**
+ * Execute PageSpeed analysis tool
+ */
+export declare function executeAnalyzePageSpeed(client: HeySeoApiClient, input: AnalyzePageSpeedInput): Promise<string>;
+/**
+ * Execute bulk PageSpeed analysis
+ */
+export declare function executeBulkPageSpeed(client: HeySeoApiClient, input: BulkPageSpeedInput): Promise<string>;
+/**
+ * PageSpeed tool definitions for MCP
+ */
+export declare const pagespeedTools: ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            url: {
+                type: string;
+                format: string;
+                description: string;
+            };
+            strategy: {
+                type: string;
+                enum: string[];
+                default: string;
+                description: string;
+            };
+            urls?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            urls: {
+                type: string;
+                items: {
+                    type: string;
+                    format: string;
+                };
+                minItems: number;
+                maxItems: number;
+                description: string;
+            };
+            strategy: {
+                type: string;
+                enum: string[];
+                default: string;
+                description: string;
+            };
+            url?: undefined;
+        };
+        required: string[];
+    };
+})[];
+//# sourceMappingURL=pagespeed.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pagespeed.d.ts","sourceRoot":"","sources":["../../src/tools/pagespeed.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAG9D,eAAO,MAAM,sBAAsB;;;;;;;;;EAOjC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAG3E,eAAO,MAAM,mBAAmB;;;;;;;;;EAW9B,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AA8CrE;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,eAAe,EACvB,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAAC,MAAM,CAAC,CAmFjB;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,eAAe,EACvB,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC,MAAM,CAAC,CAqEjB;AAED;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAiE1B,CAAC"}