Descrizione

BlogEditorAI

BlogEditorAI e un plugin WordPress che ti aiuta a trasformare i contenuti del sito in un piano editoriale chiaro, con bozze pronte da rifinire.

Funziona solo nel backend (wp-admin): non aggiunge nulla al frontend del sito.

Requisiti consigliati

• Provider AI configurato (API key + modello).
• Modello testo consigliato: GPT 5.2 (valore campo modello: gpt-5.2).
• Modello immagini consigliato: 1.5 (usa nel campo immagini l’identificativo 1.5 previsto dal tuo provider).
• Google Search Console collegato (consigliato per priorita piu affidabili).
• Provider SERP consigliato: SerpApi (attualmente l’unico testato ufficialmente su questo plugin).

1) Cos’e e perche e utile

BlogEditorAI nasce per risolvere un problema semplice: passare da “non so cosa scrivere” a “ho un piano concreto e una bozza pronta” in poco tempo.

In pratica:

• legge i tuoi articoli esistenti;
• identifica temi, opportunita e possibili keyword;
• ti propone priorita;
• ti aiuta a creare bozze WordPress (in stato Draft, mai pubblicate automaticamente).

Risultato: meno tempo perso a decidere cosa fare, piu continuita editoriale.

2) Cosa fa il plugin (in modo pratico)

Le funzioni principali sono queste:

1. Analisi contenuti esistenti

• Legge gli ultimi N articoli (con filtri).
• Evidenzia temi ricorrenti e aree poco coperte.

2. Suggerimento keyword e priorita

• Suggerisce keyword utili.
• Mostra motivazioni (opportunita, rischio sovrapposizione, segnali disponibili).

3. Piano editoriale

• Aggiungi keyword al piano.
• Imposta stato, priorita, data e responsabile.

4. Generazione bozza

• Da un item del piano puoi creare una bozza in WordPress.
• Include struttura articolo e metadati base SEO.

5. Storico operazioni

• Traccia job, stati ed eventuali errori per capire cosa e successo.

3) A chi e pensato

• Editor e content manager: velocizzare scelta topic e produzione.
• SEO specialist: avere una base ordinata per prioritizzare.
• Owner/PM: vedere roadmap contenuti e stato di avanzamento.

Non serve essere sviluppatori per usarlo nelle funzioni principali.

4) Come funziona (flusso consigliato)

1. Vai in BlogEditorAI > Settings

• Imposta le credenziali minime (API provider AI).

2. Vai in BlogEditorAI > Dashboard

• Scegli se partire da zero o leggere contenuti esistenti.
• Avvia la lettura/analisi.

3. Valuta i suggerimenti

• Controlla cluster, keyword e priorita suggerite.
• Aggiungi al piano solo cio che ha senso per il tuo business.

4. Apri BlogEditorAI > Editorial Plan

• Organizza date, owner, priorita e note.

5. Crea bozza

• Clicca “Redigi bozza” su un item del piano.
• Revisiona sempre il testo prima della pubblicazione.

6. Monitora in Jobs and History

• Se un job fallisce, controlla stato e riprova dopo la correzione.

5) Risultati attesi

Con un uso corretto, in genere puoi aspettarti:

• un piano editoriale piu ordinato;
• tempi piu rapidi per creare bozze iniziali;
• minore rischio di scrivere contenuti ripetitivi;
• migliore chiarezza su “cosa fare prima”.

Importante: il plugin aiuta il processo decisionale, non garantisce risultati SEO automatici.

6) Panoramica delle sezioni del plugin

Dashboard

Serve per avviare ingest/analisi e vedere i suggerimenti principali.

Quando usarla:

• all’inizio del lavoro settimanale;
• quando vuoi trovare nuove idee;
• quando vuoi capire se aggiornare articoli esistenti.

Settings

Serve per configurare provider AI, stile editoriale e opzioni aggiuntive.

Quando usarla:

• prima del primo utilizzo;
• quando cambi provider, modello o policy di stile.

Search Console

Serve per collegare Google Search Console e usare dati reali (impression, CTR, posizione).

Quando usarla:

• dopo la configurazione base;
• ogni volta che vuoi sincronizzare dati aggiornati.

Editorial Plan

Serve per trasformare suggerimenti in piano operativo (chi fa cosa e quando).

Quando usarla:

• dopo la fase di analisi;
• per gestire il lavoro editoriale in modo continuo.

Jobs and History

Serve per vedere lo stato delle operazioni (in coda, in corso, completate, fallite).

Quando usarla:

• se qualcosa non torna;
• per audit interno e controllo processo.

7) API e integrazioni: cosa sono, perche servono, dove prenderle, come impostarle

7.1 API Provider AI (obbligatoria)

Perche serve:

• e il motore che analizza contenuti e genera bozze.

Dove ottenerla:

• dal provider AI che scegli (esempio comune: OpenAI, se usi modelli compatibili come gpt-5.2).
• in genere la trovi nel pannello account del provider, sezione API Keys.

Come impostarla:

1. Vai in BlogEditorAI > Settings.
2. Inserisci API key provider modello.
3. Imposta Modello AI (es. gpt-5.2).
4. Salva e usa il pulsante di test connessione.

Note utili:

• se la chiave non e valida, analisi e bozze non partono;
• modello testo consigliato: GPT 5.2 (nel campo tecnico: gpt-5.2);
• conserva la chiave in modo sicuro, non condividerla.

7.2 Google Search Console API (consigliata)

Perche serve:

• aggiunge dati reali del tuo sito per decidere priorita migliori.

Dove ottenerla:

1. Crea un progetto in Google Cloud Console.
2. Abilita l’API Search Console.
3. Crea credenziali OAuth (Client ID e Client Secret).
4. Includi il redirect URI mostrato nella pagina BlogEditorAI > Search Console.

Come impostarla:

1. Apri BlogEditorAI > Search Console.
2. Inserisci Client ID, Client Secret, Property URL.
3. Salva.
4. Clicca Connetti Google Search Console.
5. Clicca Sync 28 giorni.

Risultato pratico:

• i suggerimenti keyword diventano piu affidabili grazie ai segnali reali del sito.

7.3 SERP Provider API (opzionale)

Provider consigliato:

• SerpApi (e l’unico provider testato ufficialmente in questa versione del plugin).

Perche serve:

• arricchisce la valutazione keyword con dati esterni (es. volume, difficulty, feature SERP).

Dove ottenerla:

• da SerpApi (provider consigliato e unico testato).
• nel pannello account del provider, sezione API key.

Come impostarla:

1. Vai in BlogEditorAI > Settings.
2. Nella sezione Keyword Intelligence / SERP, abilita il provider.
3. Inserisci endpoint e API key.
4. Imposta locale/device secondo il tuo mercato.

Se non la configuri:

• il plugin continua a funzionare con stime interne e dati GSC (se presenti).

7.4 Rank Math (integrazione senza API key)

Perche serve:

• permette di scrivere metadati SEO direttamente dove Rank Math li usa.

Come funziona:

• se Rank Math e installato/attivo, BlogEditorAI scrive i meta nel formato compatibile;
• se non c’e, usa un fallback interno senza bloccare il flusso.

8) Configurazione iniziale consigliata (setup rapido)

Per iniziare bene:

1. Configura API provider AI in Settings e imposta il modello testo consigliato GPT 5.2 (campo: gpt-5.2).
2. (Consigliato) Configura Search Console.
3. (Opzionale) abilita le immagini in evidenza e imposta il modello immagini consigliato 1.5 (con ID provider equivalente).
4. Lascia disattivato l’autopilota finche non hai validato il flusso manuale.
5. Fai una prima analisi su un set piccolo (es. 10 articoli).
6. Aggiungi 5-10 keyword al piano e genera 1-2 bozze test.

9) Buone pratiche d’uso

• Revisiona sempre le bozze prima di pubblicare.
• Evita di accettare tutte le keyword: seleziona quelle coerenti con obiettivi reali.
• Usa note e owner nel piano per evitare colli di bottiglia.
• Fai sync GSC periodico per mantenere priorita aggiornate.
• Controlla Jobs and History quando noti comportamenti anomali.

10) Cosa il plugin non fa (per scelta)

• Non pubblica automaticamente i contenuti.
• Non sostituisce la revisione editoriale umana.
• Non garantisce ranking SEO.

Il suo ruolo e supportare decisioni e operativita, non sostituire la strategia.

11) Risoluzione problemi comuni

Problema: test API fallisce

• Verifica chiave API e modello inserito.
• Controlla timeout in Settings.
• Controlla eventuali limiti del provider.

Problema: Search Console non si collega

• Controlla Client ID/Secret.
• Verifica che il redirect URI sia inserito correttamente nel progetto Google.
• Verifica che la property sia corretta e accessibile dal tuo account.

Problema: bozza non viene generata

• Controlla Jobs and History.
• Verifica che la configurazione API sia attiva.
• Riprova con meno richieste contemporanee.

12) Glossario rapido

• Ingest: lettura dei contenuti esistenti.
• Cluster: gruppo di articoli/keyword simili per tema.
• Keyword focus: parola chiave prioritaria su cui costruire un contenuto.
• Cannibalizzazione: piu pagine del sito che competono sulla stessa intenzione di ricerca.
• Draft: bozza non pubblicata.

Se stai iniziando ora: configura prima API provider AI + Search Console, poi fai una prima analisi su 10 articoli e crea il primo mini-piano editoriale.