MCP di Epinium
Accesso: Impostazioni → MCP
L'MCP di Epinium permette a un assistente IA di consultare i tuoi dati Epinium direttamente, senza esportare nulla né scrivere codice. Puoi chiedergli in linguaggio naturale quali campagne hanno l'ACOS peggiore o su quali ricerche se ne va il budget, e risponde con i tuoi numeri reali.
Funziona sul Model Context Protocol, uno standard aperto per collegare assistenti a fonti di dati. Internamente usa l'API di Epinium, quindi vede esattamente gli stessi dati e rispetta gli stessi permessi.
Decidi tu se può scrivere
Di base l'assistente si limita a consultare. Gli strumenti che modificano qualcosa stanno dietro permessi di scrittura che spunti tu quando crei la chiave -workflows:write per le tue automazioni, campaigns:write per le tue campagne su Amazon, tasks:write per i tuoi task, catalog:write per i tuoi cluster di keyword, i tuoi prompt, la tua identità di marca, le modifiche ai tuoi listing Amazon e le tue nuove offerte di prodotti, catalog:publish perché pubblichi su Amazon ciò che è in sospeso e che gli confermi, e costs:write per il costo dei tuoi prodotti, i loro acquisti e le tue spese proprie-: se non glieli dai, quegli strumenti per lui non esistono. Nei tuoi negozi Shopify e WooCommerce, lo strumento con cui consulta è lo stesso che scrive, e lo fa solo se la chiave ha platform:write: senza, qualsiasi tentativo di modifica viene rifiutato prima di arrivare al negozio. E scrivere è dei piani Business e Master: in Free e Guru l'assistente consulta, ma non può cambiare nulla.
L'indirizzo del server
https://mcp.epinium.com/mcpLo trovi anche in Impostazioni → MCP, con un pulsante per copiarlo.
Come collegarlo
Ci sono due modi per dare accesso all'assistente, e quello che ti serve dipende dal client che usi:
- Autorizzazione dal browser: incolli l'indirizzo del server, l'assistente ti porta su Epinium, tu approvi e basta. Non c'è nessuna chiave da copiare, e puoi revocare l'accesso quando vuoi da Impostazioni → MCP.
- API key: crei una chiave in Impostazioni → API Keys e la incolli nella configurazione del client. È la via per Claude Code e per le integrazioni tue.
Claude (web e applicazione desktop)
- Apri le impostazioni dei connettori di Claude e aggiungi un connettore personalizzato
- Incolla
https://mcp.epinium.com/mcpcome indirizzo del server - Claude ti porterà su Epinium per autorizzare l'accesso: controlla i permessi che chiede e approvali
- Verifica che funzioni chiedendogli di usare lo strumento
epinium_whoami
I connettori personalizzati richiedono un piano a pagamento di Claude.
Claude Code
Claude Code si configura da terminale e usa un'API key invece dell'autorizzazione dal browser:
claude mcp add --transport http epinium https://mcp.epinium.com/mcp \
--header "Authorization: Bearer TU_API_KEY"Sostituisci TU_API_KEY con una chiave creata in Impostazioni → API Keys, con i permessi che vuoi dare all'assistente.
ChatGPT
I connettori MCP di ChatGPT stanno nella modalità sviluppatore (Impostazioni → Sicurezza e accesso) e sono disponibili solo nei piani a pagamento e dalla versione web.
- Attiva la modalità sviluppatore in Impostazioni → Sicurezza e accesso
- Nelle impostazioni dei connettori, aggiungi un connettore nuovo
- Incolla
https://mcp.epinium.com/mcpcome indirizzo del server e lascia il metodo di registrazione così com'è: il connettore si registra da solo - ChatGPT ti porterà su Epinium per autorizzare l'accesso: controlla i permessi che chiede e approvali
- Verifica che funzioni chiedendogli di usare lo strumento
epinium_whoami
Cosa hai collegato
Impostazioni → MCP elenca gli assistenti che hai autorizzato, con quali permessi, chi li ha approvati e quando. Da lì puoi revocare l'accesso a ognuno: non può più consultare i tuoi dati, con effetto immediato, e potrai autorizzarlo di nuovo più avanti se vuoi.
Le API key si gestiscono a parte, in Impostazioni → API Keys.
Quali strumenti include
L'assistente vede uno strumento per ogni risorsa raggiunta dal tuo token. I nomi sono descrittivi, quindi basta chiedere ciò che vuoi in linguaggio naturale.
| Gruppo | Strumenti | Permesso |
|---|---|---|
| Catalogo | Prodotti, le loro viste Seller, Vendor e Advertising, la categoria del loro ranking e, per Vendor, le recensioni, brand, paesi, cluster, prompt personalizzati e identità di marca | catalog:read |
| Performance catalogo | Metriche prodotto Seller e Vendor: vendite, traffico, commissioni Amazon e margine, resi, stock, giorni di copertura e il sell-in Vendor | catalog:read |
| P&L con costo prodotto | La cascata del tuo account fino all'utile netto, il margine per prodotto, per canale di vendita, la pubblicità incrociata e la freschezza del dato, con il costo prodotto e le spese proprie se il tuo piano lo include | catalog:read |
| Spese proprie | Le tue spese proprie (personale, agenzia, 3PL, software…) e le loro categorie | catalog:read |
| Struttura advertising | Campagne, ad group, target, product ads e termini di ricerca | campaigns:read |
| Performance advertising | Metriche dei cinque livelli sopra | campaigns:read |
| Portafogli | I tuoi portafogli e il tetto di budget che ciascuno impone alle sue campagne | campaigns:read |
| Scrittura pubblicitaria | Creare e modificare campagne, portafogli, ad group, target e product ad su Amazon | campaigns:write |
| Configurazione dell'ottimizzazione | Cosa persegue l'ottimizzatore su una campagna: obiettivo, limiti di offerta, budget e quali workflow la processano | campaigns:write |
| Automazione | I tuoi workflow, la loro configurazione, quali campagne raggiungono e la performance di quelle campagne | workflows:read |
| Scrittura dell'automazione | Creare, copiare, modificare, attivare, mettere in pausa, eliminare e ripristinare workflow, lanciarli o simularli, e la previsione di quanto costerebbero | workflows:write |
| Cambiamenti dell'automazione | Cosa ha cambiato un workflow su una campagna, con l'effetto netto per entità | campaigns:read |
| Storico delle modifiche | Tutto ciò che Epinium ha modificato su Amazon, da qualunque origine, incluso ciò che Amazon ha rifiutato | campaigns:read |
| Connessioni | Le tue connessioni: Amazon, Shopify e WooCommerce | connections:read |
| Negozi collegati | epinium_platform_docs e epinium_platform_request: consultare ciò che c'è nei tuoi negozi Shopify e WooCommerce e, con platform:write, creare, modificare ed eliminare prodotti e contenuti con lo stesso strumento. La scrittura è diretta, senza attività, e alcune eliminazioni non si possono annullare | platform:read, e inoltre platform:write per scrivere |
| Modifiche nei negozi | epinium_list_platform_changes: tutto ciò che è stato scritto nei tuoi negozi negli ultimi 12 mesi, compreso ciò che il negozio ha rifiutato. Costa 1 credito per riga restituita | platform:read |
| Task | Task di Epinium e i loro item | tasks:read |
| Scrittura dei task | Creare task con suggerimenti, approvarli o rifiutarli, chiuderli e applicare ciò che è stato approvato, e chiedere all'IA di Epinium di riscrivere fino a 20 schede (epinium_optimize_listings) | tasks:write |
| Scrittura dei cluster | Creare cluster di keyword, aggiungere o rimuovere le loro keyword, i loro prodotti e i loro prompt, ed eliminarli | catalog:write |
| Scrittura dei prompt | Creare e modificare i prompt personalizzati che l'IA segue per redigere le tue schede | catalog:write |
| Scrittura dell'identità di marca | epinium_create_brand_identity e epinium_update_brand_identity: creare e modificare la tua identità di marca, con una scheda per concorrente | catalog:write |
| Modifiche ai listing | Preparare modifiche a qualsiasi attributo delle tue schede, partendo da ciò che gli dici in chat o da un foglio di calcolo: trovarne i prodotti, abbinare ogni dato a un attributo di Amazon e convalidare le righe senza salvare nulla | catalog:read |
| Scrittura dei listing | Salvare come modifiche in attesa di pubblicazione le righe di un foglio, o quelle che gli detti in chat | catalog:write |
| Nuove offerte su Amazon | epinium_search_amazon_catalog, epinium_search_amazon_product_types, epinium_list_amazon_shipping_templates, epinium_validate_listing_draft e epinium_list_listing_drafts per cercare il prodotto, sceglierne il tipo, convalidare la nuova offerta e seguirla; epinium_create_listing_draft e epinium_discard_listing_draft per salvarla in sospeso o scartarla. Offerte, prodotti nuovi e famiglie, in Seller e in Vendor | catalog:read, e inoltre catalog:write per salvare e scartare |
| Pubblicare su Amazon | epinium_review_and_publish e epinium_list_pending_listing_changes per vedere ciò che è in attesa di pubblicazione, modifiche e nuove offerte; epinium_publish_listing_changes per pubblicare ciò che gli confermi, per la stessa strada del pulsante Pubblicare dell'app | catalog:read, e inoltre catalog:write e catalog:publish per pubblicare |
| Scrittura del costo prodotto | epinium_set_product_cost, epinium_preview_product_costs e epinium_import_product_costs: creare o aggiornare il costo unitario e il costo di spedizione di un prodotto, o controllare e importare quelli di molti alla volta da un file | costs:write |
| Acquisti | epinium_list_purchases, epinium_get_purchase, epinium_list_product_purchases e epinium_get_product_stock_group per leggerli; epinium_record_purchase, epinium_update_purchase e epinium_delete_purchase per registrarli, correggerli ed eliminarli | catalog:read per leggere, costs:write per scrivere |
| Scrittura delle spese proprie | Creare spese una per una o in blocco, cambiarne la voce, la categoria o l'importo, terminarle ed eliminarle, e gestire le tue categorie | costs:write |
| Skills | Il CMO Brain: le 101 skill di marketing di Epinium | skills:read |
| Scoperta | epinium_find_data: dove si trova ogni dato. L'assistente gli chiede un nome, una sigla o un sinonimo (BSR, ACoS, TACoS, Buy Box, margine) e risponde quale strumento e quale campo lo contengono. Non legge i tuoi dati e non consuma crediti | uno qualsiasi dei precedenti |
| Account | epinium_whoami e l'elenco degli account accessibili | sempre |
Compaiono solo gli strumenti che il tuo token può usare. Se crei una chiave con solo campaigns:read, l'assistente non vedrà quelli di catalogo né quelli di task: non falliscono, semplicemente non esistono per quella chiave.
CMO Brain: il cervello di marketing di Epinium
Oltre ai tuoi dati, l'MCP serve il CMO Brain: 101 skill con i metodi che applicherebbe un CMO, scritte perché un assistente possa leggerle e seguirle. Coprono dalla pubblicità e la SEO al pricing, alla retention, ai contenuti o ai marketplace, e l'assistente le consulta prima di darti consigli.
La differenza si vede: senza di esse un assistente risponde con quello che ha letto in rete; con esse segue gli stessi criteri con cui lavoriamo noi e li applica ai tuoi numeri. Se gli chiedi di rivedere una campagna con un ACOS pessimo non improvvisa un consiglio generico: carica la skill giusta e la segue.
Richiedono il permesso skills:read, selezionato per impostazione predefinita quando crei una chiave.
Totali dell'account, per periodo e per famiglia di prodotti
Alle domande d'insieme —"quanto ho venduto a settembre?", "com'è andata la spesa in pubblicità mese per mese quest'anno?", "come vendono i prodotti del mio cluster di macchine da caffè?"— l'assistente risponde con una sola consultazione. Gli strumenti di metriche sommano da soli per account, per paese o per connessione, dividono l'intervallo in settimane, mesi, trimestri o anni, e si possono limitare a uno o più dei tuoi cluster di prodotti.
Così non deve percorrere il catalogo prodotto per prodotto e sommare, il che è lento e costoso: il totale di un mese di un account grande costa circa 150 crediti invece di oltre 17.000.
Quattro cose da tenere presenti leggendo le sue risposte:
- Ogni valuta va a parte. Se vendi su marketplace con valute diverse, l'assistente riceve un totale per valuta: gli importi non vengono mai convertiti.
- Lo stock si somma solo per paese. L'inventario paneuropeo di FBA compare per intero in ogni marketplace, quindi uno stock totale dell'account ottenuto sommando i paesi non sarebbe una cifra reale. L'assistente non lo riceve; se glielo chiedi, te lo dà paese per paese.
- Per cluster, ogni prodotto conta in tutti i suoi. Chiedigli quanto ha venduto ogni cluster e ricava la risposta da una sola query; un prodotto presente in due cluster si somma in entrambi, quindi la somma dei cluster non è il totale dell'account.
- Se inizia a sommare prodotto per prodotto, gli si ricorda di non farlo. Quando l'assistente chiede un elenco di metriche non raggruppate e restano altre pagine, la risposta stessa gli indica di raggruppare invece di continuare a paginare.
Il P&L con costo prodotto
Con il permesso catalog:read, l'assistente può leggere il tuo conto economico completo: lo stesso che vedi in Redditività → P&L, ripartito su dieci strumenti -epinium_get_pnl_cascade, epinium_list_pnl_products, epinium_get_pnl_product, epinium_list_pnl_clusters, epinium_list_pnl_channels, epinium_list_pnl_ads_matrix, epinium_get_pnl_freshness, epinium_list_pnl_margin_leaks, epinium_get_pnl_category_medians e epinium_list_pnl_inventory-, con lo stesso calcolo e gli stessi numeri.
Ciò che vede dipende dal tuo piano. In Free e Guru l'assistente arriva fino a margin_before_ads -ciò che resta dopo Amazon, prima della pubblicità e prima del costo prodotto- e non lo chiamerà "profitto", perché non lo è. In Business e Master arriva fino in fondo: margine di contribuzione, con ogni riga di costo prodotto e la sua copertura, e le tue spese proprie fino all'utile netto. Le spese fisse sono di tutto l'account: se ne hai e filtri per connessione, paese o cluster, o se il tuo token non raggiunge tutte le connessioni di vendita, la cascata si ferma al margine di contribuzione e l'assistente sa perché. Il campo includes_product_cost di ogni risposta gli dice quale dei due sta vedendo, così non deve indovinarlo da solo se i numeri corrispondono a quanto ti aspettavi. I due strumenti delle perdite di margine sono solo per Business e Master: in Free e Guru rispondono con un 403, e l'assistente ti dirà che è inclusa in Business e Master. Lo stesso vale per epinium_list_pnl_inventory, il capitale immobilizzato nei magazzini di Amazon, come in Inventario. Le loro risposte non portano includes_product_cost, perché includono sempre il costo. Se vuoi intervenire su una perdita, l'assistente ti propone di creare un'attività con quei prodotti (con il permesso tasks:write), e la crea solo se gli dici di sì.
Cinque cose da sapere:
- È l'unica parte dell'MCP che converte la valuta. Le altre risorse rispondono nella valuta in cui si è verificato ogni importo; qui l'assistente chiede una
currencye tutto viene convertito in essa, al tasso di cambio del giorno in cui si è verificato ogni importo. breakeven_acos, nelle metriche Seller, è fino a che ACOS ti puoi permettere di spendere in pubblicità prima di perdere denaro su quel prodotto, calcolato con il tuo margine e il tuo costo reali -mai con una percentuale di commissione presunta. Escenull-mai un numero inventato- se il prodotto non ha un costo completo, non ha venduto nulla nel periodo, ha il costo registrato in una valuta diversa da quella del proprio marketplace (questo dato non converte le valute), oppure se il tuo piano non include il costo prodotto (Free e Guru).- Il costo prodotto non viene eliminato scendendo di piano. Se passi a Guru, il costo già caricato resta lì: smette solo di essere servito, e torna non appena risali di piano.
- Si può restringere ai tuoi cluster di prodotti, e confrontare i cluster tra loro. La cascata, la tabella per prodotto, la tabella per cluster e la freschezza accettano uno o più cluster. Nella tabella per cluster un prodotto che è in due cluster conta in entrambi. La pubblicità conta allora solo la spesa di quei prodotti: Sponsored Brands e la spesa di campagna che non corrisponde a un prodotto specifico restano esclusi, perché non appartengono a nessun cluster.
- Vede anche il costo di ogni prodotto nel catalogo. Quando elenca i tuoi prodotti, l'assistente vede il costo del prodotto e di spedizione valido oggi, e può tenere solo quelli senza costo o quelli senza costo venduti negli ultimi 30 giorni, per dirti quali completare per primi. È lo stesso che vedi in Costi e spese.
Chiedergli cosa ha fatto la tua automazione
Con il permesso workflows:read l'assistente può fare l'audit dei tuoi workflow, ed è una delle cose che fa meglio: sono domande di incrocio di dati, quelle che a mano costano un pomeriggio.
Puoi chiedergli tre cose diverse:
- Come è configurato un workflow — la sua pianificazione, il suo diagramma e ogni variabile con il valore che ha davvero, segnalando quelle che hai cambiato tu rispetto a quelle che mantengono il valore del modello. È il modo rapido di rivedere un'impostazione senza aprire l'editor.
- Quali campagne raggiunge davvero — che non è la stessa cosa delle campagne collegate. Un workflow può essere pianificato ogni notte e non processarne nessuna; questa è la domanda che lo rivela, e quando l'insieme torna vuoto l'assistente te ne dice il motivo.
- Cosa ha cambiato in una campagna — l'offerta da cui è partito ogni target contro quella che ha ora, quante volte si è mossa lungo il percorso e il motivo dell'ultimo cambio.
Quello che vale davvero la pena è combinarlo con le metriche dello stesso periodo: «cosa ha cambiato il workflow su questa campagna questo mese e come è andato l'ACOS?» è una sola domanda, e l'assistente ha entrambe le metà. È lì che può dirti se i cambiamenti stanno servendo a qualcosa o stanno solo spostando offerte.
Due cose da tenere presenti leggendo la sua risposta:
- I cambiamenti arrivano in netto, non in elenco. Un target salito e riportato giù nella stessa notte compare come nessun cambio netto, due movimenti. È voluto: un elenco di decisioni grezzo nasconde proprio questo.
- Le simulazioni non le vede. Solo cambiamenti che hanno raggiunto Amazon davvero, e solo degli ultimi 90 giorni, che è quanto vengono conservati.
Lanciare un workflow, o simularlo prima
Con il permesso workflows:write l'assistente non si limita a leggere le tue automazioni: può anche eseguirle. Serve quando non vuoi aspettare l'orario programmato —hai appena cambiato un'impostazione e vuoi vederne l'effetto— e quando vuoi verificare un workflow nuovo prima di lasciarlo andare da solo.
Due cose da chiedergli prima di lanciarlo davvero:
- Quanto costerebbe — l'assistente può darti la previsione senza eseguire nulla. Conviene per qualsiasi workflow che percorra il catalogo o le campagne: il costo cresce con il numero di elementi che elabora, quindi un diagramma di dodici passaggi può risultare caro su un account grande. È un tetto, non una fattura; e se un passaggio non si può prevedere, esce con zero elementi e l'assistente te lo segnala.
- Che simuli prima — una simulazione percorre l'intero diagramma e non scrive nulla: né su Amazon né nei tuoi dati. Ti dice cosa avrebbe fatto, senza farlo.
Anche un workflow in pausa si può simulare, ed è esattamente il motivo per cui la simulazione esiste. Verificare un'automazione prima di accenderla non dovrebbe costringerti ad accenderla prima, che è il passaggio rischioso. Per eseguirla davvero deve invece essere attiva, esattamente come nell'applicazione.
Due cose da tenere presenti:
- Non aspetta che l'esecuzione finisca. Lanciare restituisce l'identificatore dell'esecuzione, non il suo risultato: una passata su decine di campagne richiede molto più di una risposta dell'assistente. Il risultato si consulta dopo, e l'assistente sa come farlo.
- Lanciare davvero muove offerte e budget su Amazon. Simulare ed eseguire sono due richieste diverse e l'assistente deve dire quale sta facendo. Se non lo dice, chiediglielo prima di confermare.
Creare e modificare automazioni dall'assistente
Lo stesso permesso workflows:write consente all'assistente di costruire e modificare le tue automazioni, non solo di eseguirle. Può crearne una da zero, copiarne una che hai già, partire da un modello del catalogo di Epinium, cambiarne il diagramma o le impostazioni, darle un orario, accenderla, metterla in pausa, eliminarla e tornare a una versione precedente.
Tutto ciò che viene creato nasce in pausa, per ognuna delle tre vie —creare, copiare o istanziare un modello—. Accenderlo è sempre un passo a parte che devi chiedere: da lì in poi il suo orario scatta davvero ogni notte.
Quattro cose da sapere:
- Per modificare un workflow programmato bisogna prima metterlo in pausa. L'assistente te lo dirà: mettere in pausa, fare la modifica, guardare il risultato e riaccendere. La pausa, invece, viene sempre accettata —può solo far accadere meno cose su Amazon, mai di più—.
- Copiare è meglio che rifare. Se vuoi la stessa logica con altri valori, chiedigli di copiare l'automazione e cambiare solo ciò che cambia. Gli costa meno ed è più affidabile che ricostruire il diagramma passo passo. La copia nasce in pausa e senza campagne collegate: collegarle si fa in Epinium.
- Eliminare è l'unica cosa che ti farà confermare. Viene annunciata all'assistente come operazione distruttiva, quindi il tuo client di IA te lo chiederà prima. Le altre no, di proposito: se tutto chiedesse conferma, finiresti per accettare senza leggere. Ciò che protegge davvero è che nulla nasca acceso e che simulare ed eseguire siano due richieste distinte.
- Un diagramma non valido non viene salvato. Viene controllato prima di scrivere, quindi una modifica non può lasciarti l'automazione a metà: o il cambiamento entra intero, o ti dice cosa non va e non tocca nulla.
Ogni scrittura resta registrata: cosa è cambiato, quando e con quale credenziale. Anche l'eliminazione, che lascia traccia pur non esistendo più l'automazione, e le esecuzioni, che registrano chi le ha chieste. Nella cronologia delle versioni di ogni workflow si distingue ciò che ha fatto un assistente da ciò che ha fatto una persona dall'applicazione, e puoi tornare a qualsiasi versione salvata.
Se preferisci vederlo o metterci mano a mano, tutto questo vive in Processi → Workflow.
Se l'automazione scrive nel tuo negozio Shopify o WooCommerce, la credenziale ha bisogno anche di platform:write per salvarla, copiarla, attivarla o eseguirla davvero. Simularla, metterla in pausa o rinominarla non lo richiede. Di più in Leggere e scrivere nel tuo negozio.
Tabelle interattive
Quando gli chiedi un elenco — prodotti, campagne, termini di ricerca… — l'assistente può mostrarlo come tabella dentro la conversazione, invece che come testo.
Con quella tabella puoi:
- Caricare più righe senza consumare turni dell'assistente. La tabella richiede le pagine successive da sola, quindi scorrere un catalogo lungo non consuma conversazione.
- Aprire una riga per vederne il dettaglio completo, compresi i campi che non stanno nella tabella.
- Selezionare più righe e passarle all'assistente con il pulsante Use N in chat. Da quel momento ragiona solo su quelle: scegli sei prodotti su duecento e gli fai domande su quelli, senza copiare un solo ASIN.
Quando l'assistente può scrivere
Con il permesso campaigns:write l'assistente smette di guardare soltanto: crea campagne e muove offerte, budget e stati davvero, su Amazon. Concedilo consapevolmente, e solo alla chiave che ne ha bisogno.
Ciò che l'assistente sa da sé, perché glielo dicono gli strumenti:
- Ciò che crea nasce in pausa salvo richiesta contraria, e deve avvisarti prima di attivare qualcosa: una campagna attiva inizia a spendere appena Amazon la accetta.
- Può archiviare, e te lo chiederà prima. Archiviare è l'unica operazione irreversibile: ha uno strumento proprio ed è annunciata all'assistente come distruttiva, quindi il tuo client IA ti chiederà conferma prima di eseguirla. Se vuoi solo fermare la spesa, chiedigli di mettere in pausa.
- Per muovere molte offerte usa lo strumento di lotto, non quello singolo in ciclo. Un solo lotto accetta fino a 1000 entità, ciascuna con il suo valore.
- Un lotto può tornare parziale, ed è la norma. L'assistente riceve una riga per entità e un contatore di ciò che è arrivato ad Amazon; se non legge quel contatore, darà per scontato che sia passato tutto. Se ti dice che una modifica è stata applicata, puoi chiedergli il dettaglio.
- Gestisce anche i portafogli. Può crearli, cambiarne il nome, lo stato e il tetto di budget, e spostarvi dentro o fuori campagne Sponsored Products. Il tetto limita quanto spendono insieme tutte le campagne del portafoglio, quindi toccarlo sposta la spesa di tutte in una volta.
- Scrive anche su Sponsored Brands e Sponsored Display. Può modificare e archiviare le loro campagne, ad group, target e product ad, e crearne target e negativi, con i tipi che accetta l'ad product dell'ad group. Quello che ancora non può fare è creare campagne SB o SD. E per i target
AUDIENCE,CONTENT_CATEGORYeLOCATIONgli serve l'id di Amazon, che dovrai fornirgli tu dalla console di Amazon Ads.
Tutto ciò che scrive resta registrato con la sua origine: nello storico dei cambiamenti appare come mcp, con la credenziale che l'ha fatto. Così si distingue ciò che ha fatto un assistente da ciò che ha fatto una persona dall'applicazione.
Configurare l'ottimizzazione di una campagna
Con lo stesso permesso campaigns:write, l'assistente può anche leggere e cambiare la configurazione che usa l'ottimizzatore di Epinium su una campagna: il suo obiettivo, i limiti di offerta, il budget mensile, gli override di harvesting e quali workflow la processano.
Non è la stessa cosa che scrivere su Amazon, e conviene averlo chiaro: questa configurazione resta dentro Epinium - l'ottimizzatore la consuma nella sua passata di ogni notte - quindi lo strumento non chiede una chiave di idempotenza e non lascia riga nello storico dei cambiamenti di Amazon, perché non arriva a toccarlo.
Puoi chiedergli cose come "metti l'obiettivo di questa campagna su ACOS 15%", "alza il tetto di offerta a 0,80 €" o "togli questa campagna dal workflow X", e l'assistente traduce tutto ciò nella configurazione corrispondente. Prima di toccare qualcosa, può anche dirti i valori attuali.
Cosa conviene davvero confermare prima di accettare:
- Assegnare un workflow alla campagna è ciò che la mette sotto l'ottimizzatore - non
aiEnabled, che è solo il consenso del titolare dell'account e viaggia verso Amazon come tag, né nessun'altra impostazione di questo blocco. Se l'assistente sta per collegare la campagna a un workflow, confermalo prima: da quella notte quel workflow muove offerte reali su Amazon su di essa. Un workflow con selezione automatica può anche raccoglierla per conto suo a meno che la campagna non abbia declinato quella selezione, e la lista di esclusione è l'unica cosa che la toglie con garanzia. - Un cambio in blocco non è tutto-o-niente. Se gli chiedi di applicare la stessa impostazione a più campagne, riceve una riga di risultato per campagna - ognuna validata contro il proprio stato salvato - quindi una può fallire per un motivo preciso mentre le altre vanno a buon fine. Chiedigli il dettaglio se qualcosa non torna.
Proporre modifiche come task
Con il permesso tasks:write l'assistente può lasciarti le sue proposte come un task invece di applicarle lui: analizza, crea il task con un suggerimento per ogni modifica, e tu lo rivedi in Processi → Attività o glielo fai risolvere dalla conversazione. È il modo perché un assistente lavori sul tuo account senza che nulla arrivi ad Amazon prima che tu l'abbia visto.
Quattro cose da sapere:
- Approvare e applicare sono due passaggi. Approvare un suggerimento registra solo la tua decisione; poi gli chiedi di applicare il task. Quelle di campagna arrivano subito ad Amazon e l'assistente sa quali ha accettato Amazon; quelle di prodotto vanno in coda e restano in attesa di pubblicazione: non arrivano ad Amazon finché non le pubblichi.
- Prima di applicare te lo chiederà, come prima di chiudere un task: entrambe sono annunciate all'assistente come operazioni che richiedono conferma, perché applicare cambia davvero le tue campagne e le tue schede, e chiudere non si annulla.
- Non tutti i suggerimenti si applicano. Oggi si applicano quelli di prodotto e quelli di campagna -budget giornaliero, stato e nome-. Gli altri restano come note da leggere: approvarli non cambia nulla, e l'assistente lo sa.
- Chiudi il task alla fine. Ciò che è ancora in sospeso quando lo chiudi resta congelato e non si può più approvare.
I task creati dall'assistente compaiono nel tuo elenco con l'origine API e assistenti, e ogni decisione registra con quale credenziale è stata presa.
Riscrivere le tue schede con l'IA di Epinium
Con il permesso tasks:write l'assistente può chiedere all'IA di Epinium di riscrivere le tue schede Seller o Vendor: il titolo con i suoi punti salienti, i bullet point, la descrizione e i termini di ricerca, da 1 a 20 prodotti alla volta. È la stessa IA dell'applicazione, quindi segue i cluster di keyword di ogni prodotto, i prompt collegati a essi e la tua identità di marca. Lo fa con lo strumento epinium_optimize_listings.
Tre cose da sapere:
- Ti lascia suggerimenti, non modifiche. Il risultato va in un task, quello dell'onboarding, in Processi → Attività. I suggerimenti compaiono man mano che vengono generati, e l'assistente te li mostra quando sono pronti.
- Approvare, applicare e pubblicare. Approvi o rifiuti ogni suggerimento, nella conversazione o nell'applicazione, e applicando il task le modifiche restano in attesa di pubblicazione: non arrivano su Amazon finché non le pubblichi, dall'applicazione o dalla chat.
- È gratis fino a 20 prodotti. La riscrittura non consuma i tuoi crediti: la paga Epinium, con un tetto di 20 prodotti per account in totale. Conta ogni prodotto lanciato, anche se si ripete o se la sua generazione fallisce, quindi l'assistente concorda con te prodotti e campi prima di lanciarla e non ne ripete nessuno a meno che tu non glielo chieda. Superato il tetto ti dirà che non ne restano, senza generare nulla. Approvare o rifiutare i suggerimenti si addebita come in qualsiasi task.
Creare, modificare ed eliminare cluster di keyword
Con il permesso catalog:write l'assistente può salvare ciò che trova come un cluster di keyword, gli stessi che gestisci in Segmentazione → Cluster: chiedigli di raggruppare alcuni prodotti con le keyword per cui dovrebbero posizionarsi o essere pubblicizzati, e crea il cluster o ne amplia uno che hai già. Niente arriva su Amazon: un cluster vive in Epinium, dove lo raccolgono i tuoi prompt SEO, la scoperta di keyword dell'ottimizzatore e il filtro per cluster dei grafici di prodotto.
Quattro cose da sapere:
- Modifica per delta. Aggiunge o rimuove keyword e prodotti, o rinomina il cluster, senza reinviare l'intera lista; una keyword che aggiunge di nuovo viene aggiornata, non duplicata.
- Rispetta il tuo lucchetto. Un cluster che hai protetto dall'applicazione gli viene rifiutato, e l'assistente sa che deve chiederti di sbloccarlo invece di riprovare.
- Può eliminare, e te lo chiederà prima. Eliminare un cluster non si annulla, quindi lo strumento è annunciato come distruttivo e il tuo client di IA ti chiede conferma. Viene rifiutato finché il cluster è protetto o una smart campaign lo usa come base.
- Non ti chiederà conferma per creare o modificare, proprio perché nessuna offerta, budget o scheda si muove. Il cluster viene creato a nome della persona che ha autorizzato l'assistente, e può collegare solo prodotti di catalogo (Seller o Vendor) dell'account.
Scrivere i prompt con cui vengono redatte le tue schede
Con lo stesso permesso catalog:write l'assistente può redigere i tuoi prompt personalizzati, quelli della tua libreria di prompt, e dire a ogni cluster quali usare: chiedigli, per esempio, un prompt dal tono premium per i bullet point e di collegarlo al cluster della tua gamma alta. La prossima volta che verrà generato il contenuto dei prodotti di quel cluster, l'IA di Epinium seguirà quelle istruzioni.
Tre cose da sapere:
- Un prompt da solo non cambia nulla. Salvarlo non tocca Amazon né riscrive alcuna scheda: si applica quando si genera il contenuto, e solo per i prodotti dei cluster a cui è collegato.
- Un prompt per campo. Ogni prompt indica a quali campi si applica -titolo e punti salienti, descrizione, bullet point o termini di ricerca- oppure vale per tutti. Se più prompt dei cluster di un prodotto valgono per lo stesso campo, se ne usa solo uno.
- Crea e modifica, ma non elimina. Per togliere un prompt da un cluster basta scollegarlo; il prompt resta nella tua libreria. I prompt vengono creati a nome della persona che ha autorizzato l'assistente, e contano per la quota di prompt del tuo piano.
La tua identità di marca e i tuoi concorrenti
Con il permesso catalog:write l'assistente può creare e modificare la tua identità di marca, quella di Configurazione → Marchio: il nome, il settore, i tuoi siti web, le tue osservazioni su tono e pubblico, e i brand del tuo catalogo che copre. È il contesto che usa l'IA di Epinium per redigere le tue schede.
Salva anche una scheda per ogni concorrente, fino a 50: il nome, il sito web o il negozio, gli ASIN con cui ti fa concorrenza (fino a 20), il suo prezzo rispetto al tuo (più basso, simile o più alto) e la sua pericolosità (bassa, media o alta), sempre con il motivo che la giustifica nei tuoi dati: ricerche condivise, Buy Box perse, prezzo o recensioni. Se non ci sono ancora prove, lascia la pericolosità vuota.
Tre cose da sapere:
- Le schede dei concorrenti non si vedono ancora nell'applicazione. Le salva e le legge l'assistente; Configurazione → Marchio non le mostra ancora. I siti web dei concorrenti che avevi già restano a parte.
- Quando modifica, riscrive l'intera lista. Per aggiungere un concorrente invia quelli che c'erano più il nuovo, quindi prima legge quelli attuali. I valori precedenti non vengono conservati da nessuna parte, ed è per questo che il tuo client di IA ti chiede conferma prima di modificare.
- Niente arriva su Amazon. Salvare l'identità di marca non tocca né riscrive le tue schede, e l'assistente non può eliminarla.
Modificare i tuoi listing Amazon, in chat o con un foglio
Con il permesso catalog:write l'assistente salva modifiche a qualsiasi attributo che Amazon permetta di modificare nel tipo di prodotto di ogni scheda, in Seller e in Vendor. Puoi chiedergliele in due modi, e finiscono allo stesso modo:
- In chat, in modo interattivo: gli dici la modifica e lui cerca i prodotti, ti chiede ciò che non è chiaro e la prepara. "Imposta il materiale su cotone in questi 12 SKU" o "accorcia il titolo di questo prodotto a 75 caratteri".
- Con un foglio, in modo massivo: gli passi un Excel o un CSV con una riga per prodotto. Il materiale di 200 SKU, i dati delle batterie che mancano a mezzo catalogo o i bullet point di un'intera gamma.
Niente arriva su Amazon senza di te. Ciò che salva resta in attesa di pubblicazione, come una modifica fatta a mano: lo vedi nella scheda Proprietà di ogni prodotto e in Pubblica modifiche del catalogo. Parte verso Amazon quando lo pubblichi da lì o, se la sua chiave ha catalog:publish, quando l'assistente ti mostra l'elenco e gli confermi di pubblicarlo. Prima di essere salvato passa la stessa convalida di qualsiasi altra modifica.
Come gli passi le modifiche
- Un foglio di calcolo (.xlsx, .xls o .csv). Nelle chat di Claude, web e desktop, e in ChatGPT, l'assistente ti mostra un riquadro in cui trascinarlo, e il file va direttamente a Epinium senza passare dalla conversazione. In Claude Code e in Cowork quel riquadro non compare: l'assistente legge il file e ne salva le righe da solo, e con più di circa 1.000 righe ti proporrà di farlo da una chat di Claude, che è più veloce.
- Un messaggio. "Imposta il materiale su cotone in questi 12 SKU" va bene lo stesso, anche se riguarda tutti i prodotti di un paese: l'assistente li cerca se serve e trasforma la tua richiesta in righe, senza chiederti alcun file.
I tre passaggi
- Preparare. Cerca i prodotti per SKU, ASIN o EAN nel marketplace che gli indichi, e guarda quali attributi accettano. Con questo abbina ogni colonna a un attributo di Amazon, lascia fuori quelle che sono solo tue, come il costo o delle note, e ti chiede solo di quelle dubbie. Se il foglio non ha una colonna del paese, ti chiede il marketplace: non lo indovina mai. Se un ASIN o un EAN corrisponde a più SKU, la modifica va a tutti, e te lo dice. Con l'EAN, le schede di cui Epinium non ha l'EAN risultano non trovate: usa lo SKU o l'ASIN.
- Convalidare. Controlla ogni riga con le regole di Amazon del suo tipo di prodotto, senza salvare nulla. Ti dice cosa blocca e cosa è solo un avviso, con i valori che Amazon accetta, e se un valore è sbagliato in molte righe ti propone di correggerlo in una volta sola.
- Salvare. Convalida di nuovo tutto e salva le righe valide come modifiche in attesa. Quelle che non passano non vengono salvate, e l'assistente ti dice quali e perché.
Quali colonne capisce
- Una colonna per attributo, con l'intestazione che scegli tu («Materiale», «Peso dell'articolo»): l'assistente la abbina all'attributo di Amazon.
- Parti di un attributo. Alcuni attributi contengono più dati, come
battery, con la composizione della batteria e il suo peso. Ogni dato può stare in una colonna a sé: una «Composizione della batteria» compila solobattery.cell_composition. - Unità. Si ricavano dall'intestazione, come in «Peso (kg)», oppure le indichi all'assistente.
- Attributi con più voci, come i bullet point: una colonna per posizione, «Bullet point 1», «Bullet point 2», ecc.
- I valori restano come li scrivi. Capisce la virgola decimale e misure come
19 x 11 x 8, ma non traduce: il testo viene salvato nella lingua del foglio. - Il prezzo passa anche da qui, per pubblico: consumatori e aziende. Le regole e come si cancella un valore sono in Il prezzo.
Il prezzo
- Cosa puoi cambiare. In Seller, per i consumatori (
ALL) e per le aziende (B2B): il prezzo, il minimo, il massimo e il prezzo in offerta con la sua data di inizio e di fine. Ogni colonna di prezzo si abbina a un pubblico e a un campo. Se l'intestazione non indica il pubblico, l'assistente te lo chiede. - Le regole sono le stesse per consumatori e aziende. C'è sempre un prezzo consumatore; il prezzo resta tra il minimo e il massimo; il minimo non supera il massimo; non c'è minimo né massimo senza prezzo; l'offerta resta tra il minimo e il massimo e non supera il prezzo (l'uguale va bene); l'inizio dell'offerta precede la sua fine e la fine non è anteriore a oggi; nessun importo è 0 o negativo. Un'offerta con la fine già passata conta come nessuna offerta.
- Blocca solo ciò che introduce la riga. Un prodotto che già non rispettava una regola non viene bloccato per quella: si blocca la riga che aggiunge il problema. L'eccezione: se la riga cambia il prezzo di un prodotto il cui prezzo salvato già non rispetta una regola (per esempio, un prezzo al consumatore fuori dal suo minimo o massimo), viene bloccata e quel prezzo va corretto prima nell'app.
- Chiudere un'offerta in anticipo. Metti la sua data di fine a oggi. L'offerta termina alle 0:00 della data di fine, quindi «Fine offerta» è il primo giorno senza offerta.
- Una cella vuota non cambia mai nulla. Per cancellare un valore, l'assistente te lo chiede una volta per colonna («ci sono 40 celle vuote in "Minimo" su prodotti che hanno un minimo: le lascio o cancello il minimo?») e cancella solo se confermi.
- Cosa non si può cancellare. Il prezzo consumatore non si cancella. Cancellare il prezzo aziende toglie l'intera offerta aziende, con il suo minimo, il suo massimo e la sua offerta.
- Un'offerta incompleta viene bloccata. Un prezzo in offerta con date ma senza importo, o date che non sono date reali, non vengono salvati. Se le date sono ambigue, l'assistente ti chiede l'ordine (giorno/mese o mese/giorno).
- La valuta non si converte. Gli importi si salvano nella valuta del marketplace; se il foglio ne porta un'altra, l'assistente te lo chiede e non converte mai. Un importo scritto come testo con più di 2 decimali («1.299 €») viene rifiutato, per non leggere un separatore delle migliaia come decimali; una cella numerica del foglio viene arrotondata a 2 decimali, come la vedi nel foglio.
- Il primo prezzo si imposta nell'app. Un prodotto che in Epinium non ha ancora un prezzo consumatore non può riceverlo da un file, perché la valuta deriva da quell'offerta: impostalo da Prezzi.
- Resta in attesa fino alla pubblicazione. Come il resto, la modifica del prezzo resta in attesa fino a Pubblica modifiche, e togliere un prezzo in offerta arriva su Amazon anch'esso alla pubblicazione.
Dati che vanno insieme
Alcuni valori obbligano a compilarne altri: se un prodotto passa a includere batterie, Amazon chiede anche il tipo, la composizione e quante ne contiene. Epinium individua questi casi durante la convalida, e l'assistente ti mostra ogni combinazione -il tipo di prodotto, il valore che la fa scattare, ciò che riporta il foglio e in quante righe- e ti chiede cosa farne:
- Se la confermi in chat, viene salvata con il resto della riga.
- Se non la confermi, o alla riga mancano dei dati, quelle modifiche finiscono in un task in Processi → Attività, con il nome del file, perché una persona le riveda e le approvi. Il resto della riga viene salvato comunque.
L'assistente non dà mai per confermata una combinazione senza che tu glielo dica.
Più paesi e Vendor
- Un foglio con più paesi. Con una colonna del paese, ogni riga va al suo. Riconosce il codice (
ES,UK), il dominio (amazon.es), l'ID del marketplace e il nome del paese nella sua lingua, in inglese o in spagnolo. Una riga con un paese che non riconosce viene rifiutata: non lo indovina mai. Un paese in cui non hai una connessione risulta con le sue righe non trovate, senza fermare il resto. - Ogni paese si conferma a parte. Le regole di Amazon cambiano da un marketplace all'altro, quindi confermare le batterie al litio in Spagna non le conferma in Francia.
- Ogni paese, nella sua lingua. I valori non vengono tradotti: metti «papel» nella riga della Spagna e «papier» in quella della Francia.
- Vendor. Con una colonna del vendor code, ogni riga va a quel vendor code. Se una riga senza vendor code corrisponde a schede di più vendor code in un paese, l'assistente ti chiede se salvare la modifica in tutte; se non lo confermi, quelle righe restano fuori. In Vendor non si modifica nessun prezzo da un file, né il prezzo di costo né quello di listino: quelle colonne restano fuori e il resto della riga viene salvato.
Limiti e crediti
- Fino a 5.000 righe e 8 MB per file, tutti i paesi insieme, e fino a 250 colonne.
- Il file viene conservato 7 giorni. Per salvarne le righe deve restargli almeno un giorno; altrimenti caricalo di nuovo.
- Un file si salva una volta sola. Non si può salvare di nuovo con altre impostazioni: se qualcosa non andava, correggi il foglio e caricalo di nuovo. Se un prodotto compare in più righe, vale l'ultima.
- Costa 5 crediti per riga. All'inizio si riservano le righe del file e, se il saldo non basta, non si salva nulla. Alla fine si addebitano solo le righe salvate o finite nel task, e il resto viene restituito. Caricare il foglio, prepararlo e validarlo non costa nulla. Le tariffe sono in Impostazioni → Crediti.
- È dei piani Business e Master, come qualsiasi scrittura.
Creare nuove offerte su Amazon
Con il permesso catalog:write l'assistente mette anche in vendita prodotti che non sono ancora nel tuo account Amazon: una tua offerta su un prodotto che esiste già (in Seller), un prodotto nuovo o una famiglia di varianti con il padre e i suoi figli, in Seller e in Vendor. Cerca il prodotto, lo controlla con le regole di Amazon e lo salva come nuova offerta in sospeso, che parte verso Amazon quando la pubblichi.
Cosa ti chiederà, come si pubblica una famiglia, cosa cambia in Vendor e quanto costa è spiegato in Nuove offerte di prodotti.
Rivedere e pubblicare dalla chat
Nelle chat di Claude, web e desktop, e in ChatGPT, l'assistente apre la finestra Review and publish dentro la conversazione. È lo stesso di Pubblica modifiche nell'app:
- Tre schede: Changes, New listings e Publications, con filtri per connessione e paese e una ricerca per SKU o ASIN.
- Pubblichi ciò che selezioni, e in Publications segui se Amazon lo accetta, anche le nuove offerte che si stanno importando in Epinium.
- Per pubblicare dalla finestra serve il permesso
catalog:publish(nella schermata dei permessi, Pubblicare su Amazon), oltre acatalog:write. Senza, la finestra ti mostra ciò che è in sospeso ma non lascia pubblicare. Un'autorizzazione che avevi già non lo riceve da sola: autorizza di nuovo l'assistente. - In Claude Code e in Cowork la finestra non compare. L'assistente ti mostra cosa partirà, per connessione e paese, e pubblica solo se gli dici di sì.
- Pubblicare non si può annullare. Un errore si corregge pubblicando il valore precedente.
Scrivere il costo di un prodotto
Con il permesso proprio costs:write -non catalog:write, che è per i cluster, i prompt e i listing- l'assistente crea o aggiorna il costo di un prodotto con epinium_set_product_cost: la stessa azione che fai sulla scheda del prodotto o caricando il modello CSV dei costi, con la stessa semantica. Per molti prodotti alla volta usa l'importazione.
Quattro cose da sapere:
- La semantica è quella del CSV. Se gli chiedi solo di cambiare il costo unitario, il costo di spedizione già presente resta invariato; uno
0lo azzera davvero, il che non è lo stesso che non toccarlo. - Una data passata ricalcola lo storico. Di default scrive alla data di oggi; se gli chiedi di applicare il costo da una data precedente, il P&L dei periodi già chiusi successivi a quella data si ricalcola da solo, e ci mette un po' a comparire.
- Solo nei piani che includono il costo prodotto. In Free e Guru questo strumento risponde con un 403, come qualsiasi altra scrittura su quei piani.
- Non cambia il costo unitario di un prodotto con acquisti. Il suo costo lo calcolano gli acquisti registrati, quindi l'assistente ti dirà che non può farlo. Il costo di spedizione invece lo cambia, purché lo invii da solo, senza il costo unitario: con entrambi insieme non si salva nulla. Per cambiare il suo costo prodotto, l'assistente registra o corregge un acquisto (Acquisti).
Non ti chiederà conferma prima di scrivere -non è un'operazione distruttiva, non elimina nulla e il valore precedente resta nello storico-, ma ti citerà il costo e la data che ha applicato.
Acquisti
Quando un prodotto ha acquisti, il suo costo prodotto è il costo medio del suo stock: ogni acquisto lo ricalcola con le unità che avevi e quelle che acquisti. L'assistente ti dice quali acquisti ha un prodotto, con il costo medio lasciato da ciascuno, e con quali prodotti condivide lo stock; e registra, corregge ed elimina acquisti. È lo stesso di Registrare gli acquisti sulla scheda del prodotto, con lo stesso calcolo. Per leggerli gli serve catalog:read; per registrarli, correggerli ed eliminarli, costs:write. Entrambe le cose, solo nei piani che includono il costo prodotto.
Cosa conviene sapere:
- Lo stock condiviso ha un solo costo. Con il paneuropeo, lo stesso SKU nei paesi dell'UE è lo stesso stock, quindi un acquisto cambia il costo di tutti questi paesi (UK e Vendor vanno a parte). Il gruppo nasce con il primo acquisto; se oggi quei paesi hanno costi diversi, quell'acquisto ha bisogno anche di quanto valeva lo stock già presente, e senza quel dato non si registra.
- Lo stock prima dell'acquisto. Se non gli dici quanto stock avevi, si prende l'ultimo stock Amazon FBA dei 7 giorni precedenti, più gli acquisti registrati da allora. In FBM devi darglielo tu.
- Il numero d'ordine non si ripete. Se l'acquisto ha un numero d'ordine, registrare lo stesso di nuovo viene rifiutato invece di duplicarsi.
- Correggere o eliminare ricalcola. Cambia il costo medio di quell'acquisto e di quelli successivi, e il P&L dei periodi già chiusi, come un costo con data passata. L'eliminazione non si annulla; se era l'ultimo acquisto del gruppo, tornano a valere i costi di prima.
- Prima di correggere o eliminare ti chiede conferma. Sono contrassegnate come operazioni che non si possono annullare, quindi l'assistente ti chiede conferma; per registrare un acquisto no.
- Con più account, leggere ne richiede uno e scrivere tutti. Se lo stock è condiviso da account a cui la chiave non arriva, l'assistente può leggere i loro acquisti ma non modificarli.
- Ogni scrittura costa quanto scrivere un costo.
Importare i costi di molti prodotti
Per caricare il costo di molti prodotti, l'assistente usa epinium_import_product_costs, con lo stesso permesso costs:write. È la stessa importazione di Importare costi da un file nell'app, con lo stesso modello e le stesse regole, e ricalcola il P&L una sola volta, alla fine. Prodotto per prodotto non funziona: ogni costo con una data passata ricalcola il P&L dell'intero account e, mentre è in corso, i successivi vengono rifiutati.
Cosa conviene sapere:
- Gli passi il file in un riquadro dove trascinarlo. Nelle chat di Claude, web e desktop, e in ChatGPT, te lo mostra, e il file va direttamente a Epinium:
.xlsx,.xlso.csv, fino a 8 MB e 200.000 righe, quindi un catalogo intero sta in un file, senza dividerlo. Se un Excel con molte colonne non entra, togli le colonne che non usi o salvalo come CSV. In Claude Code e in Cowork legge il file e gli passa le righe da solo, fino a 5.000 per importazione. - Capisce le colonne come l'app: quelle del modello e nomi comuni come "sku", "cost" o "date". Se non ne riconosce una, indica da quale colonna viene ogni dato, senza chiederti un altro file. Ogni riga segue le regole del file dell'app.
- Prima di importare ti mostra il controllo. Senza salvare né addebitare nulla, ti dice quante righe si applicherebbero, quante non cambierebbero nulla perché il prodotto aveva già quel costo nella loro data, quante non si applicherebbero e perché, quante sarebbero senza data e quanti crediti costerebbe. Importa solo quando gli dici di sì, e se il controllo cambia quando cambi la data, te lo mostra di nuovo prima.
- Le date contano. Una riga senza data vale da oggi e non copre le vendite precedenti. Se il tuo file non ha date, l'assistente ti chiede da quando valgono i costi e lo usa per quelle righe. E se una riga ha una data precedente a un costo che il prodotto ha già, ti avvisa che conterà solo fino a quel costo, che resta.
- I prodotti padre di variazione vengono rifiutati. Non si vendono, quindi il loro costo non coprirebbe nessuna vendita: il costo va sulle loro variazioni.
- Ti dà il risultato quando finisce: quante righe sono state applicate, quante non cambiavano nulla e quante sono state rifiutate, con il motivo di ciascuna. Fino ad allora non ti dirà che i costi sono caricati.
- Resta nella cronologia dell'app, nella Cronologia dell'importazione dei costi di quell'account.
- Un account per importazione. Se il P&L di quell'account si sta ricalcolando per una modifica di costo precedente, non importa nulla: aspetta che finisca e richiediglielo.
- Ogni riga applicata costa quanto scrivere il costo di un prodotto. All'inizio si riservano le righe che possono essere applicate e, se il tuo saldo non basta, non si importa nulla. Alla fine si addebitano solo quelle applicate e il resto viene restituito. Vedere a che punto è non costa nulla. Solo nei piani che includono il costo prodotto.
- Anche acquisti. Importa anche acquisti da un file di acquisti, solo negli account Seller. Il suo controllo verifica solo il formato di ogni riga e rifiuta già quelle malformate: lo SKU, il suo gruppo di stock e lo stock si verificano all'importazione, quindi qualche riga in più può essere rifiutata in quel momento. Ogni acquisto applicato costa quanto registrarlo singolarmente.
Scrivere spese proprie
Con lo stesso permesso costs:write, l'assistente gestisce le tue spese proprie: le stesse che registri in Costi e spese → Spese proprie. Puoi dettargliele in chat o passargli un foglio di calcolo con le tue spese, e lui le crea con epinium_create_expenses. Con un foglio, nelle chat di Claude, web e desktop, e in ChatGPT ti mostra un riquadro per trascinarlo: il file va direttamente a Epinium e si legge con le regole dell'importazione dell'app, senza che l'assistente copi le sue righe. Se le sue colonne non si chiamano come quelle del modello, l'assistente indica a Epinium da quale arriva ogni dato. In Claude Code e in Cowork, che non mostrano il riquadro, legge il foglio da solo.
Cinque cose da sapere:
- Prima ti mostra cosa sta per creare. Con più spese, l'assistente le verifica prima senza creare nulla né consumare crediti, ti mostra il risultato e le crea solo quando gli dici di sì. Se una ha un errore non ne viene creata nessuna: ti dirà quale non va perché tu la corregga, o creerà solo quelle valide se glielo chiedi.
- Ti avvisa dei possibili duplicati. Se una spesa somiglia a una che hai già, o l'hai messa due volte nel foglio, te lo chiede prima di crearla. E se un importo del foglio può essere migliaia o decimali, come
1.500, te lo chiede invece di supporlo, così come l'importazione dell'app lo rifiuta. - Ti chiede conferma prima di cambiare un importo, terminare o eliminare una spesa. Un nuovo importo vale dal mese che scegli, e l'assistente ti chiederà da quale. Terminarla elimina i cambi di importo che aveva programmati dopo. Eliminare una spesa la toglie da tutto lo storico; se vuoi solo che smetta di contare, chiedigli di terminarla.
- Il P&L le sottrae subito. Ciò che crei, modifichi o elimini si vede alla richiesta successiva del P&L, anche nei mesi già passati.
- Solo nei piani che includono il costo prodotto. In Free e Guru questi strumenti rispondono con un 403.
Consultare i tuoi negozi Shopify e WooCommerce
Con il permesso platform:read l'assistente legge in diretta ciò che c'è dentro i negozi Shopify e WooCommerce che hai collegato: prodotti, varianti, scorte, prezzi e il resto di ciò che espone ogni negozio. Lo fa con due strumenti che valgono per entrambe le piattaforme:
epinium_platform_docsgli dice quale versione dell'API del negozio usa Epinium, dove si trova la sua documentazione di riferimento e le trappole che fanno sembrare corretta una risposta che non lo è. Gli mostra anche i campi che ha il tuo negozio in questo momento, compresi quelli aggiunti dai tuoi plugin o dalle tue app, così non li scrive a memoria.epinium_platform_requestesegue la query nella lingua di ogni piattaforma: GraphQL su Shopify e REST su WooCommerce.
Con il permesso platform:write, lo stesso epinium_platform_request crea, modifica ed elimina anche prodotti e contenuti nel negozio, direttamente e senza attività. Cosa può cambiare su ciascuna piattaforma, e cosa resta registrato, è nelle guide Shopify e WooCommerce. Per copiare il tuo catalogo Amazon nel tuo negozio, passo dopo passo, consulta i casi d'uso.
Tre cose da sapere:
- È un permesso diverso da
connections:read. Quello dice che cosa hai collegato; questo permette di leggere ciò che c'è dentro il negozio. Per questo ha una sua area nella schermata dei permessi, Dati dei tuoi negozi e piattaforme collegati. - I dati personali non escono. Nomi, email, telefoni e indirizzi vengono rifiutati prima che la query arrivi al negozio. È una protezione voluta, non un errore, e l'assistente sa quale campo l'ha fatta scattare.
- Si paga in base alla dimensione della risposta. Chiedere solo i campi che ti servono costa meno ed è più veloce.
Quali dati raggiunge
Gli stessi dell'API, risorsa per risorsa. L'elenco completo degli endpoint, con cosa restituisce ognuno, è nella sezione API.
Cinque cose da sapere quando gli chiedi dati:
- Le metriche richiedono un intervallo di date. Indicagli il periodo che ti interessa; altrimenti l'assistente te lo chiederà.
- Puoi chiedere l'andamento giorno per giorno, non solo il totale del periodo. Utile per vedere le tendenze invece di una singola cifra aggregata.
- Il tetto dell'intervallo dipende dalla granularità. Con il totale del periodo o per settimane, mesi, trimestri o anni, 366 giorni; giorno per giorno, 93. Su target e termini di ricerca, le risorse più pesanti, scendono a 93 e 31. Chiedere di più restituisce un errore che indica il limite esatto.
- Un dato vuoto non è uno zero. Se l'assistente dice che una metrica non è disponibile, significa che Amazon non la riporta per quel formato di annuncio, non che valga zero.
- Prima di dirti che un dato non esiste, lo cerca. Con
epinium_find_datatrova lo strumento e il campo di qualsiasi metrica per nome o per sigla. Se ti dice ancora che non ce l'ha, è perché il MCP non lo espone.
Domande a cui risponde bene
- Quali campagne hanno l'ACOS peggiore questo mese?
- Su quali ricerche sto spendendo senza vendere nulla?
- Quali keyword stanno funzionando meglio e varrebbe la pena portare a corrispondenza esatta?
- Quali prodotti pubblicizzati non ricevono nemmeno un'impression?
- Quali dei miei prodotti hanno traffico ma non convertono?
- Cosa ha cambiato il workflow su questa campagna nell'ultimo mese, ed è servito a qualcosa?
- Quali campagne raggiunge il mio workflow, e ce n'è qualcuna che credo ottimizzata e che in realtà non tocca mai?
- Quali prodotti del mio negozio Shopify o WooCommerce stanno finendo le scorte?
- Quanto ha venduto ciascuno dei miei cluster il mese scorso, e quanto ho speso in pubblicità per ognuno?
- Quale canale di vendita mi lascia il margine reale migliore, al netto di tutto ciò che mi costa produrre e vendere il prodotto?