Pubblica dal tuo codice. Stesso flusso, in modo programmatico.

Ogni azione della dashboard è un endpoint REST. Pubblicazione, programmazione, account, analisi, webhook. Un SDK TypeScript ufficiale. Un server MCP per Claude Desktop, Cursor e ChatGPT. Chiavi API con permessi limitati per workspace, così niente trapela.

API REST pulita con risorse prevedibili
SDK TypeScript su npm, più una libreria PHP autonoma con licenza MIT
Server MCP per Claude, Cursor, ChatGPT (14 strumenti)
Chiavi API limitate per workspace e per azione
Com'è davvero l'API

Tre righe di codice. Tre piattaforme programmate.

La vera forma di una chiamata di pubblicazione: scegli un workspace, passa una didascalia e le piattaforme, ricevi l'id del post e lo stato di consegna per ogni piattaforma. La stessa chiamata da TypeScript, PHP o curl.

POST/v1/posts
TypeScript
PHP
curl
import { FoPost } from '@fopost/sdk';

const client = new FoPost({ apiKey: process.env.FOPOST_API_KEY });

const accounts = await client.accounts.list({ workspaceId });

const post = await client.posts.create({
  workspaceId,
  status:     'scheduled',
  scheduleAt: '2026-09-01T09:00:00Z',
  content:    [{ text: 'Stop launching on Tuesday.', position: 0 }],
  accounts:   accounts.map((a) => ({ id: a.id })),
});
Risposta200 OK · 142ms
ID del postpst_01H7K3MRGB8YZ4QVW
Consegne (3)
Xprogrammato · lun 9:00 UTC
LinkedInprogrammato · lun 9:00 UTC
Blueskyprogrammato · lun 9:00 UTC
SDK TypeScript ufficiale, mantenuto da noi
Permessi per chiave: post, account, analisi
Callback webhook per ogni evento
Il costo di integrare da solo le API di 33 piattaforme

Hai scritto l'integrazione con Twitter. Poi LinkedIn ha cambiato tutto.

Hai realizzato la pubblicazione su Twitter in un weekend. Poi LinkedIn ha richiesto tre giorni, il flusso OAuth una settimana, Instagram ha l'API peggiore del mondo e non hai nemmeno iniziato con TikTok.

Ogni piattaforma si rompe in modo diverso nello stesso giorno. Cambia il limite di frequenza di Bluesky. Threads aggiunge una restrizione sui tipi di media. Hashnode cambia versione di GraphQL. La tua integrazione va a fuoco e tu stai cercando di rilasciare il prodotto.

Hai scritto a mano OAuth per 5 piattaforme. Conservi i refresh token nel tuo database. Ora sei responsabile del rinnovo dei token, dell'archiviazione crittografata e di una gestione delle chiavi da SOC 2. Non è il business in cui volevi entrare.

Fa per te?

L'API fa per te?

Fa per te se

  • Stai costruendo un prodotto che deve pubblicare sui social per conto dei tuoi utenti
  • Gestisci una pipeline di content ops che parte dalla CI, da un CRM o dal tuo backend
  • Vuoi collegare FoPost a Claude Desktop, Cursor o ChatGPT tramite MCP e lasciare che sia l'agente a pubblicare per te
  • Sviluppi strumenti per agenzie e vuoi offrire la pubblicazione social ai tuoi clienti senza gestire 33 integrazioni di piattaforme

Non fa per te se

  • Pubblichi solo a mano dalla dashboard. L'API è eccessiva, l'editor è lo strumento giusto.
  • Ti serve un hosting API completamente white-label (your-brand.api.com). Parlaci di un accordo enterprise.
Cosa include

Un'API. 32 piattaforme. I guasti li gestiamo noi.

Scrivi su un unico schema. Noi lo distribuiamo su 32 piattaforme, rinnoviamo i token, gestiamo i limiti di frequenza, consegniamo il post e segnaliamo gli errori. Tu rilasci la funzionalità.

REST pulita e prevedibile

Risorse prevedibili (post, account, workspace, consegne, webhook). Una forma di richiesta e risposta coerente su ogni endpoint, con versione /v1.

SDK TypeScript, più una libreria PHP autonoma

TypeScript (npm install @fopost/sdk) incapsula questa API REST. PHP (composer require fopost/social-core, con licenza MIT) è autonomo: pubblica direttamente su 11 piattaforme con le tue credenziali, senza account FoPost.

Server MCP per assistenti IA

npx -y @fopost/mcp collega il tuo workspace FoPost a Claude Desktop, Cursor, ChatGPT e qualsiasi agente compatibile con MCP. 14 strumenti disponibili: pubblicazione, programmazione, analisi, gestione degli account. Autenticazione tramite chiave API.

Chiavi limitate per workspace

Chiavi per workspace con permessi per azione: posts, accounts, workspaces, labels, publish, deliveries, webhooks, analytics, automations. JWT per l'interfaccia, chiavi API per il codice. Nessuna super-chiave valida per tutta l'agenzia.

Webhook in uscita per ogni evento

Iscriviti a publish.success, publish.failed, account.disconnected, account.reconnected, automation.triggered e altri. Ogni payload è firmato, così puoi verificare che arrivi da noi, e le consegne non riuscite vengono ritentate con backoff esponenziale.

Limiti di frequenza pensati per il lavoro vero

Il limite è ben al di sopra di quanto serve a un'integrazione di pubblicazione, e la soglia sale automaticamente man mano che colleghi altri account. Se lo superi ricevi un 429 pulito con un Retry-After su cui regolarti, non una richiesta scartata in silenzio o una chiave sospesa.

Come funziona

Genera. Installa. Pubblica.

01

Genera una chiave API

Nel workspace da cui vuoi pubblicare, crea una chiave API con gli scope che ti servono (posts e accounts bastano per iniziare). Copiala una volta sola. Trattala come un segreto.

02

Installa l'SDK

npm install @fopost/sdk. Oppure salta l'SDK e chiama direttamente gli endpoint REST. Oppure salta entrambi e usa il server MCP da Claude.

03

Fai la chiamata

Tre righe: import, istanza, creazione. La chiamata di pubblicazione restituisce un id del post e lo stato di consegna per piattaforma. Il post arriva nella coda della tua dashboard e viene pubblicato all'orario programmato.

04

Iscriviti ai webhook (facoltativo)

Aggiungi un URL webhook nelle impostazioni del workspace. Iscriviti a publish.success e publish.failed. Il tuo endpoint riceve una POST firmata quando ogni consegna va a buon fine o fallisce. Così il tuo sistema resta sincronizzato.

rispetto alle alternative

Perché è meglio che costruire a mano 33 integrazioni di piattaforme.

Tre modi in cui gli sviluppatori affrontano oggi la pubblicazione multipiattaforma. Solo uno è una vera API con SDK, un server MCP e qualcun altro che si occupa di quando qualcosa si rompe.

Fai da te: 33 API di piattaforme

Quello che tentano i founder tecnici

  • Flusso OAuth per ogni piattaforma. Archiviazione dei token. Rinnovo dei token. Gestione cifrata dei segreti.
  • Limiti di frequenza diversi, formati di errore diversi, vincoli sui media diversi per ogni piattaforma.
  • Quando LinkedIn cambia la sua API, cambi il tuo codice. Lo stesso per Bluesky, Threads, Hashnode.
  • Smetti di aggiungere piattaforme dopo Twitter e LinkedIn. Le altre 29 restano nella lista dei desideri.

API di Buffer o Hootsuite

Quello che offrono gli operatori storici

  • L'API pubblica esiste ma sembra un ripensamento. Gli SDK sono mantenuti dalla community, a volte.
  • Nessun server MCP. Collegarla a Claude o Cursor richiede un'integrazione su misura.
  • Il prezzo per postazione rende l'API un centro di costo per le agenzie.
FoPost

API + SDK + MCP di FoPost

Quello che vuoi davvero

  • Un unico schema REST copre 32 piattaforme, e l'estensione del browser copre Substack, che non ha un'API di scrittura.
  • SDK TypeScript mantenuto da noi, più una libreria PHP con licenza MIT.
  • Il server MCP è disponibile oggi: npx -y @fopost/mcp in Claude Desktop, Cursor, ChatGPT.
  • Chiavi con scope per workspace, webhook firmati, nuovi tentativi integrati. Quando qualcosa si rompe, ce ne occupiamo noi.

Pubblica su tutti i principali social network

Domande frequenti

L'API è inclusa?

Sì: ogni account ha accesso completo in lettura e scrittura. Endpoint, scope e SDK sono identici per tutti. La soglia di richieste sale automaticamente man mano che colleghi altri account.

Dov'è il riferimento dell'API?

fopost.com/docs/api contiene il riferimento completo con esempi di codice in TypeScript, PHP e curl per ogni endpoint.

Gli SDK sono a pagamento?

No. TypeScript (@fopost/sdk) è gratuito su npm e comunica con questa API, inclusa in ogni account. La libreria PHP (composer require fopost/social-core, con licenza MIT) è gratuita e autonoma: pubblica direttamente su 11 piattaforme usando le tue credenziali e non richiede alcun account FoPost. Alimenta anche il nostro pacchetto Laravel.

E MCP per Claude, Cursor e ChatGPT?

Disponibile oggi come @fopost/mcp su npm. npx -y @fopost/mcp ti dà un server MCP stdio: puntalo verso qualsiasi client compatibile con MCP (Claude Desktop, Cursor, ChatGPT desktop, Goose, Continue), autenticati con FOPOST_API_KEY e ottieni 14 strumenti: pubblicare, programmare, elencare i post, ottenere le analisi, gestire gli account e altro.

Come funzionano gli scope delle chiavi API?

Ogni chiave è legata a un workspace, con un elenco di scope di azione che scegli alla creazione: posts, workspaces, accounts, labels, publish, deliveries, webhooks, analytics, automations. Una chiave senza lo scope "accounts" non può elencare né modificare gli account, anche se l'utente ha autorizzato quelle azioni. Gli scope vengono verificati lato server a ogni chiamata.

Per quali limiti di frequenza dovrei pianificare?

Il normale traffico di pubblicazione non si avvicinerà al limite su nessun piano. La soglia dipende dal piano associato alla tua chiave, e Business usa quella più alta, perché è il livello che automatizza di più tramite l'API. Gestisci un 429 come faresti con qualsiasi API: ogni risposta include X-RateLimit-Limit, X-RateLimit-Remaining e X-RateLimit-Reset, un 429 aggiunge Retry-After, quindi attendi e riprova e non dovrai più pensarci. Non pubblichiamo la soglia esatta, perché è un controllo anti-abuso che cambia, non una promessa.

Firmate i payload dei webhook?

Sì. Ogni POST dei webhook include un header di firma derivato dal corpo e dal segreto del tuo webhook, così puoi verificare che il payload provenga da noi prima di fidarti. La documentazione spiega come controllarlo. Le consegne non riuscite vengono ritentate più volte con backoff esponenziale prima di arrenderci.