Prodotto · API e MCP
API di visibilità AI: i tuoi dati, nel tuo stack
Howseen monitora come ChatGPT, Gemini, Perplexity e le risposte AI di Google parlano del tuo brand. L'API REST e il server MCP portano questi dati nei tuoi script, nelle dashboard dei tuoi clienti e nel tuo assistente AI.
Di Raphaël Aubry, fondatore di Howseen AI · Aggiornato il 
Definizione
Cos'è un'API di visibilità AI?
Un'API di visibilità AI restituisce, come dati, il modo in cui i motori AI rispondono alle domande dei tuoi acquirenti: quali brand nominano, in quale posizione, con quali fonti, motore per motore e nel tempo.
Le dashboard vanno bene da consultare. I report per i clienti, gli alert settimanali e la BI interna hanno bisogno dei numeri veri e propri. Howseen li espone in due modi: un'API REST di sola lettura che restituisce JSON, e un server MCP remoto che permette a un assistente AI di leggere gli stessi dati e agire di conseguenza.
Perché è importante
Perché esportare i dati di visibilità AI?
Perché ormai gli acquirenti si fermano alla risposta dell'AI, e i numeri che mostrano se l'AI ti nomina devono stare negli stessi report di traffico e fatturato.
In un'analisi del Pew Research Center sulle ricerche Google, le persone hanno cliccato su un risultato tradizionale nell'8% delle visite quando compariva un riepilogo AI, contro il 15% quando non compariva. Gartner ha previsto che il volume dei motori di ricerca calerà del 25% entro il 2026 a causa dei chatbot AI e degli assistenti virtuali. Google stessa documenta che AI Overviews e AI Mode costruiscono le risposte a partire da molte ricerche correlate (Google Search Central, AI features and your website).
“Dietro le quinte, AI Mode usa la nostra tecnica di query fan-out, scomponendo la tua domanda in sottotemi e inviando per tuo conto numerose query simultaneamente.”
Un'API trasforma questo cambiamento in un numero che il tuo team già monitora: in un report settimanale, in una dashboard BI o in un alert quando un competitor ti supera.
API REST
Cosa restituisce l'API REST
L'API REST è JSON di sola lettura, con filtri per intervallo di date e motore e paginazione, autenticata con una chiave personale.
- Brand: i siti monitorati nell'account.
- Visibilità: % di risposte AI che nominano il brand, share of voice, posizione, per motore e nel tempo.
- Prompt: le domande degli acquirenti monitorate, con i risultati per ogni domanda.
- Competitor: chi l'AI nomina accanto a te, o al posto tuo.
- Fonti: i domini e le pagine che l'AI cita sulle tue domande.
- Risposte: le risposte AI reali, con i brand nominati e gli URL citati.
- Azioni e articoli: il piano d'azione e gli articoli scritti da Howseen per il brand.
curl -H "Authorization: Bearer hs_live_YOUR_KEY" \ "https://app.howseen.ai/api/v1/brands/BRAND_ID/visibility?from=2026-09-01&engine=chatgpt"
Server MCP
Il server MCP: chiedi al tuo assistente AI, poi agisci
Il server MCP su https://app.howseen.ai/api/mcp permette a Claude, ChatGPT, Cursor o Codex di leggere la tua visibilità AI e, con una chiave che lo consente, di agire su di essa.
Chiedi “su quali domande ChatGPT nomina un competitor e non noi?”, “su quali siti dovremmo farci citare per primi?” o “cosa è cambiato dall'ultima scansione?” in linguaggio naturale. Gli strumenti di lettura funzionano con qualsiasi chiave. Gli strumenti di azione (aggiungere prompt, scrivere la bozza di un articolo, pubblicarlo sul tuo sito, richiedere l'indicizzazione, creare un report condiviso) richiedono una chiave con le azioni abilitate, e ogni azione mostra un'anteprima prima di essere applicata.
La configurazione richiede 2 minuti: crea una chiave in Impostazioni, API e assistenti AI, poi incolla il comando pronto per la tua app. Comandi e lista completa degli strumenti: la pagina MCP e il repository pubblico howseen-mcp su GitHub.
La tua visibilità AI, dove già lavori
La prova gratuita di 3 giorni include l'API e il server MCP. Annulla con 1 click.
Piani
Quali piani includono l'API e il server MCP?
L'API REST e il server MCP sono inclusi nei piani Pro e Business, e nella prova gratuita di 3 giorni.
| Starter | Pro | Business | |
|---|---|---|---|
| Prezzo | 39€/mese | 79€/mese | da 219€/mese |
| Domande d'acquisto | 20 | 50 | da 100 a 300, condivise tra 3 brand |
| Motori AI | 3: ChatGPT, Gemini, AI Overviews | 5: + Perplexity, AI Mode | 5 + Claude |
| Esecuzioni | ogni 3 giorni | ogni 3 giorni | ogni giorno (Claude ogni 3 giorni) |
| Concorrenti per brand | 3 | 5 | 5 |
| Articoli ogni 30 giorni | 4 | 15 per brand | 30 per l'account |
Agenzie che gestiscono più clienti: Business ripartisce da 100 a 300 domande su 3 brand e aggiunge i report white-label. Prezzi sulla pagina prezzi.
Domande, risposte
C'è un'API per il monitoraggio della visibilità AI?+
Sì. Howseen ha un'API REST JSON di sola lettura (URL di base https://app.howseen.ai/api/v1) per visibilità, prompt, competitor, fonti, risposte, azioni e articoli, oltre a un server MCP remoto per gli assistenti AI.
Come mi autentico?+
Con una chiave personale creata in Impostazioni, API e assistenti AI, inviata come Authorization: Bearer <key>. Le app che non possono inviare header possono passarla nell'URL MCP come ?key=, che va poi mantenuta privata come una password.
Quali assistenti AI funzionano con il server MCP?+
Qualsiasi client che supporti server MCP remoti via Streamable HTTP, inclusi Claude Code, Claude.ai, ChatGPT, Cursor e Codex.
Il server MCP può modificare cose nel mio account?+
Solo con una chiave che ha le azioni abilitate. Ogni azione (aggiungere prompt, scrivere la bozza o pubblicare un articolo, richiedere l'indicizzazione, creare un report) mostra prima un'anteprima e si applica solo dopo la conferma.
Di quale piano ho bisogno?+
Pro o Business. La prova gratuita di 3 giorni include l'API e il server MCP.
Porta la tua visibilità AI nel tuo stack
Avvia una prova gratuita di 3 giorni, crea una chiave, e interroga i tuoi dati in 2 minuti.
