@heyseo/mcp-server 0.1.3 → 0.2.1

package/dist/tools/site.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Site Management Tools
+ * Tools for selecting and managing the current working site in the MCP context
+ */
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import { z } from 'zod';
+import { HeySeoApiClient } from '../utils/api-client.js';
+/**
+ * List all available sites
+ */
+export declare function executeListSites(client: HeySeoApiClient): Promise<string>;
+/**
+ * Get current selected site
+ */
+export declare function executeGetCurrentSite(client: HeySeoApiClient, siteId?: string): Promise<string>;
+/**
+ * Validate and confirm site selection
+ */
+export declare function executeSelectSite(client: HeySeoApiClient, siteId: string): Promise<string>;
+/**
+ * Site management tool schemas
+ */
+export declare const listSitesSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+export declare const getCurrentSiteSchema: z.ZodObject<{
+    siteId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    siteId?: string | undefined;
+}, {
+    siteId?: string | undefined;
+}>;
+export declare const selectSiteSchema: z.ZodObject<{
+    siteId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    siteId: string;
+}, {
+    siteId: string;
+}>;
+/**
+ * Site management tool definitions
+ */
+export declare const siteTools: Tool[];
+//# sourceMappingURL=site.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"site.d.ts","sourceRoot":"","sources":["../../src/tools/site.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC1D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAmC/E;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAmCrG;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAgChG;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,gDAAe,CAAC;AAE5C,eAAO,MAAM,oBAAoB;;;;;;EAE/B,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;;EAE3B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,SAAS,EAAE,IAAI,EAsC3B,CAAC"}

package/dist/tools/site.js

@@ -0,0 +1,167 @@
+/**
+ * Site Management Tools
+ * Tools for selecting and managing the current working site in the MCP context
+ */
+import { z } from 'zod';
+/**
+ * List all available sites
+ */
+export async function executeListSites(client) {
+    try {
+        const sites = await client.getSites();
+        if (!sites || sites.length === 0) {
+            return JSON.stringify({
+                success: true,
+                data: {
+                    sites: [],
+                    message: 'No sites available. Please add a site first.'
+                }
+            });
+        }
+        const formattedSites = sites.map((site) => ({
+            id: site.id,
+            name: site.name,
+            url: site.url,
+            gscConnected: site.gscConnected !== false,
+            ga4Connected: site.ga4Connected !== false
+        }));
+        return JSON.stringify({
+            success: true,
+            data: {
+                sites: formattedSites,
+                count: formattedSites.length
+            }
+        });
+    }
+    catch (error) {
+        return JSON.stringify({
+            success: false,
+            error: error instanceof Error ? error.message : 'Failed to list sites'
+        });
+    }
+}
+/**
+ * Get current selected site
+ */
+export async function executeGetCurrentSite(client, siteId) {
+    try {
+        if (!siteId) {
+            return JSON.stringify({
+                success: false,
+                error: 'No site currently selected. Use heyseo_select_site to choose a site.'
+            });
+        }
+        const sites = await client.getSites();
+        const site = sites?.find((s) => s.id === siteId);
+        if (!site) {
+            return JSON.stringify({
+                success: false,
+                error: `Site with ID "${siteId}" not found`
+            });
+        }
+        return JSON.stringify({
+            success: true,
+            data: {
+                id: site.id,
+                name: site.name,
+                url: site.url,
+                gscConnected: site.gscConnected !== false,
+                ga4Connected: site.ga4Connected !== false
+            }
+        });
+    }
+    catch (error) {
+        return JSON.stringify({
+            success: false,
+            error: error instanceof Error ? error.message : 'Failed to get current site'
+        });
+    }
+}
+/**
+ * Validate and confirm site selection
+ */
+export async function executeSelectSite(client, siteId) {
+    try {
+        const sites = await client.getSites();
+        const site = sites?.find((s) => s.id === siteId);
+        if (!site) {
+            return JSON.stringify({
+                success: false,
+                error: `Site with ID "${siteId}" not found. Use heyseo_list_sites to see available sites.`
+            });
+        }
+        return JSON.stringify({
+            success: true,
+            data: {
+                selected: true,
+                site: {
+                    id: site.id,
+                    name: site.name,
+                    url: site.url,
+                    gscConnected: site.gscConnected !== false,
+                    ga4Connected: site.ga4Connected !== false
+                },
+                message: `Successfully selected site: ${site.name}. All subsequent operations will use this site.`
+            }
+        });
+    }
+    catch (error) {
+        return JSON.stringify({
+            success: false,
+            error: error instanceof Error ? error.message : 'Failed to select site'
+        });
+    }
+}
+/**
+ * Site management tool schemas
+ */
+export const listSitesSchema = z.object({});
+export const getCurrentSiteSchema = z.object({
+    siteId: z.string().optional().describe('The currently selected site ID')
+});
+export const selectSiteSchema = z.object({
+    siteId: z.string().describe('The ID of the site to select for operations')
+});
+/**
+ * Site management tool definitions
+ */
+export const siteTools = [
+    {
+        name: 'heyseo_list_sites',
+        description: 'List all available sites for the current company. Shows site names, URLs, and connection status for GSC and GA4.',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+            required: []
+        }
+    },
+    {
+        name: 'heyseo_select_site',
+        description: 'Select a specific site to work with for all subsequent SEO operations. This determines which site\'s data will be queried.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                siteId: {
+                    type: 'string',
+                    description: 'The ID of the site to select'
+                }
+            },
+            required: ['siteId']
+        }
+    },
+    {
+        name: 'heyseo_get_current_site',
+        description: 'Get information about the currently selected site. Returns site details and connection status.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                siteId: {
+                    type: 'string',
+                    description: 'The currently selected site ID (stored in context)'
+                }
+            },
+            required: []
+        }
+    }
+];
+//# sourceMappingURL=site.js.map

package/dist/tools/site.js.map

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

package/dist/tools/sitemaps.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Sitemaps Tools
+ * Tools for viewing sitemaps registered in Google Search Console
+ */
+import { z } from 'zod';
+import type { HeySeoApiClient } from '../utils/api-client.js';
+export declare const listSitemapsSchema: z.ZodObject<{
+    siteId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    siteId: string;
+}, {
+    siteId: string;
+}>;
+export type ListSitemapsInput = z.infer<typeof listSitemapsSchema>;
+export declare function executeListSitemaps(client: HeySeoApiClient, input: ListSitemapsInput): Promise<string>;
+export declare const sitemapTools: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            siteId: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+}[];
+//# sourceMappingURL=sitemaps.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sitemaps.d.ts","sourceRoot":"","sources":["../../src/tools/sitemaps.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAE9D,eAAO,MAAM,kBAAkB;;;;;;EAE7B,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEnE,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,eAAe,EACvB,KAAK,EAAE,iBAAiB,GACvB,OAAO,CAAC,MAAM,CAAC,CAoBjB;AAED,eAAO,MAAM,YAAY;;;;;;;;;;;;;GAcxB,CAAC"}

package/dist/tools/sitemaps.js

@@ -0,0 +1,44 @@
+/**
+ * Sitemaps Tools
+ * Tools for viewing sitemaps registered in Google Search Console
+ */
+import { z } from 'zod';
+export const listSitemapsSchema = z.object({
+    siteId: z.string().describe('The ID of the site'),
+});
+export async function executeListSitemaps(client, input) {
+    try {
+        const result = await client.getSitemaps(input.siteId);
+        if (!result.sitemaps || result.sitemaps.length === 0) {
+            return JSON.stringify({
+                success: true,
+                message: 'No sitemaps found registered in Google Search Console for this site.',
+                sitemaps: [],
+            });
+        }
+        return JSON.stringify({
+            success: true,
+            total: result.sitemaps.length,
+            sitemaps: result.sitemaps,
+        }, null, 2);
+    }
+    catch (error) {
+        return JSON.stringify({ success: false, error: error instanceof Error ? error.message : 'Unknown error' });
+    }
+}
+export const sitemapTools = [
+    {
+        name: 'heyseo_list_sitemaps',
+        description: `List all sitemaps registered in Google Search Console for a site.
+
+Returns sitemap URLs with their last download date, submission date, pending status, type (sitemap/sitemap index), and any errors or warnings.`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                siteId: { type: 'string', description: 'The ID of the site' },
+            },
+            required: ['siteId'],
+        },
+    },
+];
+//# sourceMappingURL=sitemaps.js.map

package/dist/tools/sitemaps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sitemaps.js","sourceRoot":"","sources":["../../src/tools/sitemaps.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC;CAClD,CAAC,CAAC;AAIH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,MAAuB,EACvB,KAAwB;IAExB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAEtD,IAAI,CAAC,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACrD,OAAO,IAAI,CAAC,SAAS,CAAC;gBACpB,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,sEAAsE;gBAC/E,QAAQ,EAAE,EAAE;aACb,CAAC,CAAC;QACL,CAAC;QAED,OAAO,IAAI,CAAC,SAAS,CAAC;YACpB,OAAO,EAAE,IAAI;YACb,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM;YAC7B,QAAQ,EAAE,MAAM,CAAC,QAAQ;SAC1B,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE,CAAC,CAAC;IAC7G,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B;QACE,IAAI,EAAE,sBAAsB;QAC5B,WAAW,EAAE;;+IAE8H;QAC3I,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oBAAoB,EAAE;aAC9D;YACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;SACrB;KACF;CACF,CAAC"}

package/dist/tools/tasks.d.ts

@@ -11,17 +11,17 @@ export declare const createTaskSchema: z.ZodObject<{
     priority: z.ZodDefault<z.ZodOptional<z.ZodEnum<["low", "medium", "high"]>>>;
     category: z.ZodDefault<z.ZodOptional<z.ZodEnum<["technical", "content", "links", "ux"]>>>;
 }, "strip", z.ZodTypeAny, {
+    siteId: string;
     title: string;
-    priority: "high" | "medium" | "low";
     category: "technical" | "content" | "links" | "ux";
-    siteId: string;
+    priority: "high" | "medium" | "low";
     description?: string | undefined;
 }, {
-    title: string;
     siteId: string;
+    title: string;
     description?: string | undefined;
-    priority?: "high" | "medium" | "low" | undefined;
     category?: "technical" | "content" | "links" | "ux" | undefined;
+    priority?: "high" | "medium" | "low" | undefined;
 }>;
 export declare const listTasksSchema: z.ZodObject<{
     siteId: z.ZodString;
@@ -31,13 +31,13 @@ export declare const listTasksSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     siteId: string;
     status?: "todo" | "in_progress" | "done" | undefined;
-    priority?: "high" | "medium" | "low" | undefined;
     category?: "technical" | "content" | "links" | "ux" | undefined;
+    priority?: "high" | "medium" | "low" | undefined;
 }, {
     siteId: string;
     status?: "todo" | "in_progress" | "done" | undefined;
-    priority?: "high" | "medium" | "low" | undefined;
     category?: "technical" | "content" | "links" | "ux" | undefined;
+    priority?: "high" | "medium" | "low" | undefined;
 }>;
 export declare const getTaskSchema: z.ZodObject<{
     taskId: z.ZodString;
@@ -55,18 +55,18 @@ export declare const updateTaskSchema: z.ZodObject<{
     category: z.ZodOptional<z.ZodEnum<["technical", "content", "links", "ux"]>>;
 }, "strip", z.ZodTypeAny, {
     taskId: string;
-    title?: string | undefined;
     description?: string | undefined;
     status?: "todo" | "in_progress" | "done" | undefined;
-    priority?: "high" | "medium" | "low" | undefined;
+    title?: string | undefined;
     category?: "technical" | "content" | "links" | "ux" | undefined;
+    priority?: "high" | "medium" | "low" | undefined;
 }, {
     taskId: string;
-    title?: string | undefined;
     description?: string | undefined;
     status?: "todo" | "in_progress" | "done" | undefined;
-    priority?: "high" | "medium" | "low" | undefined;
+    title?: string | undefined;
     category?: "technical" | "content" | "links" | "ux" | undefined;
+    priority?: "high" | "medium" | "low" | undefined;
 }>;
 export declare const deleteTaskSchema: z.ZodObject<{
     taskId: z.ZodString;
@@ -84,21 +84,21 @@ export declare const bulkCreateTasksSchema: z.ZodObject<{
         category: z.ZodDefault<z.ZodOptional<z.ZodEnum<["technical", "content", "links", "ux"]>>>;
     }, "strip", z.ZodTypeAny, {
         title: string;
-        priority: "high" | "medium" | "low";
         category: "technical" | "content" | "links" | "ux";
+        priority: "high" | "medium" | "low";
         description?: string | undefined;
     }, {
         title: string;
         description?: string | undefined;
-        priority?: "high" | "medium" | "low" | undefined;
         category?: "technical" | "content" | "links" | "ux" | undefined;
+        priority?: "high" | "medium" | "low" | undefined;
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
     siteId: string;
     tasks: {
         title: string;
-        priority: "high" | "medium" | "low";
         category: "technical" | "content" | "links" | "ux";
+        priority: "high" | "medium" | "low";
         description?: string | undefined;
     }[];
 }, {
@@ -106,8 +106,8 @@ export declare const bulkCreateTasksSchema: z.ZodObject<{
     tasks: {
         title: string;
         description?: string | undefined;
-        priority?: "high" | "medium" | "low" | undefined;
         category?: "technical" | "content" | "links" | "ux" | undefined;
+        priority?: "high" | "medium" | "low" | undefined;
     }[];
 }>;
 export declare const bulkUpdateTasksSchema: z.ZodObject<{

package/dist/tools/workflows.d.ts

@@ -0,0 +1,53 @@
+/**
+ * SEO Audit Workflow Tools
+ * Composite workflow tools for high-level site analysis
+ */
+import { z } from 'zod';
+import type { HeySeoApiClient } from '../utils/api-client.js';
+export declare const siteAuditSchema: z.ZodObject<{
+    siteId: z.ZodString;
+    days: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    siteId: string;
+    days: number;
+}, {
+    siteId: string;
+    days?: number | undefined;
+}>;
+export type SiteAuditInput = z.infer<typeof siteAuditSchema>;
+/**
+ * Execute site audit workflow
+ * Performs comprehensive SEO audit including GSC, GA4, and opportunities analysis
+ */
+export declare function executeSiteAudit(client: HeySeoApiClient, input: SiteAuditInput): Promise<string>;
+/**
+ * Workflow tool definitions for MCP
+ */
+export declare const workflowTools: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            siteId: {
+                type: string;
+                description: string;
+            };
+            days: {
+                type: string;
+                minimum: number;
+                maximum: number;
+                default: number;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    hints: {
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+    };
+}[];
+//# sourceMappingURL=workflows.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workflows.d.ts","sourceRoot":"","sources":["../../src/tools/workflows.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAI9D,eAAO,MAAM,eAAe;;;;;;;;;EAS1B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE7D;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,eAAe,EACvB,KAAK,EAAE,cAAc,GACpB,OAAO,CAAC,MAAM,CAAC,CAgHjB;AAED;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BzB,CAAC"}

package/dist/tools/workflows.js

@@ -0,0 +1,162 @@
+/**
+ * SEO Audit Workflow Tools
+ * Composite workflow tools for high-level site analysis
+ */
+import { z } from 'zod';
+import { formatResponse, formatErrorResponse } from '../utils/response-formatter.js';
+// Schema for site audit workflow
+export const siteAuditSchema = z.object({
+    siteId: z.string().describe('The ID of the site to audit'),
+    days: z
+        .number()
+        .min(7)
+        .max(90)
+        .optional()
+        .default(28)
+        .describe('Number of days to analyze'),
+});
+/**
+ * Execute site audit workflow
+ * Performs comprehensive SEO audit including GSC, GA4, and opportunities analysis
+ */
+export async function executeSiteAudit(client, input) {
+    try {
+        // Calculate date range
+        const endDate = new Date().toISOString().split('T')[0];
+        const startDate = new Date(Date.now() - input.days * 24 * 60 * 60 * 1000)
+            .toISOString()
+            .split('T')[0];
+        // Fetch all data in parallel
+        const [site, overview, topKeywords, topPages, opportunities] = await Promise.all([
+            client.getSite(input.siteId),
+            client.getSiteOverview(input.siteId, { startDate, endDate }),
+            client.getTopKeywords(input.siteId, { startDate, endDate, limit: 10 }),
+            client.getTopPages(input.siteId, { startDate, endDate, limit: 10 }),
+            client.getOpportunities(input.siteId),
+        ]);
+        // Extract and format GSC metrics
+        const gscRow = overview.gsc.rows[0];
+        const gscMetrics = {
+            clicks: gscRow?.clicks || 0,
+            impressions: gscRow?.impressions || 0,
+            ctr: gscRow ? `${(gscRow.ctr * 100).toFixed(2)}%` : '0%',
+            avgPosition: gscRow?.position.toFixed(1) || 'N/A',
+        };
+        // Extract and format GA4 metrics
+        const ga4Row = overview.ga4[0];
+        const ga4Metrics = {
+            sessions: ga4Row?.metrics?.sessions || 0,
+            activeUsers: ga4Row?.metrics?.activeUsers || 0,
+            bounceRate: ga4Row?.metrics?.bounceRate
+                ? `${(ga4Row.metrics.bounceRate * 100).toFixed(1)}%`
+                : '0%',
+            engagementRate: ga4Row?.metrics?.engagementRate
+                ? `${(ga4Row.metrics.engagementRate * 100).toFixed(1)}%`
+                : '0%',
+        };
+        // Format top keywords
+        const topKeywordsList = topKeywords.rows.slice(0, 10).map((row, index) => ({
+            rank: index + 1,
+            keyword: row.keys[0] || 'N/A',
+            clicks: row.clicks || 0,
+            position: row.position.toFixed(1),
+        }));
+        // Format top pages
+        const topPagesList = topPages.rows.slice(0, 10).map((row, index) => ({
+            rank: index + 1,
+            page: row.keys[0] || 'N/A',
+            clicks: row.clicks || 0,
+            position: row.position.toFixed(1),
+        }));
+        // Count opportunities by type and find high-priority items
+        const opportunitiesByType = {
+            keyword: 0,
+            page: 0,
+            technical: 0,
+            content: 0,
+        };
+        const highPriorityOpportunities = [];
+        for (const opp of opportunities) {
+            const type = opp.type;
+            if (type in opportunitiesByType) {
+                opportunitiesByType[type]++;
+            }
+            if (opp.priority === 'high' && highPriorityOpportunities.length < 5) {
+                highPriorityOpportunities.push({
+                    type: opp.type,
+                    title: opp.title,
+                    priority: opp.priority,
+                });
+            }
+        }
+        // Build audit report
+        const auditReport = {
+            siteInfo: {
+                name: site.name || 'N/A',
+                url: site.url || 'N/A',
+                gscConnected: site.gscConnected,
+                ga4Connected: site.ga4Connected,
+            },
+            period: {
+                startDate,
+                endDate,
+                days: input.days,
+            },
+            metrics: {
+                gsc: gscMetrics,
+                ga4: ga4Metrics,
+            },
+            topKeywords: topKeywordsList,
+            topPages: topPagesList,
+            opportunities: {
+                total: opportunities.length,
+                byType: opportunitiesByType,
+                topPriority: highPriorityOpportunities,
+            },
+        };
+        return formatResponse(true, auditReport, {
+            summary: `Site audit for ${site.name || site.url} completed`,
+            period: { startDate, endDate },
+        });
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+        return formatErrorResponse(errorMessage, 'siteAudit');
+    }
+}
+/**
+ * Workflow tool definitions for MCP
+ */
+export const workflowTools = [
+    {
+        name: 'heyseo_site_audit',
+        description: `Perform comprehensive SEO audit for a site.
+
+Analyzes GSC performance data, GA4 user engagement metrics, top keywords and pages, and SEO opportunities.
+Returns a complete site health assessment with actionable insights.`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                siteId: {
+                    type: 'string',
+                    description: 'The ID of the site to audit',
+                },
+                days: {
+                    type: 'number',
+                    minimum: 7,
+                    maximum: 90,
+                    default: 28,
+                    description: 'Number of days to analyze',
+                },
+            },
+            required: ['siteId'],
+        },
+        hints: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    },
+];
+//# sourceMappingURL=workflows.js.map

package/dist/tools/workflows.js.map

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