publora/tiktok-post

Publicación en TikTok

Sube y programa videos en TikTok usando el servidor MCP de Publora. Soporta controles de privacidad, ajustes de interacción (comentarios, duet, stitch) y divulgación de contenido comercial.

Prerrequisitos

Planes: Funciona con el plan gratuito Starter. Límites y precios actuales: publora.com/pricing.

Primeros pasos

1. Crear cuenta en publora.com/register (gratis)
2. Conectar TikTok mediante OAuth en Panel de Publora
3. Obtener clave API en app.publora.com/dashboard/api
4. Conectar tu agente al servidor MCP en https://mcp.publora.com, autenticando con Authorization: Bearer sk_TU_CLAVE_API. En Claude Code:

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

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

Alternativa con API REST

Si el servidor MCP no está disponible o devuelve errores, usa la API REST directamente:

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

Autenticación: Usa el encabezado x-publora-key (NO Authorization: Bearer):

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

# Crear una publicación
curl -X POST "https://api.publora.com/api/v1/create-post" \
  -H "x-publora-key: sk_tu_clave_api" \
  -H "Content-Type: application/json" \
  -d '{
    "platforms": ["tiktok-99887766"],
    "content": "Pie de video aquí #hashtag",
    "scheduledTime": "2026-03-25T10:00:00Z",
    "platformSettings": {
      "tiktok": {
        "viewerSetting": "PUBLIC_TO_EVERYONE",
        "allowComments": true
      }
    }
  }'

Formato del ID de plataforma: tiktok-{id} donde {id} proviene de la respuesta de /platform-connections.

Ejemplos de IDs: tiktok-99887766, tiktok-123456789

📖 Documentación completa de la API: docs.publora.com

Límites de la plataforma (API vs App nativa)

Límites críticos de la API que difieren de la app nativa de TikTok:

Requisitos de video

Especificación	Límite API	App nativa
Duración máxima	10 minutos	60 minutos
Duración mínima	3 segundos	3 segundos
Tamaño máximo de archivo	4 GB	4 GB
Fotogramas mínimos	23 FPS	23 FPS
Formatos	MP4, MOV, WebM	MP4, MOV, WebM

Límites de pie de foto

Elemento	Límite API	App nativa
Longitud del pie	2.200 caracteres	4.000 caracteres
Hashtags	Incluidos en el conteo del pie	Incluidos en el conteo del pie

Límites de tasa

Límite	Valor
Publicaciones por día	15-20
Videos por minuto	Máximo 2

Herramientas disponibles

create_post

Crea una nueva publicación en TikTok.

Parámetros:

• platforms: Arreglo con tu ID de conexión de TikTok (ej. ["tiktok-99887766"])
• content: Pie de video (hasta 2.200 caracteres)
• scheduledTime: Fecha y hora UTC en formato ISO 8601. Opcional: omítelo y la publicación se crea como borrador. Envía una hora futura para programar. Una hora con cinco o más minutos en el pasado se rechaza con SCHEDULED_TIME_IN_PAST, así que 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 archivos multimedia y la programación ocurren en una sola llamada. Esta es la alternativa de un solo paso al flujo de borrador luego get_upload_url luego complete_media. La ingesta está limitada a 60 URLs por hora.

get_upload_url

Obtiene una URL prefirmada para subir video.

Parámetros:

• postGroupId: ID de la publicación a la que adjuntar el video
• fileName: Nombre del archivo de video (ej. "video.mp4")
• contentType: video/mp4, video/quicktime o video/webm
• type: "video"

complete_media

Finaliza un archivo subido mediante get_upload_url, después de que el PUT prefirmado tenga éxito. Opcional, porque la programación también finaliza los archivos multimedia pendientes, pero llamarlo temprano expone errores de formato y sonda antes de la publicación. 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 IDs de plataforma. Llama a esto primero y copia los IDs 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 un borrador o publicación programada, por lo que corregir un error tipográfico o redirigir ya no significa eliminar y recrear. delete_media y prune_media_reference limpian archivos subidos.

Configuración de la plataforma (mediante API REST)

TikTok tiene 7 ajustes específicos de la plataforma controlados mediante platformSettings:

{
  "platformSettings": {
    "tiktok": {
      "viewerSetting": "PUBLIC_TO_EVERYONE",
      "allowComments": true,
      "allowDuet": false,
      "allowStitch": false,
      "commercialContent": false,
      "brandOrganic": false,
      "brandedContent": false
    }
  }
}

Configuración de visibilidad (Obligatorio)

Valor	Descripción
PUBLIC_TO_EVERYONE	Cualquiera puede ver (predeterminado)
MUTUAL_FOLLOW_FRIENDS	Solo seguidores mutuos
FOLLOWER_OF_CREATOR	Solo tus seguidores
SELF_ONLY	Solo tú (como borrador)

Configuración de interacción

Ajuste	Predeterminado	Descripción
allowComments	true	Si los espectadores pueden comentar
allowDuet	false	Si los espectadores pueden hacer Duetos
allowStitch	false	Si los espectadores pueden hacer Stitch

Configuración de contenido comercial

Ajuste	Predeterminado	Descripción
commercialContent	false	¿Es contenido comercial?
brandOrganic	false	Promoción orgánica de marca
brandedContent	false	Asociación paga/patrocinio

Nota: Si commercialContent es true, al menos uno de brandOrganic o brandedContent también debe ser true.

Nota: platformSettings es aceptado por las herramientas MCP create_post y update_post, así como por REST. El esquema es estricto: una plataforma o clave mal escrita se rechaza con un error de validación en lugar de ignorarse silenciosamente.

Restricciones críticas

1. Apps no auditadas = Solo PRIVADO

CRÍTICO: Si tu app de TikTok no ha pasado el proceso de revisión de TikTok, SOLO puedes publicar videos PRIVADOS (SELF_ONLY). Todos los demás valores de viewerSetting serán reemplazados por SELF_ONLY.

Para publicar videos públicos, tu app debe ser auditada por TikTok.

2. Se requiere archivo multimedia, video o carrusel de imágenes

TikTok NO admite publicaciones solo de texto: cada publicación necesita archivos multimedia.

Sí acepta carruseles de imágenes: hasta 35 imágenes, JPEG, PNG o WebP, 20 MB cada una. Una publicación es un carrusel o un solo video, nunca ambos.

3. Mínimo 23 FPS

Los videos por debajo de 23 fotogramas por segundo serán rechazados por TikTok.

Ejemplos

Publicación básica de video

Publica este video en TikTok:
"Cómo construimos nuestra startup en 60 segundos #startup #tech #coding"

Borrador privado (Pruebas)

Sube este video como borrador privado a TikTok (solo yo puedo verlo):
"Probando nuevo formato de contenido"

Usa viewerSetting: "SELF_ONLY" para pruebas antes de hacerlo público.

Contenido patrocinado

Publica este video patrocinado en TikTok con la divulgación adecuada:
"¡Me encanta este nuevo producto de @marca! #ad #sponsored"

Establece commercialContent: true y brandedContent: true para asociaciones pagas.

Publicación programada

Programa este video de TikTok para mañana a las 6 PM:
"¡Se vienen vibras de fin de semana! #weekend #fun"

Formatos de video compatibles

Formato	Recomendado	Notas
MP4	Sí	Más confiable
MOV	Sí	Formato Apple
WebM	Sí	Formato web
AVI	Aceptado por Publora	Puede ser rechazado por TikTok
MKV	Aceptado por Publora	Puede ser rechazado por TikTok

Recomendación: Usa MP4 para la mejor compatibilidad.

Mejores prácticas

Contenido

1. Engancha en los primeros 3 segundos: Atrapa la atención inmediatamente
2. Duración óptima: 15-60 segundos para mejor interacción
3. Sonidos populares: Usa audio de tendencia cuando sea posible
4. Estrategia de hashtags: 3-5 hashtags relevantes

Técnico

1. Video vertical: La relación de aspecto 9:16 funciona mejor
2. Alta calidad: Al menos resolución 720p
3. 23+ FPS: Asegura una reproducción fluida
4. Formato MP4: El formato más confiable

Momento

• Mejores horarios: 7-9 AM, 12-3 PM, 7-11 PM en la zona horaria objetivo
• Frecuencia: 1-3 publicaciones por día para crecer
• Consistencia: Un horario de publicación regular ayuda al algoritmo

Solución de problemas

Error	Causa	Solución
unaudited_client_can_only_post_to_private_accounts	App no aprobada	Envía la app para revisión de TikTok o usa SELF_ONLY
spam_risk_too_many_posts	Límite diario alcanzado	Espera 24 horas
duration_check_failed	Video demasiado largo/corto	Asegura de 3 segundos a 10 minutos
file_format_check_failed	Formato de video incorrecto	Usa MP4, MOV o WebM
"23 FPS required"	Baja tasa de fotogramas	Reconvierte el video a 23+ FPS
"TikTok requires selecting who can view"	Falta viewerSetting	Incluye siempre viewerSetting en platformSettings