claude-plugin-wordpress-manager 2.12.2 → 2.14.0

package/servers/wp-rest-bridge/build/server.js

@@ -9,7 +9,7 @@ const server = new McpServer({
     version: '1.1.0',
 });
 // Register multi-site management tools
-server.tool('switch_site', { site_id: z.string().describe('Site ID to switch to (e.g., "opencactus", "bioinagro")') }, async (args) => {
+server.tool('switch_site', { site_id: z.string().describe('Site ID to switch to (e.g., "mysite", "othersite")') }, async (args) => {
     const { switchSite } = await import('./wordpress.js');
     try {
         const newSite = switchSite(args.site_id);
@@ -36,11 +36,22 @@ function toZodType(prop, isRequired) {
         return prop;
     let zodType;
     switch (prop.type) {
-        case 'string': zodType = z.string(); break;
-        case 'number': case 'integer': zodType = z.number(); break;
-        case 'boolean': zodType = z.boolean(); break;
-        case 'array': zodType = z.array(z.any()); break;
-        case 'object': zodType = z.record(z.any()); break;
+        case 'string':
+            zodType = z.string();
+            break;
+        case 'number':
+        case 'integer':
+            zodType = z.number();
+            break;
+        case 'boolean':
+            zodType = z.boolean();
+            break;
+        case 'array':
+            zodType = z.array(z.any());
+            break;
+        case 'object':
+            zodType = z.record(z.any());
+            break;
         default: zodType = z.any();
     }
     if (prop.description)

package/servers/wp-rest-bridge/build/tools/index.js

@@ -24,9 +24,6 @@ import { plausibleTools, plausibleHandlers } from './plausible.js';
 import { cwvTools, cwvHandlers } from './cwv.js';
 import { slackTools, slackHandlers } from './slack.js';
 import { wcWorkflowTools, wcWorkflowHandlers } from './wc-workflows.js';
-import { linkedinTools, linkedinHandlers } from './linkedin.js';
-import { twitterTools, twitterHandlers } from './twitter.js';
-import { schemaTools, schemaHandlers } from './schema.js';
 // Combine all tools
 export const allTools = [
     ...unifiedContentTools, // 8 tools
@@ -55,9 +52,6 @@ export const allTools = [
     ...cwvTools, // 4 tools
     ...slackTools, // 3 tools
     ...wcWorkflowTools, // 4 tools
-    ...linkedinTools, // 5 tools
-    ...twitterTools, // 5 tools
-    ...schemaTools, // 3 tools
 ];
 // Combine all handlers
 export const toolHandlers = {
@@ -87,7 +81,4 @@ export const toolHandlers = {
     ...cwvHandlers,
     ...slackHandlers,
     ...wcWorkflowHandlers,
-    ...linkedinHandlers,
-    ...twitterHandlers,
-    ...schemaHandlers,
 };

package/servers/wp-rest-bridge/build/tools/plugin-repository.js

@@ -1,4 +1,5 @@
 import { searchWordPressPluginRepository } from '../wordpress.js';
+import axios from 'axios';
 import { z } from 'zod';
 // Define the schema for plugin repository search
 const searchPluginRepositorySchema = z.object({
@@ -70,38 +71,29 @@ export const pluginRepositoryHandlers = {
     },
     get_plugin_details: async (params) => {
         try {
-            // For plugin details, we use a different action in the WordPress.org API
             const apiUrl = 'https://api.wordpress.org/plugins/info/1.2/';
-            const requestData = {
-                action: 'plugin_information',
-                request: {
-                    slug: params.slug,
-                    fields: {
-                        description: true,
-                        sections: true,
-                        tested: true,
-                        requires: true,
-                        rating: true,
-                        ratings: true,
-                        downloaded: true,
-                        downloadlink: true,
-                        last_updated: true,
-                        homepage: true,
-                        tags: true,
-                        compatibility: true,
-                        author: true,
-                        contributors: true,
-                        banners: true,
-                        icons: true
-                    }
-                }
-            };
-            // Use axios directly for this specific request
-            const axios = (await import('axios')).default;
-            const response = await axios.post(apiUrl, requestData, {
-                headers: {
-                    'Content-Type': 'application/json'
-                }
+            // WordPress.org API requires GET with PHP-style bracket notation
+            const response = await axios.get(apiUrl, {
+                params: {
+                    action: 'plugin_information',
+                    'request[slug]': params.slug,
+                    'request[fields][description]': true,
+                    'request[fields][sections]': true,
+                    'request[fields][tested]': true,
+                    'request[fields][requires]': true,
+                    'request[fields][rating]': true,
+                    'request[fields][ratings]': true,
+                    'request[fields][downloaded]': true,
+                    'request[fields][downloadlink]': true,
+                    'request[fields][last_updated]': true,
+                    'request[fields][homepage]': true,
+                    'request[fields][tags]': true,
+                    'request[fields][compatibility]': true,
+                    'request[fields][author]': true,
+                    'request[fields][contributors]': true,
+                    'request[fields][banners]': true,
+                    'request[fields][icons]': true,
+                },
             });
             // Format the plugin details
             const plugin = response.data;

package/servers/wp-rest-bridge/build/tools/schema.js

@@ -1,4 +1,4 @@
-import { makeWordPressRequest, getActiveSite } from '../wordpress.js';
+import { makeWordPressRequest, getActiveSite, getSiteConfig } from '../wordpress.js';
 import axios from 'axios';
 import { z } from 'zod';
 
@@ -73,7 +73,15 @@ export const schemaHandlers = {
                 }
             } else {
                 // Fetch URL and extract ALL JSON-LD blocks
-                const response = await axios.get(url, { timeout: 15000 });
+                let resolvedUrl = url;
+                if (!url.startsWith('http://') && !url.startsWith('https://')) {
+                    const config = getSiteConfig();
+                    const baseUrl = config?.url?.replace(/\/wp-json.*$/, '').replace(/\/$/, '') || '';
+                    if (baseUrl) {
+                        resolvedUrl = baseUrl + (url.startsWith('/') ? url : '/' + url);
+                    }
+                }
+                const response = await axios.get(resolvedUrl, { timeout: 15000 });
                 const html = response.data;
                 const jsonLdRegex = /<script[^>]*type="application\/ld\+json"[^>]*>([\s\S]*?)<\/script>/gi;
                 const allJsonLd = [];

package/servers/wp-rest-bridge/build/tools/unified-content.js

@@ -1,4 +1,4 @@
-import { makeWordPressRequest, logToFile, getActiveSite } from '../wordpress.js';
+import { makeWordPressRequest, logToFile, getActiveSite, getSiteConfig } from '../wordpress.js';
 import { z } from 'zod';
 // Site-aware cache for post types to reduce API calls
 const postTypesCache = new Map();
@@ -35,7 +35,15 @@ function getContentEndpoint(contentType) {
 // Helper function to parse URL and extract slug and potential post type hints
 function parseUrl(url) {
     try {
-        const urlObj = new URL(url);
+        let fullUrl = url;
+        if (!url.startsWith('http://') && !url.startsWith('https://')) {
+            const config = getSiteConfig();
+            const baseUrl = config?.url?.replace(/\/wp-json.*$/, '').replace(/\/$/, '') || '';
+            if (baseUrl) {
+                fullUrl = baseUrl + (url.startsWith('/') ? url : '/' + url);
+            }
+        }
+        const urlObj = new URL(fullUrl);
         const pathname = urlObj.pathname;
         // Remove trailing slash and split path
         const pathParts = pathname.replace(/\/$/, '').split('/').filter(Boolean);

package/servers/wp-rest-bridge/build/wordpress.d.ts

@@ -101,8 +101,5 @@ export declare function hasSlackWebhook(siteId?: string): boolean;
 export declare function getSlackWebhookUrl(siteId?: string): string;
 export declare function hasSlackBot(siteId?: string): boolean;
 export declare function makeSlackBotRequest(method: string, endpoint: string, data?: Record<string, any>, siteId?: string): Promise<any>;
-/**
- * Search the WordPress.org Plugin Repository
- */
 export declare function searchWordPressPluginRepository(searchQuery: string, page?: number, perPage?: number): Promise<any>;
 export {};

package/servers/wp-rest-bridge/build/wordpress.js

@@ -39,8 +39,6 @@ const bufSiteClients = new Map();
 const sgSiteClients = new Map();
 const plSiteClients = new Map();
 const slackBotClients = new Map();
-const liSiteClients = new Map();
-const twSiteClients = new Map();
 let activeSiteId = '';
 const parsedSiteConfigs = new Map();
 const MAX_CONCURRENT_PER_SITE = 5;
@@ -113,14 +111,6 @@ export async function initWordPress() {
             await initSlackBotClient(site.id, site.slack_bot_token);
             logToStderr(`Initialized Slack Bot for site: ${site.id}`);
         }
-        if (site.linkedin_access_token) {
-            await initLinkedInClient(site.id, site.linkedin_access_token);
-            logToStderr(`Initialized LinkedIn for site: ${site.id}`);
-        }
-        if (site.twitter_bearer_token) {
-            await initTwitterClient(site.id, site.twitter_bearer_token);
-            logToStderr(`Initialized Twitter for site: ${site.id}`);
-        }
     }
     activeSiteId = defaultSite || sites[0].id;
     logToStderr(`Active site: ${activeSiteId}`);
@@ -244,30 +234,6 @@ async function initSlackBotClient(id, botToken) {
     });
     slackBotClients.set(id, client);
 }
-async function initLinkedInClient(id, accessToken) {
-    const client = axios.create({
-        baseURL: 'https://api.linkedin.com/rest/',
-        headers: {
-            'Content-Type': 'application/json',
-            'Authorization': `Bearer ${accessToken}`,
-            'LinkedIn-Version': '202401',
-            'X-Restli-Protocol-Version': '2.0.0',
-        },
-        timeout: DEFAULT_TIMEOUT_MS,
-    });
-    liSiteClients.set(id, client);
-}
-async function initTwitterClient(id, bearerToken) {
-    const client = axios.create({
-        baseURL: 'https://api.twitter.com/2/',
-        headers: {
-            'Content-Type': 'application/json',
-            'Authorization': `Bearer ${bearerToken}`,
-        },
-        timeout: DEFAULT_TIMEOUT_MS,
-    });
-    twSiteClients.set(id, client);
-}
 // ── Site Management ──────────────────────────────────────────────────
 /**
  * Get the active site's client, or a specific site's client
@@ -681,73 +647,27 @@ export async function makeSlackBotRequest(method, endpoint, data, siteId) {
         limiter.release();
     }
 }
-// ── LinkedIn Interface ──────────────────────────────────────────
-export function hasLinkedIn(siteId) {
-    const id = siteId || activeSiteId;
-    return liSiteClients.has(id);
-}
-export async function makeLinkedInRequest(method, endpoint, data, siteId) {
-    const id = siteId || activeSiteId;
-    const client = liSiteClients.get(id);
-    if (!client) {
-        throw new Error(`LinkedIn not configured for site "${id}". Add linkedin_access_token to WP_SITES_CONFIG.`);
-    }
-    const limiter = getLimiter(id);
-    await limiter.acquire();
-    try {
-        const response = await client.request({ method, url: endpoint, data: method !== 'GET' ? data : undefined, params: method === 'GET' ? data : undefined });
-        return response.data;
-    }
-    finally {
-        limiter.release();
-    }
-}
-export function getLinkedInPersonUrn(siteId) {
-    const id = siteId || activeSiteId;
-    const sites = JSON.parse(process.env.WP_SITES_CONFIG || '[]');
-    const site = sites.find((s) => s.id === id);
-    if (!site?.linkedin_person_urn) {
-        throw new Error(`LinkedIn person URN not configured for site "${id}". Add linkedin_person_urn to WP_SITES_CONFIG.`);
-    }
-    return site.linkedin_person_urn;
-}
-// ── Twitter/X Interface ─────────────────────────────────────────
-export function hasTwitter(siteId) {
-    const id = siteId || activeSiteId;
-    return twSiteClients.has(id);
-}
-export async function makeTwitterRequest(method, endpoint, data, siteId) {
-    const id = siteId || activeSiteId;
-    const client = twSiteClients.get(id);
-    if (!client) {
-        throw new Error(`Twitter not configured for site "${id}". Add twitter_bearer_token to WP_SITES_CONFIG.`);
-    }
-    const limiter = getLimiter(id);
-    await limiter.acquire();
-    try {
-        const response = await client.request({ method, url: endpoint, data: method !== 'GET' ? data : undefined, params: method === 'GET' ? data : undefined });
-        return response.data;
-    }
-    finally {
-        limiter.release();
-    }
-}
-export function getTwitterUserId(siteId) {
-    const id = siteId || activeSiteId;
-    const sites = JSON.parse(process.env.WP_SITES_CONFIG || '[]');
-    const site = sites.find((s) => s.id === id);
-    if (!site?.twitter_user_id) {
-        throw new Error(`Twitter user ID not configured for site "${id}". Add twitter_user_id to WP_SITES_CONFIG.`);
-    }
-    return site.twitter_user_id;
-}
 // ── Plugin Repository (External API) ────────────────────────────────
 /**
  * Search the WordPress.org Plugin Repository
  */
+// Flatten nested objects into PHP-style bracket notation for query params
+function flattenParams(obj, prefix = '') {
+    const result = {};
+    for (const [key, value] of Object.entries(obj)) {
+        const fullKey = prefix ? `${prefix}[${key}]` : key;
+        if (value !== null && typeof value === 'object' && !Array.isArray(value)) {
+            Object.assign(result, flattenParams(value, fullKey));
+        }
+        else {
+            result[fullKey] = String(value);
+        }
+    }
+    return result;
+}
 export async function searchWordPressPluginRepository(searchQuery, page = 1, perPage = 10) {
     const apiUrl = 'https://api.wordpress.org/plugins/info/1.2/';
-    const requestData = {
+    const params = flattenParams({
         action: 'query_plugins',
         request: {
             search: searchQuery,
@@ -766,9 +686,7 @@ export async function searchWordPressPluginRepository(searchQuery, page = 1, per
                 tags: true,
             },
         },
-    };
-    const response = await axios.post(apiUrl, requestData, {
-        headers: { 'Content-Type': 'application/json' },
     });
+    const response = await axios.get(apiUrl, { params });
     return response.data;
 }

package/servers/wp-rest-bridge/package.json

@@ -21,6 +21,7 @@
     "zod": "^3.24.2"
   },
   "devDependencies": {
+    "@clack/prompts": "^1.0.1",
     "@types/node": "^22.10.0",
     "tsx": "^4.19.0",
     "typescript": "^5.7.0"

package/skills/wp-analytics/SKILL.md

@@ -97,6 +97,15 @@ See `references/traffic-attribution.md`
 - Combining analytics with WooCommerce conversion data
 - Discrepancy analysis between platforms
 
+### Section 7: Signal Feed Generation (Content Intelligence)
+See `references/signals-feed-schema.md`
+- Generating `.content-state/signals-feed.md` from analytics data
+- NormalizedEvent format for GenSignal compatibility
+- Delta calculation against previous period
+- Anomaly detection with configurable threshold (default ±30%)
+- Pattern matching: Search Intent Shift, Early-Adopter Surge, Hype→Utility Crossover
+- Integration with wp-content-pipeline (Phase 1) and wp-editorial-planner (Phase 3)
+
 ## Reference Files
 
 | File | Content |
@@ -106,6 +115,147 @@ See `references/traffic-attribution.md`
 | `references/cwv-monitoring.md` | CWV metric definitions, thresholds, PageSpeed/CrUX APIs |
 | `references/analytics-dashboards.md` | Dashboard patterns, report templates, KPIs, combined data |
 | `references/traffic-attribution.md` | UTM params, source/medium, GA4 + WooCommerce conversions |
+| `references/signals-feed-schema.md` | NormalizedEvent format, delta rules, pattern matching, anomaly detection |
+
+## Signal Feed Generation Workflow
+
+### When to Use
+
+- User asks to "generate signals", "analyze performance and create signals", "run content intelligence"
+- User wants to understand which analytics trends are actionable
+- User mentions GenSignal integration or NormalizedEvent
+- After running a standard analytics report (Sections 1-6), user wants structured output for strategic planning
+
+### Prerequisites
+
+1. At least one analytics service configured (GA4, Plausible, or GSC)
+2. A `.content-state/{site_id}.config.md` exists for the target site
+3. Historical data for at least 2 periods (to calculate deltas)
+
+### Step 7: GENERATE SIGNAL FEED
+
+```
+COLLECT → BASELINE → NORMALIZE → DELTA → ANOMALY → PATTERN → WRITE
+```
+
+**7.1 COLLECT — Gather current period data**
+
+Call the following MCP tools for the requested period (default: last 30 days):
+
+| Tool | Data Collected | Entity Type |
+|------|---------------|-------------|
+| `ga4_top_pages` | Top 20 pages by pageviews, sessions, engagement time | Page |
+| `ga4_traffic_sources` | Source/medium breakdown with sessions, bounce rate | Source |
+| `ga4_report` | Site-level aggregate: total sessions, pageviews, conversions | Site |
+| `gsc_search_analytics` | Top 20 keywords by impressions, clicks, CTR, position | Keyword |
+| `pl_aggregate` | If Plausible configured: visitors, pageviews, bounce_rate | Site (cross-validate) |
+| `cwv_crux_origin` | If CrUX available: LCP, CLS, INP, FCP, TTFB | Site |
+
+Not all tools need to succeed. Generate events only from tools that return data. Record which tools contributed in `source_tools` frontmatter.
+
+**7.2 BASELINE — Load comparison period data**
+
+Read the existing `.content-state/signals-feed.md` if present. Extract the `period` and events to use as baseline for delta calculation.
+
+If no previous feed exists:
+- Call the same tools with date range offset by the period length (e.g., if current period = Feb, baseline = Jan)
+- If baseline tools fail: proceed without deltas (omit `delta_pct` fields)
+
+Record the comparison period in `comparison_period` frontmatter field.
+
+**7.3 NORMALIZE — Map to NormalizedEvent format**
+
+For each data point from 7.1, create a NormalizedEvent:
+
+```yaml
+- entity_id: "{EntityType}:{identifier}"
+  relation: "{metric_name}"
+  value: {numeric_value}
+  unit: "{count|seconds|percentage|position}"
+  ts: "{period_end_ISO8601}"
+  provenance:
+    source_id: "{mcp_tool_name}"
+    site: "{site_id}"
+```
+
+**Entity ID mapping:**
+- GA4 top pages → `Page:{page_path}`
+- GA4 traffic sources → `Source:{source_name}`
+- GA4 site aggregates → `Site:{site_id}`
+- GSC keywords → `Keyword:{query}`
+- CWV metrics → `Site:{site_id}` with relation = metric name
+
+**Relation mapping:**
+- GA4 `screenPageViews` → `pageviews`
+- GA4 `sessions` → `sessions` (page) or `total_sessions` (site)
+- GA4 `averageSessionDuration` → `avg_engagement_time`
+- GA4 `bounceRate` → `bounce_rate`
+- GSC `impressions` → `search_impressions`
+- GSC `clicks` → `search_clicks`
+- GSC `ctr` → `search_ctr`
+- GSC `position` → `search_position`
+- CWV metrics → lowercase (e.g., `lcp`, `cls`, `inp`)
+
+All CWV time-based metrics are normalized to seconds. API values in milliseconds should be divided by 1000.
+
+**7.4 DELTA — Calculate percentage changes**
+
+For each NormalizedEvent, find the matching baseline event (same `entity_id` + `relation`):
+
+```
+delta_pct = round(((current_value - baseline_value) / baseline_value) * 100)
+```
+
+Edge cases:
+- Baseline = 0, current > 0 → `delta_pct: +999`
+- Both = 0 → `delta_pct: 0`
+- No baseline match → omit `delta_pct`
+
+**7.5 ANOMALY — Identify significant changes**
+
+Read `anomaly_threshold` from feed config (default: 30). Filter events where `|delta_pct| >= anomaly_threshold`.
+
+**7.6 PATTERN — Match GenSignal patterns**
+
+Check each anomaly against 3 detectable patterns:
+
+**Search Intent Shift:**
+- Entity is `Keyword:*`
+- Conditions (any): `search_ctr` delta ≥ +20% with `search_position` delta ≤ +5%, OR `search_impressions` delta ≥ +50% on keywords with commercial modifiers, OR `search_impressions` delta ≥ +100% on any keyword
+- Action: "Investigate: content cluster opportunity"
+
+**Early-Adopter Surge:**
+- Entity is `Source:*`
+- Conditions: `referral_sessions` delta ≥ +50% AND site-level `total_sessions` delta < +20%
+- Action: "Scale: increase posting frequency on {source}"
+
+**Hype→Utility Crossover:**
+- Entity is `Page:*`
+- Conditions: `avg_engagement_time` delta ≥ +15% AND `bounce_rate` delta ≤ -10% AND `pageviews` delta between -20% and +10%
+- Action: "Shift: add conversion touchpoints to {page}"
+
+No pattern match → "Unclassified anomaly" / "Review: investigate cause"
+
+**7.7 WRITE — Generate signals-feed.md**
+
+Write `.content-state/signals-feed.md` with YAML frontmatter and organized body sections. See `references/signals-feed-schema.md` for exact format.
+
+**After writing**, present summary to user:
+
+```
+Signal Feed generato per {site_id}:
+- Periodo: {period}
+- Eventi normalizzati: {count}
+- Anomalie rilevate: {anomaly_count}
+- Pattern riconosciuti: {pattern_list}
+
+Anomalie principali:
+1. {entity} — {relation} {delta}% → {pattern}: {action}
+2. ...
+
+Per approfondire un segnale con GenSignal: "approfondisci il segnale N con GenSignal"
+Per creare brief dai segnali: "crea brief per i segnali azionabili"
+```
 
 ## MCP Tools
 
@@ -136,6 +286,7 @@ Use the **`wp-monitoring-agent`** for automated analytics reporting, performance
 - **`wp-content-optimization`** — use analytics data to prioritize content optimization efforts
 - **`wp-content-attribution`** — track content sources and attribute traffic to specific campaigns
 - **`wp-monitoring`** — monitor site uptime and health alongside analytics performance
+- **`wp-content-pipeline`** — use signal insights to create content briefs for publishing
 
 ## Cross-references
 
@@ -143,6 +294,8 @@ Use the **`wp-monitoring-agent`** for automated analytics reporting, performance
 - CWV monitoring feeds into `wp-performance` for technical optimization
 - Traffic attribution connects to `wp-social-email` for campaign tracking
 - Dashboard patterns support `wp-monitoring` alerting workflows
+- Signal feed generation bridges to `wp-content-pipeline` for data-driven content creation
+- GenSignal integration: signals-feed.md is the exchange format between wp-analytics and GenSignal pattern detection
 
 ## Troubleshooting