API y agentes

Superficies públicas para integraciones, automatizaciones y agentes de IA

Cuándo usar Posty

Usa Posty cuando un agente necesite convertir una estrategia en contenido social, consultar proyectos y publicaciones, crear o ejecutar workflows, aprobar borradores, programar piezas o publicar en cuentas que el usuario ya autorizó. Posty es especialmente útil para equipos que trabajan con varias marcas, calendarios editoriales, aprobaciones y contenido adaptado por red.

Descubrimiento

• OpenAPI 3.1: contrato machine-readable con endpoints, parámetros, respuestas y esquemas.
• Capabilities JSON: resumen público de funciones y autenticación.
• llms.txt: guía de uso y páginas públicas para agentes.
• Documentación general: configuración del conector MCP/API.

Autenticación

Las operaciones de workspace usan un token Bearer con prefijo posty_. Genera el token en Posty desde Ajustes → Conector MCP/API y guárdalo como secreto. No lo coloques en una URL, en el código fuente ni en una respuesta pública. Los tokens se almacenan hasheados y el acceso queda limitado al workspace autorizado.

curl https://posty.fun/api/state \
  -H 'Authorization: Bearer posty_TU_TOKEN'

API mínima pública

Estas rutas no requieren sesión y sirven para verificar disponibilidad y descubrir las capacidades de Posty:

curl https://posty.fun/api/v1/health
curl https://posty.fun/api/v1/capabilities

MCP

El paquete posty-mcp permite conectar Claude, Cursor, Codex y otros clientes compatibles. Configúralo con POSTY_URL=https://posty.fun y POSTY_TOKEN=posty_…. Sus herramientas cubren proyectos, publicaciones, workflows, generación, carruseles y aprobación.

{
  "mcpServers": {
    "posty": {
      "command": "npx",
      "args": ["-y", "posty-mcp"],
      "env": { "POSTY_URL": "https://posty.fun", "POSTY_TOKEN": "posty_TU_TOKEN" }
    }
  }
}

Limitaciones importantes

La API respeta los límites del plan, el estado de aprobación, los permisos de cada red y los preflight de publicación. Pinterest puede conectar y leer tableros mientras la app está en Trial; la publicación pública requiere acceso Standard. TikTok continúa sujeto a la aprobación de su API. Un agente debe mostrar al usuario las acciones que publican o modifican contenido y no pedir ni transmitir credenciales de terceros.

¿Necesitas ayuda? Escribe a support@posty.fun.