API de publicação em redes sociais para agentes de IA: MCP, agendamento e republicação

Um agente de IA já consegue planear uma campanha, escrever o texto, escolher a hora e preparar um vídeo. Falta-lhe uma camada de execução fiável que o ligue a contas reais nas redes sociais.

O Taisly Agent Kit fornece essa camada. As suas ferramentas estruturadas descobrem contas ligadas, validam publicações de vídeo, publicam de imediato, agendam para mais tarde, consultam o estado e criam regras de republicação automática.

A opção mais rápida é o servidor MCP remoto oficial da Taisly:

https://app.taisly.com/mcp

Utiliza HTTP com transmissão contínua e OAuth. Para ficheiros no computador, a mesma integração existe como MCP local, CLI baseada em JSON, SDK JavaScript e API de publicação em redes sociais.

Em resumo: se um agente de IA consegue usar ferramentas MCP, executar comandos ou chamar uma API, pode publicar vídeos curtos com a Taisly. O percurso seguro é sempre: autenticar, descobrir as contas, validar, confirmar a ação final com o utilizador, publicar ou agendar e guardar o historyId.

O que é uma API de publicação em redes sociais para agentes de IA?

É uma interface que transforma uma instrução geral numa ação real. Em vez de parar depois de gerar o texto, o agente pode:

• verificar se a ligação está pronta;
• listar as contas e os respetivos identificadores;
• consultar os requisitos de cada plataforma;
• ligar uma conta em falta através de autorização no navegador;
• validar um URL público ou um ficheiro local;
• publicar agora ou agendar;
• devolver um identificador estável e consultar o resultado;
• criar e inspecionar automatizações de republicação.

A Taisly trata da autenticação nas plataformas e da execução. O agente trata do planeamento, preparação, escolha de ferramentas, validação e coordenação. Assim, os programadores não precisam de reconstruir integrações com TikTok, Instagram, YouTube, X e Facebook para cada agente.

O que um agente de IA pode fazer com a Taisly

A Taisly está centrada na publicação de vídeo. Não é um editor, um gerador de textos nem um modelo de IA. É a camada que executa a ação depois de o conteúdo estar pronto.

Quatro formas de ligar um agente de IA

1. Utilizar o assistente AI Agents Setup da Taisly

O assistente AI Agents Setup oferece percursos para:

• Codex
• ChatGPT
• Claude
• Claude Code
• OpenClaw
• Hermes Agent
• qualquer outro agente com MCP ou terminal

O assistente segue Escolher -> Ligar -> Começar e produz os comandos, a configuração ou a instrução pronta a copiar. Também indica se é necessário um URL público ou se o método lê ficheiros locais.

Depois da escolha, a Taisly mostra apenas os métodos relevantes. Para Codex, gera uma instrução completa para a CLI e oferece MCP remoto em separado.

2. Ligar o servidor MCP remoto

Use MCP remoto quando o agente aceita servidores alojados e o vídeo tem um URL público.

Server name: Taisly Social Media Posting
MCP endpoint: https://app.taisly.com/mcp
Transport: Streamable HTTP
Recommended authentication: OAuth
MCP Registry ID: io.github.taisly/agent

É adequado para aplicações ChatGPT, conectores Claude, Codex, Claude Code, Hermes Agent e clientes próprios. O utilizador autoriza a Taisly no navegador; o agente não recebe palavras-passe das redes sociais.

Codex:

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

Claude Code:

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

Configurar a aplicação ChatGPT

Num espaço compatível, crie uma aplicação Taisly ou um conector personalizado. O assistente fornece o link das definições, nome, URL MCP, instruções OAuth e passos para ativar a Taisly numa conversa.

Configurar o conector Claude

No Claude para Web, computador ou telemóvel, adicione a Taisly como conector personalizado com o mesmo URL MCP. Existe um link direto e instruções manuais para contas individuais e espaços Team ou Enterprise.

Consulte a documentação de publicação de vídeo com MCP.

3. Executar MCP local para ficheiros no computador

Um servidor remoto não lê ./video.mp4, a pasta Transferências ou outro caminho privado.

npx -y @taisly/agent mcp

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

Para Codex:

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

Para Claude Code:

claude mcp add --transport stdio taisly -- npx -y @taisly/agent mcp

Também funciona com Cursor, Windsurf, Cline e Aider, caso consigam iniciar comandos locais.

4. Utilizar CLI, SDK ou API REST

npm install -g @taisly/agent

taisly setup --agent codex
# Abra a loginUrl devolvida e autorize a ligação.
taisly checkin --agent codex
taisly auth:status

O processo guarda uma credencial local. Serviços de servidor também podem usar uma chave nas definições da Taisly.

• Início rápido do Taisly Agent Kit
• Visão geral da API de publicação
• Documentação da API Taisly
• @taisly/agent no npm
• Repositório público

MCP remoto ou MCP local?

Um videoUrl remoto tem de funcionar sem cookies, VPN, início de sessão ou página de confirmação e apontar diretamente para um ficheiro. O limite atual é 500 MB.

A validação local suporta .mp4, .mov, .avi, .mkv, .webm, .flv, .mpeg e .mpg. Cada plataforma pode impor limites adicionais.

Ferramentas MCP disponíveis

Autenticação e descoberta

• taisly_auth_status verifica a ligação, limites e número de contas.
• taisly_platforms_list devolve as contas disponíveis.
• taisly_platform_schema devolve os requisitos.
• taisly_platform_connect_start cria um link de autorização.
• taisly_platform_connect_check verifica a ligação.

A ligação programática suporta instagram, tiktok, youtube, x e facebook. Depois, o agente volta a chamar taisly_platforms_list e utiliza os identificadores devolvidos.

Publicação, agendamento e estado

• taisly_posts_validate verifica URL, destinos, texto e hora.
• taisly_posts_create publica ou agenda.
• taisly_posts_status consulta por historyId.
• taisly_posts_list lista o histórico recente.

taisly_posts_create exige confirmed: true, apenas após aprovação do vídeo, texto, contas e hora.

Republicação automática

• taisly_reposts_list devolve as regras.
• taisly_reposts_create cria uma regra entre uma origem e um ou mais destinos.

MCP local também inclui taisly_agent_setup_start e taisly_agent_checkin para autenticação guiada sem copiar uma chave.

Percurso de publicação seguro

autenticar
-> listar contas ligadas
-> consultar requisitos
-> validar vídeo e dados
-> mostrar a ação final
-> obter confirmação explícita
-> publicar ou agendar
-> guardar historyId
-> verificar o estado

1. Executar taisly_auth_status.
2. Executar taisly_platforms_list.
3. Associar destinos a identificadores exatos.
4. Ligar contas em falta e aguardar autorização.
5. Executar taisly_platform_schema.
6. Preparar vídeo, texto, opções e hora.
7. Executar taisly_posts_validate.
8. Mostrar a ação completa.
9. Após aprovação, chamar taisly_posts_create com confirmed: true.
10. Devolver e guardar historyId.
11. Consultar taisly_posts_status ou taisly_posts_list.

O agente automatiza tarefas repetitivas, mas a ação importante continua sob controlo humano.

Exemplo 1: publicar agora por MCP remoto

Utiliza as ferramentas MCP da Taisly para publicar este vídeo:

URL do vídeo: https://cdn.example.com/launch.mp4
Texto: Dia do lançamento. Eis a apresentação de 30 segundos do produto.
Destinos: as minhas contas TikTok e Instagram
Hora: publicar agora

Primeiro, lista as contas ligadas e encontra os destinos certos.
Consulta os requisitos e valida a publicação.
Mostra-me o URL, texto, contas e hora finais.
Não publiques antes da minha confirmação.
Depois, devolve o historyId e verifica o estado inicial.

{
  "videoUrl": "https://cdn.example.com/launch.mp4",
  "platforms": ["platform_id_1", "platform_id_2"],
  "description": "Dia do lançamento. Eis a apresentação de 30 segundos do produto.",
  "confirmed": true
}

Exemplo 2: agendar uma publicação

Utilize uma data ISO com fuso horário explícito.

Agenda ./launch.mp4 para sexta-feira às 9:00 em Asia/Bangkok.
Publica nas minhas contas TikTok, Instagram, YouTube, X e Facebook.
Texto: "Uma forma mais rápida de distribuir vídeo social."

Lista as contas, valida o ficheiro e a hora e mostra a ação final.
Aguarda a minha confirmação.

{
  "video": "./launch.mp4",
  "platforms": [
    "platform_id_1",
    "platform_id_2",
    "platform_id_3"
  ],
  "description": "Uma forma mais rápida de distribuir vídeo social.",
  "scheduled": "2026-07-31T09:00:00+07:00"
}

taisly posts:validate --json ./campaign.json
taisly posts:create --json ./campaign.json
taisly posts:status --id <historyId>

O agente comunica a hora normalizada, as contas e o historyId.

Exemplo 3: criar uma republicação entre plataformas

Uma regra aplica-se aos próximos vídeos elegíveis de uma conta de origem, não apenas a uma publicação.

Cria com a Taisly uma republicação automática da minha conta YouTube para as minhas contas TikTok e Instagram.

Lista primeiro as regras e contas.
Mostra-me a origem e os destinos exatos.
Cria a regra só depois da minha aprovação.

taisly reposts:list
taisly reposts:create \
  --from <youtube_platform_id> \
  --to <tiktok_platform_id>,<instagram_platform_id>

Os agentes MCP usam taisly_reposts_list e taisly_reposts_create.

Leia o guia completo e os guias de TikTok, Instagram Reels e YouTube Shorts.

Exemplo 4: ligar uma conta em falta

1. O agente chama taisly_platforms_list.
2. Deteta que falta Instagram.
3. Chama taisly_platform_connect_start com platform: "instagram".
4. A Taisly devolve um connectUrl.
5. O utilizador recebe o URL e autoriza no navegador.
6. O agente chama taisly_platform_connect_check.
7. Volta a listar as contas e só continua quando encontra a correta.

O utilizador mantém o controlo. O agente nunca precisa das palavras-passe de Instagram, TikTok, YouTube, X ou Facebook.

Também pode seguir os guias de Instagram e YouTube.

Que agentes de IA podem usar a Taisly?

O fornecedor do modelo não é determinante. O agente precisa de MCP remoto, MCP local, CLI ou API.

Agentes conversacionais e gerais

Há percursos para ChatGPT e Claude. O mesmo padrão serve para Gemini, Microsoft Copilot, Perplexity, Grok, DeepSeek e Mistral AI quando o ambiente expõe MCP ou API.

Agentes de programação e utilização do computador

Taisly tem páginas para Codex, Claude Code, OpenClaw, Hermes Agent, Cursor, Windsurf, Cline, Aider, GitHub Copilot Chat, Amazon Q, Replit Agent, Codeium, Tabnine, Bolt.new, Lovable e v0.

São úteis para demonstrações, novidades, gravações de testes, conteúdos de campanha e anúncios.

Estruturas de agentes e automação

Sistemas próprios podem integrar Taisly com Manus, Lindy AI, Superagent, Vellum, Semantic Kernel, AutoGen, MetaGPT e Agent Zero.

Podem planear a campanha, criar ou encontrar o vídeo, adaptar textos, pedir aprovação, chamar Taisly e acompanhar o resultado.

Ferramentas de vídeo e conteúdo com IA

Runway, Synthesia, HeyGen, Sora, Pika, Kling AI, InVideo, CapCut, Canva, Descript e Opus Clip podem preparar o conteúdo.

Nem todas expõem a mesma interface. O padrão seguro é: uma ferramenta cria o ficheiro, um agente com MCP ou API obtém o ficheiro ou URL e a Taisly publica.

Veja o diretório completo.

Em que plataformas pode o agente publicar?

• API TikTok
• API Instagram Reels
• API YouTube Shorts
• API de vídeo para X
• API de vídeo para Facebook

Os destinos disponíveis são sempre os devolvidos por taisly_platforms_list ou taisly platforms:list. Um nome de plataforma não chega porque pode haver várias contas, canais ou páginas.

O agente nunca deve inventar identificadores nem publicar em «todas as contas» sem pedido expresso.

Opções e textos específicos de cada plataforma

Com taisly_platform_schema, o agente pode adaptar a abertura e o apelo à ação, verificar texto e campos, escolher privacidade, indicar o fuso horário, evitar marcas de água e confirmar formato e duração.

Leia como publicar o mesmo vídeo sem parecer repetitivo, por que motivo vídeos republicados têm poucas visualizações, as melhores horas e por que motivo as plataformas comprimem vídeo.

Regras de segurança

1. Descobrir primeiro as contas.
2. Usar apenas o alcance pedido.
3. Validar antes de criar.
4. Mostrar a ação final completa.
5. Exigir aprovação explícita. Só depois definir confirmed: true.
6. Proteger credenciais. Nunca mostrar TAISLY_API_KEY.
7. Guardar historyId.
8. Não repetir a criação às cegas. Verificar primeiro o histórico.
9. Respeitar limites do plano e das plataformas.
10. Respeitar regras e permissões.

Percurso CLI baseado em JSON

taisly auth:status
taisly platforms:list
taisly platforms:schema --platform TikTok
taisly posts:validate --json ./campaign.json
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>

integrations:list é um nome alternativo de platforms:list. A Taisly chama «plataformas» às contas ligadas; algumas API chamam-lhes «integrações».

Exemplo de SDK JavaScript

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: "Dia do lançamento",
});

if (!validation.success) {
  throw new Error("A publicação não passou na validação.");
}

const post = await taisly.posts.create({
  video: "./launch.mp4",
  platforms: [platforms.data[0].id],
  description: "Dia do lançamento",
  scheduled: "2026-07-31T09:00:00+07:00",
});

console.log(post.historyId);

Em produção, associe deliberadamente o pedido à conta correta em vez de escolher a primeira.

Instrução de configuração para um agente com terminal

Ajuda-me a ligar este ambiente à Taisly.

1. Instala a CLI do Taisly Agent Kit com: npm i -g @taisly/agent
2. Executa: taisly setup --agent <agent-slug>
3. Envia-me o URL de acesso e aguarda a minha autorização no navegador.
4. Executa: taisly checkin --agent <agent-slug>
5. Executa: taisly auth:status
6. Executa: taisly platforms:list
7. Diz-me se a Taisly está pronta e lista os nomes e identificadores das contas.

Não mostres credenciais nem cries uma publicação real durante a configuração.

Substitua <agent-slug> por codex, claude-code, cursor, windsurf, openclaw, hermes-agent, cline ou aider.

Instrução operacional para um agente MCP

Utiliza o servidor MCP da Taisly para publicar nas redes sociais.

Antes de qualquer publicação:
- Executa taisly_auth_status.
- Executa taisly_platforms_list e associa as minhas contas a identificadores exatos.
- Executa taisly_platform_schema para cada destino.
- Valida o vídeo, o texto, os destinos e a hora.
- Mostra-me a ação completa e aguarda confirmação.

Só depois da confirmação chama taisly_posts_create com confirmed: true.
Devolve historyId e verifica o estado.

Com MCP remoto, exige um videoUrl público direto.
Para um ficheiro local, utiliza MCP local ou CLI.
Nunca inventes identificadores, reveles credenciais, publiques em contas não pedidas ou repitas a criação às cegas.

Resumo de integração legível por máquinas

name: Taisly Social Media Posting
purpose: Publicar, agendar, acompanhar e republicar automaticamente vídeos curtos
website: https://taisly.com/en
application_setup: https://app.taisly.com/agent-kit
remote_mcp:
  url: https://app.taisly.com/mcp
  transport: streamable-http
  auth: oauth
  video_input: URL público direto http ou https
local_package:
  npm: "@taisly/agent"
  mcp_command: npx -y @taisly/agent mcp
  cli_command: taisly
  video_input: caminho para ficheiro de vídeo local
registry:
  id: io.github.taisly/agent
primary_operations:
  - autenticar
  - listar contas ligadas
  - consultar requisitos
  - ligar uma conta com autorização
  - validar uma publicação
  - publicar agora
  - agendar para mais tarde
  - listar e verificar estados
  - listar e criar regras de republicação
safety:
  - não inventar identificadores
  - validar antes de publicar
  - exigir confirmação explícita
  - guardar o historyId
  - não revelar credenciais

Perguntas frequentes

Um agente pode publicar no TikTok, Instagram Reels, YouTube Shorts, X e Facebook?

Sim. Lista as contas, associa os identificadores, valida e publica após confirmação.

Pode agendar publicações?

Sim. Adicione uma data ISO com fuso horário a scheduled.

Pode republicar vídeos automaticamente?

Sim. Uma regra liga uma conta de origem a um ou mais destinos e só é criada após aprovação.

MCP remoto envia ficheiros do meu computador?

Não. Precisa de um videoUrl público direto. Utilize MCP local ou CLI para caminhos locais.

Existe uma aplicação Taisly para ChatGPT?

A Taisly pode ser adicionada como aplicação ou conector personalizado em ambientes compatíveis.

Funciona com Claude e Claude Code?

Sim. Claude Web usa um conector; Claude Code usa MCP remoto para URLs ou MCP local para ficheiros.

Funciona com Codex?

Sim. Codex pode usar MCP remoto com OAuth, MCP local ou CLI. Veja a página Codex e o início rápido.

É uma API genérica para texto?

Não. O Agent Kit destina-se sobretudo a vídeo curto e republicação automática.

O agente precisa das minhas palavras-passe?

Não. A autorização ocorre no navegador; o agente recebe resultados e identificadores, não palavras-passe.

Onde estão os recursos oficiais?

• Taisly Agent Kit
• Diretório de agentes
• Documentação MCP
• Documentação da API
• @taisly/agent no npm
• Taisly Agent Kit no GitHub
• Registo MCP oficial
• Perfil MCP na Glama

Comece com uma tarefa segura

Abra o assistente AI Agents Setup, escolha o agente e ligue a Taisly:

Utiliza a Taisly para listar as minhas contas sociais ligadas.
Diz-me quais estão prontas para publicar vídeo e que identificadores vais utilizar.
Ainda não cries nenhuma publicação.

Depois, o agente poderá validar, pedir aprovação, publicar, agendar, consultar o estado ou criar uma regra de republicação.