Se gestisci WordPress SEO come parte di un flusso di lavoro di sviluppo, probabilmente hai desiderato a un certo punto di poter saltare l'admin e fare semplicemente una chiamata API. A partire dalla versione 4.9.8, puoi.
L'API REST di AIOSEO è ora gratuita per ogni piano, incluso Lite.
L'API REST ha ora 2 usi distinti dalla sua versione originale nella 4.1.9. Il primo è quello che probabilmente già conosci: aggiunge campi di metadati SEO agli endpoint di WordPress in modo che gli sviluppatori che creano siti headless possano estrarre tag di titolo, meta descrizioni e schema direttamente nel loro frontend.
Il secondo è nuovo nella 4.9.8. Espone il livello Abilities in WordPress: 28 azioni SEO
che gli utenti di AIOSEO MCP e WP-CLI hanno già, ora chiamabili tramite HTTP da qualsiasi linguaggio o stack. Qualsiasi richiesta HTTP autenticata può ora fare ciò che fa un agente AI.
Fino ad ora, queste funzionalità richiedevano un piano Plus (o superiore) e un'installazione separata dell'addon. Da questa release, nessuna delle due è più necessaria. L'addon è deprecato e fuso nel core, quindi se hai già aggiornato, è lì.
Ecco cosa ti permette di fare la nuova API REST di AIOSEO.
In questo articolo
Cosa puoi fare tramite l'API REST
In pratica, le nuove capacità di AIOSEO ti permettono di fare cose come:
- Trova ogni post sul tuo sito che manca di una meta descrizione e restituiscili come elenco
- Aggiorna titoli SEO e meta descrizioni in blocco su una categoria o tipo di contenuto
- Crea, aggiorna o elimina reindirizzamenti senza toccare l'admin di WordPress
- Estrai punteggi TruSEO per qualsiasi post per monitorare la salute SEO in una dashboard personalizzata
- Recupera i dati delle prestazioni di Search Console per post o periodo di tempo
- Controlla quali post sono contrassegnati come orfani o privi di collegamenti interni
E non sei limitato a leggere i dati. Qualsiasi script o strumento che si connette utilizzando le tue credenziali può apportare modifiche, nello stesso modo in cui un agente AI fa tramite AIOSEO MCP.
Non stai scrivendo tu stesso gli script? AIOSEO MCP collega strumenti AI come Claude, Cursor e ChatGPT direttamente al tuo sito. Stesse capacità, nessun codice richiesto.
Nota: Alcune funzionalità sono legate a specifiche funzionalità di AIOSEO e richiedono il piano che le include. Le funzionalità di Link Assistant richiedono Pro o superiore, e le funzionalità di Search Statistics richiedono Elite.
Il caso d'uso originale di WordPress headless funziona ancora
Se stai costruendo un sito WordPress headless, dove WordPress gestisce il contenuto e un frontend separato costruito in Next.js, Gatsby o Astro gestisce la visualizzazione, AIOSEO supporta questo fin dalla versione 4.1.9. Nulla riguardo alla configurazione cambia nella 4.9.8. Ogni endpoint supportato restituisce 3 campi SEO aggiuntivi quando AIOSEO è attivo:
aioseo_headè l'output SEO completo per il<head>della tua pagina: tag di titolo, meta descrizioni, URL canonici, dati Open Graph e schema JSON-LD, pronti per essere inseriti come stringa HTML.aioseo_head_jsonrestituisce le stesse informazioni in formato JSON, senza il markup HTML.aioseo_meta_datati fornisce i campi SEO grezzi archiviati nel database di AIOSEO. Puoi leggerli e aggiornarli tramite l'API.
L'unica cosa che è cambiata è che questi campi non sono più limitati da un piano a pagamento.
Cosa è cambiato nella 4.9.8
Prima di questa release, l'accesso ai campi dei metadati headless o alle funzionalità richiedeva un piano Plus (o superiore) e un'installazione separata dell'addon dal gestore delle funzionalità. Entrambi sono stati rimossi.
Quando aggiorni alla versione 4.9.8, tutto è automaticamente disponibile. Nessun addon da attivare, nessun piano richiesto.
Se avevi installato l'addon in precedenza e non lo vedi più nel gestore delle funzionalità, è previsto. La funzionalità è già presente, integrata nel plugin principale.
Iniziare
La configurazione si riduce a una cosa: una Password per Applicazioni WordPress. Questa non è la tua password di accesso, ma una credenziale separata che generi dall'amministratore di WordPress. Puoi crearne una navigando su Utenti >> Profilo >> Password per Applicazioni. Puoi revocarla in qualsiasi momento ed è specifica per qualsiasi strumento o script a cui ti stai connettendo.
Ecco un esempio base per recuperare i dati SEO di un post:
Nota: Questi esempi utilizzano btoa() di JavaScript per la codifica Base64, che funziona nei browser e in Node.js 16+. Nelle versioni precedenti di Node.js, sostituisci btoa('user:pass') conBuffer.from('user:pass').toString('base64').
const response = await fetch('https://yoursite.com/wp-json/wp/v2/posts/123', {
headers: {
Authorization: 'Basic ' + btoa('your_username:your_application_password'),
},
});
const post = await response.json();
const seoHead = post.aioseo_head; // Full <head> SEO output as HTML
const seoJson = post.aioseo_head_json; // Same data as JSONPer aggiornare i campi SEO su un post:
await fetch('https://yoursite.com/wp-json/wp/v2/posts/123', {
method: 'POST',
headers: {
Authorization: 'Basic ' + btoa('your_username:your_application_password'),
'Content-Type': 'application/json',
},
body: JSON.stringify({
aioseo_meta_data: {
title: 'Updated SEO Title',
description: 'Updated meta description',
},
}),
});L'API funziona con tutti gli endpoint standard di WordPress: /wp/v2/posts, /wp/v2/pages,
/wp/v2/media, /wp/v2/categories, /wp/v2/tags, e qualsiasi custom post type con
supporto REST API abilitato.
Per il riferimento completo delle funzionalità e la documentazione degli endpoint, consulta la documentazione per sviluppatori dell'API REST di AIOSEO: AIOSEO REST API developer docs.
Se desideri revocare una password per applicazioni, puoi farlo dalla stessa schermata del tuo pannello di amministrazione di WordPress dove l'hai creata.
Gratuito per tutti i piani, incluso Lite
A partire dalla versione 4.9.8, l'API REST di AIOSEO è gratuita per ogni piano AIOSEO, incluso Lite.
Se gestisci la SEO su larga scala e desideri di più dall'API, vale la pena esplorare Link Assistant (Pro) e Search Statistics (Elite). Aggiungono alcune delle funzionalità più utili nell'elenco. Puoi confrontare i piani qui: Prezzi AIOSEO.
4.9.8 include anche altri 2 aggiornamenti:
- AIOSEO MCP: Collega client AI come Claude, Cursor e ChatGPT direttamente alla tua SEO WordPress.
- Nuovi modelli di generazione di immagini AI nell'AI Image Generator.
L'API REST è stata uno degli strumenti più utili in AIOSEO per gli sviluppatori. Renderla disponibile per ogni piano significa che più persone possono creare flussi di lavoro SEO più intelligenti e automatizzati, e penso che sia la scelta giusta.
Aggiorna alla versione 4.9.8 e inizia a creare!
— Ben Rojas, Presidente di AIOSEO
Domande frequenti
Cosa posso fare con l'API REST di AIOSEO?
A partire dalla versione 4.9.8, la REST API ti offre accesso a tutte le 28 funzionalità di AIOSEO, lo stesso set disponibile tramite MCP. Puoi aggiornare le meta description e i titoli SEO, gestire i reindirizzamenti, recuperare i punteggi TruSEO, ottenere dati da Search Console e altro ancora, tutto tramite richieste HTTP. Supporta anche il caso d'uso originale di WordPress headless: il recupero dell'output completo dell'intestazione SEO per frontend disaccoppiati.
Ho bisogno di un piano a pagamento di AIOSEO per utilizzare la REST API?
No. A partire dalla versione 4.9.8, la REST API è gratuita per ogni piano AIOSEO, incluso Lite. Alcune funzionalità sono legate a specifiche funzionalità di AIOSEO e richiedono il piano che include tale funzionalità, proprio come utilizzarle tramite qualsiasi altro metodo.
Il componente aggiuntivo REST API non è più presente nel mio gestore di funzionalità. C'è qualcosa che non va?
No. È previsto. Il componente aggiuntivo è stato deprecato e unito al plugin principale. La REST API è disponibile automaticamente dopo l'aggiornamento alla versione 4.9.8. Non è necessaria alcuna reinstallazione.
Quali endpoint di WordPress supporta la REST API di AIOSEO?
Tutti gli endpoint standard della REST API di WordPress: /wp/v2/posts, /wp/v2/pages, /wp/v2/media, /wp/v2/categories, /wp/v2/tags e qualsiasi custom post type con il supporto della REST API abilitato.
Qual è la differenza tra AIOSEO MCP e la REST API?
Sia MCP che la REST API espongono le stesse 28 funzionalità di AIOSEO. La differenza sta in chi le utilizza. MCP è per gli agenti AI: consente a strumenti come Claude, Cursor e ChatGPT di agire sul tuo sito tramite chat. La REST API è per gli sviluppatori: consente di chiamare le stesse funzionalità da script, automazioni e integrazioni personalizzate tramite HTTP. Usa MCP quando vuoi che la tua IA gestisca le attività SEO. Usa la REST API quando vuoi creare qualcosa di programmatico da solo.
Come mi autentico con la REST API di AIOSEO?
Utilizza una Password per Applicazioni di WordPress. Generane una nella tua bacheca di WordPress sotto Utenti → Profilo → Password per Applicazioni, quindi includila nelle tue richieste. Gli esempi di codice nella sezione Guida introduttiva mostrano esattamente come formattarla.
Divulgazione: I nostri contenuti sono supportati dai lettori. Ciò significa che se fai clic su alcuni dei nostri link, potremmo guadagnare una commissione. Raccomandiamo solo prodotti che crediamo aggiungeranno valore ai nostri lettori.
