Taisly Social Media Posting

Publica videos cortos en TikTok, Instagram Reels, YouTube Shorts, X y Facebook desde agentes de IA a través del servidor oficial Taisly MCP.

Documentación

Taisly Agent Kit: AI agent social media posting for TikTok, Instagram Reels, YouTube Shorts, X, and Facebook

Taisly Agent Kit

Taisly MCP server Taisly MCP score

Publicación en redes sociales gratuita y centrada en IA para vídeo de formato corto. Taisly Agent Kit es un SDK, CLI, Agent Skill y servidor MCP centrados en JSON que permite a agentes de IA, herramientas de desarrollo y flujos de automatización publicar vídeos en TikTok, Instagram Reels, YouTube Shorts, X, Facebook y otras plataformas sociales conectadas a través de Taisly.

Úsalo cuando tu agente pueda crear contenido, escribir descripciones o preparar una campaña, pero aún necesite una API fiable de publicación de vídeo para poner ese contenido en línea. El paquete es gratuito de instalar y está diseñado para llevar a un agente desde la idea hasta el vídeo publicado sin tener que construir tú cada integración de plataforma.

Sitio web | Agent Kit | Documentación de API | npm | GitHub | Registro MCP | Glama | Guía

Idiomas

Lee esta guía en: English, Español, Deutsch, Français, Português, ไทย, 中文, Bahasa Indonesia, Русский, Nederlands, 한국어, 日本語, العربية, Türkçe, Polski.

Por qué lo usan los desarrolladores

  • Integra la publicación en redes sociales de agentes de IA en Codex, Claude Code, Cursor, OpenClaw y herramientas de automatización personalizadas.
  • Automatiza la publicación de vídeos desde un único archivo local a múltiples cuentas sociales conectadas.
  • Proporciona a los agentes un flujo de trabajo JSON seguro: descubre cuentas, valida cargas útiles, crea publicaciones y comprueba el estado.
  • Añade automatización de publicación mediante la API de TikTok, automatización de Instagram Reels, publicación en YouTube Shorts y automatización multiplataforma de redes sociales sin construir tú cada integración de plataforma.
  • Empieza gratis y mejora solo cuando el flujo de publicación crezca.

Taisly gestiona las cuentas conectadas y la ejecución de la publicación. Tu agente gestiona la planificación, la redacción de descripciones, la lógica de campaña o la orquestación del flujo de trabajo.

Publicación gratuita centrada en IA

  • Instala el paquete gratis.
  • Crea o conecta una cuenta de Taisly desde tu agente de IA.
  • Deja que el agente se autentique, conecte cuentas sociales, valide vídeos y publique mediante un flujo de trabajo centrado en JSON.
  • Mejora más adelante cuando necesites publicación de mayor volumen, conjuntos de cuentas más grandes o flujos de trabajo de republicación automática.

No se requiere tarjeta de crédito para empezar. Los planes de pago son para equipos y flujos de trabajo que necesitan más escala.

Agent Skill

Este paquete incluye la Taisly Social Media Posting Skill en SKILL.md. Úsala con Claude Code, Codex, Cursor, OpenClaw y otros agentes cuando quieras que el agente comprenda el flujo de publicación seguro antes de tocar cuentas sociales reales.

Flujo de trabajo recomendado de la skill:

auth -> platforms -> validate -> confirm -> create -> status

La skill indica a los agentes que descubran cuentas conectadas, validen la publicación, pidan confirmación explícita al usuario, creen la publicación y guarden el historyId devuelto para comprobaciones de estado.

Plugin de Codex

Este paquete incluye un manifiesto de plugin de Codex en .codex-plugin/plugin.json. El plugin apunta a Codex al archivo canónico SKILL.md y al servidor MCP remoto oficial:

https://app.taisly.com/mcp

Usa el plugin cuando quieras que Codex descubra tanto las instrucciones del flujo de publicación como las herramientas MCP de Taisly desde un solo paquete. El SKILL.md raíz es la única fuente de verdad para el flujo de trabajo del agente.

Instalación

npm install -g @taisly/agent

O ejecútalo sin una instalación global:

npx @taisly/agent help

Inicia el servidor MCP stdio:

npx @taisly/agent mcp

Para desarrollo local dentro de este repositorio:

node packages/agent/src/cli.js help

Autenticación

El flujo más sencillo es dejar que tu agente de IA abra el inicio de sesión en el navegador por ti. Usa cualquier slug corto de agente, por ejemplo claude-code, codex, cursor, windsurf, openclaw, hermes-agent, cline o aider.

Help me set up Taisly Agent Kit.

1. Install the CLI: npm i -g @taisly/agent
2. Run taisly setup --agent <agent-slug> and send me the login URL so I can finish authentication.
3. Wait for me to finish login in the browser.
4. Run taisly checkin --agent <agent-slug>.
5. Tell me if Taisly is connected and ready. If not, tell me what failed.

If you cannot install or run the Taisly CLI in this environment, stop and tell me to open Taisly Settings instead.

El comando de configuración almacena una credencial local de agente de Taisly, de modo que los comandos posteriores de CLI y MCP puedan ejecutarse sin copiar manualmente una clave de API.

Alternativa manual: crea una clave de API en Configuración de Taisly y luego establece:

export TAISLY_API_KEY="taisly_..."

Avanzado: de forma predeterminada, la configuración del navegador almacena la credencial local en ~/.taisly/config.json. La mayoría de los usuarios no deberían cambiar esto. Establece TAISLY_CONFIG_HOME=/path/to/dir solo para CI, pruebas o perfiles de agente aislados que necesiten un almacén de credenciales separado.

Inicio rápido

Enumera las cuentas sociales conectadas disponibles para la clave de API:

taisly auth:status
taisly platforms:list

Conecta una cuenta social desde un flujo de agente de IA:

taisly platforms:connect:start --platform instagram
# Open the returned connectUrl and finish authorization in the browser.
taisly platforms:connect:check --platform instagram
taisly platforms:list

Slugs de conexión compatibles: instagram, tiktok, youtube, x, facebook.

Valida un vídeo local antes de publicar:

taisly posts:validate \
  --video ./launch.mp4 \
  --platforms platform_id_1,platform_id_2 \
  --description "Launch day"

Publica ahora:

taisly posts:create \
  --video ./launch.mp4 \
  --platforms platform_id_1,platform_id_2 \
  --description "Launch day"

Programa para más tarde:

taisly posts:create \
  --video ./launch.mp4 \
  --platforms platform_id_1,platform_id_2 \
  --description "Launch day" \
  --scheduled "2026-06-14T09:00:00+07:00"

Comprueba la publicación devuelta:

taisly posts:status --id <historyId>

Cada comando imprime JSON para que los agentes puedan analizar los resultados sin extraer texto del terminal.

Servidor MCP

Taisly está publicado en el Registro MCP oficial como:

io.github.taisly/agent

Nombre para mostrar: Taisly Social Media Posting

Endpoint MCP remoto:

https://app.taisly.com/mcp

El servidor MCP remoto utiliza HTTP transmisible y OAuth. Las herramientas MCP remotas solo pueden publicar desde valores públicos de videoUrl porque no pueden leer archivos locales de tu máquina.

Configuración de MCP remoto en Codex:

codex mcp add taisly --url https://app.taisly.com/mcp
codex mcp login taisly

Configuración de MCP remoto en Claude Code:

claude mcp add --transport http taisly https://app.taisly.com/mcp

Luego pide a Claude Code que verifique la conexión. Si se necesita OAuth, Claude Code puede guiar el inicio de sesión en el navegador desde la sesión. También puedes autenticarte explícitamente con claude mcp login taisly si quieres completar el flujo de OAuth desde la terminal antes de usar las herramientas.

Taisly Agent Kit también incluye un servidor MCP stdio local en el mismo paquete. Usa MCP local cuando tu agente necesite leer archivos de vídeo locales:

{
  "mcpServers": {
    "taisly": {
      "command": "npx",
      "args": ["@taisly/agent", "mcp"]
    }
  }
}

Si ya usas una clave de API manual, aún puedes pasar TAISLY_API_KEY en el bloque env del servidor MCP.

Configuración de MCP local en Codex:

codex mcp add taisly -- npx @taisly/agent mcp

Configuración de MCP local en Claude Code:

claude mcp add taisly -- npx @taisly/agent mcp

Luego pide al agente:

Use the local Taisly MCP server you just added and run the Taisly agent setup start tool with agentId: "<agent-slug>".

Send me the login URL and wait for me to finish in the browser.
Then run the Taisly agent checkin tool with agentId: "<agent-slug>".
After checkin, run the Taisly auth status tool.
Tell me if Taisly is connected and ready. If not, tell me what failed.

Herramientas MCP disponibles:

  • taisly_agent_setup_start
  • taisly_agent_checkin
  • taisly_auth_status
  • taisly_platforms_list
  • taisly_platform_schema
  • taisly_platform_connect_start
  • taisly_platform_connect_check
  • taisly_posts_validate
  • taisly_posts_create
  • taisly_posts_status
  • taisly_posts_list
  • taisly_reposts_list
  • taisly_reposts_create

taisly_posts_create requiere confirmed: true. Establécelo solo después de que el usuario apruebe explícitamente el vídeo, las cuentas de destino, la descripción y la programación.

Flujo de trabajo JSON para agentes

Los agentes pueden escribir un archivo de carga útil y pasarlo a la CLI:

{
  "video": "./launch.mp4",
  "platforms": ["platform_id_1", "platform_id_2"],
  "description": "Launch day. Short demo, big update.",
  "scheduled": "2026-06-14T09:00:00+07:00"
}

Luego ejecuta:

taisly posts:validate --json ./campaign.json
taisly posts:create --json ./campaign.json

La ruta video debe apuntar a un archivo local real disponible para el agente. Las extensiones locales de verificación previa compatibles son .mp4, .mov, .avi, .mkv, .webm, .flv, .mpeg y .mpg.

Comandos

taisly auth:status
taisly setup --agent <agent-slug>
taisly checkin --agent <agent-slug>
taisly platforms:list
taisly integrations:list
taisly platforms:schema --platform TikTok
taisly posts:validate --video ./launch.mp4 --platforms platform_id_1 --description "Launch day"
taisly posts:create --video ./launch.mp4 --platforms platform_id_1 --description "Launch day"
taisly posts:create --json ./campaign.json
taisly posts:list --page 1
taisly posts:status --id <historyId>
taisly reposts:list
taisly reposts:create --from <platform_id> --to <platform_id_1,platform_id_2>
taisly mcp

Los comandos integrations:* son alias de los comandos platforms:*. Taisly llama plataformas a las cuentas sociales conectadas en la aplicación, mientras que muchas API públicas las llaman integraciones.

SDK

import { Taisly } from "@taisly/agent";

const taisly = new Taisly({
  apiKey: process.env.TAISLY_API_KEY,
});

const platforms = await taisly.platforms.list();

const validation = await taisly.posts.validate({
  video: "./launch.mp4",
  platforms: [platforms.data[0].id],
  description: "Launch day",
});

const post = await taisly.posts.create({
  video: "./launch.mp4",
  platforms: [platforms.data[0].id],
  description: "Launch day",
  scheduled: "2026-06-14T09:00:00+07:00",
});

console.log(validation.success);
console.log(post.historyId);

Uso con agentes de IA

Taisly Agent Kit está diseñado para flujos de trabajo agénticos en los que el usuario da una instrucción de alto nivel y el agente ejecuta una ruta de publicación segura.

  • Codex: deja que un agente de codificación publique vídeos de demostración, clips de lanzamiento o actualizaciones de compilación tras la confirmación del usuario.
  • Claude Code: añade publicación social a flujos de trabajo de contenido locales y scripts de campaña.
  • Cursor: publica vídeos desde herramientas de desarrollo, aplicaciones de contenido y automatización interna.
  • OpenClaw y otros agentes: conecta la planificación, la redacción de descripciones y la ejecución de la publicación a través de una única CLI.

Ruta de agente recomendada:

auth:status -> platforms:list -> platforms:schema -> posts:validate -> user confirmation -> posts:create -> posts:status

Recetas de agente

La carpeta examples/ incluye flujos de trabajo de copiar y pegar para agentes de codificación habituales:

  • examples/codex/post-video.md
  • examples/claude-code/schedule-video.md
  • examples/cursor/post-build-demo-video.md
  • examples/post-video.sh
  • examples/schedule-video.sh

Lo que este paquete no es

  • No es un panel de redes sociales.
  • No es un editor de vídeo.
  • No sustituye a una cuenta de Taisly.
  • Requiere cuentas sociales conectadas y una credencial de agente de Taisly o una clave de API.
  • No elude las reglas de la plataforma, los permisos de cuenta ni la validación de medios.

Límites actuales

  • posts:create utiliza la API multipart /post existente.
  • posts:status lee el historial reciente porque aún no hay un endpoint de estado de publicación individual disponible.
  • posts:validate es una verificación previa local; la validación final sigue ocurriendo en Taisly.
  • El MCP local utiliza transporte stdio. El MCP remoto utiliza HTTP transmisible en https://app.taisly.com/mcp.
  • El MCP remoto requiere URL de vídeo públicas; usa MCP local o la CLI para archivos de vídeo locales.
  • La reutilización de la carga de medios está planificada para más adelante.

Enlaces