Documentação · MCP
Referência de ferramentas
Esta referência cobre as 12 ferramentas de produto registradas nesta versão do Postora. O cliente pode mostrar um prefixo com o nome do servidor. Consulte o esquema retornado pela conexão para os tipos completos.
Listar canais
integrationList
Entrada: group?: string. Sem group, lista os canais da organização. Use um ID retornado por groupList para filtrar por cliente.
Retorna os IDs, nomes, plataformas e imagens dos canais. Consulta sem publicar conteúdo.
Listar grupos de clientes
groupList
Entrada: Objeto vazio: {}.
Retorna id e name de cada grupo. Use o id no filtro de integrationList.
Consultar regras de uma rede
integrationSchema
Entrada: platform: string, identificador retornado por integrationList. isPremium: boolean, informe false quando não se aplicar.
Retorna rules, maxLength, settings e tools. Consulte antes de criar posts; os campos e limites variam por rede e tipo de conta.
Buscar opções de uma conexão
triggerTool
Entrada: integrationId: string, methodName: string e dataSchema: Array<{ key: string, value: string }>. Use um método e os parâmetros indicados por integrationSchema.
Consulta opções como identificadores exigidos pelas configurações da rede. Pode contatar a rede e renovar a conexão; não aceita métodos arbitrários.
Criar rascunhos e publicações
integrationSchedulePostTool
Entrada: socialPost: lista de posts. Cada item exige integrationId: string, isPremium: boolean, date: string em UTC, shortLink: boolean, type: "draft" | "schedule" | "now", postsAndComments e settings.
Retorna postId e integration dos posts criados ou erros de validação. type="now" publica imediatamente. A operação não é idempotente: repetir pode criar duplicatas.
Consultar posts de um período
postsListTool
Entrada: startDate: string e endDate: string, ambas em UTC. customer?: string, ID de grupo retornado por groupList, para filtrar pelos canais de um cliente.
Retorna posts cuja data está no intervalo, incluindo rascunhos, agendados, publicados e com erro. Inclui id, data, estado, conteúdo, canal e configurações.
Alterar configurações de um post
postSettingsTool
Entrada: id: string, retornado por postsListTool. settings: Array<{ key: string, value: valor do campo }>. Consulte integrationSchema para os campos aceitos.
Mescla somente as configurações enviadas em um rascunho ou post ainda não publicado. Não altera o texto nem a data. Não exclui posts. Retorna postId e publishDate ou um erro.
Importar mídia de uma URL
uploadFromUrlTool
Entrada: url: string com uma URL pública de imagem ou vídeo.
Salva o arquivo na biblioteca e retorna id e path, ou error. Aceita JPEG, PNG, GIF, WebP, AVIF, BMP, TIFF e MP4. Limites: 10 MiB por imagem e 1 GiB por vídeo. O formato ainda precisa ser aceito pela rede de destino.
Gerar uma imagem
generateImageTool
Entrada: prompt: string.
Gera e salva uma imagem, retornando id e path. Usa o provedor de IA configurado pelo Postora e créditos de imagem da organização. A permissão para o gerador no app depende do plano.
Consultar opções de geração de vídeo
generateVideoOptions
Entrada: reasoning?: string, uma justificativa curta opcional.
Retorna tipos de vídeo, orientação, ferramentas auxiliares e esquema dos parâmetros. A lista de opções não garante que todos estejam disponíveis no teste grátis.
Consultar parâmetros auxiliares de vídeo
videoFunctionTool
Entrada: identifier: string e functionName: string, conforme generateVideoOptions.
Retorna opções auxiliares, como vozes. Use somente funções indicadas para o gerador escolhido.
Gerar um vídeo
generateVideoTool
Entrada: identifier: string, output: "vertical" | "horizontal" e customParams: Array<{ key: string, value: valor do campo }> conforme o esquema do gerador.
Retorna url ou error. Depende dos provedores configurados e dos créditos de vídeo. Alguns geradores não permitem uso durante o teste grátis.
Estrutura de uma publicação
Em postsAndComments, o primeiro item é o post, e os demais são comentários ou respostas, quando a rede permite. Cada item exige content: string em HTML e attachments: string[]. Use parágrafos <p>…</p>; os elementos aceitos são h1, h2, h3, u, strong, li, ul e p. Não combine u e strong.
As URLs dos anexos precisam usar domínios de upload permitidos e extensões aceitas. Importe mídias externas com uploadFromUrlTool e use o path retornado. Configurações usam uma lista de objetos { key, value }, com valores definidos pelo esquema da rede.
Use datas em UTC e confira o fuso com a pessoa que pediu o agendamento. Rascunhos ainda precisam de conteúdo ou mídia; a validação completa de formato e tamanho é exigida para publicar. Não trate um rascunho salvo como garantia de que ele está pronto para ir ao ar.
postSettingsTool não altera o texto nem a data de um post existente. Não há ferramenta de exclusão. Use o app para editar conteúdo, reagendar ou excluir.