SEO Article Generator

Autore: Claudio Novaglio Versione: 1.0.0

Plugin WordPress professionale per la generazione automatica di articoli SEO usando intelligenza artificiale tramite OpenRouter API, con funzionalità avanzate di keyword research, analytics e integrazione Google Search Console.

✨ Caratteristiche Principali

🤖 Generazione AI Avanzata

• Modelli Multipli: Supporto per Gemini 2.0 Flash, Claude Sonnet 4.5, GPT-4.1, Llama 3.1 e altri via OpenRouter
• Ricerca Web Integrata: Gemini include ricerca web automatica (grounding) per contenuti sempre aggiornati
• Business DNA: Analisi automatica del tuo sito per mantenere tono, stile e identità del brand
• Topic Suggester: AI suggerisce topic basati su trend e gap analysis

🔍 Keyword Research Integrato

• Ricerca AI-Powered: Genera keyword correlate e long-tail automaticamente
• Metriche Complete: Volume di ricerca, difficoltà, CPC, competizione (stimate)
• Best Opportunities: Identifica keyword ad alto potenziale (alto volume, bassa difficoltà)
• Competitor Analysis: Analizza SERP e identifica gap di contenuto
• Database Keyword: Traccia tutte le keyword e il loro utilizzo

📊 Analytics Avanzate

• ROI Calculator: Calcola il ritorno sull'investimento delle tue campagne content
• Grafici Interattivi: Visualizza trend di generazione articoli e performance GSC (Chart.js)
• Model Comparison: Confronta performance e costi per ogni modello AI
• Top Performing: Identifica gli articoli con migliori performance SEO
• Metriche Aggregate: Totale articoli, parole, costi, impressioni, click

🔗 Google Search Console Integration

• RankMath PRO Integration: Se hai RankMath PRO connesso, usa automaticamente quei dati (ZERO configurazione!)
• OAuth2 Manuale: Connessione diretta a Google Search Console (opzionale)
• Dati Real-Time: Impressioni, click, CTR, posizione media
• Opportunità SEO: Identifica query con alto potenziale (alte impressioni, basso CTR)
• Topic Suggestions: Suggerimenti basati su performance reali del tuo sito

✍️ Creazione Articoli Intelligente

• Articoli ottimizzati SEO con struttura H2/H3/H4
• Meta description e focus keyword automatiche
• Lunghezze configurabili (800-1000 / 1500-2000 / 3000+ parole)
• Integrazione con categorie e tag WordPress
• RankMath SEO score tracking

⏰ Pubblicazione Automatizzata

• Scheduler Avanzato: Pianifica batch di articoli con selezione automatica topic
• Cron Jobs: Pubblicazione automatica tramite WordPress cron
• Salva come bozza per revisione manuale
• Pubblicazione immediata o programmata
• Queue Management: Gestisci la coda di articoli da generare

Requisiti

• WordPress 5.8+
• PHP 7.4+
• Account OpenRouter (gratuito per alcuni modelli)
• Opzionale ma consigliato: RankMath PRO (per dati Google Search Console automatici)

Installazione

Metodo 1: Upload ZIP

1. Scarica il plugin come file ZIP
2. Vai su Plugin → Aggiungi Nuovo → Carica Plugin
3. Seleziona il file ZIP
4. Clicca Installa Ora
5. Attiva il plugin

Metodo 2: FTP/SFTP

1. Carica la cartella seo-article-generator in wp-content/plugins/
2. Vai su Plugin nel pannello WordPress
3. Attiva SEO Article Generator

Configurazione Iniziale

1. Vai su SEO Articles → Impostazioni
2. Inserisci la tua OpenRouter API Key
3. Se hai RankMath PRO: il plugin rileverà automaticamente i dati GSC!
4. Configura le impostazioni predefinite (modello, lunghezza)

Configurazione

1. Ottieni OpenRouter API Key

1. Vai su OpenRouter.ai
2. Crea un account gratuito
3. Genera una API key dalla sezione "Keys"
4. Copia la key (inizia con sk-or-)

2. Configura Business DNA

Il plugin analizza automaticamente il tuo sito alla prima attivazione per estrarre:

• Settore/industria
• Tono di scrittura
• Topic principali
• Keywords ricorrenti

Puoi modificare questi dati manualmente in SEO Articles → Business DNA

3. Configura Google Search Console (Opzionale)

Opzione A: Con RankMath PRO (CONSIGLIATA - Zero Configurazione)

1. Assicurati che RankMath PRO sia attivo
2. Connetti Google Search Console in RankMath
3. Il plugin rileverà automaticamente i dati!
4. Vai su SEO Articles → Impostazioni → Google Search Console
5. Clicca "Importa Dati da RankMath" per copiare i dati nel database del plugin

Opzione B: Connessione OAuth2 Manuale

1. Vai su Google Cloud Console
2. Crea un progetto e abilita "Search Console API"
3. Crea credenziali OAuth 2.0
4. Aggiungi redirect URI: https://tuosito.com/wp-admin/admin.php?page=sag-settings&gsc_callback=1
5. Copia Client ID e Secret nelle impostazioni del plugin
6. Clicca "Connetti a Google Search Console"

4. Genera il tuo primo articolo

1. Vai su SEO Articles → Genera Articolo
2. Inserisci il topic
3. Scegli modello AI e lunghezza
4. Seleziona categorie/tag
5. Scegli modalità pubblicazione
6. Clicca "Genera Articolo"

Modelli Disponibili (Ottobre 2025)

🌟 Google Gemini 2.5 Flash (Consigliato)

• Costo: ~$0.075-0.30 / 1M tokens
• Ricerca Web: ✅ Integrata (grounding)
• Ideale per: Articoli SEO con info aggiornate, veloce ed economico

🧠 Claude 3.7 Sonnet

• Costo: $3 input / $15 output per 1M tokens
• Ricerca Web: ❌ (usa prompt-based)
• Ideale per: Reasoning avanzato, coding, problem-solving, contenuti premium

🚀 GPT-4.1

• Costo: $2 input / $8 output per 1M tokens
• Context: 1M token window
• Ideale per: Coding, long-context reasoning, instruction following

⚡ GPT-4.1 Mini

• Costo: $0.40 input / $1.60 output per 1M tokens
• Ideale per: Bilanciato qualità/prezzo, bassa latenza

💨 GPT-5 Nano

• Costo: $0.05 input / $0.40 output per 1M tokens
• Ideale per: Real-time, velocissimo, economico

🦙 Llama 3.1 8B Instruct

• Costo: $0.02 input / $0.03 output per 1M tokens
• Ideale per: Budget limitato, velocità, open source

Vedi la lista completa su OpenRouter Models

Struttura File

seo-article-generator/
├── seo-article-generator.php       # File principale
├── README.md                       # Documentazione
├── includes/                       # Classi core
│   ├── class-database.php          # Gestione database + metodi keyword/GSC
│   ├── class-business-dna.php      # Analisi DNA sito
│   ├── class-web-search.php        # Ricerca web
│   ├── class-article-generator.php # Generazione articoli AI
│   ├── class-topic-suggester.php   # Suggerimenti topic
│   ├── class-scheduler.php         # Scheduler e queue
│   ├── class-keyword-research.php  # Keyword research AI
│   ├── class-gsc-integration.php   # Google Search Console + RankMath
│   └── functions.php               # Helper functions
├── admin/                          # Interfaccia admin
│   ├── class-admin-menu.php        # Menu, AJAX handlers
│   ├── pages/                      # Pagine admin
│   │   ├── dashboard.php           # Dashboard principale
│   │   ├── generate-article.php    # Form generazione
│   │   ├── schedule.php            # Scheduler batch
│   │   ├── business-dna.php        # Gestione DNA
│   │   ├── keyword-research.php    # Keyword research
│   │   ├── analytics.php           # Analytics avanzate
│   │   └── settings.php            # Impostazioni
│   └── assets/                     # CSS/JS
│       ├── css/admin.css
│       ├── js/admin.js
│       └── js/charts.js            # Chart.js implementation
└── languages/                      # Traduzioni

Database

Il plugin crea 5 tabelle custom:

wp_sag_generated_articles - Tracking Articoli

• Post ID, Topic, Modello AI usato
• Status pubblicazione
• Data generazione e pubblicazione
• Word count, Costo API
• SEO score (RankMath)
• Search queries utilizzate

wp_sag_article_queue - Coda Scheduler

• Topic programmati per generazione batch
• Priorità, status, retry count
• Dati trend e score topic
• Link a post generato

wp_sag_keywords - Database Keyword

• Keyword, volume ricerca, difficoltà
• CPC, competizione
• Keyword correlate
• Trend data, utilizzo in articoli

wp_sag_gsc_data - Dati Google Search Console

• Query, impressioni, click, CTR, posizione
• Range date, post ID associato
• Importato da RankMath o OAuth2

Tabelle RankMath (Lettura)

Se RankMath PRO è attivo, il plugin legge anche da:

• wp_rank_math_analytics_gsc - Dati GSC di RankMath
• wp_rank_math_analytics_ga - Dati Analytics (futuro)

Hook e Filtri

Actions

// Dopo generazione articolo
do_action( 'sag_after_article_generated', $post_id, $article_data );

// Prima di pubblicare articolo programmato
do_action( 'sag_before_publish_scheduled', $post_id );

Filters

// Modifica prompt system
add_filter( 'sag_system_prompt', function( $prompt, $dna ) {
    return $prompt . "\n\nCustom instructions...";
}, 10, 2 );

// Modifica dati articolo prima creazione post
add_filter( 'sag_article_data_before_create', function( $data, $args ) {
    $data['content'] .= "\n\nCustom footer...";
    return $data;
}, 10, 2 );

FAQ

Q: Il plugin è gratuito? A: Il plugin è gratuito. Dovrai pagare per l'uso dell'API OpenRouter in base al modello scelto.

Q: Quanto costa generare un articolo? A: Dipende dal modello e lunghezza. Esempi per articolo medio (2000 parole = ~3000 tokens):

• Gemini 2.5 Flash: ~$0.0009 (~1 centesimo ogni 10 articoli)
• GPT-4.1 Mini: ~$0.003 (~1 centesimo ogni 3 articoli)
• Claude 3.7 Sonnet: ~$0.03-0.05 (3-5 centesimi)
• Llama 3.1 8B: ~$0.0001 (praticamente gratis)

Q: Posso modificare gli articoli generati? A: Sì! Gli articoli vengono salvati come normali post WordPress. Puoi modificarli prima/dopo la pubblicazione.

Q: Il plugin supporta lingue diverse dall'italiano? A: Sì, il Business DNA rileva automaticamente la lingua del sito. Il plugin è progettato per WordPress in italiano ma funziona con qualsiasi lingua.

Q: Funziona con Gutenberg? A: Sì, gli articoli generati sono compatibili con Gutenberg e l'editor classico.

Q: Come posso migliorare la qualità degli articoli? A:

1. Configura accuratamente il Business DNA
2. Usa topic specifici e descrittivi
3. Scegli Claude per contenuti premium
4. Rivedi sempre gli articoli prima della pubblicazione

Sviluppo

Debug

Abilita debug in wp-config.php:

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);

I log verranno salvati in wp-content/debug.log

Testing

# Via WP-CLI
wp plugin list
wp plugin activate seo-article-generator
wp cron event list

Changelog

1.0.0 (2025-11-01)

Release Iniziale - Full Featured

Core Features

• ✅ Generazione articoli AI con 6+ modelli (Gemini, Claude, GPT, Llama)
• ✅ Business DNA Analyzer automatico
• ✅ Ricerca web integrata (Gemini grounding)
• ✅ Topic Suggester AI-powered
• ✅ Scheduler avanzato con queue management
• ✅ RankMath SEO integration

Nuove Features SEO Avanzate

• 🆕 Keyword Research integrato con AI

  • Generazione keyword correlate e long-tail
  • Metriche: volume, difficoltà, CPC, competizione
  • Best opportunities finder
  • Competitor analysis
  • Database keyword con tracking utilizzo

• 🆕 Analytics Avanzate

  • ROI Calculator
  • Grafici interattivi (Chart.js)
  • Model performance comparison
  • Top performing articles tracking
  • Metriche aggregate complete

• 🆕 Google Search Console Integration

  • RankMath PRO Integration (ZERO configurazione!)
  • Lettura automatica dati da RankMath
  • OAuth2 manuale (opzionale)
  • Import dati: impressioni, click, CTR, posizione
  • Identificazione opportunità SEO
  • Topic suggestions basati su performance reali

Technical

• Database: 5 tabelle custom (articoli, queue, keywords, GSC)
• Security: Nonce verification, capability checks, prepared statements
• Cron jobs: 3 task automatizzati
• Architecture: OOP, Singleton pattern, WordPress coding standards
• Compatibility: WordPress 5.8+, PHP 7.4+

Supporto

Per bug report e feature request, apri una issue su GitHub.

Licenza

GPL v2 or later

Credits

Sviluppato con ❤️ per WordPress