Mettere la SEO del tuo negozio Shopify in pilota automatico con Claude Routines

Il principio in una frase

Una routine Claude si attiva a un orario fisso, legge un elenco di contenuti nel tuo repository GitHub, sceglie il prossimo da ottimizzare, lo riscrive seguendo i consigli SEO di Vetta, invia la proposta a Vetta, spunta la riga nell’elenco e torna a dormire.

Il controllo resta a te in due punti: il file di istruzioni, che dice a Claude come scrivere, e la coda di revisione di Vetta, da cui non va online nulla senza il tuo consenso. È la configurazione che uso per le pagine delle collezioni di un negozio che gestisco. Gira da sola, e il mio lavoro si riduce a rileggere.

Cosa ti serve

Prima di iniziare, controlla di avere questi tre elementi.

Elemento	A cosa serve	Dove trovarlo
Un account GitHub e un repository privato	Contiene il file di monitoraggio e le istruzioni. La routine lo clona a ogni esecuzione e ci fa push degli aggiornamenti.	github.com (gratuito)
Un abbonamento Claude Pro, Max, Team o Enterprise	Le routine sono riservate agli abbonamenti a pagamento.	claude.ai
L’app Vetta installata sul tuo negozio	Fornisce il connettore che Claude usa per leggere i tuoi contenuti e proporre versioni.	Shopify App Store

Non serve saper programmare. Si fa tutto dal browser.

Passaggio 1: creare il repository GitHub privato

1. Accedi a GitHub e apri github.com/new.
2. Dai un nome al repository, per esempio seo-negozio.
3. Seleziona Private.
4. Seleziona Add a README file, così il repository non è vuoto.
5. Clicca su Create repository.

Lascia il branch main senza regole di protezione (è l’impostazione predefinita di un nuovo repository). La routine deve poterci fare push del file di monitoraggio aggiornato, e Claude Code si rifiuta di fare push su un branch protetto.

Passaggio 2: aggiungere il file CSV di monitoraggio

Il file di monitoraggio è la lista di lavoro della routine. Ogni riga è un contenuto Shopify; le colonne indicano se è stato trattato, se è in lavorazione e a che punto è la sua proposta in Vetta.

Scarica il modello suivi-seo.csv

Type,Handle,Title,Optimized,OptimizedAt,WorkingNow,WorkingSince,VettaStatus,VettaProposalUrl
product,borraccia-acciaio-750ml,Borraccia in acciaio 750 ml,NO,,NO,,,
product,borraccia-termica-500ml,Borraccia termica 500 ml,NO,,NO,,,
collection,borracce,Borracce,NO,,NO,,,
page,spedizioni-e-resi,Spedizioni e resi,NO,,NO,,,

Tu compili solo le prime tre colonne:

• Type: product, collection, page o article;
• Handle: la parte finale dell’URL del contenuto (in /products/borraccia-acciaio-750ml è borraccia-acciaio-750ml);
• Title: il titolo, per orientarti.

Metti NO in Optimized e WorkingNow e lascia vuoto il resto: quelle colonne le compila Claude. L’ordine delle righe conta, perché la routine prende sempre la prima non ancora trattata. Metti quindi in cima i contenuti prioritari, quelli con più traffico o che vendono di più.

Per ricavare in fretta i tuoi handle, esporta i prodotti dall’admin di Shopify (Prodotti > Esporta) e copia la colonna Handle.

Per aggiungere il file al repository: nella pagina del repository clicca su Add file > Upload files, trascina suivi-seo.csv e poi Commit changes. Tieni esattamente questo nome, perché le istruzioni lo richiamano.

Passaggio 3: aggiungere il file di istruzioni

Il file di istruzioni è il capitolato della routine. Descrive come si svolge un’esecuzione (bloccare la riga, leggere il contenuto, proporre, aggiornare il CSV) e le tue regole di scrittura.

Scarica il modello instructions-seo.md

Il modello funziona così com’è, ma è fatto per essere modificato. Le sezioni segnate «Da adattare» sono quelle che contano di più:

• Cosa ottimizzare: titolo SEO, meta description, descrizione, testo alternativo delle immagini. Togli ciò che non vuoi veder cambiare.
• Le regole di scrittura: descrivi il tono del tuo brand, se dai del tu o del Lei, le parole da evitare.

Una regola non è negoziabile, e il modello la impone: Claude non deve mai inventare caratteristiche, materiali o certificazioni. Usa solo ciò che c’è già nei tuoi contenuti. Gli errori tipici delle descrizioni prodotto scritte dall’IA nascono quasi tutti da lì.

Aggiungi il file al repository nello stesso modo (Add file > Upload files), con il nome instructions-seo.md. Per modificarlo in seguito, aprilo su GitHub e clicca sull’icona della matita. La routine leggerà la nuova versione all’esecuzione successiva.

Passaggio 4: collegare Vetta a Claude

Claude può leggere i tuoi contenuti e proporre versioni solo attraverso il connettore Vetta. Se non l’hai ancora fatto:

1. In Vetta, apri Impostazioni > Server MCP e copia l’URL del server.
2. Su claude.ai, vai nei connettori e aggiungi un connettore personalizzato con quell’URL.
3. Accedi con il tuo account Vetta quando Claude te lo chiede.

La pagina server MCP per Shopify spiega cosa permette il connettore e cosa no: non esiste alcuno strumento di pubblicazione.

Passaggio 5: creare la routine

Apri claude.ai/code/routines. Ci arrivi anche da Claude Code, con la voce Routines del menu a sinistra. Gli screenshot mostrano l’interfaccia in francese.

Clicca su New routine (nuova routine) in alto a destra.

Poi compila il modulo.

Il nome. Qualcosa di chiaro, come «SEO negozio: un contenuto per esecuzione».

Il prompt. Deve bastare a se stesso: durante l’esecuzione nessuno risponderà alle domande di Claude. Questo rimanda al file di istruzioni, così regoli tutto da GitHub senza toccare la routine:

Ottimizzi la SEO del mio negozio Shopify, un contenuto alla volta.

1. Leggi il file instructions-seo.md nella radice del repository e seguilo alla lettera.
2. Il file di monitoraggio è suivi-seo.csv, nella radice del repository.
3. Usa il connettore Vetta per leggere i contenuti e proporre le nuove versioni. Non pubblichi mai nulla.
4. Tratta UN SOLO contenuto, poi fermati.
5. Fai commit delle modifiche a suivi-seo.csv direttamente sul branch main e fai push. Non creare né un branch claude/ né una pull request.
6. Chiudi con un riepilogo: il contenuto trattato, cosa è cambiato, il link di approvazione di Vetta.

Il punto 5 è importante. Per impostazione predefinita, una routine fa push del proprio lavoro su un branch con un nome che inizia con claude/. Il CSV su main non verrebbe mai aggiornato, e la routine ritratterebbe lo stesso contenuto a ogni esecuzione.

Il repository. Seleziona il tuo repository privato. Se Claude non ha ancora accesso al tuo account GitHub, il modulo ti propone di collegarlo.

L’ambiente. Lascia Default. Il connettore Vetta passa dai server di Anthropic e non richiede alcuna configurazione di rete.

Il trigger. Scegli una pianificazione e una frequenza: ogni ora, ogni giorno, nei giorni feriali o ogni settimana. Per un ritmo su misura, vedi la sezione successiva.

I connettori. È il passaggio da non sbagliare. Controlla che Vetta - AI SEO Content Review compaia nella sezione Connectors (connettori). Senza, Claude non può né leggere i tuoi contenuti né inviare proposte, e l’esecuzione gira a vuoto.

Tutti i tuoi connettori sono inclusi per impostazione predefinita. Togli quelli che non servono alla routine (Gmail, Drive, Shopify…): durante un’esecuzione, Claude può usare tutti gli strumenti di un connettore incluso, scrittura compresa, senza chiedere il permesso.

Salva la routine e avviala subito dalla sua pagina (pulsante Run now) per fare una prima prova senza aspettare l’orario previsto.

Passaggio 6: controllare la prima esecuzione

Ogni esecuzione si apre come una normale sessione di Claude Code. Apri la prima e leggila fino in fondo. Un pallino verde significa solo che la sessione è partita e si è chiusa senza errori tecnici, non che il compito sia riuscito.

Poi controlla tre cose:

1. Su GitHub, suivi-seo.csv ha una nuova versione, con Optimized = YES sulla prima riga.
2. In Vetta, c’è una proposta in attesa nella coda di revisione.
3. La proposta ti convince.

Se il tono o la lunghezza non vanno, correggi instructions-seo.md adesso, prima che la routine tratti venti contenuti allo stesso modo. In Vetta confronti ogni campo proposto con la versione online, poi approvi, chiedi modifiche o rifiuti.

Scegliere la frequenza: le espressioni cron da copiare

Il modulo web offre solo frequenze predefinite. Per un ritmo preciso, scegli la frequenza più vicina, poi apri Claude Code in un terminale, lancia /schedule update e indica l’espressione cron che vuoi, specificando il fuso orario («ora di Roma», per esempio). L’intervallo minimo è di un’ora: un’espressione più frequente viene rifiutata.

Ritmo	Espressione cron	Esecuzioni al giorno
Ogni ora	0 * * * *	24
Ogni 2 ore	0 */2 * * *	12
Ogni 3 ore	0 */3 * * *	8
Ogni 4 ore	0 */4 * * *	6
Ogni 6 ore	0 */6 * * *	4
4 volte al giorno in orario d’ufficio (9, 12, 15, 18)	0 9,12,15,18 * * *	4
Ogni 2 ore dalle 8 alle 18, nei giorni feriali	0 8-18/2 * * 1-5	6
Una volta al giorno alle 7	0 7 * * *	1
Il lunedì alle 8	0 8 * * 1	1 a settimana

I cinque campi si leggono in quest’ordine: minuto, ora, giorno del mese, mese, giorno della settimana (1-5 = dal lunedì al venerdì). Visto che la routine tratta un contenuto per esecuzione, l’ultima colonna ti dice anche quanti contenuti vengono ottimizzati al giorno.

Il tetto di esecuzioni giornaliere

Le routine hanno un tetto di esecuzioni al giorno, oltre ai normali limiti di utilizzo del tuo abbonamento. Storicamente era di 5 esecuzioni al giorno con Pro, 15 con Max e 25 con Team ed Enterprise. Le routine sono ancora in anteprima e questi numeri possono cambiare: la quota che ti resta è indicata su claude.ai/code/routines.

Scegli quindi la frequenza di conseguenza. Con Pro, «ogni 4 ore» dà 6 esecuzioni, una di troppo: l’ultima viene rifiutata, a meno che tu non abbia attivato i crediti di utilizzo. «Ogni 6 ore» o «4 volte in orario d’ufficio» restano nei limiti. Con Max, «ogni 2 ore» (12 al giorno) va bene. Ricorda che tutte le tue routine condividono lo stesso tetto, e che le esecuzioni consumano anche il tuo utilizzo di Claude come una sessione normale.

Perché regge

L’automazione non pubblica nulla. Claude scrive, Vetta tiene ogni proposta accanto alla versione online, e una persona decide. Se una proposta inventa un dettaglio, si ferma nella coda di revisione invece di finire sulla tua scheda prodotto. È lo stesso principio di perché un agente IA non dovrebbe mai pubblicare su Shopify, applicato a un agente che lavora mentre dormi.

Il monitoraggio su GitHub ha un altro vantaggio: ogni esecuzione lascia un commit. Sai quale contenuto è stato trattato e a che ora, e puoi rimettere una riga a NO per farla ritrattare dopo aver modificato le istruzioni.

Inizia con dieci righe nel CSV e una frequenza modesta. Rileggi le dieci proposte. Se ti convincono, aggiungi il resto del catalogo.