Ravenpost
Agende e publique posts no Instagram, TikTok, X, LinkedIn, Facebook, Telegram, Threads, Bluesky e YouTube — visualizando cada um exatamente como a rede o exibirá.
Documentação
Servidor MCP Ravenpost
Agende e publique posts em redes sociais para Instagram, TikTok, X, LinkedIn, Threads, Bluesky, YouTube, Pinterest e Telegram a partir do Claude, ChatGPT, Cursor, Claude Code ou qualquer outro cliente MCP.
Ravenpost é um agendador de redes sociais multiplataforma que cobre essas nove redes (Facebook Pages está construído, mas não está disponível no momento — a Meta permite que um app tenha apenas a permissão de Login do Instagram ou a família de permissões de Login do Facebook, e a Ravenpost escolheu o Instagram). Este repositório documenta seu servidor MCP hospedado, que expõe o mesmo fluxo de publicação para qualquer cliente MCP: liste as contas que você conectou, envie ou reformate mídia, visualize um post exatamente como cada rede o renderizará, e então publique agora, agende, ou coloque-o em uma fila semanal de posts.
O servidor é hospedado. Não há nada para instalar e nada para executar.
https://api.ravenpo.st/mcp
Transporte: HTTP Streamable. Entrada oficial no registro:
st.ravenpo/ravenpost.
Conectando
Duas formas, e a primeira não exige nenhum gerenciamento de credenciais.
OAuth (recomendado). Adicione a URL acima como um conector personalizado e faça login
quando seu cliente abrir a Ravenpost. O servidor é um servidor de recursos OAuth —
/.well-known/oauth-protected-resource nomeia o servidor de autorização e o
401 carrega o desafio — então um cliente que fala autorização MCP executa todo o
fluxo por conta própria.
Token de acesso pessoal. Para clientes sem fluxo de navegador. Gere um na Ravenpost em Configurações → Tokens MCP (mostrado uma vez, revogável a qualquer momento):
claude mcp add --transport http ravenpost https://api.ravenpo.st/mcp \
--header "Authorization: Bearer rvp_your_token"
Clientes que não podem definir cabeçalhos podem passá-lo na URL —
https://api.ravenpo.st/mcp?token=rvp_….
Você precisa de uma conta Ravenpost com pelo menos uma conta social conectada. O plano gratuito é suficiente para testar.
Ferramentas
22 ferramentas. Cada uma declara um título e dicas de somente leitura / destrutivas, para que seu cliente possa informar o que uma chamada fará antes de você permiti-la.
Contas
| Ferramenta | O que faz |
|---|---|
list_workspaces | Cada workspace em que a credencial pode atuar. Com mais de um, as outras ferramentas exigem um workspaceId em vez de adivinhar qual cliente você quis dizer. |
list_accounts | Contas conectadas com seus IDs, plataformas e status. |
Posts
| Ferramenta | O que faz |
|---|---|
list_posts | Lista posts recentes, opcionalmente filtrados por status. |
get_post | Um post com o status e o link permanente de cada destino. |
preview_post | Renderiza um post como cada plataforma o mostrará sem criar nada — um card interativo em clientes que suportam MCP Apps, e contagens de caracteres por plataforma em todos os outros. |
create_post | Rascunha, publica, agenda ou enfileira um post em qualquer conjunto de contas. |
update_post | Edita um rascunho ou post agendado — redefine-o para rascunho, então passe uma ação para reenviá-lo. |
delete_post | Exclui a cópia da Ravenpost e cancela uma publicação pendente. Nunca remove um post ao vivo de uma rede. |
schedule_post | Move um post para um novo horário. |
publish_post | Publica um post imediatamente. |
Mídia
| Ferramenta | O que faz |
|---|---|
upload_media | Envia uma imagem ou vídeo de uma URL, um caminho local (somente desenvolvimento) ou base64; imagens são reformatadas para o formato de plataforma que você nomear. |
create_media_upload | Envio direto pré-assinado — para arquivos grandes ou de produção, para que os bytes nunca passem pelo contexto do modelo. |
attach_media | Registra um envio direto como um ativo, reformatando uma imagem ou gravando um vídeo como está. |
create_variants | Corta uma imagem em várias telas de plataforma de uma vez, recortando no assunto em vez do meio. |
list_media | Ativos de mídia recentes, para reutilizar um em vez de reenviar. |
image_formats | Os formatos de imagem e dimensões de destino que upload_media aceita. |
Análises
| Ferramenta | O que faz |
|---|---|
get_analytics | Seguidores por conta e engajamento em posts recentes. |
best_times | Horários de publicação recomendados medidos a partir dos posts deste próprio workspace — com uma resposta explícita de "ainda não há dados suficientes" em vez de um palpite confiante. |
Referência
| Ferramenta | O que faz |
|---|---|
list_audio | Pesquisa o catálogo de áudio licenciado do Instagram para uma trilha de reel. |
list_queue_slots | O cronograma semanal de posts e o próximo espaço livre. |
list_boards | Os quadros do Pinterest que cada conta conectada possui — um pin precisa nomear um, e o Pinterest não tem padrão. |
platform_limits | Orçamentos de legenda, regras de mídia e especificações recomendadas por plataforma. |
Habilidades
As ferramentas são a capacidade; as habilidades são o julgamento sobre quando usar qual. Este repositório também é um plugin — quatro habilidades que ensinam a um assistente o fluxo de trabalho no qual as ferramentas se encaixam:
| Habilidade | O que ensina |
|---|---|
publish-a-social-post | Definir o workspace, escolher as contas, coletar o que cada destino exige, visualizar antes de escrever, e a confirmação que uma publicação precisa — porque publicar é a única etapa que não pode ser desfeita |
manage-scheduled-posts | Encontrar, editar, mover, cancelar e verificar posts — incluindo que editar redefine um post para rascunho, e que excluir remove nossa cópia em vez da versão ao vivo |
prepare-post-media | Como enviar arquivos, as quatro telas, cortar uma imagem para várias redes, e as regras de mídia nas quais um post realmente falha |
measure-and-time-posts | Ler análises sem transformar "não coletado" em zero, e citar best_times somente quando ele tem uma resposta |
plugin.json portable manifest (Agent Plugins 1.0.0)
.claude-plugin/plugin.json the same, for clients that read this path
.mcp.json points at the hosted server above
skills/<name>/SKILL.md one workflow each
skills/publish-a-social-post/references/
tools.md every tool, its arguments and what it returns
platforms.md caption budgets, media rules, per-platform limits
Ambos os arquivos de referência são gerados a partir dos próprios registros de ferramentas e do registro de plataformas do servidor, não transcritos — uma habilidade que descreve um argumento que o servidor não aceita mais é pior do que uma que não diz nada, porque o modelo a segue e a chamada falha.
Duas coisas que vale a pena saber
Visualize antes de publicar. preview_post não escreve nada. Ele retorna o post
como cada destino o renderiza, junto com os avisos que uma imagem não pode
carregar: uma legenda acima do limite da plataforma selecionada mais restrita, uma rede
que exige mídia quando não há nenhuma, um thread direcionado a uma plataforma sem modelo
de thread, áudio fora de um reel. Uma visualização que parece correta e fica em silêncio sobre uma
rejeição é pior do que nenhuma visualização.
Ele se recusa a adivinhar seu workspace. Uma credencial atua como um usuário, e um usuário pode executar vários workspaces (um por cliente, no plano Agency). Peça a uma ferramenta com escopo de workspace com mais de um disponível e ela retorna erro, nomeando-os, em vez de publicar o conteúdo de um cliente nas contas de outro.
Links
- Produto: https://ravenpo.st/
- O que o servidor MCP faz: https://ravenpo.st/mcp/
- Referência de ferramentas: https://ravenpo.st/docs/mcp/
- API REST: https://ravenpo.st/docs/api/
- Privacidade: https://ravenpo.st/privacy/ · Termos: https://ravenpo.st/terms/
- Suporte: support@ravenpo.st
Sobre este repositório
Documentação e o manifesto de registro (server.json) para um serviço hospedado.
O código-fonte da própria Ravenpost não é público. Problemas sobre o servidor MCP são bem-vindos
aqui; qualquer coisa específica de conta deve ir para o suporte.