claude-plugin-wordpress-manager 2.3.1 → 2.4.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 (29) hide show
  1. package/.claude-plugin/plugin.json +8 -3
  2. package/CHANGELOG.md +20 -0
  3. package/agents/wp-distribution-manager.md +98 -0
  4. package/docs/plans/2026-03-01-tier3-wcop-design.md +373 -0
  5. package/docs/plans/2026-03-01-tier3-wcop-implementation.md +915 -0
  6. package/hooks/hooks.json +18 -0
  7. package/package.json +9 -3
  8. package/servers/wp-rest-bridge/build/tools/buffer.d.ts +3 -0
  9. package/servers/wp-rest-bridge/build/tools/buffer.js +205 -0
  10. package/servers/wp-rest-bridge/build/tools/index.js +9 -0
  11. package/servers/wp-rest-bridge/build/tools/mailchimp.d.ts +3 -0
  12. package/servers/wp-rest-bridge/build/tools/mailchimp.js +265 -0
  13. package/servers/wp-rest-bridge/build/tools/sendgrid.d.ts +3 -0
  14. package/servers/wp-rest-bridge/build/tools/sendgrid.js +255 -0
  15. package/servers/wp-rest-bridge/build/types.d.ts +122 -0
  16. package/servers/wp-rest-bridge/build/wordpress.d.ts +9 -0
  17. package/servers/wp-rest-bridge/build/wordpress.js +112 -0
  18. package/skills/wordpress-router/references/decision-tree.md +4 -2
  19. package/skills/wp-content/SKILL.md +1 -0
  20. package/skills/wp-content-repurposing/SKILL.md +1 -0
  21. package/skills/wp-social-email/SKILL.md +152 -0
  22. package/skills/wp-social-email/references/audience-segmentation.md +173 -0
  23. package/skills/wp-social-email/references/buffer-social-publishing.md +124 -0
  24. package/skills/wp-social-email/references/content-to-distribution.md +156 -0
  25. package/skills/wp-social-email/references/distribution-analytics.md +208 -0
  26. package/skills/wp-social-email/references/mailchimp-integration.md +145 -0
  27. package/skills/wp-social-email/references/sendgrid-transactional.md +165 -0
  28. package/skills/wp-social-email/scripts/distribution_inspect.mjs +165 -0
  29. package/skills/wp-webhooks/SKILL.md +1 -0
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "wordpress-manager",
3
- "version": "2.3.1",
4
- "description": "Unified WordPress management plugin for Claude Code. Orchestrates Hostinger MCP (infrastructure), WP REST API bridge (85 tools incl. WooCommerce + Multisite + Webhooks), and WordPress.com MCP (hosted sites) with 11 specialized agents, 33 skills, and security hooks. Includes programmatic SEO, content-commerce attribution, multi-language network, fleet monitoring, content repurposing, webhook propagation, site monitoring (uptime, performance baseline, security scanning, content integrity, alerting), CI/CD pipeline automation (GitHub Actions, GitLab CI, Bitbucket), WordPress Multisite network management, WooCommerce store management, local dev environment support, development, testing, security, i18n, accessibility, headless, and operations.",
3
+ "version": "2.4.0",
4
+ "description": "Unified WordPress management plugin for Claude Code. Orchestrates Hostinger MCP (infrastructure), WP REST API bridge (103 tools incl. WooCommerce + Multisite + Webhooks + Mailchimp + Buffer + SendGrid), and WordPress.com MCP (hosted sites) with 12 specialized agents, 34 skills, and security hooks. Includes social/email distribution (Mailchimp, Buffer, SendGrid), programmatic SEO, content-commerce attribution, multi-language network, fleet monitoring, content repurposing, webhook propagation, site monitoring, CI/CD pipeline automation, WordPress Multisite network management, WooCommerce store management, local dev environment support, development, testing, security, i18n, accessibility, headless, and operations.",
5
5
  "author": {
6
6
  "name": "vinmor",
7
7
  "email": "morreale.v@gmail.com"
@@ -25,7 +25,12 @@
25
25
  "ci-cd",
26
26
  "github-actions",
27
27
  "monitoring",
28
- "uptime"
28
+ "uptime",
29
+ "mailchimp",
30
+ "buffer",
31
+ "sendgrid",
32
+ "social-media",
33
+ "email-marketing"
29
34
  ],
30
35
  "mcpServers": "./.mcp.json"
31
36
  }
package/CHANGELOG.md CHANGED
@@ -2,6 +2,26 @@
2
2
 
3
3
  All notable changes to the WordPress Manager plugin for Claude Code.
4
4
 
5
+ ## [2.4.0] - 2026-03-01
6
+
7
+ ### Added
8
+ - **Social/Email Distribution skill** (`wp-social-email`) — content distribution to Mailchimp, Buffer, and SendGrid
9
+ - 6 reference files: `mailchimp-integration.md`, `buffer-social-publishing.md`, `sendgrid-transactional.md`, `content-to-distribution.md`, `audience-segmentation.md`, `distribution-analytics.md`
10
+ - Detection script: `distribution_inspect.mjs` (WP_SITES_CONFIG keys, WP distribution plugins, content readiness)
11
+ - **18 new MCP tools** via WP REST Bridge:
12
+ - 7 Mailchimp tools: `mc_list_audiences`, `mc_get_audience_members`, `mc_create_campaign`, `mc_update_campaign_content`, `mc_send_campaign`, `mc_get_campaign_report`, `mc_add_subscriber`
13
+ - 5 Buffer tools: `buf_list_profiles`, `buf_create_update`, `buf_list_pending`, `buf_list_sent`, `buf_get_analytics`
14
+ - 6 SendGrid tools: `sg_send_email`, `sg_list_templates`, `sg_get_template`, `sg_list_contacts`, `sg_add_contacts`, `sg_get_stats`
15
+ - **wp-distribution-manager agent** (indigo) — 5 procedures: detect services, fetch WP content, format for channel, publish/schedule, track analytics
16
+ - **2 safety hooks**: PreToolUse confirmation for `mc_send_campaign` and `sg_send_email`
17
+ - TypeScript types: `MCMailchimpAudience`, `MCCampaign`, `MCCampaignReport`, `BufProfile`, `BufUpdate`, `SGEmailRequest`, `SGTemplate`, `SGStats`
18
+ - SiteConfig extended with `mailchimp_api_key`, `buffer_access_token`, `sendgrid_api_key`
19
+
20
+ ### Changed
21
+ - Router decision-tree.md upgraded to v11 with social/email distribution keywords and routing
22
+ - Cross-references added: `wp-content-repurposing` → wp-social-email, `wp-webhooks` → wp-social-email, `wp-content` → wp-social-email
23
+ - Plugin now has 34 skills, 12 agents, and 103 MCP tools
24
+
5
25
  ## [2.3.1] - 2026-02-28
6
26
 
7
27
  ### Changed
@@ -0,0 +1,98 @@
1
+ ---
2
+ name: wp-distribution-manager
3
+ color: indigo
4
+ description: |
5
+ Use this agent when the user needs to distribute WordPress content to social media
6
+ and email channels: Mailchimp campaigns, Buffer social posts, SendGrid transactional
7
+ emails, cross-channel content distribution, or distribution analytics.
8
+
9
+ <example>
10
+ Context: User wants to send a newsletter from their latest blog posts.
11
+ user: "Crea una campagna Mailchimp con i 3 articoli più recenti del blog"
12
+ assistant: "I'll use the wp-distribution-manager agent to fetch recent posts and create a Mailchimp campaign."
13
+ <commentary>Creating a newsletter campaign from blog content requires fetching WP posts and composing a Mailchimp campaign.</commentary>
14
+ </example>
15
+
16
+ <example>
17
+ Context: User wants to schedule social media posts for a new article.
18
+ user: "Schedule this blog post to Buffer for Twitter and LinkedIn"
19
+ assistant: "I'll use the wp-distribution-manager agent to create Buffer updates for multiple social profiles."
20
+ <commentary>Multi-profile social scheduling requires the distribution agent for coordinated posting.</commentary>
21
+ </example>
22
+
23
+ <example>
24
+ Context: User wants to check email campaign performance.
25
+ user: "Show me the open rates and click rates for the last 5 Mailchimp campaigns"
26
+ assistant: "I'll use the wp-distribution-manager agent to fetch campaign reports and compile performance metrics."
27
+ <commentary>Distribution analytics across campaigns requires the specialized agent.</commentary>
28
+ </example>
29
+
30
+ model: inherit
31
+ tools: Read, Grep, Glob, Bash, WebFetch, WebSearch
32
+ ---
33
+
34
+ # Content Distribution Manager
35
+
36
+ ## 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.
38
+
39
+ ## Procedures
40
+
41
+ ### Procedure 1: Detect Available Services
42
+ 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)
45
+ 3. Report available channels
46
+
47
+ ### Procedure 2: Fetch WordPress Content
48
+ 1. Use WordPress REST tools (wp_list_posts, wp_get_post) to fetch content
49
+ 2. Extract title, excerpt, content, featured image URL, categories, tags
50
+ 3. Format for distribution (adapt per channel)
51
+
52
+ ### Procedure 3: Format for Channel
53
+ - **Email (Mailchimp)**: HTML template with header, post excerpt, read-more link, footer
54
+ - **Social (Buffer)**: Short text (280 chars for Twitter, longer for LinkedIn), link, hashtags from tags
55
+ - **Transactional (SendGrid)**: Structured email with personalization variables
56
+
57
+ ### Procedure 4: Publish / Schedule
58
+ - **Mailchimp**: mc_create_campaign -> mc_update_campaign_content -> mc_send_campaign (with user confirmation)
59
+ - **Buffer**: buf_create_update with optional scheduled_at
60
+ - **SendGrid**: sg_send_email (with user confirmation for bulk sends)
61
+
62
+ IMPORTANT: Always confirm with user before sending emails (mc_send_campaign, sg_send_email). These are destructive operations that deliver real messages.
63
+
64
+ ### Procedure 5: Track Analytics
65
+ 1. Mailchimp: mc_get_campaign_report (opens, clicks, bounces)
66
+ 2. Buffer: buf_get_analytics (clicks, reach, impressions)
67
+ 3. SendGrid: sg_get_stats (delivered, opens, clicks, bounces)
68
+ 4. Compile cross-channel performance summary
69
+
70
+ ## Report Template
71
+
72
+ After each distribution operation, provide:
73
+ | Field | Value |
74
+ |-------|-------|
75
+ | Channel | Mailchimp / Buffer / SendGrid |
76
+ | Action | Campaign sent / Post scheduled / Email delivered |
77
+ | Content | [Post title or campaign name] |
78
+ | Audience | [List name / Profile / Recipients] |
79
+ | Status | Sent / Scheduled / Draft |
80
+ | Next Steps | [Check analytics in 24h / Send follow-up / etc.] |
81
+
82
+ ## Safety
83
+
84
+ - NEVER send campaigns or emails without explicit user confirmation
85
+ - Always show content preview before send
86
+ - Verify audience/recipient list before mass sends
87
+ - Safety hooks are active for mc_send_campaign and sg_send_email
88
+
89
+ ## Related Skills
90
+
91
+ - **wp-social-email** -- Full skill with 6 reference files for all distribution workflows
92
+ - **wp-content-repurposing** -- Transform content for different channels before distributing
93
+ - **wp-webhooks** -- Webhook-based distribution alternative
94
+ - **wp-content** -- Source content from WordPress
95
+
96
+ ## Context
97
+
98
+ Working directory: `/home/vinmor/.claude/plugins/local/wordpress-manager`
@@ -0,0 +1,373 @@
1
+ # Tier 3 WCOP — Social/Email Connectors, GSC Integration, AI Content Optimization
2
+
3
+ **Data:** 2026-03-01
4
+ **Stato:** Approvato
5
+ **Baseline:** v2.3.1 (33 skill, 11 agent, 85 MCP tools, 21 detection scripts, 162 reference files)
6
+ **Approccio:** Connector-First (Approccio A) — MCP tool TypeScript separati per ogni servizio
7
+
8
+ ---
9
+
10
+ ## Riepilogo Decisioni
11
+
12
+ | Decisione | Scelta |
13
+ |-----------|--------|
14
+ | Priorita | Tutti e 3 in ordine |
15
+ | Architettura connettori | MCP tool diretti (non webhook bridge) |
16
+ | Servizi v2.4.0 | Mailchimp + Buffer + SendGrid |
17
+ | GSC auth | OAuth2 via Service Account + googleapis npm |
18
+ | AI Content | Claude-native (zero API esterne) |
19
+ | Versioning | 3 minor release (v2.4.0, v2.5.0, v2.6.0) |
20
+
21
+ ---
22
+
23
+ ## Release Plan
24
+
25
+ | Release | Feature | Effort | Nuovi MCP Tool | Nuove Skill | Nuovi Agent |
26
+ |---------|---------|--------|----------------|-------------|-------------|
27
+ | v2.4.0 | Social/Email Connectors | Alto | +18 (7 MC + 5 Buf + 6 SG) | +1 | +1 |
28
+ | v2.5.0 | GSC Integration | Medio | +8 | +1 | 0 (agent update) |
29
+ | v2.6.0 | AI Content Optimization | Medio | 0 | +1 | 0 (agent update) |
30
+
31
+ ### Conteggi a fine Tier 3
32
+
33
+ | Metrica | v2.3.1 (oggi) | v2.6.0 (target) | Delta |
34
+ |---------|---------------|-----------------|-------|
35
+ | Skills | 33 | 36 | +3 |
36
+ | Agents | 11 | 12 | +1 |
37
+ | MCP Tools | 85 | 111 | +26 |
38
+ | Detection scripts | 21 | 24 | +3 |
39
+ | Reference files | 162 | 178 | +16 |
40
+
41
+ ---
42
+
43
+ ## v2.4.0 — Social/Email Connectors
44
+
45
+ ### Componenti
46
+
47
+ | Tipo | Nome | Descrizione |
48
+ |------|------|-------------|
49
+ | Skill | `wp-social-email` | Social publishing e email marketing da WordPress |
50
+ | Agent | `wp-distribution-manager` | Distribuzione contenuti multi-canale (color: indigo) |
51
+ | MCP Tools | 3 file TypeScript | 18 nuovi tool nel WP REST Bridge |
52
+ | Detection | `distribution_inspect.mjs` | Rileva configurazione Mailchimp/Buffer/SendGrid |
53
+
54
+ ### MCP Tool — Mailchimp (7 tool)
55
+
56
+ | Tool | Descrizione | Endpoint |
57
+ |------|-------------|----------|
58
+ | `mc_list_audiences` | Lista audience/liste | GET /lists |
59
+ | `mc_get_audience_members` | Membri di un'audience | GET /lists/{id}/members |
60
+ | `mc_create_campaign` | Crea campagna email | POST /campaigns |
61
+ | `mc_update_campaign_content` | Imposta contenuto HTML | PUT /campaigns/{id}/content |
62
+ | `mc_send_campaign` | Invia campagna (safety gate) | POST /campaigns/{id}/actions/send |
63
+ | `mc_get_campaign_report` | Report performance campagna | GET /reports/{id} |
64
+ | `mc_add_subscriber` | Aggiungi subscriber a lista | POST /lists/{id}/members |
65
+
66
+ **Auth**: Mailchimp API key (formato `key-dc`) nel SiteConfig campo `mailchimp_api_key`.
67
+ **Base URL**: `https://{dc}.api.mailchimp.com/3.0/` dove `dc` e estratto dalla API key.
68
+
69
+ ### MCP Tool — Buffer (5 tool)
70
+
71
+ | Tool | Descrizione | Endpoint |
72
+ |------|-------------|----------|
73
+ | `buf_list_profiles` | Lista profili social collegati | GET /profiles |
74
+ | `buf_create_update` | Schedula post su profilo | POST /updates/create |
75
+ | `buf_list_pending` | Post in coda per profilo | GET /profiles/{id}/updates/pending |
76
+ | `buf_list_sent` | Post inviati per profilo | GET /profiles/{id}/updates/sent |
77
+ | `buf_get_analytics` | Analytics per post | GET /updates/{id}/analytics |
78
+
79
+ **Auth**: Buffer access token nel SiteConfig campo `buffer_access_token`.
80
+ **Base URL**: `https://api.bufferapp.com/1/`
81
+
82
+ ### MCP Tool — SendGrid (6 tool)
83
+
84
+ | Tool | Descrizione | Endpoint |
85
+ |------|-------------|----------|
86
+ | `sg_send_email` | Invia email transazionale (safety gate) | POST /mail/send |
87
+ | `sg_list_templates` | Lista template email | GET /templates |
88
+ | `sg_get_template` | Dettaglio template | GET /templates/{id} |
89
+ | `sg_list_contacts` | Lista contatti | GET /marketing/contacts |
90
+ | `sg_add_contacts` | Aggiungi contatti | PUT /marketing/contacts |
91
+ | `sg_get_stats` | Statistiche email | GET /stats |
92
+
93
+ **Auth**: SendGrid API key nel SiteConfig campo `sendgrid_api_key`.
94
+ **Base URL**: `https://api.sendgrid.com/v3/`
95
+
96
+ ### SiteConfig Extension
97
+
98
+ ```json
99
+ {
100
+ "id": "mysite",
101
+ "url": "https://mysite.com",
102
+ "username": "admin",
103
+ "password": "xxxx",
104
+ "mailchimp_api_key": "abc123-us21",
105
+ "buffer_access_token": "1/abc...",
106
+ "sendgrid_api_key": "SG.xxx..."
107
+ }
108
+ ```
109
+
110
+ Ogni gruppo di tool e disponibile solo se la relativa API key e configurata (pattern identico a WooCommerce `wc_consumer_key`).
111
+
112
+ ### Skill Reference Files (6)
113
+
114
+ | File | Contenuto |
115
+ |------|-----------|
116
+ | `mailchimp-integration.md` | Audience management, campaign creation, automation workflows |
117
+ | `buffer-social-publishing.md` | Multi-profile scheduling, optimal posting times, analytics |
118
+ | `sendgrid-transactional.md` | Template email, event-driven sending, delivery tracking |
119
+ | `content-to-distribution.md` | Workflow: WP content -> format per canale -> publish/schedule |
120
+ | `audience-segmentation.md` | Segmentazione audience cross-tool (Mailchimp segments + WP tags) |
121
+ | `distribution-analytics.md` | KPI cross-channel: open rate, CTR, engagement rate, conversions |
122
+
123
+ ### Agent `wp-distribution-manager`
124
+
125
+ - **Color**: indigo
126
+ - **Tools**: Read, Grep, Glob, Bash, WebFetch, WebSearch
127
+ - **Procedure**:
128
+ 1. Detect servizi configurati (`distribution_inspect.mjs`)
129
+ 2. Fetch contenuto WP via REST Bridge
130
+ 3. Format per canale target (social/email)
131
+ 4. Publish/schedule via MCP tool
132
+ 5. Track performance e report analytics
133
+ - **Safety**: conferma prima di `mc_send_campaign` e `sg_send_email`, preview contenuto prima di publish
134
+
135
+ ### Safety Hooks (2 nuovi)
136
+
137
+ - `mc_send_campaign` -> PreToolUse prompt confirmation
138
+ - `sg_send_email` -> PreToolUse prompt confirmation
139
+
140
+ ### Router v11
141
+
142
+ Nuove keyword in Step 2b:
143
+ ```
144
+ "pubblica su social" / "schedula post" / "Buffer" / "campagna email" / "Mailchimp" /
145
+ "newsletter" / "SendGrid" / "email transazionale" / "distribuzione contenuti"
146
+ -> wp-social-email skill + wp-distribution-manager agent
147
+ ```
148
+
149
+ ### Cross-references
150
+
151
+ - `wp-content-repurposing` -> "Per pubblicare il contenuto riproposto, usa `wp-social-email`"
152
+ - `wp-webhooks` -> "Per trigger event-driven verso email/social, combina `wp-webhooks` + `wp-social-email`"
153
+ - `wp-content` -> "Per distribuire contenuto dopo creazione, vedi `wp-social-email`"
154
+
155
+ ---
156
+
157
+ ## v2.5.0 — Google Search Console Integration
158
+
159
+ ### Componenti
160
+
161
+ | Tipo | Nome | Descrizione |
162
+ |------|------|-------------|
163
+ | Skill | `wp-search-console` | SEO feedback loop: keyword tracking, indexing, performance analysis |
164
+ | Agent | — | Estensione di `wp-content-strategist` (SEO workflow) |
165
+ | MCP Tools | 1 file TypeScript | 8 nuovi tool nel WP REST Bridge |
166
+ | Detection | `search_console_inspect.mjs` | Rileva sitemap.xml, robots.txt, SEO plugins, GSC config |
167
+
168
+ ### Autenticazione — OAuth2 via Service Account
169
+
170
+ GSC usa OAuth2. Implementazione via Service Account JSON key file.
171
+
172
+ Setup utente:
173
+ 1. Crea progetto Google Cloud
174
+ 2. Abilita Search Console API
175
+ 3. Crea Service Account con chiave JSON
176
+ 4. Aggiunge Service Account come utente in GSC
177
+ 5. Configura path JSON key in SiteConfig
178
+
179
+ ```json
180
+ {
181
+ "id": "mysite",
182
+ "gsc_service_account_key": "/path/to/service-account.json",
183
+ "gsc_site_url": "sc-domain:mysite.com"
184
+ }
185
+ ```
186
+
187
+ ### Dipendenza npm
188
+
189
+ ```
190
+ googleapis
191
+ ```
192
+
193
+ Necessaria per autenticazione Service Account e chiamate GSC API.
194
+
195
+ ### MCP Tools — Google Search Console (8 tool)
196
+
197
+ | Tool | Descrizione | GSC API |
198
+ |------|-------------|---------|
199
+ | `gsc_list_sites` | Lista siti verificati | GET sites |
200
+ | `gsc_search_analytics` | Query analytics (keyword, page, country, device) | POST searchAnalytics/query |
201
+ | `gsc_inspect_url` | Ispeziona stato indexing di un URL | POST urlInspection/index:inspect |
202
+ | `gsc_list_sitemaps` | Lista sitemap submesse | GET sitemaps |
203
+ | `gsc_submit_sitemap` | Submetti sitemap | PUT sitemaps/{feedpath} |
204
+ | `gsc_delete_sitemap` | Rimuovi sitemap (safety gate) | DELETE sitemaps/{feedpath} |
205
+ | `gsc_top_queries` | Top keyword per click/impressions (shortcut) | POST searchAnalytics/query (pre-filtered) |
206
+ | `gsc_page_performance` | Performance per singola pagina (shortcut) | POST searchAnalytics/query (page-filtered) |
207
+
208
+ ### Skill Reference Files (5)
209
+
210
+ | File | Contenuto |
211
+ |------|-----------|
212
+ | `gsc-setup.md` | Setup Google Cloud project, Service Account, verifica sito |
213
+ | `keyword-tracking.md` | Monitoraggio keyword: top queries, trends, keyword cannibalization |
214
+ | `indexing-management.md` | URL inspection, indexing status, sitemap management |
215
+ | `content-seo-feedback.md` | Workflow: GSC data -> content optimization -> re-measure |
216
+ | `competitor-gap-analysis.md` | Identificare keyword gap confrontando GSC data con contenuto esistente |
217
+
218
+ ### Agent Update: `wp-content-strategist`
219
+
220
+ Aggiunta sezione "SEO Feedback Loop":
221
+
222
+ ```
223
+ Procedura: GSC-Driven Content Optimization
224
+ 1. Fetch top queries da gsc_search_analytics (ultimi 28 giorni)
225
+ 2. Identifica keyword ad alto impression/basso CTR (opportunita)
226
+ 3. Fetch contenuto corrispondente via list_content
227
+ 4. Analizza: titolo/meta description allineati alle query?
228
+ 5. Suggerisci ottimizzazioni (title tag, meta description, H1)
229
+ 6. Dopo ottimizzazione: ri-misura CTR dopo 2-4 settimane
230
+ ```
231
+
232
+ ### Cross-references
233
+
234
+ - `wp-programmatic-seo` -> "Per monitorare performance pagine generate, usa `wp-search-console`"
235
+ - `wp-content-attribution` -> "Per correlare keyword GSC con conversioni WooCommerce, combina `wp-search-console` + `wp-content-attribution`"
236
+ - `wp-monitoring` -> "Per trend SEO, aggiungi check GSC al monitoring periodico"
237
+
238
+ ---
239
+
240
+ ## v2.6.0 — AI Content Optimization
241
+
242
+ ### Componenti
243
+
244
+ | Tipo | Nome | Descrizione |
245
+ |------|------|-------------|
246
+ | Skill | `wp-content-optimization` | Ottimizzazione contenuti AI-driven: headline, readability, SEO density |
247
+ | Agent | — | Estensione di `wp-content-strategist` (AI optimization workflow) |
248
+ | MCP Tools | 0 | Nessun nuovo tool — usa Claude + tool WP REST Bridge esistenti + GSC |
249
+ | Detection | `content_optimization_inspect.mjs` | Rileva volume contenuti, SEO plugins, readability plugins, content age |
250
+
251
+ ### Filosofia: Claude-Native
252
+
253
+ Nessuna API esterna. L'agent usa le proprie capacita di analisi linguistica + dati quantitativi da GSC (v2.5.0) + metriche WooCommerce (wp-content-attribution). Chiude il loop WCOP.
254
+
255
+ ### Procedure Agent (6)
256
+
257
+ | # | Procedura | Input | Output |
258
+ |---|-----------|-------|--------|
259
+ | 1 | Headline Analysis | Titolo + keyword target | Score 1-10, 3 alternative ottimizzate |
260
+ | 2 | Readability Analysis | Body contenuto | Flesch-Kincaid score, frasi troppo lunghe, suggerimenti |
261
+ | 3 | SEO Content Scoring | Body + keyword + GSC data | Keyword density, H2/H3 coverage, internal linking gaps |
262
+ | 4 | Meta Description Optimization | Current meta + GSC CTR data | Meta ottimizzata per CTR, A/B variant |
263
+ | 5 | Content Freshness Audit | Lista contenuti + publish date | Contenuti obsoleti, priorita aggiornamento |
264
+ | 6 | Bulk Content Triage | N contenuti + GSC data | Classifica: quick wins, needs rewrite, archive |
265
+
266
+ ### Bulk Content Triage — Classificazione
267
+
268
+ | Categoria | Criteri | Azione |
269
+ |-----------|---------|--------|
270
+ | Quick Wins | Alto traffico + basso CTR, headline debole | Ottimizza title/meta |
271
+ | Needs Rewrite | >12 mesi, readability bassa, keyword off-target | Riscrittura |
272
+ | Performing | Alto traffico + alto CTR | Mantenere, refresh date |
273
+ | Archive | Zero traffico >6 mesi, nessuna keyword | Redirect 301 o noindex |
274
+
275
+ ### Skill Reference Files (5)
276
+
277
+ | File | Contenuto |
278
+ |------|-----------|
279
+ | `headline-optimization.md` | Formule headline, power words, scoring criteria |
280
+ | `readability-analysis.md` | Flesch-Kincaid, sentence length, passive voice, jargon |
281
+ | `seo-content-scoring.md` | Keyword density, H-tag hierarchy, internal link analysis |
282
+ | `meta-optimization.md` | Title tag + meta description best practices, CTR optimization |
283
+ | `content-freshness.md` | Content decay, refresh strategies, evergreen vs temporal |
284
+
285
+ ### Agent Update: `wp-content-strategist`
286
+
287
+ Aggiunta sezione "AI Content Optimization Workflow":
288
+
289
+ ```
290
+ Procedura: Content Optimization Pipeline
291
+ 1. Fetch lista contenuti pubblicati (list_content status=published)
292
+ 2. Per ogni contenuto:
293
+ a. Fetch GSC data se disponibile (gsc_page_performance)
294
+ b. Analizza headline (Procedura 1)
295
+ c. Analizza readability (Procedura 2)
296
+ d. Score SEO (Procedura 3)
297
+ 3. Genera Optimization Report ordinato per impatto potenziale
298
+ 4. Per contenuti prioritari: suggerisci modifiche specifiche
299
+ 5. Se approvato: applica con update_content via REST Bridge
300
+ ```
301
+
302
+ ### Workflow Completo WCOP
303
+
304
+ ```
305
+ CREAZIONE -> DISTRIBUZIONE -> MONITORAGGIO -> OTTIMIZZAZIONE -> DISTRIBUZIONE
306
+ | | | | |
307
+ wp-content wp-social-email wp-search- wp-content- wp-social-email
308
+ wp-content- wp-distribution- console optimization (re-distribute
309
+ strategist manager wp-monitoring wp-content- optimized)
310
+ wp-monitoring- strategist
311
+ agent
312
+ ```
313
+
314
+ ### Cross-references
315
+
316
+ - `wp-content` -> "Per ottimizzare contenuto esistente, vedi `wp-content-optimization`"
317
+ - `wp-search-console` -> "Per GSC data come input di ottimizzazione, vedi `wp-content-optimization`"
318
+ - `wp-content-attribution` -> "Per prioritizzare su contenuti ad alto ROI, combina entrambi"
319
+ - `wp-programmatic-seo` -> "Per ottimizzare template programmatiche, vedi `wp-content-optimization`"
320
+
321
+ ---
322
+
323
+ ## WCOP Score Proiezione
324
+
325
+ | Layer | v2.3.1 (oggi) | v2.6.0 (target) |
326
+ |-------|---------------|-----------------|
327
+ | 1 — Content Factory | 9/10 | 9/10 |
328
+ | 2 — Quality Assurance | 8/10 | 9/10 (AI optimization) |
329
+ | 3 — Distribution | 4/10 | **8/10** (Social/Email/GSC connectors) |
330
+ | 4 — Observability | 5/10 | **7/10** (GSC feedback loop + monitoring) |
331
+ | 5 — Automation | 4/10 | **7/10** (distribution pipeline + optimization pipeline) |
332
+ | **Totale** | **6/10** | **8/10** |
333
+
334
+ ---
335
+
336
+ ## Ordine di Implementazione
337
+
338
+ ```
339
+ v2.4.0 — Social/Email Connectors
340
+ 1. Estensione types.ts (MailchimpConfig, BufferConfig, SendGridConfig)
341
+ 2. 3 file tool TypeScript (mailchimp.ts, buffer.ts, sendgrid.ts)
342
+ 3. Estensione wordpress.ts per client instances
343
+ 4. Detection script distribution_inspect.mjs
344
+ 5. Skill wp-social-email (SKILL.md + 6 reference files)
345
+ 6. Agent wp-distribution-manager.md
346
+ 7. Safety hooks (mc_send_campaign, sg_send_email)
347
+ 8. Router update v11 + cross-references
348
+ 9. Version bump + CHANGELOG
349
+ 10. Build, test, commit, publish npm + GitHub release
350
+
351
+ v2.5.0 — GSC Integration
352
+ 1. npm install googleapis in wp-rest-bridge
353
+ 2. Estensione types.ts (GSCConfig in SiteConfig)
354
+ 3. 1 file tool TypeScript (gsc.ts) con auth module
355
+ 4. Detection script search_console_inspect.mjs
356
+ 5. Skill wp-search-console (SKILL.md + 5 reference files)
357
+ 6. Agent update wp-content-strategist (SEO Feedback Loop)
358
+ 7. Router update v12 + cross-references
359
+ 8. Version bump + CHANGELOG
360
+ 9. Build, test, commit, publish npm + GitHub release
361
+
362
+ v2.6.0 — AI Content Optimization
363
+ 1. Detection script content_optimization_inspect.mjs
364
+ 2. Skill wp-content-optimization (SKILL.md + 5 reference files)
365
+ 3. Agent update wp-content-strategist (AI Optimization Workflow)
366
+ 4. Router update v13 + cross-references
367
+ 5. Version bump + CHANGELOG + GUIDE.md update
368
+ 6. Commit, publish npm + GitHub release
369
+ ```
370
+
371
+ ---
372
+
373
+ *Design Tier 3 WCOP v1.0 — wordpress-manager v2.3.1 -> v2.6.0 — 2026-03-01*