claude-plugin-wordpress-manager 2.9.0 → 2.12.0

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.
Files changed (37) hide show
  1. package/CHANGELOG.md +73 -0
  2. package/agents/wp-content-strategist.md +58 -1
  3. package/agents/wp-distribution-manager.md +39 -6
  4. package/docs/GUIDE.md +145 -14
  5. package/docs/plans/2026-03-01-tier6-7-design.md +246 -0
  6. package/docs/plans/2026-03-01-tier6-7-implementation.md +1629 -0
  7. package/hooks/hooks.json +18 -0
  8. package/package.json +6 -3
  9. package/servers/wp-rest-bridge/build/tools/index.js +9 -0
  10. package/servers/wp-rest-bridge/build/tools/linkedin.js +203 -0
  11. package/servers/wp-rest-bridge/build/tools/schema.js +159 -0
  12. package/servers/wp-rest-bridge/build/tools/twitter.js +183 -0
  13. package/servers/wp-rest-bridge/build/wordpress.js +94 -0
  14. package/skills/wordpress-router/references/decision-tree.md +10 -2
  15. package/skills/wp-content-generation/SKILL.md +128 -0
  16. package/skills/wp-content-generation/references/brief-templates.md +151 -0
  17. package/skills/wp-content-generation/references/generation-workflow.md +132 -0
  18. package/skills/wp-content-generation/references/outline-patterns.md +188 -0
  19. package/skills/wp-content-generation/scripts/content_gen_inspect.mjs +90 -0
  20. package/skills/wp-content-repurposing/SKILL.md +13 -0
  21. package/skills/wp-content-repurposing/references/auto-transform-pipeline.md +128 -0
  22. package/skills/wp-content-repurposing/references/transform-templates.md +304 -0
  23. package/skills/wp-linkedin/SKILL.md +96 -0
  24. package/skills/wp-linkedin/references/linkedin-analytics.md +58 -0
  25. package/skills/wp-linkedin/references/linkedin-posting.md +53 -0
  26. package/skills/wp-linkedin/references/linkedin-setup.md +59 -0
  27. package/skills/wp-linkedin/scripts/linkedin_inspect.mjs +55 -0
  28. package/skills/wp-structured-data/SKILL.md +94 -0
  29. package/skills/wp-structured-data/references/injection-patterns.md +160 -0
  30. package/skills/wp-structured-data/references/schema-types.md +127 -0
  31. package/skills/wp-structured-data/references/validation-guide.md +89 -0
  32. package/skills/wp-structured-data/scripts/schema_inspect.mjs +88 -0
  33. package/skills/wp-twitter/SKILL.md +101 -0
  34. package/skills/wp-twitter/references/twitter-analytics.md +60 -0
  35. package/skills/wp-twitter/references/twitter-posting.md +66 -0
  36. package/skills/wp-twitter/references/twitter-setup.md +62 -0
  37. package/skills/wp-twitter/scripts/twitter_inspect.mjs +58 -0
package/CHANGELOG.md CHANGED
@@ -2,6 +2,79 @@
2
2
 
3
3
  All notable changes to the WordPress Manager plugin for Claude Code.
4
4
 
5
+ ## [2.12.0] — 2026-03-01
6
+
7
+ ### Added — Content Generation + Structured Data (Tier 7: Content Factory Completeness)
8
+
9
+ **Structured Data (3 MCP tools)**
10
+ - `sd_validate` — validate JSON-LD/Schema.org markup
11
+ - `sd_inject` — inject/update JSON-LD in WordPress posts
12
+ - `sd_list_schemas` — audit Schema.org types across the site
13
+ - New skill: `wp-structured-data` with schema types, validation, and injection references
14
+ - Detection script: `schema_inspect.mjs`
15
+ - Supported types: Article, Product, FAQ, HowTo, LocalBusiness, Event, Organization, BreadcrumbList
16
+
17
+ **Content Generation (procedure-based, no new MCP tools)**
18
+ - New skill: `wp-content-generation` with AI-driven content pipeline
19
+ - 7-step procedure: brief → keyword research → outline → draft → SEO optimize → structured data → publish
20
+ - Uses existing MCP tools (wp/v2, gsc_*, sd_*)
21
+ - Detection script: `content_gen_inspect.mjs`
22
+ - References: generation workflow, brief templates, outline patterns
23
+
24
+ **Infrastructure**
25
+ - Router v18 (+2 categories: content generation, structured data)
26
+ - Updated wp-content-strategist agent with AI generation and schema procedures
27
+
28
+ **Stats:** 41 → 43 skills | 142 → 145 MCP tools | Router v17 → v18
29
+
30
+ ### WCOP Score
31
+ - Content Factory: 9/10 → 10/10 (AI generation + structured data)
32
+ - Distribution: 9/10 (completed in v2.10-2.11)
33
+ - **Total: 8.8/10 → 9.2/10**
34
+
35
+ ## [2.11.0] — 2026-03-01
36
+
37
+ ### Added — Auto-Transform Pipeline (Tier 6b: Distribution Completeness)
38
+
39
+ - Auto-transform pipeline in `wp-content-repurposing` skill (new Section 5)
40
+ - Template system: blog→tweet, blog→thread, blog→LinkedIn post, blog→LinkedIn article, blog→email snippet
41
+ - Platform-specific formatting rules with character limits
42
+ - Integration with `li_*`, `tw_*`, `buf_*`, `mc_*` MCP tools
43
+ - New references: `auto-transform-pipeline.md`, `transform-templates.md`
44
+
45
+ **Stats:** 41 skills (unchanged) | 142 MCP tools (unchanged) | WCOP Distribution: 8/10 → 9/10
46
+
47
+ ## [2.10.0] — 2026-03-01
48
+
49
+ ### Added — Direct Social APIs (Tier 6a: Distribution Completeness)
50
+
51
+ **LinkedIn Integration (5 MCP tools)**
52
+ - `li_get_profile` — get authenticated user profile
53
+ - `li_create_post` — create feed post (text, link, image)
54
+ - `li_create_article` — publish long-form article
55
+ - `li_get_analytics` — post analytics (impressions, clicks, engagement)
56
+ - `li_list_posts` — list recent user posts
57
+ - New skill: `wp-linkedin` with setup, posting, and analytics references
58
+ - Detection script: `linkedin_inspect.mjs`
59
+
60
+ **Twitter/X Integration (5 MCP tools)**
61
+ - `tw_create_tweet` — publish tweet (text, media)
62
+ - `tw_create_thread` — publish connected tweet thread
63
+ - `tw_get_metrics` — tweet metrics (impressions, likes, retweets)
64
+ - `tw_list_tweets` — list recent user tweets
65
+ - `tw_delete_tweet` — delete tweet
66
+ - New skill: `wp-twitter` with setup, posting, and analytics references
67
+ - Detection script: `twitter_inspect.mjs`
68
+
69
+ **Infrastructure**
70
+ - LinkedIn client helpers in wordpress.js (hasLinkedIn, makeLinkedInRequest)
71
+ - Twitter client helpers in wordpress.js (hasTwitter, makeTwitterRequest)
72
+ - Router v17 (+2 categories: LinkedIn, Twitter/X)
73
+ - +2 safety hooks (tw_delete_tweet, li_create_article)
74
+ - Updated wp-distribution-manager agent with LinkedIn + Twitter procedures
75
+
76
+ **Stats:** 39 → 41 skills | 132 → 142 MCP tools | 10 → 12 hooks | Router v16 → v17
77
+
5
78
  ## [2.9.0] - 2026-03-01
6
79
 
7
80
  ### Added — Automated Workflows (WCOP Tier 4+5 Complete)
@@ -2,7 +2,7 @@
2
2
  name: wp-content-strategist
3
3
  color: magenta
4
4
  description: |
5
- Use this agent when the user needs to create, optimize, or manage WordPress content - blog posts, pages, products, custom post types, taxonomies, and media. Provides SEO-aware content workflows and editorial guidance.
5
+ Use this agent when the user needs to create, optimize, or manage WordPress content - blog posts, pages, products, custom post types, taxonomies, and media. Provides SEO-aware content workflows, AI-driven content generation, structured data management, and editorial guidance.
6
6
 
7
7
  <example>
8
8
  Context: User wants to create a new blog post with SEO optimization.
@@ -52,6 +52,20 @@ description: |
52
52
  assistant: "I'll use the wp-content-strategist agent to run the Content Optimization Pipeline — fetching all published content, analyzing headlines, readability, and SEO scores, then classifying into quick wins, needs rewrite, and archive."
53
53
  <commentary>Bulk content triage combines Claude's linguistic analysis with GSC data for data-driven content prioritization.</commentary>
54
54
  </example>
55
+
56
+ <example>
57
+ Context: User wants to generate a new blog post with AI assistance.
58
+ user: "Write a blog post about the benefits of prickly pear for hydration"
59
+ assistant: "I'll use the wp-content-strategist agent to run the AI content generation pipeline — creating a brief, researching keywords, drafting, optimizing, and publishing with structured data."
60
+ <commentary>AI content generation follows the 7-step pipeline from wp-content-generation skill.</commentary>
61
+ </example>
62
+
63
+ <example>
64
+ Context: User wants to add structured data to their posts.
65
+ user: "Add FAQ schema to my blog posts that have Q&A sections"
66
+ assistant: "I'll use the wp-content-strategist agent to scan posts for FAQ content and inject FAQPage structured data using the sd_* tools."
67
+ <commentary>Structured data injection requires content analysis and Schema.org knowledge.</commentary>
68
+ </example>
55
69
  model: inherit
56
70
  tools: Read, Grep, Glob, Bash, WebFetch, WebSearch
57
71
  ---
@@ -315,6 +329,47 @@ When creating content for multilingual sites:
315
329
  - Use the plugin's API for translation linking
316
330
  - Maintain consistent taxonomy structure across languages
317
331
 
332
+ ## AI Content Generation Pipeline
333
+
334
+ When the user wants to create new content from scratch with AI assistance:
335
+
336
+ ### Procedure: Full Content Generation
337
+
338
+ 1. **Brief**: Gather topic, audience, goal, and word count from user. Use templates from `wp-content-generation` skill.
339
+ 2. **Keyword Research**: If GSC is available, use `gsc_query_analytics` to find keyword opportunities. Otherwise, suggest semantically related terms.
340
+ 3. **Outline**: Create H2/H3 structure using patterns from `wp-content-generation` references. Place keywords naturally in headings.
341
+ 4. **Draft**: Write full content matching the site's voice (analyze recent posts). Avoid AI-typical phrases.
342
+ 5. **SEO Optimize**: Apply on-page SEO checklist — keyword in title/first paragraph/H2s, meta description, internal links, image alt text.
343
+ 6. **Structured Data**: Auto-detect schema type (Article, FAQ, HowTo) and inject via `sd_inject`.
344
+ 7. **Publish**: Create as draft via `create_content`, present for user review, publish only after approval.
345
+
346
+ See the `wp-content-generation` skill for detailed workflow, brief templates, and outline patterns.
347
+
348
+ ## Structured Data Management
349
+
350
+ When managing Schema.org markup across the site:
351
+
352
+ ### Procedure: Schema Audit and Injection
353
+
354
+ 1. **Audit existing schemas**: Run `sd_list_schemas` to see what structured data exists across the site
355
+ 2. **Validate current markup**: For key pages, run `sd_validate` with the page URL to check JSON-LD quality
356
+ 3. **Identify gaps**: Compare existing schemas against content types — blog posts should have Article, products should have Product, FAQ sections should have FAQPage
357
+ 4. **Inject missing schemas**: Use `sd_inject` with appropriate schema type and data
358
+ 5. **Verify**: Re-run `sd_validate` on injected pages to confirm validity
359
+
360
+ ### Schema Type Selection
361
+
362
+ | Content Type | Schema | Key Properties |
363
+ |-------------|--------|----------------|
364
+ | Blog post | Article | headline, image, datePublished, author |
365
+ | Product page | Product | name, offers, sku, brand |
366
+ | FAQ section | FAQPage | mainEntity (Question + Answer array) |
367
+ | Tutorial | HowTo | name, step array, totalTime |
368
+ | About page | Organization | name, url, logo, sameAs |
369
+ | Contact page | LocalBusiness | name, address, telephone |
370
+
371
+ See the `wp-structured-data` skill for schema types reference, validation guide, and injection patterns.
372
+
318
373
  ## Related Skills
319
374
 
320
375
  - **`wp-content` skill** — content lifecycle management, editorial workflows
@@ -323,3 +378,5 @@ When creating content for multilingual sites:
323
378
  - **`wp-programmatic-seo` skill** — scalable page generation from structured data (city pages, product variants, comparison pages)
324
379
  - **`wp-search-console` skill** — Google Search Console integration for keyword tracking, indexing, and SEO feedback loops
325
380
  - **`wp-content-optimization` skill** — AI-driven content optimization: headline scoring, readability, SEO scoring, meta optimization, content freshness, bulk triage
381
+ - **`wp-content-generation` skill** — AI-driven content creation pipeline: brief → keyword research → outline → draft → SEO optimize → structured data → publish
382
+ - **`wp-structured-data` skill** — Schema.org/JSON-LD validation, injection, and site-wide audit
@@ -4,7 +4,8 @@ color: indigo
4
4
  description: |
5
5
  Use this agent when the user needs to distribute WordPress content to social media
6
6
  and email channels: Mailchimp campaigns, Buffer social posts, SendGrid transactional
7
- emails, cross-channel content distribution, or distribution analytics.
7
+ emails, LinkedIn direct posting, Twitter/X publishing, cross-channel content
8
+ distribution, or distribution analytics.
8
9
 
9
10
  <example>
10
11
  Context: User wants to send a newsletter from their latest blog posts.
@@ -27,6 +28,20 @@ description: |
27
28
  <commentary>Distribution analytics across campaigns requires the specialized agent.</commentary>
28
29
  </example>
29
30
 
31
+ <example>
32
+ Context: User wants to publish a blog post to LinkedIn.
33
+ user: "Pubblica il mio ultimo articolo su LinkedIn"
34
+ assistant: "I'll use the wp-distribution-manager agent to fetch the post and create a LinkedIn article."
35
+ <commentary>Direct LinkedIn publishing requires the distribution agent for content adaptation and API posting.</commentary>
36
+ </example>
37
+
38
+ <example>
39
+ Context: User wants to create a Twitter thread from a blog post.
40
+ user: "Turn my blog post into a Twitter thread"
41
+ assistant: "I'll use the wp-distribution-manager agent to split the post into thread-sized tweets and publish them."
42
+ <commentary>Twitter thread creation requires content splitting and sequential posting.</commentary>
43
+ </example>
44
+
30
45
  model: inherit
31
46
  tools: Read, Grep, Glob, Bash, WebFetch, WebSearch
32
47
  ---
@@ -34,14 +49,14 @@ tools: Read, Grep, Glob, Bash, WebFetch, WebSearch
34
49
  # Content Distribution Manager
35
50
 
36
51
  ## Role
37
- You are the content distribution manager for WordPress sites. You bridge WordPress content with external distribution channels (Mailchimp, Buffer, SendGrid) using dedicated MCP tools.
52
+ You are the content distribution manager for WordPress sites. You bridge WordPress content with external distribution channels (Mailchimp, Buffer, SendGrid, LinkedIn, Twitter/X) using dedicated MCP tools.
38
53
 
39
54
  ## Procedures
40
55
 
41
56
  ### Procedure 1: Detect Available Services
42
57
  Before any distribution operation:
43
- 1. Check `hasMailchimp()`, `hasBuffer()`, `hasSendGrid()` via the has-check tools
44
- 2. If no services configured, guide user through setup (reference: mailchimp-integration.md, buffer-social-publishing.md, sendgrid-transactional.md)
58
+ 1. Check `hasMailchimp()`, `hasBuffer()`, `hasSendGrid()`, `hasLinkedIn()`, `hasTwitter()` via the has-check tools
59
+ 2. If no services configured, guide user through setup (reference: mailchimp-integration.md, buffer-social-publishing.md, sendgrid-transactional.md, linkedin-setup.md, twitter-setup.md)
45
60
  3. Report available channels
46
61
 
47
62
  ### Procedure 2: Fetch WordPress Content
@@ -65,7 +80,23 @@ IMPORTANT: Always confirm with user before sending emails (mc_send_campaign, sg_
65
80
  1. Mailchimp: mc_get_campaign_report (opens, clicks, bounces)
66
81
  2. Buffer: buf_get_analytics (clicks, reach, impressions)
67
82
  3. SendGrid: sg_get_stats (delivered, opens, clicks, bounces)
68
- 4. Compile cross-channel performance summary
83
+ 4. LinkedIn: li_get_analytics (impressions, clicks, engagement rate)
84
+ 5. Twitter: tw_get_metrics (impressions, likes, retweets, replies)
85
+ 6. Compile cross-channel performance summary
86
+
87
+ ### Procedure 6: LinkedIn Direct Publishing
88
+ 1. Fetch WordPress post content (title, excerpt, HTML body, featured image)
89
+ 2. Decide format: feed post (short update + link) or article (full long-form)
90
+ 3. For feed post: li_create_post with text, link_url, visibility
91
+ 4. For article: li_create_article with title, body_html, thumbnail_url (requires user confirmation via safety hook)
92
+ 5. Check analytics after 24-48h with li_get_analytics
93
+
94
+ ### Procedure 7: Twitter/X Direct Publishing
95
+ 1. Fetch WordPress post content (title, excerpt, key points)
96
+ 2. Decide format: single tweet (announcement + link) or thread (detailed breakdown)
97
+ 3. For single tweet: tw_create_tweet with text (max 280 chars)
98
+ 4. For thread: Extract key points, craft hook tweet + numbered points + CTA, tw_create_thread
99
+ 5. Check metrics after 24-48h with tw_get_metrics
69
100
 
70
101
  ## Report Template
71
102
 
@@ -84,11 +115,13 @@ After each distribution operation, provide:
84
115
  - NEVER send campaigns or emails without explicit user confirmation
85
116
  - Always show content preview before send
86
117
  - Verify audience/recipient list before mass sends
87
- - Safety hooks are active for mc_send_campaign and sg_send_email
118
+ - Safety hooks are active for mc_send_campaign, sg_send_email, li_create_article, and tw_delete_tweet
88
119
 
89
120
  ## Related Skills
90
121
 
91
122
  - **wp-social-email** -- Full skill with 6 reference files for all distribution workflows
123
+ - **wp-linkedin** -- Direct LinkedIn posting and analytics
124
+ - **wp-twitter** -- Direct Twitter/X posting and analytics
92
125
  - **wp-content-repurposing** -- Transform content for different channels before distributing
93
126
  - **wp-webhooks** -- Webhook-based distribution alternative
94
127
  - **wp-content** -- Source content from WordPress
package/docs/GUIDE.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # WordPress Manager - Guida Completa per Utenti e Amministratori
2
2
 
3
- **Versione:** 2.6.0
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.6.0
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/ # 36 skill totali
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 v13 (dev + local + ops + multisite + cicd + monitoring + webhooks + repurposing + pseo + attribution + multilang + distribution + gsc + content-optimization)
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
- +-- hooks/ # 9 hook di sicurezza
170
- | +-- hooks.json # 7 prompt + 2 command
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
- **5 aree di monitoraggio + fleet**:
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` (v13) e il punto d'ingresso per tutti i task WordPress. Classifica automaticamente il task in **quattordici 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.
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 24 script Node.js (`.mjs`) che eseguono analisi automatica del progetto:
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 v13 → instrada a wp-block-development
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 | 111 (41 WordPress + 34 WooCommerce + 10 Multisite + 18 Distribution + 8 GSC) |
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 Optimization Pipeline — pipeline AI a 5 step per ottimizzazione contenuti (headline readability SEO meta freshness) |
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.6.0 - WordPress Manager Plugin per Claude Code*
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)*