API Tutorial
Come pubblicare su Bluesky tramite API
Per pubblicare su Bluesky tramite API, collega l'account Bluesky con Modiva (che gestisce OAuth e scope) e poi chiama lo strumento `posts_create` con il tuo testo e i tuoi media — Modiva lo pubblica su Bluesky e restituisce l'ID del post.
L'API di Bluesky richiede la revisione dell'app, la gestione di OAuth e i permessi di pubblicazione corretti prima ancora di poter pubblicare un solo aggiornamento. Modiva si occupa di tutto questo per te e mette a disposizione un unico strumento `posts_create` che pubblica su Bluesky (e su ogni altra piattaforma collegata) nello stesso modo.
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 posts_create per pubblicare su Bluesky
Chiama lo strumento `posts_create` con l'ID della connessione e il tuo contenuto. Modiva verifica il payload rispetto alle regole di formato di Bluesky (lunghezza, tipi di media, proporzioni) e pubblica immediatamente, restituendo l'ID e l'URL del post live.
Fai di più — pianifica, cross-posta, automatizza
La stessa chiamata alimenta un agente IA tramite MCP: indirizza Claude o Cursor su `https://mcp.modiva.ai/v1` e potrà pubblicare su Bluesky per tuo conto. Sostituisci `posts_create` con `posts_schedule` per metterlo in coda, oppure `posts_cross_post` per diffondere un post su ogni piattaforma in una volta sola.
Richiesta di esempio
Chiama lo strumento posts_create tramite l'API REST di Modiva. Lo stesso strumento è disponibile per gli agenti IA sul server MCP all'indirizzo https://mcp.modiva.ai/v1.
curl -X POST https://api.modiva.ai/v1/tools/invoke \
-H "Authorization: Bearer mk_live_…" \
-H "Content-Type: application/json" \
-d '{
"tool": "posts_create",
"connectionId": "conn_…",
"args": { "text": "Shipped via Modiva 🚀" }
}'Provalo con Bluesky
Inizia gratisFAQ
Ho bisogno di un'app per sviluppatori Bluesky per pubblicare tramite API?
No. Modiva possiede l'app Bluesky già approvata e gestisce OAuth, così ti colleghi con un clic e parti subito — nessuna revisione dell'app, nessuna complicazione con gli scope.
Un agente IA può pubblicare su Bluesky per me?
Sì. Lo stesso strumento `posts_create` è esposto tramite il Model Context Protocol, così qualsiasi client MCP (Claude, Cursor e simili) può pubblicare su Bluesky non appena aggiungi la tua chiave MCP di Modiva.