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: PostWire

Ferramentas

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

Desenvolvimento

bun start          # roda o servidor via stdio
bun run typecheck

Licença

MIT