Sviluppatori

Per agenti AI

VIBEPOST è pensato per essere trovato e usato dagli assistenti AI senza leggere questa pagina. Indirizza qualsiasi agente a una di queste risorse:

/llms.txtRiepilogo di una pagina per LLM: cosa fa VIBEPOST, endpoint, strumenti, regoletext

/llms-full.txtDocumentazione completa in un unico file Markdowntext

/api/v1/openapi.jsonSpecifica OpenAPI 3.1 per ogni endpoint RESTjson

/mcpServer MCP remoto (Streamable HTTP, accesso OAuth)mcp

npx vibepostCLI con output --json e codici di uscita stabilicli

Ogni pagina di questo sito è disponibile anche in Markdown aggiungendo .md al suo URL. VIBEPOST è presente nel MCP Registry ufficiale e come connettore di Claude.

CLI

# install (or use npx)
npm i -g vibepost        # or: brew install vibepost
vibepost login            # opens the browser, stores the key in your keychain

# one post, AI writes each version and picks the time
vibepost post "We just launched exam-based teacher search" \
  --to x,linkedin,threads --lang en,ja --at auto

# a video; TikTok always waits for you to confirm in the app
vibepost post --file lesson.mp4 --to tiktok --caption auto

# a week of posts from an article
vibepost plan --from https://blog.anytutor.ai/learn-anything --week next

vibepost ls --status scheduled --json | jq '.[].id'
vibepost retry post_8f2c
vibepost mcp              # local stdio MCP server for clients without remote MCP

Codice di uscita	Significato
0	Completato
1	Errore generico
2	Conferma richiesta (riesegui con `--yes` oppure conferma nell’app per TikTok)
3	Bloccato da una regola del workspace
4	Rifiutato dalla piattaforma

In CI, imposta VIBEPOST_API_KEY. Senza --yes, la CLI mostra un’anteprima e chiede conferma prima di pubblicare qualsiasi cosa.

Server MCP

Aggiungi VIBEPOST a qualsiasi client compatibile con MCP. Crea una chiave in Impostazioni → Chiavi API, poi aggiungi:

{
  "mcpServers": {
    "vibepost": {
      "url": "https://vibepost.cc/mcp",
      "headers": { "Authorization": "Bearer ap_live_…" }
    }
  }
}

Poi chiedi semplicemente al tuo assistente: “Pubblica questo annuncio su X e LinkedIn domani alle 9.”

Strumenti

list_channelsCanali collegati e relativi limitilettura

generate_variantsScrive una versione per piattaforma e lingualettura

create_draftSalva un post come bozzascrittura

schedule_postProgramma o pubblica. Rispetta le tue regole di autonomiarispetta le regole

update_postModifica testo o orario di un post programmatoscrittura

get_calendarPost in un intervallo di datelettura

get_analyticsRisultati per post, canale o periodolettura

I post creati tramite MCP finiscono nello stesso calendario e nella stessa coda di approvazione di tutto il resto. I post TikTok attendono sempre la conferma del titolare dell’account.

REST API

# Let VIBEPOST write the versions and pick the time
curl https://vibepost.cc/api/v1/posts \
  -H "Authorization: Bearer ap_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "channels": ["x_anytutor", "linkedin_anytutor"],
    "text": "We just launched exam-based teacher search.",
    "variants": "auto",
    "languages": ["en", "ja"],
    "schedule_at": "auto"
  }'

La risposta contiene un post per canale e lingua, ciascuno con uno stato: scheduled, needs_approval o failed.

Autenticazione

Usa una chiave segreta nell’header Authorization. Le chiavi sono limitate a un solo workspace, possono essere di sola lettura e vengono mostrate per intero una sola volta. Ruotale quando vuoi.

Limiti e sicurezza

Le regole del tuo workspace (limiti giornalieri, fasce di silenzio, parole vietate) si applicano a ogni chiamata API e MCP.
L’eliminazione dei post tramite API è disattivata per impostazione predefinita.
I limiti di frequenza di ogni piattaforma vengono rispettati automaticamente; le richieste vengono messe in coda, non scartate.

Webhook

Ricevi una notifica quando un post viene pubblicato, non va a buon fine o richiede approvazione: post.published, post.failed, post.needs_approval.

Infrastruttura di pubblicazione per i tuoi agenti AI