Skip to main content
Glama

postsmith

Servidor MCP que transforma o seu agente (Claude Code, opencode, Cursor...) num estúdio de posts de Instagram para várias marcas.

Cada marca tem paleta, fontes, voz, CTA e assets próprios. O agente escreve os slides em HTML+CSS, o postsmith renderiza em PNG no tamanho certo e salva junto com a legenda. Também gera imagens, vídeos e variações de mascote via OpenRouter.

Como funciona

  1. post_brief monta um briefing para o tema: objetivo (salvar, alcance, conversão...), ideias criativas, esquema de cores e tipografia sorteados, regras de layout e de legenda, e os posts recentes da marca para não repetir.

  2. O agente escreve cada slide em HTML+CSS (gráficos em SVG com dados reais) e a legenda.

  3. render_post renderiza os slides com Chrome (Playwright), devolve as imagens para o agente revisar e salva tudo em outputs/<marca>/posts/<data>-<slug>/.

Related MCP server: AdaptlyPost

Ferramentas

Ferramenta

O que faz

list_brands / save_brand

Lista e cria/atualiza marcas

asset_variation

Gera uma nova pose do mascote ou uma cópia com fundo transparente a partir de uma referência

post_brief

Briefing criativo para um post

render_post

Renderiza os slides em PNG e salva a legenda

generate_image

Imagem avulsa (texto→imagem ou imagem→imagem)

generate_video / get_video

Vídeo avulso (texto, imagem ou referência→vídeo)

chat

Prompt para qualquer modelo de chat do OpenRouter

list_models / get_credits

Modelos disponíveis e saldo no OpenRouter

Formatos: feed (1080×1350), square (1080×1080) e story (1080×1920).

Requisitos

  • Bun

  • Google Chrome instalado (ou o caminho de outro Chromium em POSTSMITH_CHROME_PATH)

  • Uma chave do OpenRouter, necessária só para gerar mídia e usar chat

Instalação

git clone https://github.com/eduumach/postsmith.git
cd postsmith
bun install
export OPENROUTER_API_KEY=sk-or-...

O repositório já traz .mcp.json (Claude Code) e opencode.json (opencode). É só abrir o agente dentro da pasta. Em outro cliente MCP:

{
  "mcpServers": {
    "postsmith": {
      "command": "bun",
      "args": ["/caminho/para/postsmith/src/index.ts"],
      "env": { "OPENROUTER_API_KEY": "sk-or-..." }
    }
  }
}

Depois é só pedir: "cria um carrossel da marca exemplo sobre os métodos de preparo de café".

Marcas

Cada marca é uma pasta em brands/<id>/:

brands/exemplo/
├── brand.json     # nome, @, público, paleta, fontes, voz, regras, CTA, hashtags, fatos verificados
├── assets/        # logo, mascote e outros PNGs transparentes que os slides podem usar
└── referencias/   # posts que a marca considera bons, usados como régua de qualidade

Veja brands/exemplo/brand.json. Também dá para criar uma marca pedindo ao agente, que usa save_brand. As marcas ficam fora do git (só a de exemplo é versionada).

Variáveis de ambiente

Variável

Padrão

Uso

OPENROUTER_API_KEY

Chave do OpenRouter

POSTSMITH_BRANDS_DIR

./brands

Pasta das marcas

POSTSMITH_OUTPUT_DIR

./outputs

Onde salvar posts e mídia

POSTSMITH_BRAND

Marca padrão quando há mais de uma

POSTSMITH_CHROME_PATH

Chrome do sistema

Executável do navegador para renderizar

Desenvolvimento

bun start          # roda o servidor via stdio
bun run typecheck

Licença

MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      A memory-backed brand generation runtime for agent-led creative iteration. Enables AI agents to plan, generate, review, and improve brand materials with persistent brand memory and structured workflows.
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Gives AI agents the ability to schedule and publish social media posts to Instagram, TikTok, YouTube, X, LinkedIn, Facebook, Pinterest, Threads, and Bluesky. Create, schedule, and bulk-plan posts with per-platform captions, then check per-platform results and retry failures.
      90
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Connects AI agents to an Instagram content hub where they can research public accounts and competitors, get full reel breakdowns with transcripts and hooks, and write strategies, scripts and carousels into editable designs. Workspaces, content plans, boards, assets and voice guides persist server-side so every session starts from the same place.
      2
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables coding agents to create a reusable brand mascot and generate consistent poses, emotions, compositions, and transparent animations, then place the finished PNG, SVG, or WebM assets directly into a project.
      MIT