Desarrolladores

Para agentes de IA

VIBEPOST está hecho para que los asistentes de IA lo encuentren y lo usen sin leer esta página. Dirige cualquier agente a uno de estos:

/llms.txtResumen de una página para LLMs: qué hace VIBEPOST, endpoints, herramientas, reglastext

/llms-full.txtDocumentación completa en un único archivo Markdowntext

/api/v1/openapi.jsonEspecificación OpenAPI 3.1 de todos los endpoints RESTjson

/mcpServidor MCP remoto (Streamable HTTP, inicio de sesión OAuth)mcp

npx vibepostCLI con salida --json y códigos de salida establescli

Todas las páginas de este sitio están también disponibles en Markdown añadiendo .md a su URL. VIBEPOST figura en el MCP Registry oficial y como conector de 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

Código de salida	Significado
0	Hecho
1	Error general
2	Requiere confirmación (vuelve a ejecutar con `--yes` o confirma en la app para TikTok)
3	Bloqueado por una regla del espacio de trabajo
4	Rechazado por la plataforma

En CI, define VIBEPOST_API_KEY. Sin --yes, la CLI muestra una vista previa y pregunta antes de publicar nada.

Servidor MCP

Añade VIBEPOST a cualquier cliente compatible con MCP. Crea una clave en Ajustes → Claves de API y luego añade:

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

Después, pídeselo a tu asistente: “Publica este anuncio en X y LinkedIn mañana a las 9.”

Herramientas

list_channelsCanales conectados y sus límiteslectura

generate_variantsEscribe una versión por plataforma e idiomalectura

create_draftGuarda una publicación como borradorescritura

schedule_postPrograma o publica. Respeta tus reglas de autonomíarespeta reglas

update_postCambia el texto o la hora de una publicación programadaescritura

get_calendarPublicaciones en un rango de fechaslectura

get_analyticsResultados por publicación, canal o periodolectura

Las publicaciones creadas mediante MCP llegan al mismo calendario y cola de aprobación que todo lo demás. Las publicaciones de TikTok siempre esperan la confirmación del titular de la cuenta.

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 respuesta contiene una publicación por canal e idioma, cada una con un estado: scheduled, needs_approval o failed.

Autenticación

Usa una clave secreta en la cabecera Authorization. Las claves pertenecen a un único espacio de trabajo, pueden ser de solo lectura y se muestran completas una sola vez. Rótalas cuando quieras.

Límites y seguridad

Las reglas de tu espacio de trabajo (límites diarios, horas de silencio, palabras prohibidas) se aplican a cada llamada de API y MCP.
Eliminar publicaciones mediante la API está desactivado por defecto.
Los límites de uso de cada plataforma se respetan automáticamente; las solicitudes se ponen en cola, no se descartan.

Webhooks

Recibe avisos cuando una publicación se publica, falla o necesita aprobación: post.published, post.failed, post.needs_approval.

Infraestructura de publicación para tus agentes de IA