claude-plugin-wordpress-manager 2.4.0 → 2.9.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 (83) hide show
  1. package/.claude-plugin/plugin.json +10 -3
  2. package/CHANGELOG.md +103 -0
  3. package/agents/wp-content-strategist.md +104 -0
  4. package/agents/wp-monitoring-agent.md +44 -0
  5. package/agents/wp-site-manager.md +19 -0
  6. package/docs/GUIDE.md +183 -23
  7. package/docs/plans/2026-03-01-tier4-5-implementation.md +1783 -0
  8. package/docs/plans/2026-03-01-tier4-5-observability-automation-design.md +426 -0
  9. package/docs/plans/2026-03-01-wcop-reassessment-v2.6.0.md +403 -0
  10. package/hooks/hooks.json +9 -0
  11. package/package.json +19 -3
  12. package/servers/wp-rest-bridge/build/tools/comments.d.ts +6 -6
  13. package/servers/wp-rest-bridge/build/tools/cwv.d.ts +3 -0
  14. package/servers/wp-rest-bridge/build/tools/cwv.js +196 -0
  15. package/servers/wp-rest-bridge/build/tools/ga4.d.ts +3 -0
  16. package/servers/wp-rest-bridge/build/tools/ga4.js +323 -0
  17. package/servers/wp-rest-bridge/build/tools/gsc.d.ts +3 -0
  18. package/servers/wp-rest-bridge/build/tools/gsc.js +354 -0
  19. package/servers/wp-rest-bridge/build/tools/index.d.ts +38 -38
  20. package/servers/wp-rest-bridge/build/tools/index.js +18 -0
  21. package/servers/wp-rest-bridge/build/tools/media.d.ts +2 -2
  22. package/servers/wp-rest-bridge/build/tools/multisite-sites.d.ts +2 -2
  23. package/servers/wp-rest-bridge/build/tools/plausible.d.ts +3 -0
  24. package/servers/wp-rest-bridge/build/tools/plausible.js +207 -0
  25. package/servers/wp-rest-bridge/build/tools/plugin-repository.d.ts +1 -1
  26. package/servers/wp-rest-bridge/build/tools/search.d.ts +2 -2
  27. package/servers/wp-rest-bridge/build/tools/slack.d.ts +3 -0
  28. package/servers/wp-rest-bridge/build/tools/slack.js +129 -0
  29. package/servers/wp-rest-bridge/build/tools/unified-content.d.ts +8 -8
  30. package/servers/wp-rest-bridge/build/tools/unified-taxonomies.d.ts +4 -4
  31. package/servers/wp-rest-bridge/build/tools/users.d.ts +6 -6
  32. package/servers/wp-rest-bridge/build/tools/wc-coupons.d.ts +1 -1
  33. package/servers/wp-rest-bridge/build/tools/wc-customers.d.ts +3 -3
  34. package/servers/wp-rest-bridge/build/tools/wc-orders.d.ts +4 -4
  35. package/servers/wp-rest-bridge/build/tools/wc-products.d.ts +8 -8
  36. package/servers/wp-rest-bridge/build/tools/wc-webhooks.d.ts +4 -4
  37. package/servers/wp-rest-bridge/build/tools/wc-workflows.d.ts +3 -0
  38. package/servers/wp-rest-bridge/build/tools/wc-workflows.js +222 -0
  39. package/servers/wp-rest-bridge/build/wordpress.d.ts +23 -0
  40. package/servers/wp-rest-bridge/build/wordpress.js +178 -0
  41. package/servers/wp-rest-bridge/package.json +1 -0
  42. package/skills/wordpress-router/SKILL.md +1 -1
  43. package/skills/wordpress-router/references/decision-tree.md +12 -2
  44. package/skills/wp-alerting/SKILL.md +142 -0
  45. package/skills/wp-alerting/references/alert-thresholds.md +79 -0
  46. package/skills/wp-alerting/references/escalation-paths.md +92 -0
  47. package/skills/wp-alerting/references/report-scheduling.md +142 -0
  48. package/skills/wp-alerting/references/slack-integration.md +109 -0
  49. package/skills/wp-alerting/scripts/alerting_inspect.mjs +150 -0
  50. package/skills/wp-analytics/SKILL.md +158 -0
  51. package/skills/wp-analytics/references/analytics-dashboards.md +83 -0
  52. package/skills/wp-analytics/references/cwv-monitoring.md +101 -0
  53. package/skills/wp-analytics/references/ga4-integration.md +76 -0
  54. package/skills/wp-analytics/references/plausible-setup.md +92 -0
  55. package/skills/wp-analytics/references/traffic-attribution.md +92 -0
  56. package/skills/wp-analytics/scripts/analytics_inspect.mjs +153 -0
  57. package/skills/wp-content/SKILL.md +1 -0
  58. package/skills/wp-content-attribution/SKILL.md +3 -0
  59. package/skills/wp-content-optimization/SKILL.md +173 -0
  60. package/skills/wp-content-optimization/references/content-freshness.md +234 -0
  61. package/skills/wp-content-optimization/references/headline-optimization.md +171 -0
  62. package/skills/wp-content-optimization/references/meta-optimization.md +243 -0
  63. package/skills/wp-content-optimization/references/readability-analysis.md +201 -0
  64. package/skills/wp-content-optimization/references/seo-content-scoring.md +245 -0
  65. package/skills/wp-content-optimization/scripts/content_optimization_inspect.mjs +237 -0
  66. package/skills/wp-content-workflows/SKILL.md +142 -0
  67. package/skills/wp-content-workflows/references/content-lifecycle-hooks.md +131 -0
  68. package/skills/wp-content-workflows/references/multi-channel-actions.md +151 -0
  69. package/skills/wp-content-workflows/references/schedule-triggers.md +118 -0
  70. package/skills/wp-content-workflows/references/trigger-management.md +159 -0
  71. package/skills/wp-content-workflows/references/wp-action-hooks.md +114 -0
  72. package/skills/wp-content-workflows/scripts/workflow_inspect.mjs +202 -0
  73. package/skills/wp-monitoring/SKILL.md +3 -0
  74. package/skills/wp-programmatic-seo/SKILL.md +2 -0
  75. package/skills/wp-search-console/SKILL.md +122 -0
  76. package/skills/wp-search-console/references/competitor-gap-analysis.md +226 -0
  77. package/skills/wp-search-console/references/content-seo-feedback.md +181 -0
  78. package/skills/wp-search-console/references/gsc-setup.md +110 -0
  79. package/skills/wp-search-console/references/indexing-management.md +182 -0
  80. package/skills/wp-search-console/references/keyword-tracking.md +181 -0
  81. package/skills/wp-search-console/scripts/search_console_inspect.mjs +178 -0
  82. package/skills/wp-social-email/SKILL.md +1 -0
  83. package/skills/wp-webhooks/SKILL.md +1 -0
package/docs/GUIDE.md CHANGED
@@ -1,7 +1,7 @@
1
1
  # WordPress Manager - Guida Completa per Utenti e Amministratori
2
2
 
3
- **Versione:** 2.3.0
4
- **Ultimo aggiornamento:** 2026-02-28
3
+ **Versione:** 2.6.0
4
+ **Ultimo aggiornamento:** 2026-03-01
5
5
  **Repository:** https://github.com/morrealev/wordpress-manager
6
6
 
7
7
  ---
@@ -63,6 +63,9 @@ WordPress Manager e un plugin per **Claude Code** (la CLI ufficiale di Anthropic
63
63
  - **SEO programmatico**: generare centinaia di pagine template da dati strutturati (city pages, product variants, directory)
64
64
  - **Attribuzione contenuti-vendite**: misurare quale contenuto WordPress genera conversioni WooCommerce (UTM tracking, attribution models, ROI)
65
65
  - **Rete multilingua**: orchestrare WordPress Multisite come network multilingua con hreflang, content sync e SEO internazionale
66
+ - **Distribuzione social/email**: distribuire contenuti su Mailchimp, Buffer e SendGrid con workflow multi-canale
67
+ - **Google Search Console**: monitorare keyword, indicizzazione, performance pagine e feedback SEO da GSC
68
+ - **Ottimizzazione contenuti AI**: headline scoring, readability analysis, SEO scoring, meta optimization, content freshness e bulk triage
66
69
 
67
70
  ### Requisiti
68
71
 
@@ -99,15 +102,15 @@ WordPress Manager e un plugin per **Claude Code** (la CLI ufficiale di Anthropic
99
102
  ### Componenti del Plugin
100
103
 
101
104
  ```
102
- wordpress-manager/ # v2.3.0
105
+ wordpress-manager/ # v2.6.0
103
106
  +-- .claude-plugin/plugin.json # Manifest
104
107
  +-- .mcp.json # Server MCP bundled
105
108
  +-- LICENSE # MIT + GPL-2.0-or-later
106
109
  +-- CHANGELOG.md # Cronologia versioni
107
- +-- agents/ # 11 agenti specializzati
110
+ +-- agents/ # 12 agenti specializzati
108
111
  | +-- wp-site-manager.md # Orchestratore centrale
109
112
  | +-- wp-deployment-engineer.md # Specialista deploy
110
- | +-- wp-content-strategist.md # Contenuti e SEO
113
+ | +-- wp-content-strategist.md # Contenuti, SEO, GSC feedback, AI optimization
111
114
  | +-- wp-security-auditor.md # Audit sicurezza (read-only)
112
115
  | +-- wp-security-hardener.md # Hardening e incident response
113
116
  | +-- wp-performance-optimizer.md # Performance e CWV
@@ -116,9 +119,10 @@ wordpress-manager/ # v2.3.0
116
119
  | +-- wp-ecommerce-manager.md # WooCommerce store management (v1.8.0)
117
120
  | +-- wp-cicd-engineer.md # CI/CD pipeline specialist (v2.0.0)
118
121
  | +-- wp-monitoring-agent.md # Site monitoring read-only (v2.1.0)
122
+ | +-- wp-distribution-manager.md # Multi-channel distribution (v2.4.0)
119
123
  +-- commands/ # 5 slash commands
120
124
  | +-- wp-status.md / wp-deploy.md / wp-audit.md / wp-backup.md / wp-setup.md
121
- +-- skills/ # 33 skill totali
125
+ +-- skills/ # 36 skill totali
122
126
  | +-- [OPERATIVE - 5 skill]
123
127
  | +-- wp-deploy/ # Procedure deploy
124
128
  | +-- wp-audit/ # Checklist audit
@@ -128,7 +132,7 @@ wordpress-manager/ # v2.3.0
128
132
  | +-- [AMBIENTE LOCALE - 1 skill]
129
133
  | +-- wp-local-env/ # Studio/LocalWP/wp-env
130
134
  | +-- [SVILUPPO - 13 skill da WordPress/agent-skills]
131
- | +-- wordpress-router/ # Router unificato v10 (dev + local + ops + multisite + cicd + monitoring + webhooks + repurposing + pseo + attribution + multilang)
135
+ | +-- wordpress-router/ # Router unificato v13 (dev + local + ops + multisite + cicd + monitoring + webhooks + repurposing + pseo + attribution + multilang + distribution + gsc + content-optimization)
132
136
  | +-- wp-project-triage/ # Auto-detect tipo progetto
133
137
  | +-- wp-block-development/ # Blocchi Gutenberg
134
138
  | +-- wp-block-themes/ # Temi a blocchi
@@ -158,8 +162,12 @@ wordpress-manager/ # v2.3.0
158
162
  | +-- wp-programmatic-seo/ # SEO programmatico scalabile (v2.3.0)
159
163
  | +-- wp-content-attribution/ # Attribuzione content-to-commerce (v2.3.0)
160
164
  | +-- wp-multilang-network/ # Rete multilingua su multisite (v2.3.0)
161
- +-- hooks/ # 7 hook di sicurezza
162
- | +-- hooks.json # 5 prompt + 2 command
165
+ | +-- [DISTRIBUZIONE + SEO AVANZATO - 3 skill]
166
+ | +-- wp-social-email/ # Distribuzione social/email multi-canale (v2.4.0)
167
+ | +-- wp-search-console/ # Google Search Console integration (v2.5.0)
168
+ | +-- 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
163
171
  | +-- scripts/ # Script per hook command-type
164
172
  +-- scripts/ # Utility
165
173
  +-- servers/wp-rest-bridge/ # MCP Server custom (TypeScript)
@@ -347,6 +355,9 @@ WordPress Manager comprende richieste in linguaggio naturale. Ecco come formular
347
355
  | SEO programmatico | "Genera city pages" / "Template pages" / "Pagine da dati" / "Programmatic SEO" |
348
356
  | Attribuzione contenuti | "Quale contenuto genera vendite?" / "UTM tracking" / "Content ROI" / "Revenue per post" |
349
357
  | Rete multilingua | "Sito multilingua" / "Hreflang" / "International SEO" / "Sub-site per lingua" |
358
+ | Distribuzione social/email | "Distribuisci il post" / "Mailchimp campaign" / "Buffer schedule" / "SendGrid email" |
359
+ | Google Search Console | "Keyword tracking" / "Search analytics" / "Indicizzazione" / "GSC performance" |
360
+ | Ottimizzazione contenuti | "Ottimizza titoli" / "Headline score" / "Readability" / "Content triage" / "Quick wins" |
350
361
 
351
362
  ---
352
363
 
@@ -510,7 +521,7 @@ I comandi slash sono scorciatoie dirette per operazioni specifiche. Si invocano
510
521
 
511
522
  Gli agenti sono "personalita" specializzate di Claude che vengono attivate automaticamente in base al contesto della conversazione. Non devi invocarli manualmente - Claude sceglie l'agente giusto per il compito.
512
523
 
513
- Il plugin include **11 agenti** organizzati per area di competenza. Alcuni agenti lavorano in coppia (audit → fix) o in modalita read-only (monitoraggio).
524
+ Il plugin include **12 agenti** organizzati per area di competenza. Alcuni agenti lavorano in coppia (audit → fix) o in modalita read-only (monitoraggio).
514
525
 
515
526
  ### wp-site-manager (Orchestratore)
516
527
 
@@ -561,8 +572,8 @@ Il plugin include **11 agenti** organizzati per area di competenza. Alcuni agent
561
572
  | Proprieta | Valore |
562
573
  |-----------|--------|
563
574
  | Colore | Magenta |
564
- | Ruolo | Creazione contenuti, SEO, gestione editoriale, contenuti multilingue |
565
- | Attivazione | Creazione post, ottimizzazione SEO, gestione tassonomie |
575
+ | Ruolo | Creazione contenuti, SEO, gestione editoriale, contenuti multilingue, GSC feedback, AI optimization |
576
+ | Attivazione | Creazione post, ottimizzazione SEO, gestione tassonomie, keyword tracking, content optimization |
566
577
 
567
578
  **Ciclo di vita contenuti**:
568
579
  ```
@@ -584,7 +595,11 @@ IDEAZIONE -> BOZZA -> REVISIONE -> OTTIMIZZAZIONE -> PUBBLICAZIONE -> MONITORAGG
584
595
 
585
596
  **Programmatic SEO** (v2.3.0): Guida la generazione scalabile di pagine da dati strutturati — city pages, product variants, comparison pages, directory listings. Workflow: assess data source → design URL pattern → create CPT → build template → generate in bulk → configure ISR/SSG → submit sitemap. Usa la skill `wp-programmatic-seo`.
586
597
 
587
- **Skill correlata**: `wp-content`, `wp-i18n`, `wp-content-repurposing`, `wp-programmatic-seo`
598
+ **SEO Feedback Loop** (v2.5.0): Integrazione con Google Search Console per feedback loop SEO. Workflow: pull GSC data (top queries, page performance) → identifica contenuti sotto-performanti → suggerisce ottimizzazioni basate su CTR, impressions, position → monitora risultati nel tempo. Usa la skill `wp-search-console` e i tool `gsc_*`.
599
+
600
+ **AI Content Optimization** (v2.6.0): Pipeline AI-driven in 5 step per ottimizzazione contenuti: headline scoring → readability analysis (Flesch-Kincaid) → SEO scoring → meta optimization → content freshness check. Include bulk triage per analisi rapida di tutti i contenuti con classificazione Quick Wins / Maintain / Deep Review / Outdated. Usa la skill `wp-content-optimization`.
601
+
602
+ **Skill correlata**: `wp-content`, `wp-i18n`, `wp-content-repurposing`, `wp-programmatic-seo`, `wp-search-console`, `wp-content-optimization`
588
603
 
589
604
  ---
590
605
 
@@ -827,7 +842,36 @@ Complementa `wp-security-auditor`: l'auditor **trova** i problemi, l'hardener **
827
842
 
828
843
  ---
829
844
 
830
- ### Pattern di Collaborazione tra Agent
845
+ ### wp-distribution-manager (Distribuzione)
846
+
847
+ | Proprieta | Valore |
848
+ |-----------|--------|
849
+ | Colore | Indigo |
850
+ | Ruolo | Distribuzione multi-canale contenuti su Mailchimp, Buffer e SendGrid |
851
+ | Attivazione | "Distribuisci il post", "invia newsletter", "programma social", "email campaign", "Buffer schedule" |
852
+
853
+ **3 canali supportati**:
854
+
855
+ | Canale | Servizio | Tool prefix | Operazioni |
856
+ |--------|----------|-------------|-----------|
857
+ | Email Marketing | Mailchimp | `mc_*` | Liste, campagne, template, audience |
858
+ | Social Media | Buffer | `buf_*` | Profili, post scheduling, analytics |
859
+ | Email Transazionale | SendGrid | `sg_*` | Template, invio, contatti, statistiche |
860
+
861
+ **Workflow distribuzione**:
862
+ 1. Seleziona contenuto WordPress da distribuire (via `list_content`)
863
+ 2. Detection con `distribution_inspect.mjs` (servizi configurati, credenziali)
864
+ 3. Adatta contenuto per ogni canale (lunghezza, formato, CTA)
865
+ 4. Programma o invia su canali selezionati
866
+ 5. Report: conferma invio, link preview, metriche
867
+
868
+ **Prerequisiti**: Almeno un servizio configurato in `WP_SITES_CONFIG` (Mailchimp API key, Buffer access token, o SendGrid API key).
869
+
870
+ **Skill correlata**: `wp-social-email`
871
+
872
+ ---
873
+
874
+
831
875
 
832
876
  | Pattern | Flusso | Descrizione |
833
877
  |---------|--------|-------------|
@@ -835,12 +879,12 @@ Complementa `wp-security-auditor`: l'auditor **trova** i problemi, l'hardener **
835
879
  | **Monitor → Delegate** | `wp-monitoring-agent` → agent specializzati | Il monitoring rileva anomalie e delega agli agent competenti |
836
880
  | **Delegazione** | `wp-site-manager` → tutti gli altri | Il site manager delega a agent specializzati in base al task |
837
881
 
838
- Il `wp-site-manager` puo delegare a tutti gli 11 agent specializzati:
882
+ Il `wp-site-manager` puo delegare a tutti i 12 agent specializzati:
839
883
 
840
884
  | Task | Agent delegato |
841
885
  |------|---------------|
842
886
  | Deploy, migrazione | `wp-deployment-engineer` |
843
- | Contenuti, SEO | `wp-content-strategist` |
887
+ | Contenuti, SEO, AI optimization | `wp-content-strategist` |
844
888
  | Audit sicurezza | `wp-security-auditor` |
845
889
  | Hardening, incident response | `wp-security-hardener` |
846
890
  | Performance, CWV | `wp-performance-optimizer` |
@@ -849,6 +893,7 @@ Il `wp-site-manager` puo delegare a tutti gli 11 agent specializzati:
849
893
  | WooCommerce, e-commerce | `wp-ecommerce-manager` |
850
894
  | CI/CD pipeline | `wp-cicd-engineer` |
851
895
  | Site monitoring e health reports | `wp-monitoring-agent` |
896
+ | Distribuzione social/email | `wp-distribution-manager` |
852
897
 
853
898
  ---
854
899
 
@@ -888,10 +933,11 @@ Le skill di sviluppo provengono da due fonti:
888
933
  - **5 skill estese** (MIT) aggiunte in v1.6.0: testing, security, internazionalizzazione, accessibilita, headless.
889
934
  - **6 skill e-commerce + infrastruttura** (MIT) aggiunte in v1.8.0-v2.2.0: WooCommerce, Multisite, CI/CD, Monitoring, Content Repurposing, Webhooks.
890
935
  - **3 skill strategia + SEO internazionale** (MIT) aggiunte in v2.3.0: Programmatic SEO, Content-Commerce Attribution, Multi-Language Network.
936
+ - **3 skill distribuzione + SEO avanzato** (MIT) aggiunte in v2.4.0-v2.6.0: Social/Email Distribution, Google Search Console, AI Content Optimization.
891
937
 
892
938
  ### Il Router Unificato
893
939
 
894
- La skill `wordpress-router` (v10) e il punto d'ingresso per tutti i task WordPress. Classifica automaticamente il task in **undici categorie**: sviluppo, ambiente locale, operativo, multisite, CI/CD, monitoring, content repurposing, webhook, programmatic SEO, content attribution, multi-language network.
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.
895
941
 
896
942
  ```
897
943
  Utente: "Crea un blocco custom per la gallery"
@@ -991,6 +1037,30 @@ wordpress-router: TASK = operativo (multi-language network)
991
1037
  wp-multilang-network skill + wp-site-manager agent
992
1038
  ```
993
1039
 
1040
+ ```
1041
+ Utente: "Distribuisci l'ultimo post via Mailchimp e Buffer"
1042
+ |
1043
+ wordpress-router: TASK = operativo (social/email distribution)
1044
+ |
1045
+ wp-social-email skill + wp-distribution-manager agent
1046
+ ```
1047
+
1048
+ ```
1049
+ Utente: "Quali keyword posizionano meglio il mio sito su Google?"
1050
+ |
1051
+ wordpress-router: TASK = operativo (search console)
1052
+ |
1053
+ wp-search-console skill + wp-content-strategist agent
1054
+ ```
1055
+
1056
+ ```
1057
+ Utente: "Analizza e ottimizza i titoli dei miei post per CTR"
1058
+ |
1059
+ wordpress-router: TASK = operativo (content optimization)
1060
+ |
1061
+ wp-content-optimization skill + wp-content-strategist agent
1062
+ ```
1063
+
994
1064
  ### Panoramica Skills di Sviluppo — Community (13)
995
1065
 
996
1066
  | Skill | Si attiva quando... | Risorse |
@@ -1046,9 +1116,19 @@ Aggiunte in v2.3.0, queste skill coprono SEO programmatico, attribuzione content
1046
1116
  | `wp-content-attribution` | "content ROI", "UTM tracking", "revenue per post", "quale contenuto genera vendite" | 5 reference files, attribution_inspect.mjs | `wp-ecommerce-manager` |
1047
1117
  | `wp-multilang-network` | "multilingua", "hreflang", "international SEO", "sub-site per lingua", "translate site" | 5 reference files, multilang_inspect.mjs | `wp-site-manager` |
1048
1118
 
1119
+ ### Panoramica Skills Distribuzione + SEO Avanzato (3)
1120
+
1121
+ Aggiunte in v2.4.0-v2.6.0, queste skill coprono distribuzione multi-canale, Google Search Console e ottimizzazione contenuti AI-driven.
1122
+
1123
+ | Skill | Si attiva quando... | Risorse | Agent dedicato |
1124
+ |-------|---------------------|---------|----------------|
1125
+ | `wp-social-email` | "distribuisci", "Mailchimp", "Buffer", "SendGrid", "newsletter", "social schedule" | 6 reference files, distribution_inspect.mjs | `wp-distribution-manager` |
1126
+ | `wp-search-console` | "Search Console", "keyword tracking", "indicizzazione", "GSC", "search analytics" | 5 reference files, search_console_inspect.mjs | `wp-content-strategist` |
1127
+ | `wp-content-optimization` | "ottimizza titoli", "readability", "headline score", "content triage", "meta optimization" | 5 reference files, content_optimization_inspect.mjs | `wp-content-strategist` |
1128
+
1049
1129
  ### Script di Rilevamento Automatico
1050
1130
 
1051
- Le skill includono 21 script Node.js (`.mjs`) che eseguono analisi automatica del progetto:
1131
+ Le skill includono 24 script Node.js (`.mjs`) che eseguono analisi automatica del progetto:
1052
1132
 
1053
1133
  | Script | Cosa rileva |
1054
1134
  |--------|-------------|
@@ -1073,6 +1153,9 @@ Le skill includono 21 script Node.js (`.mjs`) che eseguono analisi automatica de
1073
1153
  | `programmatic_seo_inspect.mjs` | Headless frontend, SEO plugin, content counts, CPT, WPGraphQL, readiness (v2.3.0) |
1074
1154
  | `attribution_inspect.mjs` | WooCommerce, analytics plugin, UTM tracking, content/product volume, order meta (v2.3.0) |
1075
1155
  | `multilang_inspect.mjs` | Multisite, multilingual plugin, language patterns, hreflang tags, WPLANG (v2.3.0) |
1156
+ | `distribution_inspect.mjs` | Mailchimp, Buffer, SendGrid config, API keys, servizi attivi (v2.4.0) |
1157
+ | `search_console_inspect.mjs` | GSC service account, siti verificati, sitemap, keyword data (v2.5.0) |
1158
+ | `content_optimization_inspect.mjs` | Content volume, titoli, meta description, readability readiness (v2.6.0) |
1076
1159
 
1077
1160
  ### WordPress Playground — Ambienti Disposable
1078
1161
 
@@ -1107,7 +1190,7 @@ Senza il server MCP, la skill usa conoscenza generale di `@wordpress/components`
1107
1190
  ```
1108
1191
  1. cd mio-progetto-wordpress/
1109
1192
  2. Claude esegue wp-project-triage → rileva "wp-block-plugin"
1110
- 3. wordpress-router v10 → instrada a wp-block-development
1193
+ 3. wordpress-router v13 → instrada a wp-block-development
1111
1194
  4. Claude guida la creazione con block.json, edit.js, save.js
1112
1195
  5. wp-e2e-testing + wp-test-engineer → esegue test E2E con Playwright
1113
1196
  6. wp-accessibility + wp-accessibility-auditor → verifica WCAG 2.2
@@ -1186,6 +1269,8 @@ Questi hook chiedono a Claude di valutare se l'operazione e stata esplicitamente
1186
1269
  | 3 | Import WordPress | `hosting_importWordpressWebsite` | Conferma prima di SOVRASCRIVERE l'installazione esistente |
1187
1270
  | 4 | Modifica DNS | `DNS_updateDNSRecordsV1`, `DNS_resetDNSRecordsV1` | Conferma prima di modificare i record DNS |
1188
1271
  | 5 | Eliminazione webhook WC | `wc_delete_webhook` | Conferma prima di eliminare un webhook (le integrazioni esterne smetteranno di ricevere eventi) |
1272
+ | 6 | Invio campagna Mailchimp | `mc_send_campaign` | Conferma prima di inviare una campagna email (azione irreversibile verso tutti i destinatari) |
1273
+ | 7 | Invio email SendGrid | `sg_send_email` | Conferma prima di inviare email transazionali (azione irreversibile) |
1189
1274
 
1190
1275
  ### Hook Command-Based (Validazione Script)
1191
1276
 
@@ -1242,7 +1327,7 @@ MCP (Model Context Protocol) e il protocollo che permette a Claude di comunicare
1242
1327
  | Sorgente | Custom TypeScript server in `servers/wp-rest-bridge/` |
1243
1328
  | Trasporto | stdio (JSON-RPC via stdin/stdout) |
1244
1329
  | Autenticazione | `WP_SITES_CONFIG` JSON env var |
1245
- | Tool disponibili | 85 (41 WordPress + 34 WooCommerce + 10 Multisite) |
1330
+ | Tool disponibili | 111 (41 WordPress + 34 WooCommerce + 10 Multisite + 18 Distribution + 8 GSC) |
1246
1331
 
1247
1332
  **Categorie tool WordPress** (`wp/v2`):
1248
1333
 
@@ -1278,6 +1363,22 @@ MCP (Model Context Protocol) e il protocollo che permette a Claude di comunicare
1278
1363
  | Admin | 2 | `ms_list_super_admins`, `ms_network_settings` |
1279
1364
  | DNS | 2 | `ms_domain_mapping`, `ms_site_url` |
1280
1365
 
1366
+ **Categorie tool Distribution** (richiede API key per ciascun servizio):
1367
+
1368
+ | Categoria | Tool | Esempio |
1369
+ |-----------|------|---------|
1370
+ | Mailchimp | 7 | `mc_list_audiences`, `mc_create_campaign`, `mc_send_campaign`, `mc_get_campaign_report`, `mc_list_templates`, `mc_add_subscriber`, `mc_list_campaigns` |
1371
+ | Buffer | 5 | `buf_list_profiles`, `buf_create_post`, `buf_list_scheduled`, `buf_get_analytics`, `buf_list_channels` |
1372
+ | SendGrid | 6 | `sg_send_email`, `sg_list_templates`, `sg_create_template`, `sg_list_contacts`, `sg_add_contact`, `sg_get_stats` |
1373
+
1374
+ **Categorie tool Google Search Console** (`gsc_` prefix, richiede Service Account JSON):
1375
+
1376
+ | Categoria | Tool | Esempio |
1377
+ |-----------|------|---------|
1378
+ | Site Management | 2 | `gsc_list_sites`, `gsc_inspect_url` |
1379
+ | Search Analytics | 3 | `gsc_search_analytics`, `gsc_top_queries`, `gsc_page_performance` |
1380
+ | Sitemaps | 3 | `gsc_list_sitemaps`, `gsc_submit_sitemap`, `gsc_delete_sitemap` |
1381
+
1281
1382
  **Architettura multi-sito**: Il server mantiene una `Map<siteId, AxiosInstance>` dove ogni sito ha la propria istanza HTTP autenticata. Il cambio sito e istantaneo.
1282
1383
 
1283
1384
  #### WordPress.com MCP
@@ -1664,6 +1765,55 @@ Claude (attiva wp-site-manager + skill wp-multilang-network):
1664
1765
  -> Report: network multilingua configurato, hreflang attivo, SEO verificato
1665
1766
  ```
1666
1767
 
1768
+ ### Scenario 23: Distribuzione Multi-Canale con Mailchimp e Buffer
1769
+
1770
+ ```
1771
+ Tu: "Distribuisci l'ultimo post del blog via newsletter Mailchimp e programma sui social con Buffer"
1772
+
1773
+ Claude (attiva wp-distribution-manager + skill wp-social-email):
1774
+ 1. Detection con distribution_inspect.mjs (Mailchimp e Buffer configurati?)
1775
+ 2. Seleziona ultimo post via list_content
1776
+ 3. Estrae headline, excerpt, URL, immagine featured
1777
+ 4. Crea campagna Mailchimp: mc_create_campaign con template, audience, subject line
1778
+ 5. Conferma invio (hook mc_send_campaign) → mc_send_campaign
1779
+ 6. Programma social post: buf_create_post per ogni profilo Buffer (LinkedIn, Twitter)
1780
+ 7. Verifica scheduling: buf_list_scheduled
1781
+ -> Report: campagna email inviata, 3 social post programmati, link preview
1782
+ ```
1783
+
1784
+ ### Scenario 24: Keyword Tracking con Google Search Console
1785
+
1786
+ ```
1787
+ Tu: "Quali keyword posizionano meglio il mio sito e quali pagine devo ottimizzare?"
1788
+
1789
+ Claude (attiva wp-content-strategist + skill wp-search-console):
1790
+ 1. Detection con search_console_inspect.mjs (GSC configurato? siti verificati?)
1791
+ 2. Pull top queries: gsc_top_queries per ultimi 28 giorni
1792
+ 3. Pull page performance: gsc_page_performance per tutte le pagine
1793
+ 4. Identifica keyword ad alto impressions ma basso CTR (opportunita)
1794
+ 5. Identifica pagine in posizione 5-20 (quick wins per salire in top 3)
1795
+ 6. Verifica indicizzazione pagine chiave: gsc_inspect_url
1796
+ 7. Cross-reference con contenuti WordPress (list_content)
1797
+ -> Report: top 20 keyword, pagine sotto-performanti, azioni SEO prioritizzate
1798
+ ```
1799
+
1800
+ ### Scenario 25: AI Content Optimization e Bulk Triage
1801
+
1802
+ ```
1803
+ Tu: "Analizza tutti i post del blog e dimmi quali titoli migliorare e quali contenuti sono obsoleti"
1804
+
1805
+ Claude (attiva wp-content-strategist + skill wp-content-optimization):
1806
+ 1. Detection con content_optimization_inspect.mjs (volume contenuti, meta status)
1807
+ 2. Pull tutti i post via list_content
1808
+ 3. Bulk triage: classifica ogni post in Quick Wins / Maintain / Deep Review / Outdated
1809
+ 4. Per Quick Wins: headline scoring (power words, lunghezza, emotional trigger)
1810
+ 5. Readability analysis: Flesch-Kincaid score per ogni post
1811
+ 6. SEO scoring: keyword in title, meta description, heading structure
1812
+ 7. Content freshness: identifica post > 12 mesi senza aggiornamento
1813
+ 8. Genera piano di ottimizzazione prioritizzato con stime di impatto
1814
+ -> Report: matrice triage, top 10 titoli da migliorare, 5 contenuti obsoleti, azioni immediate
1815
+ ```
1816
+
1667
1817
  ---
1668
1818
 
1669
1819
  ## 14. Amministrazione Avanzata
@@ -1914,7 +2064,7 @@ bash ~/.claude/plugins/local/wordpress-manager/scripts/validate-wp-operation.sh
1914
2064
  | **RTL** | Right-to-Left — supporto per lingue scritte da destra a sinistra (arabo, ebraico) |
1915
2065
  | **WCAG** | Web Content Accessibility Guidelines — standard W3C per accessibilita web (target: 2.2 AA) |
1916
2066
  | **WPGraphQL** | Plugin WordPress che espone un'API GraphQL come alternativa alla REST API |
1917
- | **WooCommerce** | Plugin e-commerce per WordPress; il WP REST Bridge espone 30 tool via namespace `wc/v3` |
2067
+ | **WooCommerce** | Plugin e-commerce per WordPress; il WP REST Bridge espone 34 tool via namespace `wc/v3` |
1918
2068
  | **Consumer Key/Secret** | Credenziali API WooCommerce per accesso REST (`wc/v3`), generate da WooCommerce > Settings > REST API |
1919
2069
  | **Multisite** | Funzionalita WordPress per gestire una rete di siti da una singola installazione (Network Admin) |
1920
2070
  | **Super Admin** | Ruolo utente WordPress con accesso a tutte le operazioni del network multisite |
@@ -1947,8 +2097,18 @@ bash ~/.claude/plugins/local/wordpress-manager/scripts/validate-wp-operation.sh
1947
2097
  | **x-default** | Valore hreflang speciale che indica la pagina fallback per utenti senza match di lingua |
1948
2098
  | **Content Sync** | Sincronizzazione di contenuti tra sub-site di lingua diversa in un network multilingua |
1949
2099
  | **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) |
2101
+ | **CTR (Click-Through Rate)** | Rapporto percentuale tra impressioni e click — metrica chiave in Google Search Console e email marketing |
2102
+ | **Flesch-Kincaid** | Formula di leggibilita che stima il livello scolastico necessario per comprendere un testo — usata nell'AI content optimization |
2103
+ | **Content Triage** | Classificazione rapida di tutti i contenuti in categorie di azione: Quick Wins, Maintain, Deep Review, Outdated |
2104
+ | **Quick Wins** | Contenuti che richiedono piccole ottimizzazioni (titolo, meta description) per ottenere significativi miglioramenti di performance |
2105
+ | **Service Account** | Account Google di servizio (JSON key) per accesso server-to-server a Google Search Console senza autenticazione interattiva |
2106
+ | **Mailchimp** | Piattaforma di email marketing per newsletter e campagne — integrata via API con 7 tool MCP (prefix `mc_*`) |
2107
+ | **Buffer** | Piattaforma di social media scheduling — integrata via API con 5 tool MCP (prefix `buf_*`) |
2108
+ | **SendGrid** | Servizio di email transazionale e marketing — integrato via API con 6 tool MCP (prefix `sg_*`) |
2109
+ | **GSC (Google Search Console)** | Strumento Google per monitorare presence del sito nei risultati di ricerca — integrato con 8 tool MCP (prefix `gsc_*`) |
1950
2110
 
1951
2111
  ---
1952
2112
 
1953
- *Guida v2.3.0 - WordPress Manager Plugin per Claude Code*
1954
- *Ultimo aggiornamento: 2026-02-28*
2113
+ *Guida v2.6.0 - WordPress Manager Plugin per Claude Code*
2114
+ *Ultimo aggiornamento: 2026-03-01*