La API che scrive anche i contenuti
Pubblica sui principali social, sincronizza le analitiche e ricevi eventi in tempo reale con la stessa API del nostro pannello. E quando i contenuti non li porti tu, li genera lei: testi e immagini, un'intera settimana per piano.

npm i planvortexIl client ufficiale per Node: tipizzato, con retry e verifica dei webhook. Riferimento →pip install planvortexIl client ufficiale per Python: sincrono e asincrono, tipizzato, la stessa API. Riferimento →npx -y planvortex-mcpIl server MCP ufficiale: il tuo assistente IA pubblica, legge i commenti e risponde ai messaggi. Riferimento →n8n-nodes-planvortexIl nodo verificato per n8n: pubblica, programma e risponde ai commenti da qualsiasi flusso, senza scrivere richieste. Riferimento →L'API è su tutti e quattro i piani, incluso quello gratuito: 1 app su Free, 2 su Basic, 5 su Pro e 10 su Custom, con un limite di richieste al minuto in base al piano. Nessuna revisione di app da parte tua: i tuoi utenti si collegano con le nostre app approvate di Meta, TikTok e LinkedIn.
Mandi un tema,
ti restituisce la settimana scritta
Mandi un tema (o le tue foto, un articolo o il catalogo reale di un negozio o di un account collegato) e PlanVortex restituisce la settimana divisa per social: i testi scritti, le immagini generate e ogni pubblicazione nel suo slot, come bozze che il tuo prodotto modifica con gli endpoint di pubblicazione di sempre.
import { isAiPlanChange, planvortexWebhooks, } from "planvortex/webhooks"; // 1. Accoda il piano: ricevi il preventivo, non ancora i contenuti const { ai_plan } = await pv.aiPlans.create(client, org, { prompt: "Pane a lievito madre, forno a legna, quartiere", accounts: [instagram, linkedin], template: "from_images", // le tue foto: zero crediti immagine source: { images }, }); // 2. Un job lo genera e avvisa il tuo webhook_url alla fine const onChanges = async (changes) => { for (const { id_ai_plan } of changes.filter(isAiPlanChange)) { const plan = await pv.aiPlans.get(client, org, id_ai_plan); // mostra le bozze al tuo utente } }; const receive = planvortexWebhooks({ secret, onChanges }); app.post("/webhooks/planvortex", receive); // 3. Quando il tuo utente le approva, validare le rende pronte await pv.aiPlans.validate(client, org, ai_plan._id);
Creare un piano non lo genera. Lo restituisce in pending con il suo preventivo e lo genera un job a parte, che può metterci qualche minuto. Quando finisce, il webhook_url della tua app riceve ai_plan_generated o ai_plan_failed, quindi non serve interrogarlo. Senza webhook, o se una consegna va persa (non vengono ritentate), get dice comunque com'è finito il piano. Validare è ciò che porta le bozze allo stato pronto.
Cinque punti di partenza per il piano
Il piano può nascere da un tema, dalle foto che carica il tuo utente, da un articolo incollato o dal suo URL, da un conto alla rovescia verso una data o dal catalogo reale di un negozio WooCommerce o di un account collegato. Le due che non inventano l'immagine costano il 91 % in meno: la stessa settimana sono 519 crediti con immagini generate e 48 con le foto dell'utente.
Il prezzo si sa prima di generare
Il costo lo calcola il server, mai il modello, e la creazione del piano lo restituisce nel preventivo. Se l'indispensabile non rientra nei crediti disponibili, il piano viene rifiutato per intero con l'errore 941 invece di essere generato a metà.
Oppure porta la tua chiave
Configura il tuo provider e il tuo modello per ambito (orchestratore, testo, immagine) e quell'ambito smette di consumare crediti. La chiave viaggia cifrata ed è in sola scrittura: la API restituisce il provider e il modello, mai la chiave.
I crediti IA partono dal piano Basic. Quello gratuito ne ha zero, quindi queste rotte rispondono 941 finché non vengono acquistati.
Credenziali client, senza sessione utente
Ogni app che crei ha il proprio identificativo e il proprio segreto. Richiedi un token con il flusso client credentials sul nostro endpoint (lo stesso dominio del resto dell'API) e inizi a chiamare: niente cookie, nessun utente di mezzo e nessun rinnovo OAuth rete per rete.
curl -X POST "https://api.planvortex.com/v1.0.0/oauth/token" \ -d grant_type=client_credentials \ -d client_id=$APP_CLIENT_ID \ -d client_secret=$APP_SECRET
Il token scade, e la scadenza non arriva come 401 ma come 400 con il codice 501 o 522 nel corpo. Richiedine un altro con la stessa chiamata.
Con la libreria Node questa chiamata non la scrivi: la fa lei, mette il token in cache e lo rinnova prima che scada.
Pubblicare in poche righe
Scegli l'account e la rete di destinazione, invii il testo e i file caricati in precedenza, e PlanVortex si occupa del resto. Se aggiungi una data di pubblicazione, il post viene programmato invece di uscire subito. Da Node, la libreria ufficiale porta i tipi e gestisce il token, i tentativi e il multipart.
import { PlanVortex } from "planvortex"; const pv = new PlanVortex({ clientId, clientSecret }); const upload = await pv.uploads.create(org, { file: "./pagnotta.jpg" }); const post = await pv.publications.create(org, account, { social_network: "instagram", text: "Nuovo forno, nuove pagnotte", files: [upload._id], publish_date: new Date("2026-09-01T10:00:00Z"), });
Il tuo assistente IA, collegato ai tuoi account
Il server MCP ufficiale mette l'intera API a portata di Claude Desktop, Claude Code, Cursor o VS Code: trentuno strumenti per programmare pubblicazioni, leggere la casella dei commenti, rispondere ai messaggi diretti delle reti che li hanno e chiedere alla nostra IA di scrivere la settimana. Si avvia con le tue credenziali, sulla tua macchina, e chi lo usa non scrive una riga di codice.
claude mcp add planvortex \ --env PLANVORTEX_CLIENT_ID=... \ --env PLANVORTEX_CLIENT_SECRET=... \ -- npx -y planvortex-mcp
Claude Desktop, Cursor e VS Code vogliono lo stesso blocco nel loro file dei server MCP. E se non hai Node, ogni versione pubblica un pacchetto .mcpb che si installa con un doppio clic.
Per ChatGPT e Claude non serve niente di tutto questo: lo stesso server gira ospitato, è nelle loro directory e si collega con il tuo account PlanVortex, senza Node né app.
PlanVortex nella directory di Claude →PlanVortex in ChatGPT →Guida: pubblicare dal tuo assistente IA con MCP →Trentuno strumenti
Ventidue che leggono e nove che scrivono, più tre prompt e quattro risorse con i limiti e le capacità di ogni rete. Le differenze tra le reti viaggiano come dati, così il modello non deve indovinare che cosa permette ciascuna.
E l'IA, con l'interruttore in mano tua
C'è anche il pianificatore: il tuo assistente legge i modelli con quanto costa ciascuno e ti propone la settimana. Generarla consuma crediti, quindi quello strumento (e solo quello) lo accendi tu con una riga nella configurazione; spento non compare nemmeno nell'elenco. Quello che esce sono bozze: programmarle resta a te.
Non cancella nulla
Nessuno strumento cancella una pubblicazione, un account o un commento, e non è un'impostazione che si possa attivare: il codice non esiste. Il server legge testo scritto da sconosciuti mentre il modello può pubblicare a tuo nome, quindi il caso peggiore possibile deve essere qualcosa che vedi e annulli.
Gira sulla tua macchina
Il client_secret vive nel processo che avvia il tuo client IA, mai su un nostro server. E se preferisci ospitarlo tu, la modalità --http porta il suo Dockerfile, ascolta solo in locale ed esige un token per legarsi a qualsiasi altra cosa.
Per chi è pensata
Pensata per chi sta già costruendo un proprio prodotto e vuole che i social ne facciano parte.
Agenzie
Centralizza la gestione dei clienti nel tuo pannello interno, senza che debbano accedere a PlanVortex.
Piattaforme e SaaS
Aggiungi pubblicazione e analitiche social al tuo prodotto senza costruirle da zero.
Team di prodotto
Collega PlanVortex al tuo stack interno: BI, CRM, automazioni.
Casi d'uso
Quello che puoi già automatizzare oggi con la API. Il primo non lo fa nessun'altra API di pubblicazione tra quelle che abbiamo profilato.
Generare i contenuti
Chiedi una settimana di pubblicazioni a partire da un tema, da alcune foto o da un catalogo, e ricevila in bozze che il tuo prodotto modifica prima di pubblicare.
Pubblicare e programmare
Crea, programma e pubblica contenuti sugli account collegati, via codice.
Sincronizzare le analitiche
Porta le metriche di ogni account e pubblicazione nel tuo pannello.
Commenti e messaggi
Leggi la casella dei commenti e le conversazioni degli account collegati, e rispondi dal tuo stesso prodotto.
Webhook in tempo reale
Ricevi eventi immediati quando cambiano account, messaggi o pubblicazioni, senza polling.
Connessione integrata
Lascia che i tuoi utenti colleghino i social senza uscire dal tuo prodotto, con la schermata per scegliere gli account disegnata da te o da noi, come preferisci. Si collegano con le nostre app approvate, così eviti la revisione delle app di Meta, TikTok e LinkedIn.
Come iniziare
Da zero alla tua prima chiamata autenticata.
Crea un'app
Dal tuo pannello cliente, dai un nome alla tua app e attivala. Su tutti i piani, anche quello gratuito.
Ottieni le credenziali
Un identificativo client e un segreto, che puoi ruotare quando vuoi dal pannello.
Autenticati
Richiedi il tuo token di accesso con il flusso client-credentials. Con la libreria Node non devi nemmeno farlo.
Esplora la API
Consulta la documentazione interattiva e verifica ogni endpoint disponibile.
Gli endpoint che userai il primo giorno
Partono tutti dalla stessa base e si autenticano con l'header Authorization: Bearer. Il riferimento completo, con ogni parametro e le risposte di esempio, è nella documentazione.
URL basehttps://api.planvortex.com/v1.0.0
| Metodo | Endpoint | A cosa serve |
|---|---|---|
| POST | /clients/{id_client}/apps | Creare un'app all'interno del tuo account cliente. |
| GET | /clients/{id_client}/apps/{id_app}/secret | Consultare il segreto dell'app per poterti autenticare. |
| GET | /organizations/{id_organization}/accounts | Elencare gli account collegati di un'organizzazione e il loro stato. |
| GET | /organizations/{id_organization}/connect_links | Generare i link con cui il tuo utente collega le sue reti senza uscire dal tuo prodotto. |
| POST | /organizations/{id_organization}/uploads | Caricare l'immagine o il video prima di pubblicarlo. |
| POST | /organizations/{id_organization}/accounts/{id_account}/publish | Pubblicare o programmare su un account specifico. |
| GET | /organizations/{id_organization}/publish | Consultare le pubblicazioni dell'organizzazione e in che stato si trovano. |
| GET | /organizations/{id_organization}/publish/{id_publication}/metrics | Metriche di una pubblicazione specifica. |
| GET | /organizations/{id_organization}/accounts/{id_account}/metrics | Metriche dell'account. |
| GET | /organizations/{id_organization}/limits | Consumo e limiti del piano in quel momento. |
Eventi che ti inviamo
Imposti un URL nella tua app e PlanVortex ci fa una POST quando succede qualcosa sugli account collegati. Ogni invio è firmato con il segreto dell'app, così puoi verificare che arrivi davvero da noi.
Un utente ha appena collegato un nuovo account.
Lo stato di un account è cambiato: è stato ricollegato, il token è scaduto o non è più disponibile.
È arrivato un messaggio diretto su un account collegato.
Qualcuno ha commentato un tuo post o ha lasciato una recensione sulla tua scheda Google.
Versionamento
La versione fa parte del percorso. Finché resta lì, quello che oggi ti funziona continuerà a funzionare allo stesso modo.
Firma dei webhook
Ogni POST porta gli header x-hub-signature e x-hub-signature-256, calcolati con il segreto della tua app. Verificali prima di elaborare il corpo.
Documentazione interattiva
Riferimento OpenAPI per aree (account, pubblicazioni, caricamenti, organizzazioni, ruoli e piani di IA) con ogni parametro e la sua risposta di esempio.
Fattura in euro, società spagnola
I prezzi sono in euro e la fattura è emessa da una società spagnola. Le imposte si calcolano al pagamento in base al tuo paese; se sei un'azienda dell'UE con partita IVA valida si applica l'inversione contabile. Il servizio gira su server propri nell'UE e il contratto di responsabile del trattamento si scarica senza moduli.
Vedi affidabilità e protezione dei datiTutta la API, documentata
Ogni endpoint con i suoi parametri, le risposte di esempio e la richiesta pronta da copiare in cURL, JavaScript e Python. Si consulta per intero senza creare un account.