Native Ad Library MCP: Interroga 635,443 annunci nativi da Claude e ChatGPT
Foreplay ha rivendicato l'MCP della libreria di annunci per gli annunci Meta. Le reti native ora hanno il loro: un server MCP ospitato che espone 43 strumenti su 635,443 creative di Taboola, Outbrain, MGID e Revcontent — ecco cosa possono fare gli agenti e come configurarlo.

Ora puoi chiedere a Claude o ChatGPT domande come "quali inserzionisti hanno lanciato nuove campagne Taboola nel settore assicurativo questa settimana, e quali dei loro annunci sono sopravvissuti più a lungo?" — e ottenere risposte calcolate dai dati pubblicitari live catturati, non dalla memoria di addestramento del modello. L'infrastruttura che rende possibile tutto ciò è MCP, e da luglio 2026 OpenAdLibrary ospita un server MCP su mcp.openadlibrary.com che espone 43 strumenti su un indice di 635.443 creatività di annunci nativi provenienti da 27.256 inserzionisti attraverso 46 reti. Questa guida spiega cosa significa, cosa fanno gli strumenti e come collegarlo al tuo assistente AI in circa cinque minuti.
Gli inserzionisti Meta hanno già questo schema: Foreplay ha rilasciato un MCP per la libreria di annunci per la ricerca creativa su Meta e TikTok all'inizio di quest'anno. Le reti di scoperta native — Taboola, Outbrain, MGID, Revcontent, il feed MSN — non avevano nulla, il che è coerente con la storia del canale: non esisteva una libreria pubblica di annunci nativi fino a poco tempo fa (la storia completa è in cos'è una libreria di annunci nativi). Questo server MCP è quella libreria, resa richiamabile dagli agenti.
Cos'è MCP, in un minuto#
MCP (Model Context Protocol) è uno standard aperto, introdotto da Anthropic a fine 2024 e da allora adottato dalle principali piattaforme AI, che consente agli assistenti AI di chiamare strumenti esterni. Un server pubblica un catalogo di strumenti — "cerca annunci", "ottieni brand", "elenca tendenze" — ognuno con input e output tipizzati. Il client AI (Claude, ChatGPT, Cursor, VS Code o il tuo agente personalizzato) legge il catalogo e decide quando chiamare cosa. Parli con l'assistente in inglese semplice; lui gestisce i meccanismi dell'API, la paginazione e le chiamate successive.
La conseguenza pratica: una libreria di annunci smette di essere un sito web che navighi e diventa una fonte di dati su cui il tuo agente può ragionare. Invece di venti minuti a cliccare filtri, fai una domanda composta e l'agente incatena cinque chiamate di strumenti per rispondere.
Cosa espone l'MCP di OpenAdLibrary#
Il server ospitato è un sottile strato autenticato sopra la stessa API pubblica descritta nella panoramica API dei dati degli annunci nativi — stesso indice, stesse quote, stessa chiave. I 43 strumenti si raggruppano in sei cluster:
| Cluster | Strumenti esemplificativi | Cosa fanno gli agenti con essi |
|---|---|---|
| Ricerca annunci | search_ads, get_creative, walk_ads_keyset, sync_ads_changes |
Trovare annunci live per rete, paese, verticale, inserzionista o testo; sincronizzare delta |
| Brand e inserzionisti | list_brands, get_brand, search_advertisers, batch_brands, get_brand_hierarchy |
Scoprire chi si cela realmente dietro un annuncio; profilare l'intero portfolio di un concorrente |
| Pagine di destinazione | list_landing_pages, get_landing_page, get_landing_page_ads |
Recuperare l'imbuto di destinazione tracciato dietro una creatività |
| Intelligence di mercato | get_trending, get_share_of_voice, get_keyword_trends, list_new_entrants, get_network_profile |
Individuare inserzionisti in crescita, misurare il dominio verticale, confrontare reti |
| Editori e catena di fornitura | list_publishers, get_publisher_monetization, get_supply_chain_publisher |
Vedere quali siti gestiscono quali reti e chi monetizza dove |
| Flusso di lavoro | watch_advertiser, list_watchlist, save_search, list_boards, list_notifications |
Persistere watchlist e ricerche che l'agente può controllare su base programmata |
Dietro questi strumenti si trova l'intero corpus: 171.050 creatività di Taboola, 92.290 da Outbrain, 54.585 da MGID, 12.821 da Revcontent, più 1.081.997 pagine di destinazione tracciate e 5.874.698 osservazioni di annunci (luglio 2026). Ogni creatività porta l'etichetta reale dell'inserzionista, le date di prima/ultima osservazione, rete, geo e lingua — la materia prima per ogni caso d'uso seguente.
Cosa puoi effettivamente fare con esso#
Ricerca concorrenti senza la giungla di schede#
Chiedi: "Profilare la pubblicità nativa di competitor-brand.com. Su quali reti sono, quante creatività live, quali angolazioni stanno usando e cosa vendono le loro pagine di destinazione?" L'agente incatena get_brand → search_ads → get_landing_page_ads e restituisce un briefing che richiederebbe a un analista un pomeriggio. La versione manuale di questo flusso di lavoro è documentata in come spiare gli annunci nativi dei concorrenti — la versione MCP è la stessa logica, delegata.
Ideazione creativa da vincitori comprovati#
Il briefing creativo più affidabile nella pubblicità nativa è "ciò che è già sopravvissuto". Chiedi: "Trova gli annunci sanitari più longevi su Taboola negli Stati Uniti, raggruppa i loro hook e abbozza cinque nuove angolazioni di titolo che usano la stessa psicologia senza copiare." La longevità è il proxy della redditività — nel nostro indice circa l'89% delle creatività di immagini scompare entro 10 giorni dalla prima osservazione, quindi i sopravvissuti sono un insieme prefiltrato di cose che funzionano (vedi longevità degli annunci come segnale vincente). Un agente con search_ads più le tue istruzioni di scrittura trasforma quel filtro in un pipeline creativo, e come analizzare le creatività di annunci nativi vincenti fornisce il quadro di punteggio che vale la pena incollare nel tuo prompt.
Controlli di longevità e affaticamento su richiesta#
Chiedi: "Controlla ogni annuncio nella mia watchlist — quali hanno smesso di essere osservati questa settimana e quali hanno superato i 21 giorni di attività?" Con list_watchlist e sync_ads_changes, questo diventa un compito programmato dell'agente anziché una scocciatura del lunedì. Abbinalo ai segnali di come trovare annunci vincenti e hai un report automatizzato dei movimenti di mercato.
Esplorazione di verticali e reti#
Chiedi: "Confronta Taboola vs MGID per il verticale intrattenimento: volume creativo, principali inserzionisti e nuovi entranti negli ultimi 30 giorni." Strumenti come get_network_profile, get_share_of_voice e list_new_entrants sono stati costruiti proprio per questa aggregazione. Per contesto su come differiscono le reti, MGID vs Taboola è la versione scritta da umani.
Guida alla configurazione#
Il server parla HTTP Streamable — lo standard di trasporto MCP corrente — all'indirizzo https://mcp.openadlibrary.com/mcp, e autentica con la tua chiave API personale inviata come token Bearer. Ogni client principale segue lo stesso schema.
Passo 1 — ottieni una chiave. Crea un account gratuito, poi genera una chiave API in Impostazioni. Le chiavi hanno aspetto oal_... e vengono mostrate una sola volta. Il livello gratuito è veramente limitato: 2 richieste/giorno, sufficienti per verificare la connessione ed eseguire un paio di chiamate. Un piano a pagamento ($29.99/mese) sblocca la quota standard di 5.000 richieste/giorno.
Passo 2 — aggiungi il connettore. In Claude, aggiungi un connettore personalizzato puntando a https://mcp.openadlibrary.com/mcp con la tua chiave come intestazione Authorization. In Claude Code è un singolo comando:
claude mcp add --transport http openadlibrary \
https://mcp.openadlibrary.com/mcp \
--header "Authorization: Bearer oal_YOUR_KEY"
Cursor, VS Code e la maggior parte degli altri client accettano la configurazione JSON equivalente:
{
"mcpServers": {
"openadlibrary": {
"url": "https://mcp.openadlibrary.com/mcp",
"headers": { "Authorization": "Bearer oal_YOUR_KEY" }
}
}
}
Passo 3 — test di fumo. Chiedi al tuo assistente: "Usando gli strumenti di openadlibrary, quanti annunci Taboola live menzionano apparecchi acustici e chi ne gestisce di più?" Se ottieni numeri con nomi di inserzionisti, sei connesso. Se invece ricevi un errore di autenticazione, il colpevole di solito è il prefisso Bearer mancante sulla chiave.
Alcune note operative che vale la pena conoscere. Il server è stateless e multi-tenant — la tua chiave è la tua identità, e le quote e i limiti di frequenza (120 richieste/minuto a raffica) sono applicati per chiave, esattamente come sulla REST API grezza. Non esiste un prezzo separato per MCP; è lo stesso piano e lo stesso pool di quote della API pubblica. E poiché il server è un pass-through su /api/v1, tutto ciò che puoi fare in MCP puoi anche scriptarlo direttamente — il confronto strumenti di spionaggio pubblicitario con API copre quando REST batte MCP e viceversa.
Un esempio pratico: smontaggio di un concorrente in una sessione#
Per rendere concreto, ecco uno schema di sessione reale — il tipo di compito composto che giustifica la configurazione. Supponi di vendere apparecchi acustici e di voler comprendere il panorama nativo prima di impegnare budget.
Turno 1: "Cerca nell'indice di annunci nativi gli annunci di apparecchi acustici su Taboola e Outbrain negli Stati Uniti. Quante creatività live e chi sono i primi cinque inserzionisti per numero di creatività?" L'agente chiama search_ads con filtri di rete e testo, aggrega e fa i nomi — inclusi i brand fittizi di cui non hai mai sentito parlare che si scopre gestiscano centinaia di creatività.
Turno 2: "Per il primo inserzionista, recupera le loro creatività osservate più a lungo e le pagine di destinazione dietro di esse. Qual è la struttura dell'imbuto?" L'agente incatena get_brand, search_ads ordinato per durata osservata e get_landing_page_ads. Impari se i vincitori eseguono funnel di quiz, advertorial o pagine prodotto dirette — la differenza tra copiare un titolo e comprendere una strategia.
Turno 3: "Aggiungi i primi tre inserzionisti alla mia watchlist e salva questa ricerca." L'agente chiama watch_advertiser e save_search, così la sessione della prossima settimana inizia con "cosa è cambiato nella mia watchlist?" anziché ricominciare da capo.
Venti minuti, nessuna scheda, e l'output è un briefing scritto che puoi incollare in un documento di campagna. Il flusso di lavoro manuale equivalente è reale — lo abbiamo documentato in come fare analisi degli annunci della concorrenza — ma è un pomeriggio, non venti minuti.
Pattern di prompting che ottengono buone risposte#
Gli agenti di dati pubblicitari falliscono in modi prevedibili, e tre abitudini prevengono la maggior parte dei fallimenti.
Definisci l'ambito prima di spazzare. "Mostrami annunci vincenti" costringe l'agente a indovinare rete, geo e verticale, bruciando quota su chiamate ampie. "Annunci Taboola USA nel settore assicurativo osservati per 14+ giorni" ottiene una chiamata precisa al primo tentativo — il che conta su una chiave misurata.
Chiedi le prove, non solo la conclusione. Fai restituire all'agente ID creatività, date di prima osservazione ed etichette degli inserzionisti insieme al suo riepilogo. Gli agenti riassumono con sicurezza; la disciplina di citare righe li mantiene onesti e rende l'output verificabile nella dashboard.
Insegna una volta l'avvertenza sulla longevità. Aggiungi alle tue istruzioni di progetto: "giorni di attività significa giorni osservati all'interno di una finestra mobile di circa 31 giorni; trattalo come un limite minimo." Ogni conclusione sulla longevità che l'agente trae a valle eredita quella correzione — quel pezzo di conoscenza di dominio è ciò che trasforma l'accesso grezzo agli strumenti in analisi competente.
Per i costruttori di AI: oltre i client chat#
Nulla del server presuppone un'interfaccia chat. Poiché parla MCP HTTP Streamable standard, si collega a framework di agenti — Claude Agent SDK, OpenAI Agents SDK, adattatori MCP di LangChain — come fonte di strumenti per pipeline completamente autonome. I pattern che vediamo funzionare: un agente cron settimanale che esamina una watchlist e invia per email un digest della concorrenza; un pipeline di generazione creativa che recupera i dieci annunci più longevi in un verticale come contesto few-shot prima di scrivere; e bot Slack interni che rispondono a "chi sta pubblicizzando X?" per tutto il team senza licenze per postazione.
Il design delle quote supporta deliberatamente questo: le chiavi sono per utente, le quote sono applicate lato server (5.000 richieste/giorno standard, 120/minuto a raffica), e il layer MCP è stateless, quindi la concorrenza orizzontale degli agenti non necessita di affinità di sessione. Se preferisci saltare il sovraccarico MCP in una pipeline puramente di codice, le stesse operazioni esistono come REST semplice su /api/v1 con semantica identica.
Da dove provengono i dati (e perché gli agenti possono fidarsi)#
Le conclusioni di un agente sono valide solo quanto il corpus sottostante, quindi vale la pena sapere cosa stanno effettivamente interrogando gli strumenti. L'indice è costruito catturando continuamente posizionamenti di annunci nativi live da pagine pubbliche di editori — le unità di raccomandazione sponsorizzate che tutti vedono sotto gli articoli — tramite le API di consegna delle stesse reti, mai cliccando annunci live (cliccare farebbe pagare soldi reali agli inserzionisti e inquinerebbe le loro analisi; la cattura e il tracciamento dei clic sono separati per design). Ogni creatività catturata è memorizzata a piena qualità, classificata per verticale e lingua, risolta attraverso la sua catena di reindirizzamento tracker fino a un'etichetta reale dell'inserzionista e — per una quota crescente — collegata a una pagina di destinazione tracciata. Quel passaggio di risoluzione è più importante per gli agenti che per gli umani: quando Claude riporta che un vago brand "sponsorizzato" è in realtà uno specifico operatore di lead generation assicurativa, sta leggendo il campo brandLabel, non indovinando.
Scala e freschezza sono misurabili piuttosto che affermate: 5.874.698 osservazioni di annunci fino ad oggi, con la sola fetta di Taboola che mostra 167.524 creatività osservate per la prima volta negli ultimi 30 giorni (luglio 2026). Per gli agenti, quella freschezza è la differenza tra "ecco cosa ha funzionato nella pubblicità nativa una volta" e "ecco cosa sta funzionando in questo momento" — ed è il motivo per cui i controlli di longevità, le scansioni di nuovi entranti e le domande sulle tendenze restituiscono risposte che cambiano di settimana in settimana, come si comporta effettivamente un mercato live.
MCP vs dashboard: quando usare l'uno o l'altra#
La dashboard rimane migliore per la navigazione visiva — scorrere griglie creative, valutare stili di immagini, il lavoro di serendipità descritto in come trovare angolazioni vincenti negli annunci nativi. L'MCP vince ogni volta che la domanda è composta ("trova X, poi per ciascuno controlla Y"), programmata (digest settimanali) o alimenta un altro sistema (un briefing, un report, un modello). La maggior parte dei professionisti finirà per usarli entrambi: naviga per costruire intuizione, delega agli agenti per la ripetizione.
Una cautela per il pubblico dei costruttori di AI: gli agenti amplificano i problemi di qualità dei dati. Il nostro indice osserva gli annunci in una finestra mobile (attualmente fino a circa 31 giorni di osservazione continua per creatività), quindi "giorni di attività" significa giorni osservati, non durata di vita — istruisci di conseguenza il tuo agente, altrimenti le sue conclusioni sulla longevità saranno sistematicamente conservative. La stessa avvertenza si applica a ogni libreria di annunci, inclusa quella di Meta; la differenza è se il fornitore te lo dice.
In sintesi#
"Ad library MCP" esisteva a malapena come frase prima del 2026 — Foreplay l'ha rivendicato per gli annunci Meta, e le reti native ora hanno il loro su mcp.openadlibrary.com: 43 strumenti su 635.443 creatività native, 1.081.997 pagine di destinazione e un layer di flusso di lavoro per watchlist e ricerche salvate, sulla stessa chiave e quota dell'API pubblica a partire da $29.99/mese con un livello di test gratuito. Se sei un marketer tecnico o un costruttore di AI, il messaggio è semplice: la ricerca pubblicitaria della concorrenza sta diventando un compito per agenti, e gli agenti hanno bisogno di una fonte di dati che parli il loro protocollo. Per la pubblicità nativa, questo è tutto.







