> For the complete documentation index, see [llms.txt](https://docs.sellermagnet.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sellermagnet.com/it-sellermagnet-guida/strumenti-di-vendita/listing-optimizer-overview/listing-agent.md).
# Listing Agent
{% hint style="info" %}
**Difficoltà:** 🟡 Intermedio · **Tempo di lettura:** \~8 min
{% endhint %}
{% hint style="warning" %}
**Disponibilità:** Listing Agent fa parte della suite **Listing Manager AI**, che viene rilasciata **per account**. Mentre il vostro è in attesa, vedrete una clessidra ambra accanto ad esso nel menu **Listing-Manager** e una nota "you're on the list" quando lo aprite - senza addebito finché non decidete di tenerlo. Richiede un account Amazon collegato. Vedete [Listing Optimizer](/it-sellermagnet-guida/strumenti-di-vendita/listing-optimizer-overview.md).
{% endhint %}
{% hint style="success" icon="rocket" %}
**Apri questa pagina nella tua dashboard:** [**Vai a Listing Agent →**](https://dashboard.sellermagnet.com/listing-agent)
{% endhint %}
## 📋 Panoramica
Il **Listing Agent** è il modo più veloce per trovare e correggere le lacune di contenuto nell'intero catalogo Amazon. Anziché aprire un listing alla volta, scansiona ogni prodotto che avete sincronizzato, li classifica in base a quanto necessitano attenzione e vi permette di redigere testo IA e inviarlo ad Amazon in batch.
Pensatelo come un triage di massa: l'Agent vi mostra dove sono i danni su molti listing in una volta, redige una correzione per ogni campo debole e invia i campi che approvate, tutto senza lasciare la pagina.
Una singola scansione guarda fino a **sei segnali di contenuto**, ma valuta solo quelli che l'API di Amazon può effettivamente vedere:
| Segnale | Cosa controlla | Gravità |
| ----------------- | ----------------------------------------------------------- | ------------------------------------------------------------------------------------------ |
| **Title** | Presente e di almeno 50 caratteri | Mancante = Critical · Troppo corto = Warning |
| **Bullet Points** | Tutti e 5 i punti elenco presenti | 0 punti = Critical · Meno di 5 = Warning |
| **Images** | Almeno 5 immagini (7+ raccomandate) | 0 immagini = Critical · Meno di 5 = Warning |
| **Description** | Segnalato solo quando il corpo è effettivamente visibile | Non visibile via API = escluso (chip neutro) · Visibile ma sotto \~100 caratteri = Warning |
| **A+ Content** | Segnalato solo quando un'assenza è effettivamente osservata | Stato sconosciuto (il caso solito) = escluso (chip neutro) · Osservato assente = Warning |
| **Video** | Segnalato solo quando un'assenza è effettivamente osservata | Stato sconosciuto (il caso solito) = escluso (chip neutro) · Osservato assente = Info |
Il motivo per cui Description, A+ Content e Video si comportano così è che l'API di Amazon (SP-API) di solito non può vederli - raramente restituisce il corpo della descrizione, e lo stato A+/video spesso torna sconosciuto. Quando un segnale è sconosciuto, l'Agent lo **esclude dal punteggio e lo mostra come chip neutro** anziché penalizzarvi per qualcosa che non può verificare. Una descrizione vuota o illeggibile pertanto **non è più Critical**; solo una descrizione genuinamente visibile e sotto \~100 caratteri solleva un Warning.
Ogni prodotto ottiene un **punteggio di qualità** che è la **quota dei segnali noti che supera** - in pratica di solito è Title + Bullets + Images (su 3), non sempre 6 - mostrato come percentuale con un anello colorato: verde all'80%+, ambra al 50-79%, rosso sotto il 50%.
{% hint style="info" %}
**Chip "Not visible via Amazon API".** I campi che l'API di Amazon non può vedere - descrizione, A+ Content e video - vengono renderizzati come un chip grigio neutro con un'icona a punto interrogativo e il tooltip **"Not visible via Amazon API"**. Un chip così **non** è un fallimento e non conta contro il vostro punteggio; significa semplicemente che l'Agent non ha dati affidabili per quel campo. Solo Title, Bullets e Images sono costantemente visibili, quindi sono quelli su cui il punteggio è normalmente costruito.
{% endhint %}
{% hint style="info" %}
**Da dove provengono i dati della scansione.** Il Listing Agent legge l'**ultimo snapshot Listing Quality** per ogni prodotto, non recupera dati aggiornati da Amazon stesso. Se l'Agent mostra uno stato vuoto ("No Listing Data Found"), aprite [Listing Quality](/it-sellermagnet-guida/strumenti-di-vendita/listing-optimizer-overview/listing-quality.md) e scansionate prima i vostri prodotti lì per popolare i dati del catalogo, poi tornate all'Agent.
{% endhint %}
***
## Le schede statistiche
Una volta terminata una scansione, quattro schede riassumono il vostro catalogo a colpo d'occhio:
| Scheda | Cosa conta |
| -------------------- | ------------------------------------------------------------------------------------------- |
| **Total Products** | Ogni prodotto restituito dalla scansione |
| **Critical Issues** | Prodotti che hanno almeno un problema Critical (un titolo, descrizione o immagini mancanti) |
| **Warnings** | Prodotti che hanno avvisi ma **nessun** problema Critical |
| **Perfect Listings** | Prodotti senza alcun problema su tutti i segnali noti |
Gli stessi gruppi appaiono come schede filtro sopra l'elenco prodotti: **All**, **Critical**, **Warnings** e **Perfect**. Un prodotto con qualsiasi problema Critical finisce nel gruppo Critical; un prodotto con solo avvisi finisce in Warnings; un prodotto pulito finisce in Perfect. L'elenco è ordinato prima per gravità, così i listing più dannosi (per esempio, un titolo mancante) risalgono sempre in cima.
Quando una scansione copre meno prodotti dell'intero catalogo, una riga appare sopra la griglia - **"Scanned {n} of {m} products - data as of {date}"** - così sapete sempre quanta parte del catalogo la vista corrente riflette e quanto è fresca.
***
## 🔧 Passo dopo passo: scansione, correzione e invio
{% stepper %}
{% step %}
### Scansionate il catalogo
Cliccate **Scan Catalog** nella barra degli strumenti in alto. L'Agent percorre i vostri prodotti sincronizzati e li raggruppa in All / Critical / Warnings / Perfect. Usate la **casella di ricerca** per filtrare per ASIN o titolo in qualsiasi momento.
{% endstep %}
{% step %}
### Scegliete un gruppo
Cliccate la scheda **Critical** per lavorare sui prodotti che vi stanno danneggiando di più, o usate **Warnings** per una pulizia più leggera. Ogni riga mostra l'immagine del prodotto, titolo, ASIN e SKU, una fila di chip di salute per campo (Title, Bullets, Description, Images, A+, Video) e l'anello del punteggio di qualità.
{% endstep %}
{% step %}
### Aprite il cassetto Fix
Cliccate **Fix** su qualsiasi prodotto con problemi (o cliccate la riga) per aprire il **cassetto Fix** sulla destra. I problemi sono elencati dal più dannoso per primo, ciascuno come una scheda di raccomandazione che spiega cosa non va.
{% endstep %}
{% step %}
### Generate con l'IA per campo
Per ogni campo correggibile, cliccate **Generate with AI**. L'Agent redige testo sostitutivo usando il contesto del vostro prodotto e lo mostra in linea per la revisione. La stesura IA nell'Agent copre **Title**, **Bullet Points** e **Description**. Le lacune di immagine e A+ sono evidenziate nel cassetto come risultati, ma quelle le create in [Listing Quality](/it-sellermagnet-guida/strumenti-di-vendita/listing-optimizer-overview/listing-quality.md) o nell'AI Image Studio, non dal pulsante Generate dell'Agent.
{% endstep %}
{% step %}
### Update on Amazon
Quando siete soddisfatti delle bozze, cliccate **Update on Amazon** in cima al cassetto. Si apre una finestra modale che elenca gli elementi che potete inviare: **Title**, **Bullet Points**, **Description**, **Keywords** e **Images**.
{% endstep %}
{% step %}
### Scegliete i campi e Save
Spuntate gli elementi che volete inviare, poi cliccate **Save**. Solo i campi per cui avete effettivamente generato contenuto vengono inviati, se spuntate un elemento senza una bozza dietro, l'Agent vi dice di generare prima il contenuto anziché inviare una modifica vuota. SellerMagnet invia poi i campi selezionati ad Amazon come batch.
{% endstep %}
{% endstepper %}
{% hint style="info" %}
**Campi che l'Agent può redigere vs. inviare.** Il pulsante Generate redige Title, Bullet Points e Description. La finestra di aggiornamento elenca tutti e cinque gli elementi per completezza, ma un campo viene inviato solo quando ha contenuto generato (o modificato) dall'IA dietro. Per il lavoro su immagini e A+, e per l'editor approfondito completo, usate [Listing Quality](/it-sellermagnet-guida/strumenti-di-vendita/listing-optimizer-overview/listing-quality.md).
{% endhint %}
***
## 🤖 Modalità IA
Dietro le quinte l'IA gira su template di prompt predefiniti con quattro **modalità**. Il pulsante **Generate with AI** con un clic dell'Agent usa sempre **Optimize** (migliora il campo che avete già). Le altre modalità sono disponibili nell'AI Studio più approfondito di [Listing Quality](/it-sellermagnet-guida/strumenti-di-vendita/listing-optimizer-overview/listing-quality.md).
| Modalità | Usatela per |
| -------------- | --------------------------------------------------------------------------------------------------------------------- |
| **Create** | Scrivere un campo da zero quando non c'è nulla da cui partire |
| **Optimize** | Ripulire e migliorare in ottica SEO il titolo, i punti elenco o la descrizione esistenti (è ciò che usa l'Agent) |
| **Competitor** | Generare testo progettato per superare un rivale, incollate un titolo concorrente come obiettivo da battere |
| **Translate** | Localizzare il campo nella lingua del marketplace con testo dal suono nativo, non una traduzione automatica letterale |
### La conformità alla guida di stile di Amazon è integrata
Ogni prompt ha le regole di titolo e contenuto di Amazon integrate, così l'output è conforme per costruzione anziché necessitare una pulizia manuale:
* **Title Case** (maiuscola per tutte le parole tranne le preposizioni corte)
* **Limiti di caratteri** per campo (titoli intorno a 80-150 caratteri, punti elenco 150-250 ciascuno e sotto 1.000 totali)
* **Niente linguaggio promozionale** (niente "best seller", "#1", "guarantee" e affermazioni simili)
* **Niente emoji** e niente caratteri speciali vietati (`~ ! * $ ? _ { } # < > ^`)
* **Struttura brand-first** (Brand + Nome prodotto + Caratteristica chiave + Taglia/Colore/Variante)
* **Parole chiave in primo piano** così i termini di ricerca più importanti vengono per primi
***
## 🔒 Sicurezza dell'invio
Il Listing Agent è deliberatamente draft-first. Nulla di ciò che generate tocca il vostro listing live finché non compite un'azione esplicita.
{% hint style="warning" %}
**Nulla viene inviato ad Amazon finché non lo inviate.** Ogni bozza IA atterra nel cassetto Fix come **suggerimento**, mai una modifica applicata. Il vostro listing live cambia solo dopo che aprite **Update on Amazon**, spuntate elementi specifici e cliccate **Save**.
{% endhint %}
{% hint style="info" %}
**Amazon mette in coda gli invii, non li applica istantaneamente.** Un invio riuscito significa che Amazon **ha accettato il vostro invio nella sua coda**. Il listing si aggiorna una volta che Amazon finisce di convalidarlo, e Amazon può comunque **rifiutare** una modifica durante quel passaggio. Vedrete la conferma: "Changes submitted to Amazon and queued for processing. Amazon can still reject them during validation."
{% endhint %}
Ulteriori salvaguardie su ogni invio:
| Salvaguardia | Cosa fa |
| ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Pre-controllo policy di testo** | Prima che qualsiasi cosa venga inviata, ogni campo è vagliato per formulazioni notoriamente problematiche. Il contenuto bloccato dalle policy viene fermato localmente e riportato a voi, non inviato ad Amazon. |
| **Controllo di proprietà del marketplace** | L'Agent conferma che il marketplace di destinazione appartiene al vostro account Amazon collegato prima di inviare. |
| **Risultati per campo** | La formulazione di convalida di Amazon stessa è mostrata per campo nella finestra modale, così un fallimento parziale vi dice esattamente quale elemento è stato rifiutato e perché, anziché un singolo errore generico. |
| **Change log** | Ogni modifica applicata è registrata (valore vecchio e valore nuovo), così c'è una traccia di audit di cosa è stato inviato e quando, e le modifiche possono essere annullate. |
***
## Listing Agent vs. Listing Quality
Entrambi gli strumenti vivono nella suite Listing Manager AI ed entrambi possono inviare ad Amazon, ma sono costruiti per compiti diversi.
| | **Listing Agent** | **Listing Quality** |
| ----------------- | ----------------------------------------------------------------------- | --------------------------------------------------------------------------------- |
| **Costruito per** | Triage di massa veloce su molti listing | Lavoro approfondito su un singolo listing |
| **Ambito** | Intero catalogo in una volta, raggruppato per gravità | Un prodotto alla volta |
| **Controlli** | Sei segnali di contenuto per prodotto | 37 controlli dettagliati con sotto-punteggi |
| **Modifica** | Bozza IA con un clic per campo, invio in batch | Editor completo, AI Studio, schede parole chiave e cronologia, strumenti immagine |
| **Meglio quando** | Volete spazzare il catalogo e correggere velocemente le lacune peggiori | Volete perfezionare uno specifico listing di alto valore |
Usate l'Agent per trovare dove sono i danni e superare le lacune ovvie in massa; passate a [Listing Quality](/it-sellermagnet-guida/strumenti-di-vendita/listing-optimizer-overview/listing-quality.md) quando un listing necessita un lavoro attento e dettagliato.
***
## ⚠️ Avvertenze
* **Rilascio per account.** La suite Listing Manager AI viene rilasciata per account. Mentre il vostro è in attesa, vedrete una clessidra ambra accanto ad esso nel menu Listing-Manager e una nota "you're on the list" quando lo aprite - senza addebito finché non decidete di tenerlo.
* **Richiede un account Amazon collegato.** L'Agent legge il vostro catalogo sincronizzato e invia attraverso l'API Amazon, quindi è richiesta una connessione Amazon attiva.
* **Necessita prima dei dati Listing Quality.** La scansione legge gli ultimi snapshot Listing Quality. Se non è stato ancora scansionato nulla, popolate i dati da [Listing Quality](/it-sellermagnet-guida/strumenti-di-vendita/listing-optimizer-overview/listing-quality.md) prima che l'Agent possa mostrare i vostri prodotti.
* **L'IA gira su crediti della piattaforma, nessuna chiave API necessaria.** L'IA usa i modelli propri di SellerMagnet; non portate né pagate la vostra chiave OpenAI o Gemini. La stesura attinge a un'**allocazione di crediti** mensile inclusa nel vostro piano, **condivisa con il** [**Bulk Sourcer**](/it-sellermagnet-guida/strumenti-di-vendita/product-sourcer-overview/bulk-sourcer.md). Se il saldo si esaurisce, il pulsante Generate si ferma finché l'allocazione non si ricarica.
***
## ✅ Migliori pratiche
1. **Lavorate prima la scheda Critical.** Evidenzia i listing che vi stanno attivamente facendo perdere conversione e reperibilità, un titolo, descrizione o immagini mancanti. Correggere questi porta i maggiori guadagni reali.
2. **Ordinate per fatturato nella vostra testa.** L'Agent classifica per gravità, ma voi decidete l'ordine. Superate le lacune peggiori sui vostri ASIN più venduti prima della coda lunga.
3. **Leggete sempre la bozza IA prima di inviare.** Trattate ogni bozza come una solida prima versione, non una finita. Leggetela, ritoccate se necessario, poi inviate.
4. **Inviate solo i campi che avete generato.** Spuntare Keywords o Images senza una bozza dietro non fa nulla di utile, generate prima il contenuto, o gestite quei campi in Listing Quality.
5. **Riscansionate dopo che Amazon elabora la modifica.** Un invio è in coda, non istantaneo. Riscansionate più tardi per confermare che il campo è stato risolto e il punteggio è salito.
6. **Tenete d'occhio il vostro saldo crediti.** La stesura spende dall'allocazione mensile condivisa con il Bulk Sourcer; il saldo rimanente è mostrato nel menu Listing. Vedete [quanto costano le azioni IA](/it-sellermagnet-guida/strumenti-di-vendita/listing-optimizer-overview.md) per i costi in crediti per azione.
***
## ❓ FAQ
Perché il mio Listing Agent è vuoto anche se ho prodotti?
L'Agent legge l'ultimo snapshot Listing Quality per ogni prodotto, non recupera dati aggiornati da Amazon da solo. Aprite [Listing Quality](/it-sellermagnet-guida/strumenti-di-vendita/listing-optimizer-overview/listing-quality.md), scansionate i vostri prodotti lì, poi tornate all'Agent e mostrerà il vostro catalogo.
Qual è la differenza tra un problema Critical e un Warning?
I problemi Critical sono lacune che sopprimono attivamente conversione o reperibilità, un titolo mancante, una descrizione mancante o nessuna immagine. I Warning sono contenuti che esistono ma sono deboli (troppo corti, o meno di cinque punti elenco) e che vale la pena migliorare quando avete tempo. Un prodotto con qualsiasi problema Critical finisce nel gruppo Critical; uno con solo avvisi finisce in Warnings.
Quali campi può redigere l'Agent con l'IA?
Title, Bullet Points e Description. La finestra di aggiornamento elenca anche Keywords e Images per completezza, ma il pulsante Generate dell'Agent non li crea, usate [Listing Quality](/it-sellermagnet-guida/strumenti-di-vendita/listing-optimizer-overview/listing-quality.md) e l'AI Image Studio per il lavoro su immagini e parole chiave.
Le mie modifiche vanno in live su Amazon immediatamente?
No. Quando inviate, Amazon accetta la modifica nella sua coda e la applica dopo la convalida, e può comunque rifiutare una modifica durante quel passaggio. SellerMagnet registra ogni invio e memorizza i valori vecchi e nuovi così le modifiche possono essere annullate. Trattatelo come l'invio di una modifica in Seller Central, non una modifica istantanea.
L'output IA è conforme ad Amazon?
I prompt hanno la guida di stile di Amazon integrata, Title Case, limiti di caratteri, niente linguaggio promozionale, niente emoji o simboli vietati, struttura brand-first e parole chiave in primo piano, così l'output è conforme per costruzione. In aggiunta, un pre-controllo delle policy di testo vaglia ogni campo per formulazioni notoriamente problematiche prima che venga inviato.
L'IA ha bisogno di una mia chiave OpenAI o Gemini, e costa un extra?
Nessuna chiave necessaria. L'IA gira sui modelli propri di SellerMagnet ed è inclusa nel vostro piano. L'utilizzo attinge a un'allocazione di crediti mensile che è condivisa con il Bulk Sourcer. Se il saldo raggiunge lo zero, il pulsante Generate si mette in pausa finché l'allocazione non si ricarica.
Quando dovrei usare Listing Agent invece di Listing Quality?
Usate l'Agent per un triage di massa veloce, spazzando l'intero catalogo, classificando per gravità e inviando velocemente diversi listing. Usate [Listing Quality](/it-sellermagnet-guida/strumenti-di-vendita/listing-optimizer-overview/listing-quality.md) quando un singolo listing necessita un lavoro approfondito e dettagliato con l'analisi completa a 37 controlli, l'editor e gli strumenti immagine.
***
## ➡️ Cosa fare dopo?
{% content-ref url="/pages/UzTgdtOuznAJlBl8teaZ" %}
[Listing Quality](/it-sellermagnet-guida/strumenti-di-vendita/listing-optimizer-overview/listing-quality.md)
{% endcontent-ref %}
{% content-ref url="/pages/j6xiZZZNRKVJ4JfTzV97" %}
[Keyword Research](/it-sellermagnet-guida/strumenti-di-vendita/listing-optimizer-overview/keyword-research.md)
{% endcontent-ref %}
{% content-ref url="/pages/tLHNzeksuQ6AFSkQGujz" %}
[Ottimizzatore di listing](/it-sellermagnet-guida/strumenti-di-vendita/listing-optimizer-overview.md)
{% endcontent-ref %}