mcp-wordpress 2.6.4 → 2.7.0

package/dist/tools/seo/SEOToolDefinitions.js

@@ -0,0 +1,385 @@
+/**
+ * SEO Tool Definitions for MCP Registration
+ *
+ * Defines all SEO-related tools with their schemas, descriptions,
+ * and handler functions for the Model Context Protocol.
+ *
+ * @since 2.7.0
+ */
+/**
+ * Analyze content for SEO optimization opportunities
+ */
+export const analyzeContentTool = {
+    name: "wp_seo_analyze_content",
+    description: "Analyze WordPress post content for SEO optimization opportunities including readability, keyword density, structure, and technical factors",
+    inputSchema: {
+        type: "object",
+        properties: {
+            postId: {
+                type: "number",
+                description: "WordPress post ID to analyze",
+            },
+            analysisType: {
+                type: "string",
+                enum: ["readability", "keywords", "structure", "full"],
+                description: "Type of SEO analysis to perform (default: full)",
+            },
+            focusKeywords: {
+                type: "array",
+                items: { type: "string" },
+                description: "Primary keywords to analyze for optimization",
+            },
+            site: {
+                type: "string",
+                description: "Site identifier for multi-site setups",
+            },
+        },
+        required: ["postId"],
+    },
+};
+/**
+ * Generate optimized metadata for posts
+ */
+export const generateMetadataTool = {
+    name: "wp_seo_generate_metadata",
+    description: "Generate SEO-optimized metadata including title tags, meta descriptions, OpenGraph, and Twitter Card data",
+    inputSchema: {
+        type: "object",
+        properties: {
+            postId: {
+                type: "number",
+                description: "WordPress post ID",
+            },
+            title: {
+                type: "string",
+                description: "Custom title to optimize (optional, uses post title if not provided)",
+            },
+            description: {
+                type: "string",
+                description: "Custom description to optimize (optional, uses excerpt if not provided)",
+            },
+            focusKeyword: {
+                type: "string",
+                description: "Primary keyword to include in metadata",
+            },
+            site: {
+                type: "string",
+                description: "Site identifier for multi-site setups",
+            },
+        },
+        required: ["postId"],
+    },
+};
+/**
+ * Bulk update metadata for multiple posts
+ */
+export const bulkUpdateMetadataTool = {
+    name: "wp_seo_bulk_update_metadata",
+    description: "Update SEO metadata for multiple posts with progress tracking and error handling",
+    inputSchema: {
+        type: "object",
+        properties: {
+            postIds: {
+                type: "array",
+                items: { type: "number" },
+                description: "Array of WordPress post IDs to update",
+            },
+            updates: {
+                type: "object",
+                properties: {
+                    title: { type: "string" },
+                    description: { type: "string" },
+                    focusKeyword: { type: "string" },
+                    canonical: { type: "string" },
+                },
+                description: "Metadata fields to update for all posts",
+            },
+            dryRun: {
+                type: "boolean",
+                description: "Perform a dry run without making actual changes",
+            },
+            site: {
+                type: "string",
+                description: "Site identifier for multi-site setups",
+            },
+        },
+        required: ["postIds", "updates"],
+    },
+};
+/**
+ * Generate structured data schema markup
+ */
+export const generateSchemaTool = {
+    name: "wp_seo_generate_schema",
+    description: "Generate JSON-LD structured data schema for enhanced search results",
+    inputSchema: {
+        type: "object",
+        properties: {
+            postId: {
+                type: "number",
+                description: "WordPress post ID",
+            },
+            schemaType: {
+                type: "string",
+                enum: [
+                    "Article",
+                    "Product",
+                    "FAQ",
+                    "HowTo",
+                    "Organization",
+                    "Website",
+                    "BreadcrumbList",
+                    "Event",
+                    "Recipe",
+                    "Course",
+                    "LocalBusiness",
+                    "Person",
+                    "Review",
+                    "VideoObject",
+                ],
+                description: "Type of schema.org structured data to generate",
+            },
+            customData: {
+                type: "object",
+                description: "Additional custom data for the schema",
+            },
+            site: {
+                type: "string",
+                description: "Site identifier for multi-site setups",
+            },
+        },
+        required: ["postId", "schemaType"],
+    },
+};
+/**
+ * Validate schema markup
+ */
+export const validateSchemaTool = {
+    name: "wp_seo_validate_schema",
+    description: "Validate JSON-LD schema markup for correctness and compliance",
+    inputSchema: {
+        type: "object",
+        properties: {
+            schema: {
+                type: "object",
+                description: "JSON-LD schema object to validate",
+            },
+            schemaType: {
+                type: "string",
+                description: "Expected schema type for validation",
+            },
+            useGoogleValidator: {
+                type: "boolean",
+                description: "Use Google's Rich Results Test API for validation",
+            },
+            site: {
+                type: "string",
+                description: "Site identifier for multi-site setups",
+            },
+        },
+        required: ["schema"],
+    },
+};
+/**
+ * Suggest internal linking opportunities
+ */
+export const suggestInternalLinksTool = {
+    name: "wp_seo_suggest_internal_links",
+    description: "Analyze content and suggest relevant internal linking opportunities for better SEO",
+    inputSchema: {
+        type: "object",
+        properties: {
+            postId: {
+                type: "number",
+                description: "WordPress post ID to analyze for linking opportunities",
+            },
+            maxSuggestions: {
+                type: "number",
+                description: "Maximum number of link suggestions (default: 5)",
+            },
+            minimumRelevance: {
+                type: "number",
+                description: "Minimum relevance score (0-100) for suggestions",
+            },
+            site: {
+                type: "string",
+                description: "Site identifier for multi-site setups",
+            },
+        },
+        required: ["postId"],
+    },
+};
+/**
+ * Perform comprehensive site audit
+ */
+export const performSiteAuditTool = {
+    name: "wp_seo_site_audit",
+    description: "Perform comprehensive SEO audit of the WordPress site including technical, content, and performance analysis",
+    inputSchema: {
+        type: "object",
+        properties: {
+            auditType: {
+                type: "string",
+                enum: ["technical", "content", "performance", "full"],
+                description: "Type of audit to perform (default: full)",
+            },
+            maxPages: {
+                type: "number",
+                description: "Maximum number of pages to audit (default: 100)",
+            },
+            includeExternalLinks: {
+                type: "boolean",
+                description: "Include external link validation in audit",
+            },
+            force: {
+                type: "boolean",
+                description: "Force refresh, bypassing cached audit results",
+            },
+            site: {
+                type: "string",
+                description: "Site identifier for multi-site setups",
+            },
+        },
+        required: [],
+    },
+};
+/**
+ * Track SERP positions
+ */
+export const trackSERPPositionsTool = {
+    name: "wp_seo_track_serp",
+    description: "Track search engine result page positions for target keywords",
+    inputSchema: {
+        type: "object",
+        properties: {
+            keywords: {
+                type: "array",
+                items: { type: "string" },
+                description: "Keywords to track positions for",
+            },
+            url: {
+                type: "string",
+                description: "Specific URL to track (optional, uses site home if not provided)",
+            },
+            searchEngine: {
+                type: "string",
+                enum: ["google", "bing", "yahoo"],
+                description: "Search engine to track positions on",
+            },
+            location: {
+                type: "string",
+                description: "Geographic location for localized results",
+            },
+            site: {
+                type: "string",
+                description: "Site identifier for multi-site setups",
+            },
+        },
+        required: ["keywords"],
+    },
+};
+/**
+ * Keyword research and suggestions
+ */
+export const keywordResearchTool = {
+    name: "wp_seo_keyword_research",
+    description: "Research keywords and get suggestions based on topic and competition analysis",
+    inputSchema: {
+        type: "object",
+        properties: {
+            seedKeyword: {
+                type: "string",
+                description: "Seed keyword or topic to research",
+            },
+            includeVariations: {
+                type: "boolean",
+                description: "Include keyword variations and long-tail keywords",
+            },
+            includeQuestions: {
+                type: "boolean",
+                description: "Include question-based keywords",
+            },
+            maxResults: {
+                type: "number",
+                description: "Maximum number of keyword suggestions",
+            },
+            site: {
+                type: "string",
+                description: "Site identifier for multi-site setups",
+            },
+        },
+        required: ["seedKeyword"],
+    },
+};
+/**
+ * Test SEO integration with WordPress
+ */
+export const testSEOIntegrationTool = {
+    name: "wp_seo_test_integration",
+    description: "Test SEO plugin integration and detect available SEO plugins on the WordPress site",
+    inputSchema: {
+        type: "object",
+        properties: {
+            checkPlugins: {
+                type: "boolean",
+                description: "Check which SEO plugins are installed and active",
+            },
+            testMetadataAccess: {
+                type: "boolean",
+                description: "Test ability to read/write SEO metadata",
+            },
+            site: {
+                type: "string",
+                description: "Site identifier for multi-site setups",
+            },
+        },
+        required: [],
+    },
+};
+/**
+ * Get live SEO data from WordPress
+ */
+export const getLiveSEODataTool = {
+    name: "wp_seo_get_live_data",
+    description: "Retrieve live SEO data from WordPress including plugin-specific metadata and configurations",
+    inputSchema: {
+        type: "object",
+        properties: {
+            postId: {
+                type: "number",
+                description: "WordPress post ID to get SEO data for",
+            },
+            includeAnalysis: {
+                type: "boolean",
+                description: "Include SEO analysis of the live data",
+            },
+            includeRecommendations: {
+                type: "boolean",
+                description: "Include optimization recommendations",
+            },
+            site: {
+                type: "string",
+                description: "Site identifier for multi-site setups",
+            },
+        },
+        required: ["postId"],
+    },
+};
+/**
+ * Export all SEO tool definitions
+ */
+export const seoToolDefinitions = [
+    analyzeContentTool,
+    generateMetadataTool,
+    bulkUpdateMetadataTool,
+    generateSchemaTool,
+    validateSchemaTool,
+    suggestInternalLinksTool,
+    performSiteAuditTool,
+    trackSERPPositionsTool,
+    keywordResearchTool,
+    testSEOIntegrationTool,
+    getLiveSEODataTool,
+];
+export default seoToolDefinitions;
+//# sourceMappingURL=SEOToolDefinitions.js.map

package/dist/tools/seo/SEOToolDefinitions.js.map

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

package/dist/tools/seo/SEOTools.d.ts

@@ -0,0 +1,203 @@
+/**
+ * WordPress SEO Tools - Main Module
+ *
+ * This module provides comprehensive SEO management functionality for WordPress
+ * through the MCP protocol. It combines content analysis, metadata generation,
+ * schema markup, and optimization capabilities in a modular architecture.
+ *
+ * Features:
+ * - Content analysis for readability and keyword optimization
+ * - Metadata generation with AI assistance and safety filters
+ * - Schema markup generation and validation
+ * - Internal linking optimization
+ * - Site audits and Core Web Vitals monitoring
+ * - Bulk operations with progress tracking
+ *
+ * @since 2.7.0
+ */
+import type { SEOAnalysisResult, SEOMetadata, SchemaMarkup, SEOToolParams, BulkOperationResult, SiteAuditResult } from "../../types/seo.js";
+/**
+ * Main SEOTools class that provides WordPress SEO management functionality.
+ *
+ * This class serves as the interface between the MCP framework and WordPress
+ * SEO operations. It follows the established pattern of other tool classes
+ * while providing SEO-specific capabilities.
+ *
+ * The class is designed with a modular architecture:
+ * - Analyzers for content evaluation
+ * - Generators for metadata and schema creation
+ * - Validators for ensuring compliance
+ * - Optimizers for performance improvements
+ *
+ * @since 2.7.0
+ */
+export declare class SEOTools {
+    private logger;
+    private clients;
+    private seoClients;
+    private contentAnalyzer;
+    private metaGenerator;
+    private schemaGenerator;
+    private cacheManager;
+    constructor();
+    /**
+     * Analyzes content for SEO optimization opportunities.
+     *
+     * Performs comprehensive analysis including:
+     * - Readability scoring (Flesch-Kincaid)
+     * - Keyword density and distribution
+     * - Content structure evaluation
+     * - Meta tag optimization suggestions
+     *
+     * @param params - Analysis parameters including post ID and analysis type
+     * @returns Detailed SEO analysis with scores and recommendations
+     */
+    analyzeContent(params: SEOToolParams): Promise<SEOAnalysisResult>;
+    /**
+     * Generates optimized metadata for posts.
+     *
+     * Creates SEO-friendly metadata including:
+     * - Title tags (60 character limit)
+     * - Meta descriptions (155-160 characters)
+     * - OpenGraph tags
+     * - Twitter Card metadata
+     *
+     * @param params - Generation parameters including content and constraints
+     * @returns Generated metadata with safety filters applied
+     */
+    generateMetadata(params: SEOToolParams): Promise<SEOMetadata>;
+    /**
+     * Performs bulk metadata updates with progress tracking.
+     *
+     * Handles large-scale metadata updates with:
+     * - Batch processing (10 posts per batch)
+     * - Progress event streaming
+     * - Retry logic with exponential backoff
+     * - Dry-run mode for validation
+     *
+     * @param params - Bulk operation parameters
+     * @returns Operation results with success/failure counts
+     */
+    bulkUpdateMetadata(params: SEOToolParams): Promise<BulkOperationResult>;
+    /**
+     * Generates structured data schema markup.
+     *
+     * Creates JSON-LD schema for:
+     * - Article, Product, FAQ, HowTo
+     * - Organization, Website, BreadcrumbList
+     * - Event, Recipe, Course, and more
+     *
+     * @param params - Schema generation parameters
+     * @returns Valid JSON-LD schema markup
+     */
+    generateSchema(params: SEOToolParams): Promise<SchemaMarkup>;
+    /**
+     * Validates schema markup for correctness.
+     *
+     * Performs validation using:
+     * - Local validation rules
+     * - Google Rich Results Test API (optional)
+     * - Schema.org specifications
+     *
+     * @param params - Validation parameters including schema JSON
+     * @returns Validation results with errors and warnings
+     */
+    validateSchema(params: SEOToolParams): Promise<unknown>;
+    /**
+     * Suggests internal linking opportunities.
+     *
+     * Analyzes content to suggest:
+     * - Related posts for contextual linking
+     * - Anchor text recommendations
+     * - Hub-and-spoke content architectures
+     * - Topical cluster connections
+     *
+     * @param params - Linking parameters including post ID
+     * @returns Internal linking suggestions with confidence scores
+     */
+    suggestInternalLinks(params: SEOToolParams): Promise<unknown>;
+    /**
+     * Performs comprehensive site SEO audit.
+     *
+     * Audits include:
+     * - Technical SEO issues
+     * - Content quality analysis
+     * - Core Web Vitals assessment
+     * - Mobile usability checks
+     * - Structured data validation
+     *
+     * @param params - Audit parameters including scope and depth
+     * @returns Detailed audit results with prioritized recommendations
+     */
+    performSiteAudit(params: SEOToolParams): Promise<SiteAuditResult>;
+    /**
+     * Retrieves all SEO tool definitions for MCP registration.
+     *
+     * @returns Array of SEO tool definitions with handlers
+     */
+    getTools(): unknown[];
+    /**
+     * Maps tool names to their corresponding handler methods.
+     *
+     * @param toolName - Name of the tool
+     * @returns Handler function for the tool
+     * @private
+     */
+    private getHandlerForTool;
+    /**
+     * Gets or creates a WordPress client for the specified site.
+     *
+     * @param site - Site identifier
+     * @returns WordPress client instance
+     * @private
+     */
+    private getSiteClient;
+    /**
+     * Get SEO-enhanced WordPress client for a specific site
+     */
+    private getSEOClient;
+    /**
+     * Retrieves cached result if available.
+     *
+     * @param key - Cache key
+     * @returns Cached result or null
+     * @private
+     */
+    private getCachedResult;
+    /**
+     * Caches a result with specified TTL.
+     *
+     * @param key - Cache key
+     * @param result - Result to cache
+     * @param ttl - Time to live in seconds
+     * @private
+     */
+    private cacheResult;
+    private performAnalysis;
+    private createMetadata;
+    private processBulkUpdate;
+    private createSchema;
+    private performSchemaValidation;
+    private findLinkingOpportunities;
+    /**
+     * Test SEO plugin integration and WordPress API connectivity
+     */
+    testSEOIntegration(params: SEOToolParams): Promise<unknown>;
+    /**
+     * Get live SEO data for multiple posts
+     */
+    getLiveSEOData(params: SEOToolParams & {
+        maxPosts?: number;
+    }): Promise<unknown>;
+    private executeSiteAudit;
+    /**
+     * Generate integration recommendations based on test results
+     */
+    private generateIntegrationRecommendations;
+    /**
+     * Analyze live SEO data for insights
+     */
+    private analyzeLiveSEOData;
+}
+export default SEOTools;
+//# sourceMappingURL=SEOTools.d.ts.map

package/dist/tools/seo/SEOTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SEOTools.d.ts","sourceRoot":"","sources":["../../../src/tools/seo/SEOTools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AA2BH,OAAO,KAAK,EACV,iBAAiB,EACjB,WAAW,EACX,YAAY,EACZ,aAAa,EACb,mBAAmB,EACnB,eAAe,EAChB,MAAM,gBAAgB,CAAC;AAGxB;;;;;;;;;;;;;;GAcG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,OAAO,CAA2C;IAC1D,OAAO,CAAC,UAAU,CAA8C;IAChE,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,YAAY,CAAkB;;IAiBtC;;;;;;;;;;;OAWG;IACG,cAAc,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAiCvE;;;;;;;;;;;OAWG;IACG,gBAAgB,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC;IAsBnE;;;;;;;;;;;OAWG;IACG,kBAAkB,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAsB7E;;;;;;;;;;OAUG;IACG,cAAc,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IAiClE;;;;;;;;;;OAUG;IACG,cAAc,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC;IAoB7D;;;;;;;;;;;OAWG;IACG,oBAAoB,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC;IAsBnE;;;;;;;;;;;;OAYG;IACG,gBAAgB,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,eAAe,CAAC;IA+BvE;;;;OAIG;IACI,QAAQ,IAAI,OAAO,EAAE;IAO5B;;;;;;OAMG;IACH,OAAO,CAAC,iBAAiB;IAuBzB;;;;;;OAMG;IACH,OAAO,CAAC,aAAa;IAYrB;;OAEG;YACW,YAAY;IAiB1B;;;;;;OAMG;YACW,eAAe;IAI7B;;;;;;;OAOG;YACW,WAAW;YAKX,eAAe;YAQf,cAAc;YA0Bd,iBAAiB;YA+BjB,YAAY;YA2BZ,uBAAuB;YAiBvB,wBAAwB;IAiCtC;;OAEG;IACG,kBAAkB,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC;IAgDjE;;OAEG;IACG,cAAc,CAAC,MAAM,EAAE,aAAa,GAAG;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC;YAuDvE,gBAAgB;IAiB9B;;OAEG;IACH,OAAO,CAAC,kCAAkC;IAkD1C;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAiF3B;AAED,eAAe,QAAQ,CAAC"}