API Tutorial
Come pubblicare su X tramite API
Per pubblicare su X tramite API, collega l'account X 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 X e restituisce l'ID del post.
L'API di X 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 X (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 X
Nella dashboard clicca su Collega e scegli X. 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 X. La connessione riceve un `connectionId` stabile a cui fai riferimento in ogni chiamata.
Chiama posts_create per pubblicare su X
Chiama lo strumento `posts_create` con l'ID della connessione e il tuo contenuto. Modiva verifica il payload rispetto alle regole di formato di X (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 X 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 X
Inizia gratisFAQ
Ho bisogno di un'app per sviluppatori X per pubblicare tramite API?
No. Modiva possiede l'app X 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 X 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 X non appena aggiungi la tua chiave MCP di Modiva.