publora/x-post

Publicación en X/Twitter

Crea y programa publicaciones en X (Twitter) usando el servidor MCP de Publora. Soporta publicaciones de texto, imágenes (hasta 4), videos y división automática en hilos para contenido extenso.

Requisitos previos

Planes: Requiere un plan de pago (los costos de la API de X se trasladan). Límites y precios actuales: publora.com/pricing.

Importante: X/Twitter NO está disponible en el plan gratuito Starter debido a los costos de la API de Twitter.

Primeros pasos

1. Crear cuenta en publora.com/register
2. Elegir plan Pro o Premium (X/Twitter requiere plan de pago)
3. Conectar X/Twitter mediante OAuth en el Panel de Publora
4. Obtener clave API en app.publora.com/dashboard/api
5. Conectar tu agente al servidor MCP en https://mcp.publora.com, autenticando con Authorization: Bearer sk_YOUR_API_KEY. En Claude Code:

claude mcp add publora --transport http https://mcp.publora.com \
  --header "Authorization: Bearer sk_YOUR_API_KEY"

Claude Desktop, Cursor, Codex, OpenClaw y el conector de claude.ai necesitan cada uno un archivo de configuración o flujo diferente: consulta configuración del cliente para la ruta exacta y el fragmento de código.

Alternativa con API REST

Si MCP no está disponible, usa la API REST directamente:

URL base: https://api.publora.com/api/v1

Autenticación: encabezado x-publora-key

# Obtener plataformas conectadas
curl -X GET "https://api.publora.com/api/v1/platform-connections" \
  -H "x-publora-key: sk_your_api_key"

# Crear una publicación
curl -X POST "https://api.publora.com/api/v1/create-post" \
  -H "x-publora-key: sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "platforms": ["twitter-123456789"],
    "content": "El contenido de tu tweet",
    "scheduledTime": "2026-03-25T10:00:00Z"
  }'

Formato del ID de plataforma: twitter-{id} (ej., twitter-123456789)

📖 Documentación: docs.publora.com

Límites de la plataforma

Característica	Límite de API	Notas
Caracteres	280	Los emojis cuentan como 2 caracteres
Imágenes	Hasta 4	Se convierten automáticamente a PNG (ancho máximo 1000 px)
Duración del video	2 min 20 s (140 s)	Publora valida videos de X en 140 s
Tamaño del video	512 MB	Formatos MP4, MOV
Hilos	Automático	Contenido que supera los 280 caracteres se divide con marcadores (1/N)

Conteo de caracteres

X tiene reglas específicas de conteo de caracteres que Publora maneja automáticamente:

• Caracteres estándar = 1
• Emojis = 2 caracteres
• URLs cuentan por su longitud literal
• Los marcadores de hilo reservan 10 caracteres por tweet

Hilos automáticos

Cuando el contenido supera los 280 caracteres, Publora crea automáticamente un hilo conectado:

1. El contenido se divide primero por saltos de párrafo, luego por límites de oraciones y finalmente por límites de palabras
2. Cada parte se numera con el formato (1/N), (2/N)
3. Los tweets se conectan mediante el parámetro reply_to_id de X

Saltos de hilo manuales

Usa --- en una línea aparte para forzar un salto de hilo:

Este es mi primer tweet del hilo.

---

Este es mi segundo tweet del hilo.

---

¡Y este es mi tercer tweet!

Herramientas disponibles

create_post

Crea una nueva publicación o hilo en X/Twitter.

Parámetros:

• platforms: Arreglo con tu ID de conexión de X (ej., ["twitter-12345678"])
• content: Texto de la publicación (se convierte automáticamente en hilo si supera los 280 caracteres)
• scheduledTime: Fecha y hora UTC en formato ISO 8601. Opcional: si se omite, la publicación se crea como borrador. Envía una hora futura para programarla. Una hora con cinco o más minutos en el pasado se rechaza con SCHEDULED_TIME_IN_PAST; para publicación inmediata usa la hora actual más un minuto.
• mediaUrls: Hasta 10 URLs públicas https de imágenes o videos. Publora las descarga del lado del servidor y las adjunta antes de la validación, por lo que los medios y la programación se realizan en una sola llamada. Esta es la alternativa de una sola llamada al flujo de borrador seguido de get_upload_url y luego complete_media. La ingesta tiene un límite de 60 URLs por hora.

get_upload_url

Obtiene una URL prefirmada para subir archivos multimedia.

Parámetros:

• postGroupId: ID de la publicación a la que se adjuntará el archivo multimedia
• fileName: Nombre del archivo (ej., "image.png", "video.mp4")
• contentType: image/png, image/jpeg, video/mp4
• type: "image" o "video"

complete_media

Finaliza un archivo subido mediante get_upload_url, después de que la subida PUT prefirmada se haya completado con éxito. Es opcional, porque la programación también finaliza los archivos multimedia pendientes, pero llamarlo antes permite detectar errores de formato y prueba antes de publicar. No es necesario para archivos multimedia adjuntos con mediaUrls.

Parámetros:

• mediaId: el ID devuelto por get_upload_url

list_connections

Lista tus cuentas conectadas con sus ID de plataforma. Llama a esto primero y copia los ID textualmente; nunca son adivinables.

list_posts / get_post / update_post / delete_post

Gestiona publicaciones programadas y borradores. update_post también modifica content y platforms en una publicación en borrador o programada, por lo que corregir un error tipográfico o reorientar el destino ya no implica eliminar y volver a crear. delete_media y prune_media_reference limpian los archivos subidos.

Ejemplos

Tweet simple

Publica esto en X:
"¡Acabamos de publicar nuestra nueva documentación de API. Échale un vistazo!"

Tweet con imágenes

Publica esto en Twitter con capturas de pantalla del nuevo panel:
"Antes y después de nuestro rediseño. ¿Qué opinas?"

Nota: Se permiten hasta 4 imágenes. Todas las imágenes se convierten automáticamente a PNG.

Hilo largo

Crea un hilo de Twitter:
"Hilo: 5 lecciones de construir nuestra startup

---

1. Lanza pronto, itera rápido. Lanzamos con un MVP con errores y mejoramos basándonos en comentarios reales.

---

2. Habla con los usuarios a diario. Nuestras mejores funciones surgieron de conversaciones con clientes.

---

3. El enfoque supera las funciones. Cancelamos 3 productos para centrarnos en el que funcionaba."

Tweet programado

Programa esto para mañana a las 9 AM:
"Motivación de lunes: Empieza antes de estar listo."

Restricciones importantes

1. Plan Pro requerido: X/Twitter está excluido del plan gratuito Starter debido a los costos de la API de Twitter.

2. Límite de video de 140 segundos: Publora valida videos de X en 2 minutos 20 segundos (140 segundos). Los videos más largos fallan la validación.

3. Conversión automática de imágenes: Todas las imágenes se convierten a PNG (ancho máximo de 1000 px) antes de subirlas. Los GIF animados pierden la animación.

4. Sin mezcla de imagen y video: Un tweet puede tener imágenes O video, no ambos.

5. Medios solo en el primer tweet: En hilos, las imágenes/video se adjuntan solo al primer tweet.

Mejores prácticas

Contenido

1. Gancho en la primera línea: La mayor parte de la interacción ocurre en el primer tweet
2. Longitud óptima del hilo: De 3 a 7 tweets para la mejor interacción
3. Conciencia de emojis: Recuerda que los emojis cuentan como 2 caracteres

Momento

• Mejores horas: 8-10 AM, 12-1 PM, 5-6 PM en la zona horaria objetivo
• Frecuencia: 3-5 tweets por día para crecimiento
• Hilos: Publica por la mañana para máxima visibilidad

Interacción

• Responde a los comentarios durante la primera hora
• Cita tus propios hilos para mayor visibilidad
• Usa hashtags relevantes (1-2 por tweet)

Solución de problemas

Error	Causa	Solución
"X/Twitter requiere plan Pro"	Usando plan Starter	Actualiza a Pro en publora.com/settings
"Contenido demasiado largo"	Más de 280 caracteres y falló la creación del hilo	Agrega saltos manuales ---
"Video demasiado largo"	Más de 140 segundos	Recorta el video a menos de 2 min 20 s
"Demasiadas imágenes"	Más de 4 imágenes	Reduce a 4 o menos
"Límite de velocidad superado"	Límite de API de X alcanzado	Espera y vuelve a intentar