Un'unica API pubblicitaria per il tuo codice e i tuoi agenti
La REST API v1 e il server MCP funzionano con la stessa chiave vk_live_… e lo stesso set di scope: 31 strumenti per un assistente ed endpoint per campagne, analytics, lead Meta e regole. Una chiave può essere emessa in sola lettura, e qualsiasi scrittura senza il suo scope risponde 403.
01Cosa non va
Perché un'integrazione pubblicitaria costa più di quanto sembri
Un wrapper fatto in casa per ogni piattaforma
Google Ads e Meta parlano lingue diverse: campi, stati e limiti propri. Lo strato scritto per un report sopravvive al report per cui era stato scritto.
L'assistente non ha dove collegarsi
Claude o ChatGPT sanno ragionare benissimo sulle campagne, ma non hanno né accesso né confini — di solito la scelta è tra una chiave per tutto o niente.
La chiave che tutti hanno dimenticato
Un token sta in una variabile d'ambiente senza scadenza, senza scope e senza traccia: nessuno sa chi lo usa né cosa succede il giorno in cui trapela.
Scorri per vederlo all'opera
API e MCP in quattro mosse
- 01Frammentato
Senza API e MCP, questo lavoro è sparso tra fogli di calcolo e schede.
- 02Connesso
API e MCP legge gli account e i dati che hai già collegato.
- 03Trovati
Mette in evidenza ciò che conta adesso, con le prove a supporto.
- 04Approvate
Decidi tu cosa succede dopo: cosa si applica da solo e cosa attende l'approvazione.
02Come funziona
Tre passi dalla chiave alla prima chiamata
- 01
Crea la chiave
Nella sezione chiavi sviluppatore, dalle un nome, seleziona gli scope necessari e, se vuoi, una scadenza in giorni. La chiave viene mostrata una sola volta; viene salvato solo un hash SHA-256.
- 02
Collega un client
Le chiamate REST vanno a /api/v1 con un header Authorization: Bearer, x-api-key o apikey. Un assistente si collega all'endpoint MCP /mcp con la stessa chiave.
- 03
Lavora dentro gli scope della chiave
Funzionano solo gli scope concessi: senza campaigns:write una scrittura restituisce 403 insufficient_scope, e una campagna creata in questo modo arriva come bozza, non live.
03Cosa ottieni
Cosa ottiene lo sviluppatore e cosa ottiene l'agente
31 strumenti MCP
Campagne, analytics, lead Meta, regole, punteggi di salute e generazione di testi, esposti a un assistente come normali strumenti dietro una sola chiave.
01REST API v1
Campagne con pausa, ripresa, performance e punteggio di salute, più analytics, lead Meta, una panoramica dell'account e regole di automazione.
02Nove scope di accesso
campaigns, analytics, rules, health, leads e ai:generate — una chiave per una dashboard può essere rigorosamente in sola lettura senza mai aprire le scritture.
03Chiavi di cui non perdi le tracce
Un prefisso nell'elenco, un contatore di richieste, l'ultimo utilizzo e una scadenza; revocarne una la disattiva in tutte le integrazioni in un colpo.
04Una specifica OpenAPI 3.0
Lo schema è servito su /api/docs/openapi.json con la documentazione interattiva accanto, così il client si genera invece di scriverlo a mano.
05Le stesse regole di sicurezza
Le campagne create tramite API o MCP arrivano come bozze, le scritture richiedono uno scope di scrittura e le modifiche live restano spente finché non le attivi per un account.
0604In numeri
- 31
- strumenti MCP disponibili dietro una chiave sviluppatore
- 9
- scope di accesso assegnabili singolarmente a una chiave
- 100
- richieste al minuto per chiave di default
Chi ottiene cosa
Cosa ottiene ogni tipo di cliente
Cosa colleghi
- Account pubblicitari
- Analitica
- Sito web
- Banca e fatture
Cosa Valkiria fa
- 01Raccoglie spesa e risultati
- 02Trova dispersioni e lacune
- 03Propone i prossimi passi
Cosa ottieni
- Piano d'azione
- Report per il titolare
- Controllo della spesa
Vedi ogni budget pubblicitario e cosa rende, senza aprire cinque dashboard
Google, Meta, TikTok e il resto in un'unica vista, nella tua valuta, con i risultati accanto ai costi.
I risultati diventano un elenco prioritario di prossimi passi, ciascuno con le sue prove.
Le nuove campagne vengono create in pausa. Le modifiche alle campagne attive restano disattivate finché non le attivi per un account; eliminazioni e nuova spesa attendono sempre l'approvazione.
Moduli che fanno il lavoro
05Domande frequenti
Domande degli sviluppatori
06Vedi anche
Tutti i moduliInizia ora
Emetti la tua prima chiave in un minuto
Una chiave si crea con gli scope e la scadenza che scegli e si revoca con un clic. Parti in sola lettura e amplia gli scope dopo averne osservato il comportamento.