Taisly Social Media Posting

Publique vídeos curtos no TikTok, Instagram Reels, YouTube Shorts, X e Facebook a partir de agentes de IA através do servidor oficial Taisly MCP.

GitHub

219

Experimente este MCPPatrocinado

Documentação

Taisly Agent Kit

Publicação gratuita em redes sociais com foco em IA para vídeos curtos. O Taisly Agent Kit é um SDK, CLI, Skill de Agente e servidor MCP com prioridade em JSON que permite que agentes de IA, ferramentas de desenvolvimento e fluxos de automação publiquem vídeos no TikTok, Instagram Reels, YouTube Shorts, X, Facebook e outras plataformas sociais conectadas por meio do Taisly.

Use-o quando seu agente puder criar conteúdo, escrever legendas ou preparar uma campanha, mas ainda precisar de uma API confiável de publicação de vídeos para colocar esse conteúdo online. O pacote é gratuito para instalar e foi projetado para levar um agente da ideia ao vídeo publicado sem que você precise criar cada integração de plataforma do zero.

Idiomas

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

Por que os desenvolvedores usam

Integre a publicação em redes sociais por agentes de IA no Codex, Claude Code, Cursor, OpenClaw e ferramentas de automação personalizadas.
Automatize a publicação de vídeos de um único arquivo local para várias contas sociais conectadas.
Dê aos agentes um fluxo JSON seguro: descubra contas, valide payloads, crie posts e verifique o status.
Adicione automação de publicação via API do TikTok, automação de Instagram Reels, publicação de YouTube Shorts e automação de redes sociais multiplataforma sem criar cada integração de plataforma do zero.
Comece gratuitamente e faça upgrade somente quando o fluxo de publicação crescer.

O Taisly cuida das contas conectadas e da execução da publicação. Seu agente cuida do planejamento, da escrita de legendas, da lógica de campanha ou da orquestração do fluxo de trabalho.

Publicação gratuita com foco em IA

Instale o pacote gratuitamente.
Crie ou conecte uma conta Taisly pelo seu agente de IA.
Deixe o agente autenticar, conectar contas sociais, validar vídeos e publicar por meio de um fluxo JSON-first.
Faça upgrade depois quando precisar de publicação em maior volume, conjuntos maiores de contas ou fluxos automáticos de republicação.

Não é necessário cartão de crédito para começar. Os planos pagos são para equipes e fluxos que precisam de mais escala.

Skill de Agente

Este pacote inclui a Taisly Social Media Posting Skill em SKILL.md. Use-a com Claude Code, Codex, Cursor, OpenClaw e outros agentes quando quiser que o agente entenda o fluxo seguro de publicação antes de tocar em contas sociais reais.

Fluxo recomendado da skill:

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

A skill orienta os agentes a descobrir contas conectadas, validar o post, pedir confirmação explícita do usuário, criar o post e salvar o historyId retornado para verificações de status.

Plugin Codex

Este pacote inclui um manifesto de plugin Codex em .codex-plugin/plugin.json. O plugin aponta o Codex para o arquivo SKILL.md canônico e para o servidor MCP remoto oficial:

https://app.taisly.com/mcp

Use o plugin quando quiser que o Codex descubra tanto as instruções do fluxo de publicação quanto as ferramentas MCP do Taisly a partir de um único pacote. O SKILL.md raiz é a fonte única de verdade para o fluxo do agente.

Instalação

npm install -g @taisly/agent

Ou execute sem instalação global:

npx @taisly/agent help

Inicie o servidor MCP stdio:

npx @taisly/agent mcp

Para desenvolvimento local dentro deste repositório:

node packages/agent/src/cli.js help

Autenticação

O fluxo mais fácil é deixar seu agente de IA abrir o login no navegador para você. Use qualquer slug curto de agente, por exemplo claude-code, codex, cursor, windsurf, openclaw, hermes-agent, cline ou 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.

O comando de configuração armazena uma credencial local de agente Taisly, para que comandos CLI e MCP posteriores possam ser executados sem copiar manualmente uma chave de API.

Fallback manual: crie uma chave de API em Taisly Settings e depois defina:

export TAISLY_API_KEY="taisly_..."

Avançado: por padrão, a configuração no navegador armazena a credencial local em ~/.taisly/config.json. A maioria dos usuários não deve alterar isso. Defina TAISLY_CONFIG_HOME=/path/to/dir apenas para CI, testes ou perfis de agente isolados que precisem de um armazenamento de credenciais separado.

Início rápido

Liste as contas sociais conectadas disponíveis para a chave de API:

taisly auth:status
taisly platforms:list

Conecte uma conta social a partir de um fluxo 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 conexão suportados: instagram, tiktok, youtube, x, facebook.

Valide um vídeo local antes de publicar:

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

Publique agora:

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

Agende para depois:

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

Verifique o post retornado:

taisly posts:status --id <historyId>

Cada comando imprime JSON para que os agentes possam analisar os resultados sem extrair texto do terminal.

Servidor MCP

O Taisly está publicado no MCP Registry oficial como:

io.github.taisly/agent

Nome de exibição: Taisly Social Media Posting

Endpoint MCP remoto:

https://app.taisly.com/mcp

O servidor MCP remoto usa HTTP streamable e OAuth. As ferramentas MCP remotas só podem publicar a partir de valores videoUrl públicos, pois não conseguem ler arquivos locais da sua máquina.

Configuração MCP remota no Codex:

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

Configuração MCP remota no Claude Code:

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

Depois, peça ao Claude Code para verificar a conexão. Se OAuth for necessário, o Claude Code pode guiar o login no navegador a partir da sessão. Você também pode autenticar explicitamente com claude mcp login taisly se quiser concluir o fluxo OAuth no shell antes de usar as ferramentas.

O Taisly Agent Kit também inclui um servidor MCP stdio local no mesmo pacote. Use MCP local quando seu agente precisar ler arquivos de vídeo locais:

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

Se você já usa uma chave de API manual, ainda pode passar TAISLY_API_KEY no bloco env do servidor MCP.

Configuração MCP local no Codex:

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

Configuração MCP local no Claude Code:

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

Depois, pergunte ao 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.

Ferramentas MCP disponíveis:

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 requer confirmed: true. Defina-o somente depois que o usuário aprovar explicitamente o vídeo, as contas de destino, a legenda e o agendamento.

Fluxo JSON para agentes

Os agentes podem escrever um arquivo de payload e passá-lo para a 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"
}

Depois, execute:

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

O caminho video deve apontar para um arquivo local real disponível para o agente. As extensões locais de pré-verificação suportadas são .mp4, .mov, .avi, .mkv, .webm, .flv, .mpeg e .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

Os comandos integrations:* são aliases dos comandos platforms:*. O Taisly chama as plataformas de contas sociais conectadas de "plataformas" no aplicativo, enquanto muitas APIs públicas as chamam de "integrações".

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 com agentes de IA

O Taisly Agent Kit foi projetado para fluxos agenticos em que o usuário dá uma instrução de alto nível e o agente executa um caminho seguro de publicação.

Codex: deixe um agente de codificação publicar vídeos de demonstração, clipes de lançamento ou atualizações de build após confirmação do usuário.
Claude Code: adicione publicação social a fluxos de conteúdo local e scripts de campanha.
Cursor: envie publicação de vídeos a partir de ferramentas de desenvolvimento, aplicativos de conteúdo e automação interna.
OpenClaw e outros agentes: conecte planejamento, escrita de legendas e execução de publicação por meio de uma única CLI.

Caminho recomendado para agentes:

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

Receitas para agentes

A pasta examples/ inclui fluxos prontos para copiar e colar para agentes de codificação comuns:

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

O que este pacote não é

Não é um painel de redes sociais.
Não é um editor de vídeo.
Não substitui uma conta Taisly.
Requer contas sociais conectadas e uma credencial de agente Taisly ou chave de API.
Não ignora regras da plataforma, permissões de conta ou validação de mídia.

Limites atuais

posts:create usa a API multipart /post existente.
posts:status lê o histórico recente porque um endpoint de status de post único ainda não está disponível.
posts:validate é uma pré-verificação local; a validação final ainda acontece no Taisly.
MCP local usa transporte stdio. MCP remoto usa HTTP streamable em https://app.taisly.com/mcp.
MCP remoto requer URLs de vídeo públicos; use MCP local ou a CLI para arquivos de vídeo locais.
Reutilização de upload de mídia está planejada para depois.