AI Competitor — Monitoraggio prezzi della concorrenza

Panoramica

AI Competitor monitora i prezzi dei tuoi concorrenti direttamente dal back-office PrestaShop. Per ogni prodotto del catalogo dichiari uno o più URL concorrenti; il modulo li visita a intervalli regolari, estrae il prezzo mostrato (con un fallback IA quando i metodi classici falliscono), rileva le variazioni significative, ti avvisa via email e ti propone un prezzo adeguato secondo la tua strategia tariffaria.

Installazione

1. Nel back-office, apri Moduli → Gestione moduli → Carica un modulo.
2. Carica il file dfaicompetitor.zip.
3. Il modulo si installa e crea automaticamente le sue tre tabelle (dfaicompetitor_url, dfaicompetitor_price, dfaicompetitor_alert) oltre al menu Catalogo → AI Competitor.

All’installazione viene generato un token cron unico, visibile nella dashboard del modulo.

Configurazione iniziale

Apri Catalogo → AI Competitor. La dashboard riunisce le statistiche e quattro blocchi di configurazione.

Provider IA

Il fallback IA è facoltativo ma fortemente consigliato: subentra quando un sito concorrente non espone né dati strutturati né un selettore utilizzabile. Tre provider supportati:

• Mistral AI (predefinito) — il più economico, modello consigliato: mistral-small-latest
• Anthropic Claude — la migliore precisione sulle pagine complesse, modello consigliato: claude-haiku-4-5-20251001
• OpenAI — buon compromesso, modello consigliato: gpt-4o-mini

Inserisci la chiave API del provider scelto. Viene mostrata mascherata; lascia il campo vuoto nei salvataggi successivi per conservare la chiave. Paghi il provider direttamente, senza ricarico DataFirefly.

Avvisi

• Email di notifica — destinatario dei digest di avvisi e del report settimanale.
• Soglia di variazione — in percentuale (3 % per impostazione predefinita). Al di sotto, nessun avviso viene creato.
• Giorno del report settimanale — lunedì per impostazione predefinita.

Scraping

• URL per batch cron — numero di URL elaborati a ogni esecuzione (20 per impostazione predefinita).
• Intervallo predefinito — in ore, applicato ai nuovi URL (24 h per impostazione predefinita).
• Timeout HTTP e User-Agent — lo User-Agent fornito è identificabile (DataFireflyBot); puoi personalizzarlo.

Strategia di adeguamento

Tre strategie determinano il prezzo suggerito, sempre calcolato a partire dal concorrente più economico:

• Allineare — stesso prezzo del concorrente più basso.
• Undercut di X % — X % al di sotto (predefinito: 1 %).
• Premium a X % — X % al di sopra, per un posizionamento premium dichiarato.

Aggiungere URL concorrenti

Apri Catalogo → AI Competitor → Competitor URLs → Aggiungi. Ogni riga associa un prodotto del tuo catalogo a una pagina concorrente:

• Prodotto — selezionato dal tuo catalogo.
• Nome del concorrente — etichetta libera (Amazon, ePrice, qualsiasi sito…).
• URL — l’indirizzo completo della scheda prodotto concorrente.
• Selettore CSS (facoltativo) — vedi sotto.
• Valuta ISO — EUR per impostazione predefinita.
• Forza estrazione IA — salta i metodi classici per questo URL.
• Intervallo — in ore, specifico per questo URL.

Il pulsante Scrape di ogni riga avvia un’estrazione immediata — utile per validare un URL appena creato.

Come funziona l’estrazione

Per ogni URL, il modulo prova quattro metodi in cascata e si ferma al primo che riesce:

1. JSON-LD — i dati strutturati Product/Offer, presenti sulla grande maggioranza dei siti e-commerce. Prezzo, valuta e disponibilità vengono letti direttamente, senza configurazione.
2. OpenGraph — i meta tag product price amount.
3. Selettore CSS — se ne hai fornito uno. Il convertitore integrato gestisce classi, id, selettori di attributo e combinatori figlio. Esempi validi: .current-price, .price-box > .amount, span[itemprop=price].
4. IA — un estratto HTML ripulito viene inviato al tuo provider, che restituisce prezzo, valuta e stato di stock. I formati di prezzo internazionali sono gestiti (1 299,90 — 1.234,56 — $49.99).

Configurare il cron

Lo scraping periodico si basa su un endpoint protetto da token, visibile nella dashboard. Programmalo ogni 30 minuti:

*/30 * * * * curl -s "https://il-tuo-negozio.it/index.php?fc=module&module=dfaicompetitor&controller=cron&token=IL_TUO_TOKEN" > /dev/null

A ogni esecuzione, il cron: elabora il batch di URL con intervallo scaduto, invia le email di avviso in attesa, spedisce il report settimanale nel giorno configurato e ripulisce i dati vecchi (snapshot > 180 giorni, avvisi > 365 giorni). La risposta è un JSON riepilogativo.

Il token può essere rigenerato in qualsiasi momento dalla dashboard (i cron esistenti dovranno essere aggiornati). È disponibile anche un trigger manuale tramite il pulsante Run cron now.

Avvisi

Vengono generati cinque tipi di avvisi, ciascuno con una severità:

• price_drop / price_rise — variazione oltre la soglia. Una variazione ≥ 10 % passa a critical.
• undercut — un concorrente scende sotto il tuo prezzo di vendita IVA inclusa. Sempre critical.
• out_of_stock / back_in_stock — transizioni di disponibilità rilevate tramite dati strutturati o IA.
• scrape_error — solo dopo 3 fallimenti consecutivi, per eliminare il rumore delle indisponibilità passeggere.

Gli avvisi sono raggruppati in un’unica email digest per esecuzione cron, e consultabili in Reports & Alerts con conferma di lettura («Acknowledge all»).

Report settimanale

Ogni settimana, nel giorno configurato, un’email HTML riepiloga: i prodotti più sottoquotati, i maggiori ribassi e rialzi dei concorrenti, lo stato di salute dello scraping e un riassunto esecutivo redatto dall’IA che gerarchizza le azioni da intraprendere. Un’anteprima del report corrente è disponibile in ogni momento in Reports & Alerts, con un pulsante di invio immediato.

Suggerimento di prezzo

In Reports & Alerts, seleziona un prodotto monitorato: il modulo mostra il tuo prezzo attuale, il min/media/max dei concorrenti, le fonti e il prezzo suggerito secondo la tua strategia. Il pulsante Applica scrive il prezzo sul prodotto PrestaShop.

Risoluzione dei problemi

Status «no_price»

Nessun metodo ha trovato un prezzo. Verifica l’URL in un browser, aggiungi un selettore CSS che punti all’elemento del prezzo, oppure attiva «Forza estrazione IA» per questo URL.

Status «error»

La pagina non ha risposto (HTTP ≥ 400 o timeout). Alcuni siti bloccano i robot: personalizza lo User-Agent nella configurazione, aumenta il timeout o allarga l’intervallo. Un avviso viene emesso solo al 3° fallimento consecutivo.

L’estrazione IA non funziona

Verifica che la chiave API sia valida e che il modello esista presso il tuo provider. Gli errori di chiamata IA sono registrati in Parametri avanzati → Log con il prefisso [dfaicompetitor].

Le email non arrivano

Testa la configurazione email di PrestaShop (Parametri avanzati → E-mail). Il modulo usa il sistema di posta nativo con i propri template FR/EN.

Buone pratiche e conformità

• Mantieni intervalli ampi (6-24 h per URL bastano per il monitoraggio dei prezzi) per non sovraccaricare i server dei concorrenti.
• Conserva uno User-Agent identificabile: è la pratica leale attesa nella competitive intelligence.
• Leggere prezzi pubblici è generalmente lecito in Europa, ma resti responsabile dell’uso dei dati raccolti.