Cosa posso esportare, e da dove?
| Dati | Dove | Formato |
|---|---|---|
| Risposte campionate | “Visibilità nell’IA”, il pulsante di esportazione delle N risposte campionate nell’intestazione del report | CSV |
| Citazioni | “Visibilità nell’IA”, scheda “Citazioni”, il pulsante di esportazione delle N citazioni nell’intestazione | CSV |
| Prompts monitorati e relativi risultati | Scheda “Prompts”, menu di esportazione | CSV o JSON, download o copia |
| Ricerche dei motori | Scheda “Prompts”, “Ricerche dei motori”, menu di esportazione | CSV o JSON |
| Le tue pagine | “Siti web”, l’elenco delle pagine | CSV |
| Visite dei crawler di IA | “AI Traffic Analytics” | CSV |
Come esporto tutte le risposte di un periodo?
- Apri “Visibilità nell’IA” per il brand.
- Scegli l’intervallo di date nella barra degli strumenti.
- Fai clic sul pulsante di esportazione delle N risposte campionate, dove N è il numero di risposte dell’intervallo.
- Il CSV si scarica con una riga per risposta, nelle colonne definite dal server, così una nuova colonna non va mai persa.
Un file contiene fino a 20.000 righe. Se un intervallo ne ha di più, l’app avvisa che ha esportato le prime 20.000, così un file non contiene mai in silenzio meno di quanto prometteva il pulsante. Una cella vuota significa nessuna osservazione, mai zero.
Posso esportare i dati delle citazioni per i report?
Sì. La scheda “Citazioni” esporta in CSV ogni pagina citata dell’intervallo, pronta per un foglio di calcolo o uno strumento di BI, e nei piani a pagamento il nostro team può configurare un flusso verso Looker Studio o lo strumento di BI che già usi. Per una pagina che un cliente o il tuo capo possono aprire senza account, usa “Condividi report”, descritto in Integrazioni e report.
Esiste un’API REST?
Sì. La Reports API su app.proofsource.co/v2 restituisce i tuoi dati in JSON: /v2/reports/visibility, /v2/reports/citations, /v2/reports/sentiment e /v2/reports/fanouts, autenticata con una chiave API da “Impostazioni”. La sua specifica OpenAPI è pubblicata su app.proofsource.co/v2/openapi.json, così puoi generare un client in qualsiasi linguaggio.
Il mio agente di IA può leggere i miei dati?
Sì, tramite il Model Context Protocol (MCP). Un agente di IA come Claude Code, Claude Desktop, Cursor o uno costruito sull’API di OpenAI legge gli stessi numeri che vedi nell’app, dal server su app.proofsource.co/v1/mcp.
- Nell’app, apri “Impostazioni”, poi “Chiavi API”, e crea una chiave. Copiala subito: viene mostrata una sola volta.
- Scegli la lettura per un agente che deve solo consultare. Scegli la scrittura solo se deve anche aggiungere domande o segnare correzioni come pubblicate. Una chiave agisce con il tuo ruolo nello spazio di lavoro.
- Apri “Impostazioni”, poi “Agenti IA”, copia l’URL del server e lo snippet di configurazione per il tuo client, e incolla la tua chiave dove indicato.
| Strumento | Cosa restituisce o fa |
|---|---|
| list_brands | I tuoi brand monitorati e i loro id. |
| list_topics | Gli argomenti e le domande d’acquisto monitorate in ciascuno. |
| get_visibility | Quanto spesso le risposte dell’IA ti menzionano, per motore o per domanda. |
| get_competitors | La share of voice rispetto ai concorrenti menzionati nelle risposte dell’IA. |
| get_citations | Le fonti citate nelle risposte dell’IA e in quale posizione si trovano i tuoi domini. |
| get_changes | Cosa si è mosso: andamento della visibilità, ricambio delle risposte, modifiche ai siti dei concorrenti, nuove fonti. |
| list_fix_opportunities | Cosa impedisce ai motori di citarti, e la correzione. |
| get_fix_verification | Il prima e il dopo di ogni correzione pubblicata, e se ha funzionato. |
| create_prompt | Monitora una nuova domanda d’acquisto. Richiede una chiave di scrittura. |
| mark_fix_shipped | Data una correzione così che possa essere verificata. Richiede una chiave di scrittura. |
Ogni chiave può fare 60 chiamate agli strumenti al minuto e 30 scritture all’ora. ChatGPT, Claude, Grok e Cursor si collegano senza chiave: accedi invece a Proofsource, come descritto in Usa Proofsource in ChatGPT, Claude, Grok e Cursor.
