Vai al contenuto
Lorenzo Algeri

Pipeline per le inserzioni dei concorrenti

Raccoglie dalla Meta Ad Library le inserzioni dei concorrenti di un e-commerce e scarta le creative già viste, anche se ricaricate.

Cliente · Agenti & LLMStato: Fermo

Per chi
Un e-commerce, tramite un partner commerciale (nomi omessi)
Ruolo
Progettazione e sviluppo
Stack
Python · Apify · ImageHash · ffmpeg · OpenRouter · Claude · Google Drive API · WeasyPrint · openpyxl · pytest

In breve

Prima
Le inserzioni dei concorrenti si controllavano a mano sulla Meta Ad Library, e le creative ricaricate sembravano nuove.
Cosa ho fatto
Una pipeline che le raccoglie, scarta le creative già viste e consegna digest, PDF ed Excel su Drive.
A che punto è
Fermo. Lo scheduler è scritto ma non è mai stato acceso: le run partivano a mano.

Com'era prima

Chi seguiva le inserzioni per il cliente apriva a mano le pagine dei concorrenti sulla Meta Ad Library, riconosceva a occhio le creative già viste e le scaricava su Drive. I concorrenti però ricaricano la stessa creativa come se fosse nuova.

Come funziona

Cosa faccio fare all'LLM

Claude, via OpenRouter

Interviene in alcuni punti: triage, shortlist, sommario del digest.

Sempre facoltativo

Se la chiamata fallisce, la pipeline va avanti e il digest esce lo stesso.

Parere facoltativo

Cosa lascio al codice

Raccolta via Apify

Le inserzioni dei concorrenti dalla Meta Ad Library, con retry e cache su disco.

Filtro e dedup

Tiene solo le inserzioni recenti. Poi un perceptual hash sui frame video, confrontato con tutto lo storico.

Un verdetto per creativa

Unica, sospetta o doppione. Si scarta solo ad alta confidenza.

Consegna su Drive

Digest, PDF ed Excel, con upload idempotenti e in sola aggiunta.

Se l'LLM sbaglia o non risponde

Se Claude non risponde, la pipeline salta triage, shortlist e sommario, e il digest esce lo stesso con le creative filtrate dal codice.

Perché è fatto così

I doppioni con il perceptual hash

Ogni frame video diventa un'impronta, e il confronto con lo storico usa la distanza di Hamming con una soglia configurabile. Nessun modello decide cosa è già stato visto.

Si scarta solo ad alta confidenza

Una creativa si scarta solo se il confronto è netto, e un valore che manca resta vuoto invece di diventare zero. Il prezzo è qualche doppione in più nella shortlist.

Il modello è facoltativo

Triage, shortlist e sommario usano Claude, ma se la chiamata fallisce la pipeline va avanti e il digest esce lo stesso.

Solo lettura

La pipeline legge dati pubblici e su Meta non scrive nulla: non crea inserzioni e non tocca budget. Su Drive aggiunge file senza sovrascrivere.

I numeri

Contesto
Cliente
Stato
Fermo
LLM
1 nodo
Codice
2 nodi

Lavoro per terzi: lo racconto in astratto, senza dati reali.

A che punto è, e cosa rifarei

Fermo. Lo scheduler è scritto ma non è mai stato acceso: le run partivano a mano.

Altri casi

Se da voi qualcuno controlla a mano pagine o annunci, scrivimi quali fonti guarda e cosa vi serve alla fine. info@lorenzoalgeri.it