@heyseo/mcp-server 0.2.0 → 0.2.1

package/dist/tools/memory.js

@@ -0,0 +1,242 @@
+/**
+ * SEO Memory Tools
+ * Tools for accessing and updating the SEO memory system (strategy, goals, actions, learnings)
+ */
+import { z } from 'zod';
+export const getMemorySchema = z.object({
+    siteId: z.string().describe('The ID of the site'),
+});
+export const updateStrategySchema = z.object({
+    siteId: z.string().describe('The ID of the site'),
+    action: z.enum(['update_summary', 'create_goal', 'update_goal']).describe('The action to perform'),
+    strategySummary: z.string().optional().describe('New strategy summary (for update_summary)'),
+    goalType: z.enum(['clicks', 'position', 'ctr', 'traffic', 'ranking', 'custom']).optional().describe('Goal type (for create_goal)'),
+    goalDescription: z.string().optional().describe('Goal description'),
+    goalTargetValue: z.number().optional().describe('Goal target value'),
+    goalCurrentValue: z.number().optional().describe('Goal current value'),
+    goalTargetDate: z.string().optional().describe('Goal target date (YYYY-MM-DD)'),
+    goalId: z.string().optional().describe('Goal ID (for update_goal)'),
+    goalStatus: z.enum(['active', 'achieved', 'missed', 'paused']).optional().describe('Goal status (for update_goal)'),
+});
+export const recordActionSchema = z.object({
+    siteId: z.string().describe('The ID of the site'),
+    title: z.string().describe('Title of the SEO action taken'),
+    description: z.string().describe('Description of what was done'),
+    category: z.enum(['technical', 'content', 'links', 'ux']).describe('Category of the action'),
+    hypothesis: z.string().optional().describe('What you expect to happen'),
+    targetMetrics: z.array(z.string()).optional().describe('Metrics to track'),
+    measurementDays: z.number().optional().default(28).describe('Days to measure impact'),
+    goalId: z.string().optional().describe('Link to a goal'),
+});
+export const addLearningSchema = z.object({
+    siteId: z.string().describe('The ID of the site'),
+    type: z.enum(['fact', 'pattern']).describe('Type of learning to add'),
+    fact: z.string().optional().describe('A key fact about the site (for type=fact)'),
+    pattern: z.string().optional().describe('A success pattern observed (for type=pattern)'),
+    evidence: z.string().optional().describe('Evidence for the pattern'),
+    applicableCategories: z.array(z.enum(['technical', 'content', 'links', 'ux'])).optional().describe('Which categories this pattern applies to'),
+    confidence: z.enum(['high', 'medium', 'low']).optional().default('low').describe('Confidence level'),
+});
+export async function executeGetMemory(client, input) {
+    try {
+        const context = await client.getMemoryContext(input.siteId);
+        const summary = {
+            success: true,
+            healthTrend: context.healthTrend,
+        };
+        if (context.strategy) {
+            summary.strategy = {
+                summary: context.strategy.strategySummary || '(no strategy set)',
+                activeGoals: context.activeGoals.length,
+                pendingActions: context.pendingActions.length,
+                goals: context.activeGoals.map(g => ({
+                    id: g.id,
+                    type: g.type,
+                    description: g.description,
+                    progress: `${g.progress}%`,
+                    target: g.targetValue,
+                    current: g.currentValue,
+                    status: g.status,
+                })),
+                updatedAt: context.strategy.updatedAt,
+            };
+        }
+        else {
+            summary.strategy = null;
+        }
+        if (context.learnings) {
+            summary.learnings = {
+                keyFactsCount: context.learnings.keyFacts.length,
+                keyFacts: context.learnings.keyFacts.slice(0, 10),
+                successPatternsCount: context.learnings.successPatterns.length,
+                trajectory: context.learnings.trajectory,
+            };
+        }
+        else {
+            summary.learnings = null;
+        }
+        summary.recentSnapshots = context.recentSnapshots.length;
+        return JSON.stringify(summary, null, 2);
+    }
+    catch (error) {
+        return JSON.stringify({ success: false, error: error instanceof Error ? error.message : 'Unknown error' });
+    }
+}
+export async function executeUpdateStrategy(client, input) {
+    try {
+        if (input.action === 'update_summary') {
+            if (!input.strategySummary) {
+                return JSON.stringify({ success: false, error: 'strategySummary is required for update_summary action' });
+            }
+            await client.updateStrategy(input.siteId, input.strategySummary);
+            return JSON.stringify({ success: true, message: 'Strategy summary updated' });
+        }
+        if (input.action === 'create_goal') {
+            if (!input.goalType || !input.goalDescription || input.goalTargetValue === undefined) {
+                return JSON.stringify({ success: false, error: 'goalType, goalDescription, and goalTargetValue are required for create_goal action' });
+            }
+            const goal = await client.createGoal(input.siteId, {
+                type: input.goalType,
+                description: input.goalDescription,
+                targetValue: input.goalTargetValue,
+                currentValue: input.goalCurrentValue,
+                targetDate: input.goalTargetDate,
+            });
+            return JSON.stringify({ success: true, goal }, null, 2);
+        }
+        if (input.action === 'update_goal') {
+            if (!input.goalId) {
+                return JSON.stringify({ success: false, error: 'goalId is required for update_goal action' });
+            }
+            const updates = {};
+            if (input.goalStatus)
+                updates.status = input.goalStatus;
+            if (input.goalCurrentValue !== undefined)
+                updates.currentValue = input.goalCurrentValue;
+            if (input.goalDescription)
+                updates.description = input.goalDescription;
+            if (input.goalTargetValue !== undefined)
+                updates.targetValue = input.goalTargetValue;
+            const goal = await client.updateGoal(input.siteId, input.goalId, updates);
+            return JSON.stringify({ success: true, goal }, null, 2);
+        }
+        return JSON.stringify({ success: false, error: `Unknown action: ${input.action}` });
+    }
+    catch (error) {
+        return JSON.stringify({ success: false, error: error instanceof Error ? error.message : 'Unknown error' });
+    }
+}
+export async function executeRecordAction(client, input) {
+    try {
+        const action = await client.recordAction(input.siteId, {
+            title: input.title,
+            description: input.description,
+            category: input.category,
+            hypothesis: input.hypothesis,
+            targetMetrics: input.targetMetrics,
+            measurementDays: input.measurementDays,
+            goalId: input.goalId,
+        });
+        return JSON.stringify({ success: true, action }, null, 2);
+    }
+    catch (error) {
+        return JSON.stringify({ success: false, error: error instanceof Error ? error.message : 'Unknown error' });
+    }
+}
+export async function executeAddLearning(client, input) {
+    try {
+        const result = await client.addLearning(input.siteId, {
+            type: input.type,
+            fact: input.fact,
+            pattern: input.pattern,
+            evidence: input.evidence,
+            applicableCategories: input.applicableCategories,
+            confidence: input.confidence,
+        });
+        return JSON.stringify({ success: true, ...result }, null, 2);
+    }
+    catch (error) {
+        return JSON.stringify({ success: false, error: error instanceof Error ? error.message : 'Unknown error' });
+    }
+}
+export const memoryTools = [
+    {
+        name: 'heyseo_get_memory',
+        description: `Get the full SEO memory context for a site.
+
+Returns the site's SEO strategy summary, active goals with progress, recent performance snapshots, key learnings (facts and patterns), and overall health trend. This provides persistent context about the site's SEO journey.`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                siteId: { type: 'string', description: 'The ID of the site' },
+            },
+            required: ['siteId'],
+        },
+    },
+    {
+        name: 'heyseo_update_strategy',
+        description: `Update SEO strategy, create goals, or update goal progress.
+
+Actions:
+- update_summary: Set the overall SEO strategy summary
+- create_goal: Create a new SEO goal (clicks, position, CTR, traffic, ranking, custom)
+- update_goal: Update a goal's status or progress`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                siteId: { type: 'string', description: 'The ID of the site' },
+                action: { type: 'string', enum: ['update_summary', 'create_goal', 'update_goal'], description: 'Action to perform' },
+                strategySummary: { type: 'string', description: 'New strategy summary (for update_summary)' },
+                goalType: { type: 'string', enum: ['clicks', 'position', 'ctr', 'traffic', 'ranking', 'custom'], description: 'Goal type' },
+                goalDescription: { type: 'string', description: 'Goal description' },
+                goalTargetValue: { type: 'number', description: 'Goal target value' },
+                goalCurrentValue: { type: 'number', description: 'Current value' },
+                goalTargetDate: { type: 'string', description: 'Target date (YYYY-MM-DD)' },
+                goalId: { type: 'string', description: 'Goal ID (for update_goal)' },
+                goalStatus: { type: 'string', enum: ['active', 'achieved', 'missed', 'paused'], description: 'Goal status' },
+            },
+            required: ['siteId', 'action'],
+        },
+    },
+    {
+        name: 'heyseo_record_action',
+        description: `Record an SEO action that was taken on the site.
+
+Track what changes were made, the hypothesis behind them, and which metrics to monitor. The system will track the action's impact over a measurement period (default 28 days).`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                siteId: { type: 'string', description: 'The ID of the site' },
+                title: { type: 'string', description: 'Title of the action taken' },
+                description: { type: 'string', description: 'Description of the action' },
+                category: { type: 'string', enum: ['technical', 'content', 'links', 'ux'], description: 'Category' },
+                hypothesis: { type: 'string', description: 'What you expect to happen' },
+                targetMetrics: { type: 'array', items: { type: 'string' }, description: 'Metrics to track' },
+                measurementDays: { type: 'number', minimum: 7, maximum: 90, default: 28, description: 'Days to measure' },
+                goalId: { type: 'string', description: 'Link to a goal' },
+            },
+            required: ['siteId', 'title', 'description', 'category'],
+        },
+    },
+    {
+        name: 'heyseo_add_learning',
+        description: `Add a key fact or success pattern to the site's learning memory.
+
+- type=fact: Add a key fact about the site (e.g., "Site migrated to Next.js in January 2025")
+- type=pattern: Add a success pattern observed (e.g., "Long-form guides rank better for informational queries")`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                siteId: { type: 'string', description: 'The ID of the site' },
+                type: { type: 'string', enum: ['fact', 'pattern'], description: 'Type of learning' },
+                fact: { type: 'string', description: 'A key fact (for type=fact)' },
+                pattern: { type: 'string', description: 'A success pattern (for type=pattern)' },
+                evidence: { type: 'string', description: 'Evidence for the pattern' },
+                applicableCategories: { type: 'array', items: { type: 'string', enum: ['technical', 'content', 'links', 'ux'] }, description: 'Applicable categories' },
+                confidence: { type: 'string', enum: ['high', 'medium', 'low'], default: 'low', description: 'Confidence level' },
+            },
+            required: ['siteId', 'type'],
+        },
+    },
+];
+//# sourceMappingURL=memory.js.map

package/dist/tools/memory.js.map

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

package/dist/tools/onpage.d.ts

@@ -0,0 +1,37 @@
+/**
+ * On-Page Audit Tools
+ * Tools for running on-page SEO analysis
+ */
+import { z } from 'zod';
+import type { HeySeoApiClient } from '../utils/api-client.js';
+export declare const onpageAuditSchema: z.ZodObject<{
+    url: z.ZodString;
+    siteId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    url: string;
+    siteId?: string | undefined;
+}, {
+    url: string;
+    siteId?: string | undefined;
+}>;
+export type OnpageAuditInput = z.infer<typeof onpageAuditSchema>;
+export declare function executeOnpageAudit(client: HeySeoApiClient, input: OnpageAuditInput): Promise<string>;
+export declare const onpageTools: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            url: {
+                type: string;
+                description: string;
+            };
+            siteId: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+}[];
+//# sourceMappingURL=onpage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"onpage.d.ts","sourceRoot":"","sources":["../../src/tools/onpage.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,iBAAiB;;;;;;;;;EAG5B,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAEjE,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,eAAe,EACvB,KAAK,EAAE,gBAAgB,GACtB,OAAO,CAAC,MAAM,CAAC,CAWjB;AAED,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;GAuBvB,CAAC"}

package/dist/tools/onpage.js

@@ -0,0 +1,46 @@
+/**
+ * On-Page Audit Tools
+ * Tools for running on-page SEO analysis
+ */
+import { z } from 'zod';
+export const onpageAuditSchema = z.object({
+    url: z.string().describe('The URL to audit'),
+    siteId: z.string().optional().describe('Optional site ID to associate the audit with'),
+});
+export async function executeOnpageAudit(client, input) {
+    try {
+        const result = await client.analyzeOnPage(input.url, input.siteId);
+        return JSON.stringify({
+            success: true,
+            audit: result,
+        }, null, 2);
+    }
+    catch (error) {
+        return JSON.stringify({ success: false, error: error instanceof Error ? error.message : 'Unknown error' });
+    }
+}
+export const onpageTools = [
+    {
+        name: 'heyseo_onpage_audit',
+        description: `Run a full on-page SEO audit on a URL.
+
+Analyzes the page and returns:
+- SEO score (0-100)
+- Meta tags (title, description, Open Graph, Twitter Cards)
+- Heading structure (H1-H6 hierarchy)
+- Word count and content analysis
+- Internal and external links
+- Image optimization (alt text, sizes)
+- Structured data detection
+- Issues found with severity levels`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                url: { type: 'string', description: 'The URL to audit' },
+                siteId: { type: 'string', description: 'Optional site ID to save the audit results' },
+            },
+            required: ['url'],
+        },
+    },
+];
+//# sourceMappingURL=onpage.js.map

package/dist/tools/onpage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"onpage.js","sourceRoot":"","sources":["../../src/tools/onpage.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC;IAC5C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;CACvF,CAAC,CAAC;AAIH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,MAAuB,EACvB,KAAuB;IAEvB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QAEnE,OAAO,IAAI,CAAC,SAAS,CAAC;YACpB,OAAO,EAAE,IAAI;YACb,KAAK,EAAE,MAAM;SACd,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,WAAW,GAAG;IACzB;QACE,IAAI,EAAE,qBAAqB;QAC3B,WAAW,EAAE;;;;;;;;;;oCAUmB;QAChC,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kBAAkB,EAAE;gBACxD,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,4CAA4C,EAAE;aACtF;YACD,QAAQ,EAAE,CAAC,KAAK,CAAC;SAClB;KACF;CACF,CAAC"}

package/dist/tools/reports.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Reports Tools
+ * Tools for accessing AI-generated SEO reports
+ */
+import { z } from 'zod';
+import type { HeySeoApiClient } from '../utils/api-client.js';
+export declare const listReportsSchema: z.ZodObject<{
+    siteId: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodEnum<["weekly", "monthly"]>>;
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    type?: "weekly" | "monthly" | undefined;
+    siteId?: string | undefined;
+}, {
+    type?: "weekly" | "monthly" | undefined;
+    siteId?: string | undefined;
+    limit?: number | undefined;
+}>;
+export type ListReportsInput = z.infer<typeof listReportsSchema>;
+export declare const getReportSchema: z.ZodObject<{
+    reportId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    reportId: string;
+}, {
+    reportId: string;
+}>;
+export type GetReportInput = z.infer<typeof getReportSchema>;
+export declare function executeListReports(client: HeySeoApiClient, input: ListReportsInput): Promise<string>;
+export declare function executeGetReport(client: HeySeoApiClient, input: GetReportInput): Promise<string>;
+export declare const reportTools: ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            siteId: {
+                type: string;
+                description: string;
+            };
+            type: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            limit: {
+                type: string;
+                minimum: number;
+                maximum: number;
+                default: number;
+                description: string;
+            };
+            reportId?: undefined;
+        };
+        required: never[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            reportId: {
+                type: string;
+                description: string;
+            };
+            siteId?: undefined;
+            type?: undefined;
+            limit?: undefined;
+        };
+        required: string[];
+    };
+})[];
+//# sourceMappingURL=reports.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reports.d.ts","sourceRoot":"","sources":["../../src/tools/reports.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,iBAAiB;;;;;;;;;;;;EAI5B,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAEjE,eAAO,MAAM,eAAe;;;;;;EAE1B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE7D,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,eAAe,EACvB,KAAK,EAAE,gBAAgB,GACtB,OAAO,CAAC,MAAM,CAAC,CA2BjB;AAED,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,eAAe,EACvB,KAAK,EAAE,cAAc,GACpB,OAAO,CAAC,MAAM,CAAC,CAmBjB;AAED,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA8BvB,CAAC"}

package/dist/tools/reports.js

@@ -0,0 +1,92 @@
+/**
+ * Reports Tools
+ * Tools for accessing AI-generated SEO reports
+ */
+import { z } from 'zod';
+export const listReportsSchema = z.object({
+    siteId: z.string().optional().describe('Filter reports by site ID'),
+    type: z.enum(['weekly', 'monthly']).optional().describe('Filter by report type'),
+    limit: z.number().min(1).max(50).optional().default(10).describe('Number of reports to return'),
+});
+export const getReportSchema = z.object({
+    reportId: z.string().describe('The ID of the report to retrieve'),
+});
+export async function executeListReports(client, input) {
+    try {
+        const result = await client.getReports(input.siteId, input.type, input.limit);
+        if (result.reports.length === 0) {
+            return JSON.stringify({
+                success: true,
+                message: 'No reports found. Reports are generated automatically based on your schedule settings.',
+                total: 0,
+                reports: [],
+            });
+        }
+        return JSON.stringify({
+            success: true,
+            total: result.total,
+            reports: result.reports.map(r => ({
+                id: r.id,
+                siteId: r.siteId,
+                type: r.type,
+                title: r.title,
+                createdAt: r.createdAt,
+            })),
+        }, null, 2);
+    }
+    catch (error) {
+        return JSON.stringify({ success: false, error: error instanceof Error ? error.message : 'Unknown error' });
+    }
+}
+export async function executeGetReport(client, input) {
+    try {
+        const report = await client.getReport(input.reportId);
+        return JSON.stringify({
+            success: true,
+            report: {
+                id: report.id,
+                siteId: report.siteId,
+                type: report.type,
+                title: report.title,
+                data: report.data,
+                aiAnalysis: report.aiAnalysis,
+                createdAt: report.createdAt,
+            },
+        }, null, 2);
+    }
+    catch (error) {
+        return JSON.stringify({ success: false, error: error instanceof Error ? error.message : 'Unknown error' });
+    }
+}
+export const reportTools = [
+    {
+        name: 'heyseo_list_reports',
+        description: `List AI-generated SEO reports for your sites.
+
+Returns a list of reports with their type, title, and creation date.
+Filter by site ID or report type (weekly/monthly).`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                siteId: { type: 'string', description: 'Filter reports by site ID' },
+                type: { type: 'string', enum: ['weekly', 'monthly'], description: 'Filter by report type' },
+                limit: { type: 'number', minimum: 1, maximum: 50, default: 10, description: 'Number of reports to return' },
+            },
+            required: [],
+        },
+    },
+    {
+        name: 'heyseo_get_report',
+        description: `Get the full details of a specific SEO report.
+
+Returns the complete report including metrics data and AI-generated analysis with insights and recommendations.`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                reportId: { type: 'string', description: 'The ID of the report to retrieve' },
+            },
+            required: ['reportId'],
+        },
+    },
+];
+//# sourceMappingURL=reports.js.map

package/dist/tools/reports.js.map

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

package/dist/tools/serp.d.ts

@@ -0,0 +1,55 @@
+/**
+ * SERP Tools
+ * Tools for searching Google SERP
+ */
+import { z } from 'zod';
+import type { HeySeoApiClient } from '../utils/api-client.js';
+export declare const serpSearchSchema: z.ZodObject<{
+    query: z.ZodString;
+    siteId: z.ZodOptional<z.ZodString>;
+    country: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    numResults: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    query: string;
+    country: string;
+    numResults: number;
+    siteId?: string | undefined;
+}, {
+    query: string;
+    country?: string | undefined;
+    siteId?: string | undefined;
+    numResults?: number | undefined;
+}>;
+export type SerpSearchInput = z.infer<typeof serpSearchSchema>;
+export declare function executeSerpSearch(client: HeySeoApiClient, input: SerpSearchInput): Promise<string>;
+export declare const serpTools: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            query: {
+                type: string;
+                description: string;
+            };
+            siteId: {
+                type: string;
+                description: string;
+            };
+            country: {
+                type: string;
+                default: string;
+                description: string;
+            };
+            numResults: {
+                type: string;
+                minimum: number;
+                maximum: number;
+                default: number;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+}[];
+//# sourceMappingURL=serp.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"serp.d.ts","sourceRoot":"","sources":["../../src/tools/serp.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,gBAAgB;;;;;;;;;;;;;;;EAK3B,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE/D,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,eAAe,EACvB,KAAK,EAAE,eAAe,GACrB,OAAO,CAAC,MAAM,CAAC,CAgBjB;AAED,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiBrB,CAAC"}

package/dist/tools/serp.js

@@ -0,0 +1,47 @@
+/**
+ * SERP Tools
+ * Tools for searching Google SERP
+ */
+import { z } from 'zod';
+export const serpSearchSchema = z.object({
+    query: z.string().describe('The search query to look up'),
+    siteId: z.string().optional().describe('Optional site ID for site presence detection in SERP results'),
+    country: z.string().optional().default('us').describe('Country code (e.g., us, gb, de)'),
+    numResults: z.number().min(1).max(100).optional().default(10).describe('Number of results to return'),
+});
+export async function executeSerpSearch(client, input) {
+    try {
+        const result = await client.searchSerp(input.query, {
+            siteId: input.siteId,
+            country: input.country,
+            numResults: input.numResults,
+        });
+        return JSON.stringify({
+            success: true,
+            query: input.query,
+            ...result,
+        }, null, 2);
+    }
+    catch (error) {
+        return JSON.stringify({ success: false, error: error instanceof Error ? error.message : 'Unknown error' });
+    }
+}
+export const serpTools = [
+    {
+        name: 'heyseo_serp_search',
+        description: `Search Google SERP for a keyword and see the current results.
+
+Returns organic results with position, title, URL, and snippet. Also includes featured snippets, People Also Ask, and related searches. If a siteId is provided, it will detect your site's presence in the results.`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                query: { type: 'string', description: 'The search query' },
+                siteId: { type: 'string', description: 'Optional site ID for presence detection' },
+                country: { type: 'string', default: 'us', description: 'Country code (e.g., us, gb, de)' },
+                numResults: { type: 'number', minimum: 1, maximum: 100, default: 10, description: 'Number of results' },
+            },
+            required: ['query'],
+        },
+    },
+];
+//# sourceMappingURL=serp.js.map

package/dist/tools/serp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serp.js","sourceRoot":"","sources":["../../src/tools/serp.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;IACzD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8DAA8D,CAAC;IACtG,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,iCAAiC,CAAC;IACxF,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,6BAA6B,CAAC;CACtG,CAAC,CAAC;AAIH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAAuB,EACvB,KAAsB;IAEtB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,EAAE;YAClD,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,UAAU,EAAE,KAAK,CAAC,UAAU;SAC7B,CAAC,CAAC;QAEH,OAAO,IAAI,CAAC,SAAS,CAAC;YACpB,OAAO,EAAE,IAAI;YACb,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,GAAG,MAAM;SACV,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,SAAS,GAAG;IACvB;QACE,IAAI,EAAE,oBAAoB;QAC1B,WAAW,EAAE;;qNAEoM;QACjN,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kBAAkB,EAAE;gBAC1D,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yCAAyC,EAAE;gBAClF,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,iCAAiC,EAAE;gBAC1F,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,WAAW,EAAE,mBAAmB,EAAE;aACxG;YACD,QAAQ,EAAE,CAAC,OAAO,CAAC;SACpB;KACF;CACF,CAAC"}