PostBazooka

Servidor MCP OAuth remoto para ideias sociais com fonte, feedback da equipe, agendamento e publicação de posts aprovados em oito redes.

Documentação

Use o PostBazooka com um agente de IA

Conecte seu agente ao https://postbazooka.com/mcp com OAuth. O PostBazooka MCP é uma interface de texto/dados e ações; ele não incorpora um widget do PostBazooka.

Use seu agente para pesquisar, criar, editar, analisar, reagir, comentar, agendar, publicar e aprender com feedback de forma conversacional. Use o PostBazooka Feed para navegar e visualizar conteúdo, e use Scheduled para gerenciar visualmente publicações futuras e passadas.

Como um agente começa

A primeira chamada do PostBazooka deve ser sempre get_workflow. Essa resposta contém o fluxo de trabalho atual completo e um valor opaco em structuredContent.workflowVersion. O agente copia esse valor exato para a entrada obrigatória workflowVersion de toda chamada de ferramenta posterior. Ele nunca deve adivinhar o valor ou pedir que você o forneça.

Se o PostBazooka informar que o valor está desatualizado, a ação rejeitada não foi executada. O agente busca get_workflow novamente e tenta a ação inalterada uma vez. Se uma ferramenta nomeada pelo fluxo de trabalho estiver ausente, atualize ou reconecte a conexão do PostBazooka para que o agente receba o esquema atual de 26 ferramentas.

O que significa conclusão

O PostBazooka é o sistema de registro. Pesquisas, rascunhos escritos e imagens geradas com as ferramentas nativas do agente são resultados intermediários. Uma solicitação para adicionar ou alterar conteúdo do PostBazooka só é concluída após a mutação correspondente persistir o resultado:

  • Ideias por meio de create_ideas;
  • Posts e todos os anexos de mídia solicitados por meio de create_posts;
  • revisões por meio de edit_post;
  • agendamentos por meio de set_post_publishing ou set_connection_schedule;
  • publicação imediata por meio de publish_post_now.

Uma mutação só é bem-sucedida quando esse resultado direto exato da ferramenta contém structuredContent.operation.name e .requestId correspondentes, tem .operationCommitted: true e inclui POSTBAZOOKA COMMIT CONFIRMED no texto. Essa prova é autoritativa, então o agente a relata sem uma leitura de verificação separada ou nova tentativa desnecessária. Saída nula ou ausente, um erro de conector, tempo limite, isError: true, mídia gerada, argumentos enviados ou uma leitura posterior não são prova; o agente deve dizer que a alteração solicitada não foi confirmada.

Mídia, feedback e agendamento

Os agentes podem passar mídia existente da biblioteca, dados de imagem gerados, URLs públicas geradas, URLs públicas de propriedade do usuário ou mídia pública licenciada diretamente ao criar ou editar um Post. A mídia do Post deve ser gerada por IA, fornecida pelo usuário ou incluir evidência verificável de fonte, licença e atribuição pronta para exibição. A mídia retornada usa mediaId como seu identificador público de ativo e inclui uma URL HTTPS utilizável e informações de proveniência.

As entradas de mídia são deliberadamente planas para confiabilidade do conector. Criar com dados gerados usa um objeto de mídia formatado como { source: "generated_data", dataUrl, generator }. Substituir a mídia do Post usa { action: "replace", source: "generated_data", dataUrl, generator }; removê-la usa { action: "remove" }. Remoções de texto de plataforma usam campos explícitos removePlatformText ou clearPlatformText em vez de valores nulos.

Curtidas e não curtidas são feedback. A publicação automática usa a pontuação de reação, mas o agendamento explícito não cria uma curtida e não é silenciosamente cancelado por uma não curtida. Cada destino pode ser independentemente automático, agendado ou retido. publish_post_now é uma ação explícita separada que cria imediatamente snapshots imutáveis de Publicação.

Chamadas de agendamento também usam entradas planas. Uma decisão de publicação contém destinationId, mode e scheduledFor opcional; leituras de agendamento selecionam view: "upcoming" ou view: "history" em um único objeto.

Meu Agente é um conjunto de instruções para todo o espaço de trabalho. Reações humanas, comentários e edições de site se tornam feedback para revisão posterior do agente; ações do agente e de agendamento não criam loops de feedback.

O agente segue cursores de continuação quando os dados solicitados abrangem várias páginas. Resultados de projetos do espaço de trabalho contêm contagens de conexões em vez de uma lista ilimitada de destinos; o agente seleciona um projeto e segue seu cursor de conexão independente quando detalhes de destino são necessários. A capacidade do plano gratuito e a página de preços são incluídas quando um limite afeta uma solicitação. Planos pagos não têm cotas ordinárias de produto e permanecem sujeitos ao uso justo e aos limites dos provedores sociais.

Por exemplo, gerar uma imagem para um Post existente é apenas a etapa intermediária. O agente deve então chamar edit_post com essa fonte de mídia gerada e terminar somente quando o resultado direto da edição fornecer a prova de commit estruturada correspondente e POSTBAZOOKA COMMIT CONFIRMED. Decisões de publicação desbloqueadas existentes para destinos que permanecem no Post são preservadas. Se a edição não produzir resultado direto ou gerar um erro, ela não foi confirmada; uma imagem gerada ou uma leitura posterior não pode transformá-la em sucesso.