claude-plugin-wordpress-manager 2.6.0 → 2.9.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +61 -0
- package/agents/wp-monitoring-agent.md +44 -0
- package/agents/wp-site-manager.md +19 -0
- package/docs/GUIDE.md +145 -14
- package/docs/plans/2026-03-01-tier4-5-implementation.md +1783 -0
- package/docs/plans/2026-03-01-tier4-5-observability-automation-design.md +426 -0
- package/docs/plans/2026-03-01-wcop-reassessment-v2.6.0.md +403 -0
- package/hooks/hooks.json +9 -0
- package/package.json +10 -3
- package/servers/wp-rest-bridge/build/tools/cwv.d.ts +3 -0
- package/servers/wp-rest-bridge/build/tools/cwv.js +196 -0
- package/servers/wp-rest-bridge/build/tools/ga4.d.ts +3 -0
- package/servers/wp-rest-bridge/build/tools/ga4.js +323 -0
- package/servers/wp-rest-bridge/build/tools/index.js +15 -0
- package/servers/wp-rest-bridge/build/tools/plausible.d.ts +3 -0
- package/servers/wp-rest-bridge/build/tools/plausible.js +207 -0
- package/servers/wp-rest-bridge/build/tools/slack.d.ts +3 -0
- package/servers/wp-rest-bridge/build/tools/slack.js +129 -0
- package/servers/wp-rest-bridge/build/tools/wc-workflows.d.ts +3 -0
- package/servers/wp-rest-bridge/build/tools/wc-workflows.js +222 -0
- package/servers/wp-rest-bridge/build/wordpress.d.ts +18 -0
- package/servers/wp-rest-bridge/build/wordpress.js +139 -0
- package/skills/wordpress-router/SKILL.md +1 -1
- package/skills/wordpress-router/references/decision-tree.md +8 -2
- package/skills/wp-alerting/SKILL.md +142 -0
- package/skills/wp-alerting/references/alert-thresholds.md +79 -0
- package/skills/wp-alerting/references/escalation-paths.md +92 -0
- package/skills/wp-alerting/references/report-scheduling.md +142 -0
- package/skills/wp-alerting/references/slack-integration.md +109 -0
- package/skills/wp-alerting/scripts/alerting_inspect.mjs +150 -0
- package/skills/wp-analytics/SKILL.md +158 -0
- package/skills/wp-analytics/references/analytics-dashboards.md +83 -0
- package/skills/wp-analytics/references/cwv-monitoring.md +101 -0
- package/skills/wp-analytics/references/ga4-integration.md +76 -0
- package/skills/wp-analytics/references/plausible-setup.md +92 -0
- package/skills/wp-analytics/references/traffic-attribution.md +92 -0
- package/skills/wp-analytics/scripts/analytics_inspect.mjs +153 -0
- package/skills/wp-content-attribution/SKILL.md +1 -0
- package/skills/wp-content-optimization/SKILL.md +1 -0
- package/skills/wp-content-workflows/SKILL.md +142 -0
- package/skills/wp-content-workflows/references/content-lifecycle-hooks.md +131 -0
- package/skills/wp-content-workflows/references/multi-channel-actions.md +151 -0
- package/skills/wp-content-workflows/references/schedule-triggers.md +118 -0
- package/skills/wp-content-workflows/references/trigger-management.md +159 -0
- package/skills/wp-content-workflows/references/wp-action-hooks.md +114 -0
- package/skills/wp-content-workflows/scripts/workflow_inspect.mjs +202 -0
- package/skills/wp-monitoring/SKILL.md +2 -0
- package/skills/wp-search-console/SKILL.md +1 -0
- package/skills/wp-social-email/SKILL.md +1 -0
- package/skills/wp-webhooks/SKILL.md +1 -0
package/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,67 @@
|
|
|
2
2
|
|
|
3
3
|
All notable changes to the WordPress Manager plugin for Claude Code.
|
|
4
4
|
|
|
5
|
+
## [2.9.0] - 2026-03-01
|
|
6
|
+
|
|
7
|
+
### Added — Automated Workflows (WCOP Tier 4+5 Complete)
|
|
8
|
+
- **wp-content-workflows skill** — workflow triggers for scheduled events, content lifecycle hooks, and WP action/filter hooks
|
|
9
|
+
- **4 new MCP tools**: `wf_list_triggers`, `wf_create_trigger`, `wf_update_trigger`, `wf_delete_trigger`
|
|
10
|
+
- **5 reference files**: schedule-triggers, content-lifecycle-hooks, wp-action-hooks, multi-channel-actions, trigger-management
|
|
11
|
+
- **Detection script**: `workflow_inspect.mjs` — detects action channels, automation plugins, custom REST endpoints, WP-Cron config
|
|
12
|
+
- **Safety hook**: PreToolUse confirmation for `wf_delete_trigger` (prevents accidental deletion of active workflows)
|
|
13
|
+
|
|
14
|
+
### Changed
|
|
15
|
+
- **wp-site-manager agent**: added Workflow Automation Management section (6-step procedure), 4 Workflow MCP tools, wp-content-workflows in Related Skills
|
|
16
|
+
- **Router v16**: added 9 workflow keywords and `wp-content-workflows` route
|
|
17
|
+
- **Cross-references**: wp-webhooks → wp-content-workflows, wp-social-email → wp-content-workflows
|
|
18
|
+
|
|
19
|
+
### Metrics
|
|
20
|
+
- Skills: 39 (+1) | MCP tools: 132 (+4) | Reference files: 192 (+5) | Detection scripts: 27 (+1) | Safety hooks: 5 (+1)
|
|
21
|
+
|
|
22
|
+
### WCOP Score (Final)
|
|
23
|
+
| Layer | v2.6.0 | v2.9.0 |
|
|
24
|
+
|-------|--------|--------|
|
|
25
|
+
| Content Factory | 9/10 | 9/10 |
|
|
26
|
+
| Quality Assurance | 9/10 | 9/10 |
|
|
27
|
+
| Distribution | 8/10 | 8/10 |
|
|
28
|
+
| Observability | 7/10 | **9/10** |
|
|
29
|
+
| Automation | 7/10 | **9/10** |
|
|
30
|
+
| **Total** | **8/10** | **8.8/10** |
|
|
31
|
+
|
|
32
|
+
## [2.8.0] - 2026-03-01
|
|
33
|
+
|
|
34
|
+
### Added — Smart Alerting (WCOP Tier 4b)
|
|
35
|
+
- **wp-alerting skill** — severity-based alert routing via Slack and SendGrid
|
|
36
|
+
- **3 new MCP tools**: `slack_send_alert` (webhook), `slack_send_message` (Bot Token + Block Kit), `slack_list_channels`
|
|
37
|
+
- **4 reference files**: slack-integration, alert-thresholds, escalation-paths, report-scheduling
|
|
38
|
+
- **Detection script**: `alerting_inspect.mjs` — detects Slack, SendGrid, monitoring setup
|
|
39
|
+
- **SiteConfig extension**: `slack_webhook_url`, `slack_bot_token`, `slack_channel`
|
|
40
|
+
|
|
41
|
+
### Changed
|
|
42
|
+
- **wp-monitoring-agent**: added Procedure 10 (Alert Dispatch — severity-based routing: info→Slack webhook, warning→Slack Bot + thread, critical→Slack + email), added Alerting MCP Tools section (3 Slack + 2 SendGrid)
|
|
43
|
+
- **Router v15**: added 13 alerting keywords and `wp-alerting` route
|
|
44
|
+
- **Cross-references**: wp-monitoring → wp-alerting + wp-analytics
|
|
45
|
+
|
|
46
|
+
### Metrics
|
|
47
|
+
- Skills: 38 (+1) | MCP tools: 128 (+3) | Reference files: 187 (+4) | Detection scripts: 26 (+1)
|
|
48
|
+
|
|
49
|
+
## [2.7.0] - 2026-03-01
|
|
50
|
+
|
|
51
|
+
### Added — Analytics (WCOP Tier 4a)
|
|
52
|
+
- **wp-analytics skill** — unified analytics: GA4, Plausible, Core Web Vitals
|
|
53
|
+
- **14 new MCP tools**: 6 GA4 (`ga4_run_report`, `ga4_get_realtime`, `ga4_top_pages`, `ga4_traffic_sources`, `ga4_user_demographics`, `ga4_conversion_events`), 4 Plausible (`pl_get_stats`, `pl_get_timeseries`, `pl_get_breakdown`, `pl_get_realtime`), 4 CWV (`cwv_analyze_url`, `cwv_batch_analyze`, `cwv_get_field_data`, `cwv_compare_pages`)
|
|
54
|
+
- **5 reference files**: ga4-integration, plausible-setup, cwv-monitoring, analytics-dashboards, traffic-attribution
|
|
55
|
+
- **Detection script**: `analytics_inspect.mjs` — detects GA4, Plausible, Google API key config
|
|
56
|
+
- **SiteConfig extension**: `ga4_property_id`, `ga4_service_account_key`, `plausible_api_key`, `plausible_base_url`, `google_api_key`
|
|
57
|
+
|
|
58
|
+
### Changed
|
|
59
|
+
- **wp-monitoring-agent**: added Procedure 8 (Analytics Monitoring) and Procedure 9 (CWV Trend Check) with 14 analytics MCP tools
|
|
60
|
+
- **Router v14**: added GA4, Plausible, CWV keywords and route
|
|
61
|
+
- **Cross-references**: wp-search-console, wp-content-attribution, wp-content-optimization → wp-analytics
|
|
62
|
+
|
|
63
|
+
### Metrics
|
|
64
|
+
- Skills: 37 (+1) | MCP tools: 125 (+14) | Reference files: 183 (+5) | Detection scripts: 25 (+1)
|
|
65
|
+
|
|
5
66
|
## [2.6.0] - 2026-03-01
|
|
6
67
|
|
|
7
68
|
### Added
|
|
@@ -54,6 +54,15 @@ You are a WordPress monitoring specialist. You perform comprehensive site health
|
|
|
54
54
|
- **Hosting**: `hosting_listWebsites` — check hosting status and resources
|
|
55
55
|
- **DNS**: `DNS_getDNSRecordsV1` — verify DNS records and email auth (SPF, DKIM, DMARC)
|
|
56
56
|
|
|
57
|
+
### Analytics MCP Tools (`mcp__wp-rest-bridge__ga4_*`, `mcp__wp-rest-bridge__pl_*`, `mcp__wp-rest-bridge__cwv_*`)
|
|
58
|
+
- **GA4**: `ga4_run_report`, `ga4_get_realtime`, `ga4_top_pages`, `ga4_traffic_sources`, `ga4_user_demographics`, `ga4_conversion_events`
|
|
59
|
+
- **Plausible**: `pl_get_stats`, `pl_get_timeseries`, `pl_get_breakdown`, `pl_get_realtime`
|
|
60
|
+
- **CWV**: `cwv_analyze_url`, `cwv_batch_analyze`, `cwv_get_field_data`, `cwv_compare_pages`
|
|
61
|
+
|
|
62
|
+
### Alerting MCP Tools (`mcp__wp-rest-bridge__slack_*`, `mcp__wp-rest-bridge__sg_*`)
|
|
63
|
+
- **Slack**: `slack_send_alert`, `slack_send_message`, `slack_list_channels`
|
|
64
|
+
- **SendGrid**: `sg_send_email`, `sg_send_template_email` (for critical severity email alerts)
|
|
65
|
+
|
|
57
66
|
### External Tools
|
|
58
67
|
- **Bash**: Run health-check scripts, SSL checks, Lighthouse CLI, file integrity scans
|
|
59
68
|
- **WebFetch**: Fetch PageSpeed Insights, check external URLs, verify sitemap
|
|
@@ -133,6 +142,39 @@ Run health assessments across all configured sites and generate a fleet-wide com
|
|
|
133
142
|
- Common configuration drift from baselines
|
|
134
143
|
5. **Generate fleet report** (see Fleet Report template below)
|
|
135
144
|
|
|
145
|
+
### Procedure 8: Analytics Monitoring (Performance Dashboard)
|
|
146
|
+
|
|
147
|
+
1. Fetch traffic data from GA4 (`ga4_top_pages`, `ga4_traffic_sources`) or Plausible (`pl_get_stats`, `pl_get_breakdown`)
|
|
148
|
+
2. Fetch CWV for top pages (`cwv_batch_analyze`)
|
|
149
|
+
3. Fetch keyword data from GSC (`gsc_top_queries`) if available
|
|
150
|
+
4. Correlate: pages with high traffic + Poor CWV = optimization priority
|
|
151
|
+
5. Generate Performance Dashboard Report
|
|
152
|
+
6. If CWV Poor on top pages → recommend delegation to `wp-performance-optimizer`
|
|
153
|
+
|
|
154
|
+
### Procedure 9: CWV Trend Check
|
|
155
|
+
|
|
156
|
+
1. Run `cwv_analyze_url` on homepage and top landing pages
|
|
157
|
+
2. Compare with CWV thresholds (Good: LCP<2.5s, INP<200ms, CLS<0.1)
|
|
158
|
+
3. If available, fetch field data via `cwv_get_field_data` for real-user metrics
|
|
159
|
+
4. Report status (Good/Needs Improvement/Poor) per metric
|
|
160
|
+
5. If any metric is Poor → alert with specific pages and metrics
|
|
161
|
+
|
|
162
|
+
### Procedure 10: Alert Dispatch (Severity-Based Routing)
|
|
163
|
+
|
|
164
|
+
Route monitoring findings to notification channels based on severity. See `wp-alerting` skill for full threshold and escalation configuration.
|
|
165
|
+
|
|
166
|
+
1. **Classify severity** for each finding:
|
|
167
|
+
- **Info**: Plugin updates available, backup completed, minor metric changes
|
|
168
|
+
- **Warning**: LCP > 2.5s, error rate > 2%, disk > 80%, SSL < 30 days
|
|
169
|
+
- **Critical**: Site down, LCP > 4s, error rate > 5%, disk > 95%, security vulnerability
|
|
170
|
+
2. **Dispatch by severity**:
|
|
171
|
+
- **Info** → `slack_send_alert` to general channel (simple text)
|
|
172
|
+
- **Warning** → `slack_send_message` with Block Kit formatting + threaded details
|
|
173
|
+
- **Critical** → `slack_send_message` with `<!channel>` mention + `sg_send_email` to alert recipients
|
|
174
|
+
3. **Deduplication**: Check `{site}:{metric}:{severity}` key against cooldown window (info: 60m, warning: 30m, critical: 10m). Severity escalation bypasses cooldown.
|
|
175
|
+
4. **Recovery**: When a metric returns to normal after an alert, send recovery notification to the same channel/thread.
|
|
176
|
+
5. **Scheduled reports**: Use Procedure 8 output to generate daily/weekly health digests via Slack Block Kit.
|
|
177
|
+
|
|
136
178
|
## Report Generation
|
|
137
179
|
|
|
138
180
|
After completing relevant procedures, generate a report following the templates in `references/reporting-templates.md`:
|
|
@@ -232,3 +274,5 @@ For issues found during monitoring:
|
|
|
232
274
|
- **`wp-audit` skill** — one-time comprehensive audit (security + performance + SEO)
|
|
233
275
|
- **`wp-security` skill** — security hardening procedures
|
|
234
276
|
- **`wp-performance` skill** — backend profiling and optimization
|
|
277
|
+
- **`wp-analytics` skill** — analytics setup, traffic reports, CWV monitoring
|
|
278
|
+
- **`wp-alerting` skill** — alert thresholds, severity routing, Slack/email escalation, scheduled reports
|
|
@@ -52,6 +52,7 @@ Content and data management via WordPress REST API:
|
|
|
52
52
|
- **Comments**: `list_comments`, `get_comment`, `create_comment`, `update_comment`, `delete_comment`
|
|
53
53
|
- **Plugins**: `list_plugins`, `get_plugin`, `activate_plugin`, `deactivate_plugin`, `create_plugin`
|
|
54
54
|
- **WP.org**: `search_plugin_repository`, `get_plugin_details`
|
|
55
|
+
- **Workflows**: `wf_list_triggers`, `wf_create_trigger`, `wf_update_trigger`, `wf_delete_trigger`
|
|
55
56
|
|
|
56
57
|
### 2. Hostinger MCP (`mcp__hostinger-mcp__*`)
|
|
57
58
|
Infrastructure and hosting management:
|
|
@@ -148,11 +149,28 @@ When setting up or managing a multi-language WordPress Multisite network:
|
|
|
148
149
|
|
|
149
150
|
See the `wp-multilang-network` skill for detailed reference files on network architecture, hreflang, content sync, language routing, and international SEO.
|
|
150
151
|
|
|
152
|
+
### Workflow Automation Management
|
|
153
|
+
|
|
154
|
+
Manage automated workflow triggers that connect WordPress events to notification channels.
|
|
155
|
+
|
|
156
|
+
1. **Detect existing workflows**: Run `node skills/wp-content-workflows/scripts/workflow_inspect.mjs` to assess current configuration
|
|
157
|
+
2. **List triggers**: Use `wf_list_triggers` to see all configured workflows, filter by `status` or `type`
|
|
158
|
+
3. **Create trigger**: Use `wf_create_trigger` with:
|
|
159
|
+
- `type`: `schedule` (cron-based), `hook` (WP action/filter), or `content` (post lifecycle)
|
|
160
|
+
- `conditions`: Trigger-specific conditions (cron interval, hook name, post status transition)
|
|
161
|
+
- `actions`: Array of notification actions (Slack, email, webhook) with templates and recipients
|
|
162
|
+
4. **Update trigger**: Use `wf_update_trigger` to modify conditions, actions, or status (activate/deactivate)
|
|
163
|
+
5. **Delete trigger**: Use `wf_delete_trigger` — requires user confirmation via safety hook
|
|
164
|
+
6. **Test trigger**: Create with `status: "inactive"`, review configuration, then update to `status: "active"`
|
|
165
|
+
|
|
166
|
+
See the `wp-content-workflows` skill for reference files on schedule patterns, content lifecycle hooks, WP action hooks, multi-channel actions, and trigger management.
|
|
167
|
+
|
|
151
168
|
### Safety Rules
|
|
152
169
|
- NEVER delete content without explicit user confirmation
|
|
153
170
|
- NEVER deactivate plugins without listing dependencies first
|
|
154
171
|
- NEVER modify published content status without confirmation
|
|
155
172
|
- Always show a summary of changes before executing bulk operations
|
|
173
|
+
- NEVER delete workflow triggers without explicit user confirmation (safety hook enforced)
|
|
156
174
|
|
|
157
175
|
## Specialized Agents
|
|
158
176
|
|
|
@@ -176,3 +194,4 @@ For domain-specific tasks, delegate to specialized agents:
|
|
|
176
194
|
|
|
177
195
|
- **`wp-multisite` skill** — multisite network management with 10 MCP tools
|
|
178
196
|
- **`wp-multilang-network` skill** — multi-language network orchestration (hreflang, content sync, international SEO)
|
|
197
|
+
- **`wp-content-workflows` skill** — workflow triggers, scheduled events, content lifecycle automation
|
package/docs/GUIDE.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# WordPress Manager - Guida Completa per Utenti e Amministratori
|
|
2
2
|
|
|
3
|
-
**Versione:** 2.
|
|
3
|
+
**Versione:** 2.9.0
|
|
4
4
|
**Ultimo aggiornamento:** 2026-03-01
|
|
5
5
|
**Repository:** https://github.com/morrealev/wordpress-manager
|
|
6
6
|
|
|
@@ -66,6 +66,9 @@ WordPress Manager e un plugin per **Claude Code** (la CLI ufficiale di Anthropic
|
|
|
66
66
|
- **Distribuzione social/email**: distribuire contenuti su Mailchimp, Buffer e SendGrid con workflow multi-canale
|
|
67
67
|
- **Google Search Console**: monitorare keyword, indicizzazione, performance pagine e feedback SEO da GSC
|
|
68
68
|
- **Ottimizzazione contenuti AI**: headline scoring, readability analysis, SEO scoring, meta optimization, content freshness e bulk triage
|
|
69
|
+
- **Analytics unificata**: GA4, Plausible e Core Web Vitals in un unico punto di accesso, con dashboard, trend e confronto pagine
|
|
70
|
+
- **Smart alerting**: routing alerting basato su severity (info→Slack webhook, warning→Slack Bot con thread, critical→Slack + email) via Slack e SendGrid
|
|
71
|
+
- **Workflow automatizzati**: trigger basati su schedule (cron), hook WordPress e lifecycle contenuti con azioni multi-canale (Slack, email, webhook)
|
|
69
72
|
|
|
70
73
|
### Requisiti
|
|
71
74
|
|
|
@@ -102,7 +105,7 @@ WordPress Manager e un plugin per **Claude Code** (la CLI ufficiale di Anthropic
|
|
|
102
105
|
### Componenti del Plugin
|
|
103
106
|
|
|
104
107
|
```
|
|
105
|
-
wordpress-manager/ # v2.
|
|
108
|
+
wordpress-manager/ # v2.9.0
|
|
106
109
|
+-- .claude-plugin/plugin.json # Manifest
|
|
107
110
|
+-- .mcp.json # Server MCP bundled
|
|
108
111
|
+-- LICENSE # MIT + GPL-2.0-or-later
|
|
@@ -122,7 +125,7 @@ wordpress-manager/ # v2.6.0
|
|
|
122
125
|
| +-- wp-distribution-manager.md # Multi-channel distribution (v2.4.0)
|
|
123
126
|
+-- commands/ # 5 slash commands
|
|
124
127
|
| +-- wp-status.md / wp-deploy.md / wp-audit.md / wp-backup.md / wp-setup.md
|
|
125
|
-
+-- skills/ #
|
|
128
|
+
+-- skills/ # 39 skill totali
|
|
126
129
|
| +-- [OPERATIVE - 5 skill]
|
|
127
130
|
| +-- wp-deploy/ # Procedure deploy
|
|
128
131
|
| +-- wp-audit/ # Checklist audit
|
|
@@ -132,7 +135,7 @@ wordpress-manager/ # v2.6.0
|
|
|
132
135
|
| +-- [AMBIENTE LOCALE - 1 skill]
|
|
133
136
|
| +-- wp-local-env/ # Studio/LocalWP/wp-env
|
|
134
137
|
| +-- [SVILUPPO - 13 skill da WordPress/agent-skills]
|
|
135
|
-
| +-- wordpress-router/ # Router unificato
|
|
138
|
+
| +-- wordpress-router/ # Router unificato v16 (dev + local + ops + multisite + cicd + monitoring + webhooks + repurposing + pseo + attribution + multilang + distribution + gsc + content-optimization + analytics + alerting + workflows)
|
|
136
139
|
| +-- wp-project-triage/ # Auto-detect tipo progetto
|
|
137
140
|
| +-- wp-block-development/ # Blocchi Gutenberg
|
|
138
141
|
| +-- wp-block-themes/ # Temi a blocchi
|
|
@@ -166,8 +169,12 @@ wordpress-manager/ # v2.6.0
|
|
|
166
169
|
| +-- wp-social-email/ # Distribuzione social/email multi-canale (v2.4.0)
|
|
167
170
|
| +-- wp-search-console/ # Google Search Console integration (v2.5.0)
|
|
168
171
|
| +-- wp-content-optimization/ # AI content optimization e bulk triage (v2.6.0)
|
|
169
|
-
+--
|
|
170
|
-
| +--
|
|
172
|
+
| +-- [ANALYTICS + ALERTING + AUTOMAZIONE - 3 skill]
|
|
173
|
+
| +-- wp-analytics/ # GA4, Plausible, Core Web Vitals unificati (v2.7.0)
|
|
174
|
+
| +-- wp-alerting/ # Smart alerting severity-based via Slack/SendGrid (v2.8.0)
|
|
175
|
+
| +-- wp-content-workflows/ # Workflow triggers (schedule, lifecycle, hooks) con azioni multi-canale (v2.9.0)
|
|
176
|
+
+-- hooks/ # 10 hook di sicurezza
|
|
177
|
+
| +-- hooks.json # 8 prompt + 2 command
|
|
171
178
|
| +-- scripts/ # Script per hook command-type
|
|
172
179
|
+-- scripts/ # Utility
|
|
173
180
|
+-- servers/wp-rest-bridge/ # MCP Server custom (TypeScript)
|
|
@@ -358,6 +365,9 @@ WordPress Manager comprende richieste in linguaggio naturale. Ecco come formular
|
|
|
358
365
|
| Distribuzione social/email | "Distribuisci il post" / "Mailchimp campaign" / "Buffer schedule" / "SendGrid email" |
|
|
359
366
|
| Google Search Console | "Keyword tracking" / "Search analytics" / "Indicizzazione" / "GSC performance" |
|
|
360
367
|
| Ottimizzazione contenuti | "Ottimizza titoli" / "Headline score" / "Readability" / "Content triage" / "Quick wins" |
|
|
368
|
+
| Analytics unificata | "GA4 report" / "Plausible stats" / "Core Web Vitals" / "Traffic sources" / "Page performance" |
|
|
369
|
+
| Smart alerting | "Configura alert Slack" / "Notifica critiche" / "Severity routing" / "Alert su Slack" |
|
|
370
|
+
| Workflow automatizzati | "Crea trigger" / "Workflow cron" / "Automatizza notifiche" / "Content lifecycle trigger" |
|
|
361
371
|
|
|
362
372
|
---
|
|
363
373
|
|
|
@@ -815,7 +825,7 @@ Complementa `wp-security-auditor`: l'auditor **trova** i problemi, l'hardener **
|
|
|
815
825
|
| Ruolo | Monitoring continuo del sito (read-only, non modifica nulla) |
|
|
816
826
|
| Attivazione | "Monitora il sito", "health report", "uptime check", "performance trend", "security scan periodico", "fleet health", "monitora tutti i siti" |
|
|
817
827
|
|
|
818
|
-
**
|
|
828
|
+
**8 aree di monitoraggio + fleet**:
|
|
819
829
|
|
|
820
830
|
| Area | Cosa monitora |
|
|
821
831
|
|------|--------------|
|
|
@@ -825,6 +835,9 @@ Complementa `wp-security-auditor`: l'auditor **trova** i problemi, l'hardener **
|
|
|
825
835
|
| Content | Modifiche non autorizzate, broken links, spam comments, media integrity |
|
|
826
836
|
| Alerting | Threshold P0-P3, notifiche email/Slack/webhook, escalation |
|
|
827
837
|
| Fleet (v2.2.0) | Cross-site health comparison, fleet-wide patterns, per-site breakdown |
|
|
838
|
+
| Analytics (v2.7.0) | GA4 report, Plausible stats, traffic sources, user demographics, conversion events |
|
|
839
|
+
| CWV Trend (v2.7.0) | Core Web Vitals trend analysis, field data, page comparison |
|
|
840
|
+
| Alert Dispatch (v2.8.0) | Severity-based routing: info→Slack webhook, warning→Slack Bot + thread, critical→Slack + email |
|
|
828
841
|
|
|
829
842
|
**Report disponibili**: Daily Health Summary, Weekly Performance, Monthly Security, Quarterly Trend, Executive Dashboard, Fleet Health Report (v2.2.0).
|
|
830
843
|
|
|
@@ -838,7 +851,7 @@ Complementa `wp-security-auditor`: l'auditor **trova** i problemi, l'hardener **
|
|
|
838
851
|
|
|
839
852
|
**Detection**: `monitoring_inspect.mjs` rileva setup monitoring esistente (uptime tools, Lighthouse CI, security plugins, logging config).
|
|
840
853
|
|
|
841
|
-
**Skill correlata**: `wp-monitoring`
|
|
854
|
+
**Skill correlata**: `wp-monitoring`, `wp-analytics`, `wp-alerting`
|
|
842
855
|
|
|
843
856
|
---
|
|
844
857
|
|
|
@@ -934,10 +947,11 @@ Le skill di sviluppo provengono da due fonti:
|
|
|
934
947
|
- **6 skill e-commerce + infrastruttura** (MIT) aggiunte in v1.8.0-v2.2.0: WooCommerce, Multisite, CI/CD, Monitoring, Content Repurposing, Webhooks.
|
|
935
948
|
- **3 skill strategia + SEO internazionale** (MIT) aggiunte in v2.3.0: Programmatic SEO, Content-Commerce Attribution, Multi-Language Network.
|
|
936
949
|
- **3 skill distribuzione + SEO avanzato** (MIT) aggiunte in v2.4.0-v2.6.0: Social/Email Distribution, Google Search Console, AI Content Optimization.
|
|
950
|
+
- **3 skill analytics + alerting + automazione** (MIT) aggiunte in v2.7.0-v2.9.0: Analytics (GA4/Plausible/CWV), Smart Alerting (Slack/SendGrid severity routing), Automated Workflows (triggers + multi-channel actions).
|
|
937
951
|
|
|
938
952
|
### Il Router Unificato
|
|
939
953
|
|
|
940
|
-
La skill `wordpress-router` (
|
|
954
|
+
La skill `wordpress-router` (v16) e il punto d'ingresso per tutti i task WordPress. Classifica automaticamente il task in **diciassette categorie**: sviluppo, ambiente locale, operativo, multisite, CI/CD, monitoring, content repurposing, webhook, programmatic SEO, content attribution, multi-language network, social/email distribution, search console, content optimization, analytics, alerting, content workflows.
|
|
941
955
|
|
|
942
956
|
```
|
|
943
957
|
Utente: "Crea un blocco custom per la gallery"
|
|
@@ -1061,6 +1075,30 @@ wordpress-router: TASK = operativo (content optimization)
|
|
|
1061
1075
|
wp-content-optimization skill + wp-content-strategist agent
|
|
1062
1076
|
```
|
|
1063
1077
|
|
|
1078
|
+
```
|
|
1079
|
+
Utente: "Mostrami il report GA4 e le Core Web Vitals del mio sito"
|
|
1080
|
+
|
|
|
1081
|
+
wordpress-router: TASK = operativo (analytics)
|
|
1082
|
+
|
|
|
1083
|
+
wp-analytics skill + wp-monitoring-agent agent
|
|
1084
|
+
```
|
|
1085
|
+
|
|
1086
|
+
```
|
|
1087
|
+
Utente: "Configura un alert Slack quando il sito va giu"
|
|
1088
|
+
|
|
|
1089
|
+
wordpress-router: TASK = operativo (alerting)
|
|
1090
|
+
|
|
|
1091
|
+
wp-alerting skill + wp-monitoring-agent agent
|
|
1092
|
+
```
|
|
1093
|
+
|
|
1094
|
+
```
|
|
1095
|
+
Utente: "Crea un trigger che invia su Slack quando un post viene pubblicato"
|
|
1096
|
+
|
|
|
1097
|
+
wordpress-router: TASK = operativo (content workflows)
|
|
1098
|
+
|
|
|
1099
|
+
wp-content-workflows skill + wp-site-manager agent
|
|
1100
|
+
```
|
|
1101
|
+
|
|
1064
1102
|
### Panoramica Skills di Sviluppo — Community (13)
|
|
1065
1103
|
|
|
1066
1104
|
| Skill | Si attiva quando... | Risorse |
|
|
@@ -1126,9 +1164,19 @@ Aggiunte in v2.4.0-v2.6.0, queste skill coprono distribuzione multi-canale, Goog
|
|
|
1126
1164
|
| `wp-search-console` | "Search Console", "keyword tracking", "indicizzazione", "GSC", "search analytics" | 5 reference files, search_console_inspect.mjs | `wp-content-strategist` |
|
|
1127
1165
|
| `wp-content-optimization` | "ottimizza titoli", "readability", "headline score", "content triage", "meta optimization" | 5 reference files, content_optimization_inspect.mjs | `wp-content-strategist` |
|
|
1128
1166
|
|
|
1167
|
+
### Panoramica Skills Analytics + Alerting + Automazione (3)
|
|
1168
|
+
|
|
1169
|
+
Aggiunte in v2.7.0-v2.9.0, queste skill completano il WCOP (WordPress Content Operations Pipeline) portando il punteggio da 8/10 a 8.8/10.
|
|
1170
|
+
|
|
1171
|
+
| Skill | Si attiva quando... | Risorse | Agent dedicato |
|
|
1172
|
+
|-------|---------------------|---------|----------------|
|
|
1173
|
+
| `wp-analytics` | "GA4 report", "Plausible stats", "Core Web Vitals", "traffic sources", "page performance", "conversion events" | 5 reference files, analytics_inspect.mjs | `wp-monitoring-agent` |
|
|
1174
|
+
| `wp-alerting` | "alert Slack", "notifica critiche", "severity routing", "escalation", "alert email" | 4 reference files, alerting_inspect.mjs | `wp-monitoring-agent` |
|
|
1175
|
+
| `wp-content-workflows` | "crea trigger", "workflow cron", "content lifecycle", "automatizza notifiche", "trigger schedule" | 5 reference files, workflow_inspect.mjs | `wp-site-manager` |
|
|
1176
|
+
|
|
1129
1177
|
### Script di Rilevamento Automatico
|
|
1130
1178
|
|
|
1131
|
-
Le skill includono
|
|
1179
|
+
Le skill includono 27 script Node.js (`.mjs`) che eseguono analisi automatica del progetto:
|
|
1132
1180
|
|
|
1133
1181
|
| Script | Cosa rileva |
|
|
1134
1182
|
|--------|-------------|
|
|
@@ -1156,6 +1204,9 @@ Le skill includono 24 script Node.js (`.mjs`) che eseguono analisi automatica de
|
|
|
1156
1204
|
| `distribution_inspect.mjs` | Mailchimp, Buffer, SendGrid config, API keys, servizi attivi (v2.4.0) |
|
|
1157
1205
|
| `search_console_inspect.mjs` | GSC service account, siti verificati, sitemap, keyword data (v2.5.0) |
|
|
1158
1206
|
| `content_optimization_inspect.mjs` | Content volume, titoli, meta description, readability readiness (v2.6.0) |
|
|
1207
|
+
| `analytics_inspect.mjs` | GA4 property ID, Plausible config, Google API key, analytics setup (v2.7.0) |
|
|
1208
|
+
| `alerting_inspect.mjs` | Slack webhook/bot token, SendGrid config, monitoring setup, alert readiness (v2.8.0) |
|
|
1209
|
+
| `workflow_inspect.mjs` | Action channel config, automation plugins, custom REST endpoints, WP-Cron, webhook config (v2.9.0) |
|
|
1159
1210
|
|
|
1160
1211
|
### WordPress Playground — Ambienti Disposable
|
|
1161
1212
|
|
|
@@ -1190,7 +1241,7 @@ Senza il server MCP, la skill usa conoscenza generale di `@wordpress/components`
|
|
|
1190
1241
|
```
|
|
1191
1242
|
1. cd mio-progetto-wordpress/
|
|
1192
1243
|
2. Claude esegue wp-project-triage → rileva "wp-block-plugin"
|
|
1193
|
-
3. wordpress-router
|
|
1244
|
+
3. wordpress-router v16 → instrada a wp-block-development
|
|
1194
1245
|
4. Claude guida la creazione con block.json, edit.js, save.js
|
|
1195
1246
|
5. wp-e2e-testing + wp-test-engineer → esegue test E2E con Playwright
|
|
1196
1247
|
6. wp-accessibility + wp-accessibility-auditor → verifica WCAG 2.2
|
|
@@ -1271,6 +1322,7 @@ Questi hook chiedono a Claude di valutare se l'operazione e stata esplicitamente
|
|
|
1271
1322
|
| 5 | Eliminazione webhook WC | `wc_delete_webhook` | Conferma prima di eliminare un webhook (le integrazioni esterne smetteranno di ricevere eventi) |
|
|
1272
1323
|
| 6 | Invio campagna Mailchimp | `mc_send_campaign` | Conferma prima di inviare una campagna email (azione irreversibile verso tutti i destinatari) |
|
|
1273
1324
|
| 7 | Invio email SendGrid | `sg_send_email` | Conferma prima di inviare email transazionali (azione irreversibile) |
|
|
1325
|
+
| 8 | Eliminazione workflow trigger | `wf_delete_trigger` | Conferma prima di eliminare un trigger di automazione (ferma tutte le notifiche e azioni associate) |
|
|
1274
1326
|
|
|
1275
1327
|
### Hook Command-Based (Validazione Script)
|
|
1276
1328
|
|
|
@@ -1327,7 +1379,7 @@ MCP (Model Context Protocol) e il protocollo che permette a Claude di comunicare
|
|
|
1327
1379
|
| Sorgente | Custom TypeScript server in `servers/wp-rest-bridge/` |
|
|
1328
1380
|
| Trasporto | stdio (JSON-RPC via stdin/stdout) |
|
|
1329
1381
|
| Autenticazione | `WP_SITES_CONFIG` JSON env var |
|
|
1330
|
-
| Tool disponibili |
|
|
1382
|
+
| Tool disponibili | 132 (41 WordPress + 34 WooCommerce + 10 Multisite + 18 Distribution + 8 GSC + 14 Analytics + 3 Alerting + 4 Workflows) |
|
|
1331
1383
|
|
|
1332
1384
|
**Categorie tool WordPress** (`wp/v2`):
|
|
1333
1385
|
|
|
@@ -1379,6 +1431,26 @@ MCP (Model Context Protocol) e il protocollo che permette a Claude di comunicare
|
|
|
1379
1431
|
| Search Analytics | 3 | `gsc_search_analytics`, `gsc_top_queries`, `gsc_page_performance` |
|
|
1380
1432
|
| Sitemaps | 3 | `gsc_list_sitemaps`, `gsc_submit_sitemap`, `gsc_delete_sitemap` |
|
|
1381
1433
|
|
|
1434
|
+
**Categorie tool Analytics** (richiede GA4 Property ID, Plausible API key, o Google API key):
|
|
1435
|
+
|
|
1436
|
+
| Categoria | Tool | Esempio |
|
|
1437
|
+
|-----------|------|---------|
|
|
1438
|
+
| GA4 | 6 | `ga4_run_report`, `ga4_get_realtime`, `ga4_top_pages`, `ga4_traffic_sources`, `ga4_user_demographics`, `ga4_conversion_events` |
|
|
1439
|
+
| Plausible | 4 | `pl_get_stats`, `pl_get_timeseries`, `pl_get_breakdown`, `pl_get_realtime` |
|
|
1440
|
+
| Core Web Vitals | 4 | `cwv_analyze_url`, `cwv_batch_analyze`, `cwv_get_field_data`, `cwv_compare_pages` |
|
|
1441
|
+
|
|
1442
|
+
**Categorie tool Alerting** (richiede Slack webhook URL o Bot Token):
|
|
1443
|
+
|
|
1444
|
+
| Categoria | Tool | Esempio |
|
|
1445
|
+
|-----------|------|---------|
|
|
1446
|
+
| Slack | 3 | `slack_send_alert` (webhook), `slack_send_message` (Bot Token + Block Kit), `slack_list_channels` |
|
|
1447
|
+
|
|
1448
|
+
**Categorie tool Workflows** (namespace `wp-manager/v1/workflows`):
|
|
1449
|
+
|
|
1450
|
+
| Categoria | Tool | Esempio |
|
|
1451
|
+
|-----------|------|---------|
|
|
1452
|
+
| Trigger Management | 4 | `wf_list_triggers`, `wf_create_trigger`, `wf_update_trigger`, `wf_delete_trigger` |
|
|
1453
|
+
|
|
1382
1454
|
**Architettura multi-sito**: Il server mantiene una `Map<siteId, AxiosInstance>` dove ogni sito ha la propria istanza HTTP autenticata. Il cambio sito e istantaneo.
|
|
1383
1455
|
|
|
1384
1456
|
#### WordPress.com MCP
|
|
@@ -1814,6 +1886,54 @@ Claude (attiva wp-content-strategist + skill wp-content-optimization):
|
|
|
1814
1886
|
-> Report: matrice triage, top 10 titoli da migliorare, 5 contenuti obsoleti, azioni immediate
|
|
1815
1887
|
```
|
|
1816
1888
|
|
|
1889
|
+
### Scenario 26: Analytics Unificata con GA4 e Plausible
|
|
1890
|
+
|
|
1891
|
+
```
|
|
1892
|
+
Tu: "Mostrami il report GA4, le top pages e le Core Web Vitals del mio sito"
|
|
1893
|
+
|
|
1894
|
+
Claude (attiva wp-monitoring-agent + skill wp-analytics):
|
|
1895
|
+
1. Detection con analytics_inspect.mjs (GA4 configurato? Plausible? Google API key?)
|
|
1896
|
+
2. GA4 report: ga4_run_report per sessioni, pageviews, bounce rate ultimi 28 giorni
|
|
1897
|
+
3. Top pages: ga4_top_pages con traffic sources breakdown
|
|
1898
|
+
4. Traffic sources: ga4_traffic_sources per organic vs direct vs referral vs social
|
|
1899
|
+
5. Core Web Vitals: cwv_analyze_url per homepage + landing pages principali
|
|
1900
|
+
6. CWV field data: cwv_get_field_data per dati reali degli utenti
|
|
1901
|
+
7. Confronto pagine: cwv_compare_pages per identificare pagine lente
|
|
1902
|
+
-> Report: dashboard analytics unificata, CWV score per pagina, raccomandazioni
|
|
1903
|
+
```
|
|
1904
|
+
|
|
1905
|
+
### Scenario 27: Smart Alerting con Slack
|
|
1906
|
+
|
|
1907
|
+
```
|
|
1908
|
+
Tu: "Configura alert Slack per quando il sito ha problemi critici"
|
|
1909
|
+
|
|
1910
|
+
Claude (attiva wp-monitoring-agent + skill wp-alerting):
|
|
1911
|
+
1. Detection con alerting_inspect.mjs (Slack webhook? Bot token? SendGrid?)
|
|
1912
|
+
2. Configura severity routing:
|
|
1913
|
+
- P3 (info): slack_send_alert via webhook (canale #wp-info)
|
|
1914
|
+
- P2 (warning): slack_send_message via Bot Token con thread per dettagli
|
|
1915
|
+
- P1/P0 (critical): Slack message + email via SendGrid ai responsabili
|
|
1916
|
+
3. Imposta threshold per metriche chiave (response time > 3s, SSL < 14 giorni, errori 5xx)
|
|
1917
|
+
4. Test alert: invia messaggio di test su canale Slack
|
|
1918
|
+
-> Report: severity routing configurato, threshold impostati, test completato
|
|
1919
|
+
```
|
|
1920
|
+
|
|
1921
|
+
### Scenario 28: Workflow Automatizzato per Content Lifecycle
|
|
1922
|
+
|
|
1923
|
+
```
|
|
1924
|
+
Tu: "Crea un workflow che notifica su Slack quando un post viene pubblicato e invia un'email di recap settimanale"
|
|
1925
|
+
|
|
1926
|
+
Claude (attiva wp-site-manager + skill wp-content-workflows):
|
|
1927
|
+
1. Detection con workflow_inspect.mjs (action channels, automation plugins, WP-Cron)
|
|
1928
|
+
2. Crea trigger "hook": wf_create_trigger con hook "transition_post_status" (publish)
|
|
1929
|
+
- Azione: Slack notification con titolo, autore, link del post
|
|
1930
|
+
3. Crea trigger "schedule": wf_create_trigger con cron "0 9 * * 1" (lunedi ore 9)
|
|
1931
|
+
- Azione: email recap settimanale con post pubblicati nell'ultima settimana
|
|
1932
|
+
4. Verifica trigger attivi: wf_list_triggers
|
|
1933
|
+
5. Test trigger manuale per verificare funzionamento
|
|
1934
|
+
-> Report: 2 trigger configurati, Slack + email, prossima esecuzione cron
|
|
1935
|
+
```
|
|
1936
|
+
|
|
1817
1937
|
---
|
|
1818
1938
|
|
|
1819
1939
|
## 14. Amministrazione Avanzata
|
|
@@ -2097,7 +2217,7 @@ bash ~/.claude/plugins/local/wordpress-manager/scripts/validate-wp-operation.sh
|
|
|
2097
2217
|
| **x-default** | Valore hreflang speciale che indica la pagina fallback per utenti senza match di lingua |
|
|
2098
2218
|
| **Content Sync** | Sincronizzazione di contenuti tra sub-site di lingua diversa in un network multilingua |
|
|
2099
2219
|
| **MultilingualPress** | Plugin WordPress nativo per multisite multilingua — connessioni tra contenuti cross-site |
|
|
2100
|
-
| **WCOP** | WordPress Content
|
|
2220
|
+
| **WCOP** | WordPress Content Operations Pipeline — framework a 5 layer per la gestione completa dei contenuti WordPress (Content Factory, Quality Assurance, Distribution, Observability, Automation). Score attuale: 8.8/10 |
|
|
2101
2221
|
| **CTR (Click-Through Rate)** | Rapporto percentuale tra impressioni e click — metrica chiave in Google Search Console e email marketing |
|
|
2102
2222
|
| **Flesch-Kincaid** | Formula di leggibilita che stima il livello scolastico necessario per comprendere un testo — usata nell'AI content optimization |
|
|
2103
2223
|
| **Content Triage** | Classificazione rapida di tutti i contenuti in categorie di azione: Quick Wins, Maintain, Deep Review, Outdated |
|
|
@@ -2107,8 +2227,19 @@ bash ~/.claude/plugins/local/wordpress-manager/scripts/validate-wp-operation.sh
|
|
|
2107
2227
|
| **Buffer** | Piattaforma di social media scheduling — integrata via API con 5 tool MCP (prefix `buf_*`) |
|
|
2108
2228
|
| **SendGrid** | Servizio di email transazionale e marketing — integrato via API con 6 tool MCP (prefix `sg_*`) |
|
|
2109
2229
|
| **GSC (Google Search Console)** | Strumento Google per monitorare presence del sito nei risultati di ricerca — integrato con 8 tool MCP (prefix `gsc_*`) |
|
|
2230
|
+
| **GA4 (Google Analytics 4)** | Piattaforma di analytics web di Google — integrata via API con 6 tool MCP (prefix `ga4_*`) per report, realtime, traffic sources e conversioni |
|
|
2231
|
+
| **Plausible Analytics** | Alternativa privacy-first a Google Analytics — integrata via API con 4 tool MCP (prefix `pl_*`) per stats, timeseries e breakdown |
|
|
2232
|
+
| **CWV (Core Web Vitals)** | Metriche Google (LCP, INP, CLS) per UX — 4 tool MCP (prefix `cwv_*`) per analisi URL, batch, field data e confronto pagine |
|
|
2233
|
+
| **Slack Webhook** | URL di callback per inviare messaggi a un canale Slack — usato per alert di severity info (P3) |
|
|
2234
|
+
| **Slack Bot Token** | Token di autenticazione per Slack Bot API — permette messaggi formattati con Block Kit, thread e interazioni avanzate |
|
|
2235
|
+
| **Severity Routing** | Pattern di alerting dove il livello di gravita (P0-P3) determina il canale di notifica (webhook, bot, email) |
|
|
2236
|
+
| **Workflow Trigger** | Regola di automazione che esegue azioni (Slack, email, webhook) in risposta a eventi (schedule, hook WordPress, lifecycle contenuto) |
|
|
2237
|
+
| **WP-Cron** | Sistema di scheduling di WordPress — usato per trigger workflow basati su cron expression (es. "ogni lunedi alle 9") |
|
|
2238
|
+
| **Content Lifecycle Hook** | Hook WordPress legato al ciclo di vita dei contenuti (publish, update, trash) — usato come trigger per workflow automatizzati |
|
|
2239
|
+
| **WCOP Score** | WordPress Content Operations Pipeline — score 0-10 su 5 layer: Content Factory, Quality Assurance, Distribution, Observability, Automation |
|
|
2110
2240
|
|
|
2111
2241
|
---
|
|
2112
2242
|
|
|
2113
|
-
*Guida v2.
|
|
2243
|
+
*Guida v2.9.0 — WordPress Manager Plugin per Claude Code*
|
|
2114
2244
|
*Ultimo aggiornamento: 2026-03-01*
|
|
2245
|
+
*WCOP Score: 8.8/10 (Tier 4+5 complete)*
|