1forh/sendcove

Usando o Sendcove

O Sendcove é um agendador de mídias sociais. Seu servidor MCP fornece ferramentas para gerenciar os posts, mídia, análises e caixa de entrada do usuário. Se nenhuma ferramenta do Sendcove estiver disponível, diga ao usuário para conectar o Sendcove (guias de configuração: https://www.sendcove.app/features/mcp).

Comece pelas contas

1. Chame list_accounts antes de criar ou alterar um post. Passe os ids retornados como accountIds; o Sendcove descobre as plataformas a partir deles.
2. Se o usuário tiver várias contas e não disser qual usar, pergunte. Não publique em todas as contas por padrão.
3. Uma conta com needsReconnect: true falhará ao publicar. Diga ao usuário para reconectá-la no Sendcove.

Criando posts

• create_post cria um rascunho a menos que você defina status. Rascunhos são o padrão seguro: crie um, mostre ao usuário o que você fez e deixe-o agendar ou publicar.
• content é o texto padrão para todas as plataformas. Use platformContent para dar a uma plataforma seu próprio texto, por exemplo, uma versão de 280 caracteres para twitter e uma legenda mais longa para instagram. Chaves: twitter, instagram, tiktok, threads, bluesky, facebook, linkedin (strings) e youtube ({ title, description }).
• Opções por plataforma (tipo de post do Instagram, tipo e visibilidade do vídeo no YouTube, privacidade do TikTok, configurações de resposta do Bluesky, comunidade do X e assim por diante) vão em platformSettings. Obtenha os campos permitidos e valores do esquema de entrada da ferramenta e suas descrições, em vez de adivinhar. Antes de definir platformSettings.tiktok, chame get_tiktok_creator_info para os níveis de privacidade e interações que aquela conta permite.
• Os limites de caracteres são verificados quando o post é publicado: X 280, Bluesky 300, Threads 500, Instagram e TikTok 2200, LinkedIn 3000, título do YouTube 100 e descrição 5000. Mantenha o texto de cada plataforma dentro do seu limite (use platformContent) para que o post não falhe depois.
• Posts do Instagram e TikTok precisam de mídia; o YouTube precisa de um vídeo.
• Threads: passe posts de acompanhamento como threadItems (cada { content, mediaUrls? }). Eles são publicados como uma thread no X, Bluesky e Threads (Pro e Max); outras plataformas recebem apenas content. update_post com threadItems: [] interrompe o encadeamento.
• Hashtags: list_hashtag_sets retorna os conjuntos salvos do usuário (armazenados sem #).
• Passe um idempotencyKey (qualquer string única, de 8 a 200 caracteres) para create_post, duplicate_post e reply_to_inbox_item. Se uma chamada expirar ou você não tiver certeza de que foi concluída, tente novamente com a mesma chave: você obterá o primeiro resultado em vez de um post ou resposta duplicada.
• update_post altera apenas os campos que você passa, mas platformContent, platformSettings e threadItems substituem todo o valor armazenado. Chame get_post primeiro e envie o objeto completo.

Mídia

• A mídia deve estar na biblioteca de mídia do Sendcove do usuário antes de poder ir em mediaUrls. list_media mostra o que já está lá.
• Uma URL https pública: upload_media_from_url, depois use a url retornada.
• Um arquivo local: chame create_media_upload_url e execute o comando curl retornado com o caminho real do arquivo (por exemplo curl -s -X POST '<uploadUrl>' -F 'file=@/caminho/para/foto.jpg'). A resposta JSON tem a url a ser usada. A URL de upload dura 10 minutos e não precisa de chave de API. Para arquivos com mais de 4 MB, passe contentType e execute os dois comandos retornados (PUT para o armazenamento, depois o POST de finalização) nessa ordem. Adicione -F convertForInstagram=true para converter uma imagem para JPEG para o Instagram.
• Tipos permitidos: JPEG, PNG, GIF, WebP, MP4, MOV, AVI.

Agendamento e publicação

Agende, publique ou responda apenas quando o usuário solicitar nesta conversa. Escrever um post não é permissão para publicá-lo.

• Agendar: status: "scheduled" com scheduledFor como ISO 8601 com offset (2026-11-20T15:00:00Z). Converta o horário local do usuário e confirme o fuso horário se não estiver claro. Ou passe nextOpenSlot: true para usar o próximo horário livre de postagem que o usuário definiu para essas contas.
• Publicar agora: status: "pending" em create_post, ou publish_post para um post existente.
• Após a publicação, chame get_post: cada conta tem seu próprio status (published, failed, pending) e error. Um post com falha geralmente significa que uma conta falhou. publish_post nesse post tenta novamente apenas as contas com falha; nunca república onde já está ativo.
• delete_post não pode ser desfeito. Confirme antes de excluir.

Conexões apenas para rascunhos (403)

Agendar, publicar e responder exigem um plano Pro ou Max e uma conexão que permita a publicação. No plano Basic, ou com uma chave de API ou aplicativo conectado definido como apenas rascunhos, essas chamadas retornam 403 "Esta chave de API ou aplicativo conectado só pode criar rascunhos".

Quando isso acontecer, não tente novamente e não contorne. Salve o post como rascunho e diga ao usuário:

Salvei isso como rascunho no Sendcove. Esta conexão é apenas para rascunhos, então não posso agendar ou publicar. Para me permitir publicar, você precisa de um plano Pro ou Max, depois reconecte o Sendcove aqui e escolha "Permitir publicação" (ou use uma chave de API criada com "Permitir publicação" ativado, em Conta > Chaves de API no Sendcove). Você também pode agendar o rascunho você mesmo no Sendcove.

Análises e caixa de entrada

• get_engagement: totais, detalhamento por plataforma, principais posts e os melhores posts recentes de cada conta em relação à sua própria mediana (timesMedian mostra o quanto um post foi melhor, não o porquê).
• get_post_analytics: métricas de um post publicado por conta; passe refresh: true para números atualizados (armazenados em cache por uma hora). Nem toda plataforma relata todas as métricas.
• get_best_times: melhores dias e horários para postar, com base no engajamento do próprio usuário.
• list_inbox / get_inbox_item: respostas, menções e comentários. reply_to_inbox_item posta uma resposta pública, então mostre o texto ao usuário e obtenha uma confirmação primeiro. update_inbox_item marca itens como lidos, não lidos ou arquivados.