@heyseo/mcp-server 0.1.0

package/README.md

@@ -0,0 +1,284 @@
+# HeySeo MCP Server
+
+Connect your LLM to your SEO data. Query Google Search Console, Google Analytics 4, and PageSpeed Insights directly from Claude, Cursor, or any MCP-compatible client.
+
+## Features
+
+### Tools
+
+| Tool | Description |
+|------|-------------|
+| `heyseo_query_gsc` | Query Google Search Console analytics with custom dimensions and filters |
+| `heyseo_top_keywords` | Get top performing keywords for a site |
+| `heyseo_top_pages` | Get top performing pages for a site |
+| `heyseo_query_ga4` | Query Google Analytics 4 data |
+| `heyseo_landing_pages` | Get landing page performance with engagement metrics |
+| `heyseo_traffic_sources` | Analyze traffic sources and channels |
+| `heyseo_pagespeed` | Run PageSpeed Insights analysis with Core Web Vitals |
+| `heyseo_pagespeed_bulk` | Analyze multiple pages at once |
+| `heyseo_compare_periods` | Compare SEO metrics between two time periods |
+| `heyseo_week_over_week` | Quick week-over-week comparison |
+| `heyseo_find_opportunities` | Discover SEO optimization opportunities |
+| `heyseo_create_task` | Create SEO tasks in HeySeo Kanban |
+
+### Resources
+
+Access your SEO data as readable resources:
+
+- `heyseo://sites` - List all connected sites
+- `heyseo://sites/{id}` - Site details
+- `heyseo://sites/{id}/overview` - Current metrics overview
+- `heyseo://sites/{id}/keywords` - Top 50 keywords
+- `heyseo://sites/{id}/pages` - Top 50 pages
+
+### Prompts
+
+Pre-built prompts for common SEO tasks:
+
+- `seo_audit` - Comprehensive SEO audit
+- `weekly_report` - Weekly performance report
+- `keyword_research` - Keyword analysis and opportunities
+- `content_optimization` - Page optimization recommendations
+- `technical_health_check` - Core Web Vitals and performance
+- `traffic_analysis` - Traffic patterns and sources
+- `quick_wins` - Low-effort, high-impact opportunities
+- `ranking_changes` - Recent ranking changes analysis
+
+## Installation
+
+```bash
+npm install @heyseo/mcp-server
+```
+
+Or clone and build from source:
+
+```bash
+git clone https://github.com/heyseo/mcp-server
+cd mcp-server
+npm install
+npm run build
+```
+
+## Configuration
+
+### Environment Variables
+
+```bash
+# Required: Your HeySeo API key
+HEYSEO_API_KEY=your_api_key_here
+
+# Optional: Custom API URL (defaults to https://heyseo.app)
+HEYSEO_API_URL=https://heyseo.app
+```
+
+### Claude Desktop Configuration
+
+Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):
+
+```json
+{
+  "mcpServers": {
+    "heyseo": {
+      "command": "npx",
+      "args": ["@heyseo/mcp-server"],
+      "env": {
+        "HEYSEO_API_KEY": "your_api_key_here"
+      }
+    }
+  }
+}
+```
+
+Or if installed locally:
+
+```json
+{
+  "mcpServers": {
+    "heyseo": {
+      "command": "node",
+      "args": ["/path/to/mcp-server/dist/index.js"],
+      "env": {
+        "HEYSEO_API_KEY": "your_api_key_here"
+      }
+    }
+  }
+}
+```
+
+### Cursor Configuration
+
+Add to your Cursor settings:
+
+```json
+{
+  "mcp.servers": {
+    "heyseo": {
+      "command": "npx",
+      "args": ["@heyseo/mcp-server"],
+      "env": {
+        "HEYSEO_API_KEY": "your_api_key_here"
+      }
+    }
+  }
+}
+```
+
+## Usage Examples
+
+### Query Top Keywords
+
+```
+User: What are my top 10 keywords this month?
+
+Claude: I'll query your top keywords using HeySeo.
+[Calls heyseo_top_keywords with limit=10]
+
+Here are your top 10 keywords for the last 28 days:
+
+| Rank | Keyword | Clicks | Impressions | CTR | Position |
+|------|---------|--------|-------------|-----|----------|
+| 1 | seo tools | 1,234 | 45,000 | 2.7% | 4.2 |
+| 2 | keyword research | 890 | 32,000 | 2.8% | 5.1 |
+...
+```
+
+### Run SEO Audit
+
+```
+User: Run an SEO audit on my site
+
+Claude: I'll perform a comprehensive SEO audit.
+[Uses seo_audit prompt template]
+[Calls multiple tools: top_keywords, top_pages, find_opportunities]
+
+## SEO Audit Report
+
+### Performance Overview
+- Total Clicks: 15,234 (+12% MoM)
+- Impressions: 456,000 (+8% MoM)
+- Average CTR: 3.3%
+- Average Position: 12.4
+
+### Key Findings
+1. **Quick Wins Found**: 23 keywords with high impressions but low CTR
+2. **Page 2 Opportunities**: 15 keywords ranking positions 11-20
+3. **Underperforming Pages**: 5 pages with >1000 impressions but <2% CTR
+
+### Recommendations
+1. [HIGH] Optimize meta descriptions for top 10 low-CTR pages
+2. [MEDIUM] Expand content on page 2 keywords
+3. [LOW] Add FAQ schema to product pages
+
+Creating tasks for top recommendations...
+```
+
+### Compare Performance
+
+```
+User: How did we do this week vs last week?
+
+Claude: I'll compare your week-over-week performance.
+[Calls heyseo_week_over_week]
+
+## Week-over-Week Comparison
+
+| Metric | Last Week | This Week | Change |
+|--------|-----------|-----------|--------|
+| Clicks | 3,456 | 3,890 | +12.6% |
+| Impressions | 98,000 | 105,000 | +7.1% |
+| CTR | 3.5% | 3.7% | +0.2pp |
+| Position | 11.2 | 10.8 | -0.4 (improved) |
+
+**Top Gainers:**
+- "best seo tool" +45 clicks (+32%)
+- "keyword tracker" +28 clicks (+18%)
+
+**Top Losers:**
+- "seo software" -12 clicks (-8%)
+```
+
+### Analyze Page Speed
+
+```
+User: Check the page speed for our homepage
+
+Claude: I'll analyze your homepage performance.
+[Calls heyseo_pagespeed with url and strategy=mobile]
+
+## PageSpeed Analysis: https://example.com
+
+**Performance Score: 72/100** (Needs Improvement)
+
+### Core Web Vitals
+| Metric | Value | Rating |
+|--------|-------|--------|
+| LCP | 2.8s | Needs Improvement |
+| INP | 120ms | Good |
+| CLS | 0.05 | Good |
+| FCP | 1.2s | Good |
+| TTFB | 0.8s | Good |
+
+### Top Opportunities
+1. **Serve images in next-gen formats** - Save 1.2s
+2. **Eliminate render-blocking resources** - Save 0.8s
+3. **Reduce unused JavaScript** - Save 0.4s
+
+Would you like me to create tasks for these optimizations?
+```
+
+## API Reference
+
+### Getting an API Key
+
+1. Sign up at [heyseo.app](https://heyseo.app)
+2. Connect your Google Search Console and/or GA4 properties
+3. Generate an API key in Settings > API
+
+### Rate Limits
+
+- 100 requests per minute per API key
+- 10,000 requests per day per API key
+
+### Error Handling
+
+All tools return JSON with a `success` field:
+
+```json
+// Success
+{
+  "success": true,
+  "data": { ... }
+}
+
+// Error
+{
+  "success": false,
+  "error": "Error message here"
+}
+```
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Run in development mode
+npm run dev
+
+# Test locally
+HEYSEO_API_KEY=your_key node dist/index.js
+```
+
+## License
+
+MIT
+
+## Support
+
+- Documentation: [docs.heyseo.app](https://docs.heyseo.app)
+- Issues: [GitHub Issues](https://github.com/heyseo/mcp-server/issues)
+- Discord: [HeySeo Community](https://discord.gg/heyseo)

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+/**
+ * HeySeo MCP Server
+ * Model Context Protocol server for connecting LLMs to HeySeo SEO data
+ *
+ * @author HeySeo
+ * @license MIT
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;GAMG"}

package/dist/index.js

@@ -0,0 +1,258 @@
+#!/usr/bin/env node
+/**
+ * HeySeo MCP Server
+ * Model Context Protocol server for connecting LLMs to HeySeo SEO data
+ *
+ * @author HeySeo
+ * @license MIT
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, ListResourcesRequestSchema, ReadResourceRequestSchema, ListPromptsRequestSchema, GetPromptRequestSchema, ErrorCode, McpError, } from '@modelcontextprotocol/sdk/types.js';
+import { createApiClient } from './utils/api-client.js';
+import { allTools, executeQueryGSC, executeTopKeywords, executeTopPages, executeQueryGA4, executeLandingPages, executeTrafficSources, executeAnalyzePageSpeed, executeBulkPageSpeed, executeComparePeriod, executeWeekOverWeek, executeFindOpportunities, executeCreateTask, queryGSCSchema, topKeywordsSchema, topPagesSchema, queryGA4Schema, landingPagesSchema, trafficSourcesSchema, analyzePageSpeedSchema, bulkPageSpeedSchema, comparePeriodSchema, weekOverWeekSchema, findOpportunitiesSchema, createTaskSchema, } from './tools/index.js';
+import { listResources, fetchResource, resourceTemplates } from './resources/index.js';
+import { promptTemplates, generatePromptMessages } from './prompts/index.js';
+// Server info
+const SERVER_NAME = 'heyseo-mcp';
+const SERVER_VERSION = '0.1.0';
+/**
+ * Main MCP Server class
+ */
+class HeySeoMCPServer {
+    server;
+    client = null;
+    constructor() {
+        this.server = new Server({
+            name: SERVER_NAME,
+            version: SERVER_VERSION,
+        }, {
+            capabilities: {
+                tools: {},
+                resources: {},
+                prompts: {},
+            },
+        });
+        this.setupHandlers();
+        this.setupErrorHandling();
+    }
+    /**
+     * Initialize the API client
+     */
+    initClient() {
+        if (!this.client) {
+            this.client = createApiClient();
+        }
+        return this.client;
+    }
+    /**
+     * Setup request handlers
+     */
+    setupHandlers() {
+        // List available tools
+        this.server.setRequestHandler(ListToolsRequestSchema, async () => {
+            return {
+                tools: allTools,
+            };
+        });
+        // Handle tool calls
+        this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
+            const { name, arguments: args } = request.params;
+            const client = this.initClient();
+            try {
+                let result;
+                switch (name) {
+                    // GSC Tools
+                    case 'heyseo_query_gsc': {
+                        const parsed = queryGSCSchema.parse(args);
+                        result = await executeQueryGSC(client, parsed);
+                        break;
+                    }
+                    case 'heyseo_top_keywords': {
+                        const parsed = topKeywordsSchema.parse(args);
+                        result = await executeTopKeywords(client, parsed);
+                        break;
+                    }
+                    case 'heyseo_top_pages': {
+                        const parsed = topPagesSchema.parse(args);
+                        result = await executeTopPages(client, parsed);
+                        break;
+                    }
+                    // GA4 Tools
+                    case 'heyseo_query_ga4': {
+                        const parsed = queryGA4Schema.parse(args);
+                        result = await executeQueryGA4(client, parsed);
+                        break;
+                    }
+                    case 'heyseo_landing_pages': {
+                        const parsed = landingPagesSchema.parse(args);
+                        result = await executeLandingPages(client, parsed);
+                        break;
+                    }
+                    case 'heyseo_traffic_sources': {
+                        const parsed = trafficSourcesSchema.parse(args);
+                        result = await executeTrafficSources(client, parsed);
+                        break;
+                    }
+                    // PageSpeed Tools
+                    case 'heyseo_pagespeed': {
+                        const parsed = analyzePageSpeedSchema.parse(args);
+                        result = await executeAnalyzePageSpeed(client, parsed);
+                        break;
+                    }
+                    case 'heyseo_pagespeed_bulk': {
+                        const parsed = bulkPageSpeedSchema.parse(args);
+                        result = await executeBulkPageSpeed(client, parsed);
+                        break;
+                    }
+                    // Comparison Tools
+                    case 'heyseo_compare_periods': {
+                        const parsed = comparePeriodSchema.parse(args);
+                        result = await executeComparePeriod(client, parsed);
+                        break;
+                    }
+                    case 'heyseo_week_over_week': {
+                        const parsed = weekOverWeekSchema.parse(args);
+                        result = await executeWeekOverWeek(client, parsed);
+                        break;
+                    }
+                    case 'heyseo_find_opportunities': {
+                        const parsed = findOpportunitiesSchema.parse(args);
+                        result = await executeFindOpportunities(client, parsed);
+                        break;
+                    }
+                    // Task Tools
+                    case 'heyseo_create_task': {
+                        const parsed = createTaskSchema.parse(args);
+                        result = await executeCreateTask(client, parsed);
+                        break;
+                    }
+                    default:
+                        throw new McpError(ErrorCode.MethodNotFound, `Unknown tool: ${name}`);
+                }
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: result,
+                        },
+                    ],
+                };
+            }
+            catch (error) {
+                if (error instanceof McpError) {
+                    throw error;
+                }
+                const errorMessage = error instanceof Error ? error.message : 'Unknown error occurred';
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({ success: false, error: errorMessage }),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+        });
+        // List available resources
+        this.server.setRequestHandler(ListResourcesRequestSchema, async () => {
+            try {
+                const client = this.initClient();
+                const resources = await listResources(client);
+                return { resources };
+            }
+            catch {
+                // Return resource templates if we can't fetch actual resources
+                return {
+                    resources: resourceTemplates.map((t) => ({
+                        uri: t.uriTemplate,
+                        name: t.name,
+                        description: t.description,
+                        mimeType: t.mimeType,
+                    })),
+                };
+            }
+        });
+        // Read resource content
+        this.server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+            const { uri } = request.params;
+            const client = this.initClient();
+            try {
+                const { content, mimeType } = await fetchResource(client, uri);
+                return {
+                    contents: [
+                        {
+                            uri,
+                            mimeType,
+                            text: content,
+                        },
+                    ],
+                };
+            }
+            catch (error) {
+                throw new McpError(ErrorCode.InvalidRequest, error instanceof Error ? error.message : 'Failed to read resource');
+            }
+        });
+        // List available prompts
+        this.server.setRequestHandler(ListPromptsRequestSchema, async () => {
+            return {
+                prompts: promptTemplates.map((p) => ({
+                    name: p.name,
+                    description: p.description,
+                    arguments: p.arguments,
+                })),
+            };
+        });
+        // Get prompt content
+        this.server.setRequestHandler(GetPromptRequestSchema, async (request) => {
+            const { name, arguments: args } = request.params;
+            const template = promptTemplates.find((p) => p.name === name);
+            if (!template) {
+                throw new McpError(ErrorCode.InvalidRequest, `Unknown prompt: ${name}`);
+            }
+            // Validate required arguments
+            for (const arg of template.arguments) {
+                if (arg.required && (!args || !args[arg.name])) {
+                    throw new McpError(ErrorCode.InvalidParams, `Missing required argument: ${arg.name}`);
+                }
+            }
+            const messages = generatePromptMessages(name, args || {});
+            return {
+                description: template.description,
+                messages,
+            };
+        });
+    }
+    /**
+     * Setup error handling
+     */
+    setupErrorHandling() {
+        this.server.onerror = (error) => {
+            console.error('[HeySeo MCP Error]', error);
+        };
+        process.on('SIGINT', async () => {
+            await this.server.close();
+            process.exit(0);
+        });
+        process.on('SIGTERM', async () => {
+            await this.server.close();
+            process.exit(0);
+        });
+    }
+    /**
+     * Run the server
+     */
+    async run() {
+        const transport = new StdioServerTransport();
+        await this.server.connect(transport);
+        console.error(`HeySeo MCP Server v${SERVER_VERSION} running on stdio`);
+    }
+}
+// Main entry point
+const server = new HeySeoMCPServer();
+server.run().catch((error) => {
+    console.error('Failed to start HeySeo MCP Server:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/prompts/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * MCP Prompt Templates
+ * Pre-built prompts for common SEO analysis tasks
+ */
+export interface PromptTemplate {
+    name: string;
+    description: string;
+    arguments: Array<{
+        name: string;
+        description: string;
+        required: boolean;
+    }>;
+}
+export declare const promptTemplates: PromptTemplate[];
+/**
+ * Generate prompt messages for a template
+ */
+export declare function generatePromptMessages(templateName: string, args: Record<string, string>): Array<{
+    role: 'user';
+    content: string;
+}>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,KAAK,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,OAAO,CAAC;KACnB,CAAC,CAAC;CACJ;AAED,eAAO,MAAM,eAAe,EAAE,cAAc,EA2H3C,CAAC;AAEF;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC3B,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAuJ1C"}