API Tutorial

Come ottenere le analitiche di Bluesky tramite API

Per ottenere le analitiche di Bluesky tramite API, collega Bluesky con Modiva e poi chiama `analytics_unified` — restituisce reach, impression, engagement e metriche sui follower in una forma normalizzata che puoi visualizzare o analizzare.

Ogni piattaforma riporta le metriche in modo diverso, quindi il reporting cross-piattaforma di solito richiede un livello di mapping per ogni rete. Lo strumento `analytics_unified` di Modiva restituisce le metriche di Bluesky nello stesso schema di ogni altra piattaforma, così una singola query alimenta un'intera dashboard.

Passo dopo passo

Crea un account Modiva e una chiave MCP

Registrati gratuitamente e genera una chiave MCP (`mk_live_…`) dalla dashboard. La stessa chiave autentica sia il server MCP ospitato (per gli agenti IA) sia la REST API (per il tuo backend), così gestisci un'unica credenziale.

Collega il tuo account Bluesky

Nella dashboard clicca su Collega e scegli Bluesky. Modiva esegue il flusso OAuth e richiede per te gli scope corretti, poi salva i token di accesso e di refresh in un vault cifrato e li mantiene aggiornati — non maneggi mai le credenziali API grezze di Bluesky. La connessione riceve un `connectionId` stabile a cui fai riferimento in ogni chiamata.

Chiama analytics_unified per le metriche di Bluesky

Chiama `analytics_unified` con l'ID della connessione, le metriche che desideri e un intervallo di tempo. Modiva le recupera da Bluesky, normalizza i nomi dei campi e restituisce una forma JSON coerente, pronta da visualizzare.

Unisci ogni piattaforma in un unico report

Passa più ID di connessione per combinare Bluesky con il resto del tuo stack in un'unica risposta. Tramite MCP un agente può recuperare i numeri e scrivere il report settimanale per te, poi chiamare `analytics_best_time_to_post` per pianificare il prossimo.

Richiesta di esempio

Chiama lo strumento analytics_unified tramite l'API REST di Modiva. Lo stesso strumento è disponibile per gli agenti IA sul server MCP all'indirizzo https://mcp.modiva.ai/v1.

POST /v1/tools/invoke

curl -X POST https://api.modiva.ai/v1/tools/invoke \
  -H "Authorization: Bearer mk_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "tool": "analytics_unified",
    "connectionId": "conn_…",
    "args": { "metrics": ["reach", "engagement"], "period": "last_30_days" }
  }'

Provalo con Bluesky

Inizia gratis

FAQ

Le metriche di Bluesky sono confrontabili con quelle delle altre piattaforme?

Sì — Modiva normalizza le analitiche di Bluesky in uno schema comune, così reach ed engagement combaciano su ogni rete collegata.

Un agente IA può generare il report?

Sì. Esponi `analytics_unified` tramite MCP e un agente può recuperare i numeri di Bluesky e comporre la sintesi in autonomia.

Continua a costruire con Bluesky

Integrazione API Bluesky Server MCP Bluesky Come pubblicare su Bluesky tramite API Come pianificare i post su Bluesky tramite API Come leggere e rispondere ai commenti su Bluesky tramite API Come ottenere le analitiche di Instagram tramite API Come ottenere le analitiche di TikTok tramite API