mcp-reddit-publisher

Servidor MCP para publicar no Reddit com segurança, feito para ser instalado do jeito mais simples possível em Claude, Codex, OpenCode e qualquer cliente MCP via stdio.

Repo: https://github.com/uptrixbr/mcp-reddit-publisher Pacote npm: mcp-reddit-publisher

Instalação rápida

Você NÃO precisa clonar o projeto nem rodar build manual.

Use direto via npm/npx:

npx -y mcp-reddit-publisher --help

Para gerar uma configuração pronta para o seu cliente:

npx -y mcp-reddit-publisher setup claude \
  --client-id "SEU_REDDIT_CLIENT_ID" \
  --client-secret "SEU_REDDIT_CLIENT_SECRET" \
  --refresh-token "SEU_REDDIT_REFRESH_TOKEN" \
  --user-agent "mcp-reddit-publisher/0.1.0 by u/SEU_USUARIO" \
  --allowed "SideProject,saas,startups" \
  --dry-run true

Troque claude por codex ou opencode:

npx -y mcp-reddit-publisher setup codex ...
npx -y mcp-reddit-publisher setup opencode ...

O comando imprime o bloco de configuração MCP já pronto para copiar e colar.

Fallback sem npm registry, direto do GitHub:

npx -y github:uptrixbr/mcp-reddit-publisher --help

Credenciais Reddit

Você precisa criar um app Reddit uma vez:

1. Acesse https://www.reddit.com/prefs/apps
2. Clique em create another app.
3. Escolha o tipo script para uso pessoal/local.
4. Copie:
   • client_id
   • client_secret
5. Configure um user agent descritivo, exemplo:

mcp-reddit-publisher/0.1.0 by u/seu_usuario

Autenticação recomendada:

REDDIT_REFRESH_TOKEN

Alternativa para app do tipo script:

REDDIT_USERNAME + REDDIT_PASSWORD

Claude Desktop / Claude Code

Gere o config:

npx -y mcp-reddit-publisher setup claude \
  --client-id "..." \
  --client-secret "..." \
  --refresh-token "..." \
  --user-agent "mcp-reddit-publisher/0.1.0 by u/SEU_USUARIO" \
  --allowed "SideProject,saas" \
  --dry-run true

Saída esperada:

{
  "mcpServers": {
    "reddit-publisher": {
      "command": "npx",
      "args": ["-y", "mcp-reddit-publisher"],
      "env": {
        "REDDIT_CLIENT_ID": "...",
        "REDDIT_CLIENT_SECRET": "...",
        "REDDIT_REFRESH_TOKEN": "...",
        "REDDIT_USER_AGENT": "mcp-reddit-publisher/0.1.0 by u/SEU_USUARIO",
        "REDDIT_DRY_RUN": "true"
      }
    }
  }
}

Cole no arquivo de configuração MCP do Claude e reinicie o Claude.

Codex

Gere o config:

npx -y mcp-reddit-publisher setup codex \
  --client-id "..." \
  --client-secret "..." \
  --refresh-token "..." \
  --user-agent "mcp-reddit-publisher/0.1.0 by u/SEU_USUARIO" \
  --dry-run true

Saída esperada em TOML:

[mcp_servers.reddit-publisher]
command = "npx"
args = ["-y", "mcp-reddit-publisher"]
env.REDDIT_CLIENT_ID = "..."
env.REDDIT_CLIENT_SECRET = "..."
env.REDDIT_REFRESH_TOKEN = "..."
env.REDDIT_USER_AGENT = "mcp-reddit-publisher/0.1.0 by u/SEU_USUARIO"
env.REDDIT_DRY_RUN = "true"

Adicione ao config.toml do Codex e reinicie o Codex.

OpenCode

Gere o config:

npx -y mcp-reddit-publisher setup opencode \
  --client-id "..." \
  --client-secret "..." \
  --refresh-token "..." \
  --user-agent "mcp-reddit-publisher/0.1.0 by u/SEU_USUARIO" \
  --dry-run true

Saída esperada:

{
  "mcp": {
    "reddit-publisher": {
      "type": "local",
      "command": "npx -y mcp-reddit-publisher",
      "enabled": true,
      "environment": {
        "REDDIT_CLIENT_ID": "...",
        "REDDIT_CLIENT_SECRET": "...",
        "REDDIT_REFRESH_TOKEN": "...",
        "REDDIT_USER_AGENT": "mcp-reddit-publisher/0.1.0 by u/SEU_USUARIO",
        "REDDIT_DRY_RUN": "true"
      }
    }
  }
}

Adicione ao arquivo de configuração do OpenCode e reinicie o OpenCode.

OpenAI Agents / outros clientes MCP

Use o servidor stdio:

{
  "command": "npx",
  "args": ["-y", "mcp-reddit-publisher"],
  "env": {
    "REDDIT_CLIENT_ID": "...",
    "REDDIT_CLIENT_SECRET": "...",
    "REDDIT_REFRESH_TOKEN": "...",
    "REDDIT_USER_AGENT": "mcp-reddit-publisher/0.1.0 by u/SEU_USUARIO",
    "REDDIT_DRY_RUN": "true"
  }
}

Ferramentas MCP disponíveis

• health: valida a configuração sem expor secrets.
• search_subreddits: busca comunidades por termo.
• get_subreddit_rules: lê regras do subreddit e aponta riscos.
• preview_text_post: valida e mostra o post sem publicar.
• submit_text_post: publica o post, respeitando dry-run, allowlist, checagem de regras e rate limit.

Segurança por padrão

Por padrão, nada é publicado:

REDDIT_DRY_RUN=true

Recomendações:

REDDIT_ALLOWED_SUBREDDITS=SideProject,saas,startups
REDDIT_REQUIRE_RULE_CHECK=true
REDDIT_MIN_SECONDS_BETWEEN_POSTS=300

Só mude para publicação real depois de testar:

REDDIT_DRY_RUN=false

Exemplo de prompt depois de instalar

Use o reddit-publisher para buscar subreddits sobre SaaS, verificar as regras de r/SideProject e preparar um post pedindo feedback. Faça apenas preview, não publique.

Depois, se estiver tudo certo e REDDIT_DRY_RUN=false:

Publique em r/SideProject somente se as regras permitirem e me retorne o permalink.

Desenvolvimento local

git clone https://github.com/uptrixbr/mcp-reddit-publisher.git
cd mcp-reddit-publisher
npm install
npm run typecheck
npm test
npm run build
node scripts/smoke.mjs

Licença

Uso permitido para uso pessoal, avaliação, integrações e uso interno.

Não é permitido vender, redistribuir comercialmente, republicar como seu, remover créditos, fazer white-label ou oferecer como produto/SaaS/serviço próprio sem autorização por escrito.

Crédito obrigatório: MCP Reddit Publisher by Samuel Novaes / UptrixBR.

Veja LICENSE.