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.
- package/.claude-plugin/plugin.json +8 -3
- package/CHANGELOG.md +20 -0
- package/agents/wp-distribution-manager.md +98 -0
- package/docs/plans/2026-03-01-tier3-wcop-design.md +373 -0
- package/docs/plans/2026-03-01-tier3-wcop-implementation.md +915 -0
- package/hooks/hooks.json +18 -0
- package/package.json +9 -3
- package/servers/wp-rest-bridge/build/tools/buffer.d.ts +3 -0
- package/servers/wp-rest-bridge/build/tools/buffer.js +205 -0
- package/servers/wp-rest-bridge/build/tools/index.js +9 -0
- package/servers/wp-rest-bridge/build/tools/mailchimp.d.ts +3 -0
- package/servers/wp-rest-bridge/build/tools/mailchimp.js +265 -0
- package/servers/wp-rest-bridge/build/tools/sendgrid.d.ts +3 -0
- package/servers/wp-rest-bridge/build/tools/sendgrid.js +255 -0
- package/servers/wp-rest-bridge/build/types.d.ts +122 -0
- package/servers/wp-rest-bridge/build/wordpress.d.ts +9 -0
- package/servers/wp-rest-bridge/build/wordpress.js +112 -0
- package/skills/wordpress-router/references/decision-tree.md +4 -2
- package/skills/wp-content/SKILL.md +1 -0
- package/skills/wp-content-repurposing/SKILL.md +1 -0
- package/skills/wp-social-email/SKILL.md +152 -0
- package/skills/wp-social-email/references/audience-segmentation.md +173 -0
- package/skills/wp-social-email/references/buffer-social-publishing.md +124 -0
- package/skills/wp-social-email/references/content-to-distribution.md +156 -0
- package/skills/wp-social-email/references/distribution-analytics.md +208 -0
- package/skills/wp-social-email/references/mailchimp-integration.md +145 -0
- package/skills/wp-social-email/references/sendgrid-transactional.md +165 -0
- package/skills/wp-social-email/scripts/distribution_inspect.mjs +165 -0
- package/skills/wp-webhooks/SKILL.md +1 -0
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "wordpress-manager",
|
|
3
|
-
"version": "2.
|
|
4
|
-
"description": "Unified WordPress management plugin for Claude Code. Orchestrates Hostinger MCP (infrastructure), WP REST API bridge (
|
|
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*
|