Construa um Agente de Publicação no Medium com Draft-First

Publicar o mesmo artigo técnico em mais de uma plataforma parece uma tarefa de copiar e colar. Na prática, a parte arriscada é decidir o que um agente de IA pode fazer com uma sessão de navegador autenticada.

Este tutorial constrói um fluxo de trabalho no Medium que prioriza o rascunho com publish-agents, um projeto de código aberto em TypeScript de Fernando Paladini. O pacote @paladini/medium-publisher-mcp@ expõe operações de publicação no Medium através do Modelo de Protocolo de Contexto, enquanto mantém login, importação, revisão e publicação ao vivo como decisões separadas.

TL;DR

Instale o pacote estável v0.2.3, faça login uma vez, registre seu servidor MCP stdio e peça ao seu cliente MCP para importar um artigo público do DEV.to com publish: false. O agente pode preparar e inspecionar um rascunho, mas você mantém a aprovação para autenticação do navegador, alterações de formatação e publicação.

O que você irá construir

O fluxo resultante tem quatro limites:

1. Um artigo público do DEV.to fornece o Markdown fonte.
2. O servidor MCP local expõe ferramentas de publicação para um cliente de IA.
3. Patchright usa uma sessão de navegador salva para trabalhar no Medium.
4. Um humano revisa o editor real antes de qualquer publicação ao vivo.

O MCP padroniza como um host se conecta a ferramentas, mas não torna uma ferramenta segura por si só. A documentação do protocolo descreve ferramentas como capacidades que precisam de consentimento e autorização cuidadosa. É por isso que este exemplo usa um rascunho como resultado padrão.

Pré-requisitos

Você precisa:

• Node.js 20 ou mais recente.
• Um cliente compatível com MCP, como Cursor ou Claude Code.
• Uma conta no Medium que possa criar histórias.
• Um artigo publicado no DEV.to com uma URL pública.
• Permissão para instalar o navegador Chromium incluído localmente.

A referência de lançamento testada é v0.2.3. O pacote declara a versão @paladini/medium-publisher-mcp 0.2.3, requer Node.js >=20, usa Patchright e é licenciado sob MIT.

Instale o pacote estável

O caminho mais curto instala o pacote npm publicado:

npm install -g @paladini/medium-publisher-mcp

O pacote expõe dois comandos: medium-publisher para o CLI e medium-publisher-mcp para o servidor MCP. Seu script pós-instalação solicita o navegador Chromium do Patchright. Se seu gerenciador de pacotes pulou essa etapa, siga a documentação de instalação do Patchright antes de tentar a automação do navegador.

Você pode verificar se o CLI está no seu PATH sem fazer login:

medium-publisher --help

Se você preferir um checkout de fonte, o repositório estável documenta este caminho equivalente:

git clone https://github.com/paladini/publish-agents.git
cd publish-agents
git checkout v0.2.3
npm install
npm run build -w @paladini/medium-publisher-mcp
npm link -w @paladini/medium-publisher-mcp

Crie a sessão de navegador local

O login é interativo porque a ferramenta precisa de uma sessão do Medium, não de uma chave de API do Medium:

medium-publisher login

O padrão documentado para Windows é %LOCALAPPDATA%\medium-publisher\storageState.json. O pacote também suporta MEDIUM_STATE_PATH e MEDIUM_PUBLISHER_HOME quando você precisa de uma localização local diferente.

Verifique a sessão na saída estruturada:

medium-publisher session-check --json

Trate storageState.json como um armazenamento de credenciais. Não o comite, anexe a um problema ou coloque em um artefato CI. Um perfil de navegador local pode conter cookies que concedem acesso à sua conta do Medium.

Registre o servidor MCP

O servidor usa stdio. Uma configuração mínima do MCP é:

{
  "mcpServers": {
    "medium-publisher": {
      "command": "medium-publisher-mcp"
    }
  }
}

O repositório inclui notas de configuração específicas do cliente para Cursor e Claude Code. Após registrar o servidor, reinicie ou recarregue o cliente para que ele descubra as ferramentas.

O pacote expõe sete ferramentas na versão documentada. As mais importantes para este fluxo de trabalho são medium_session_check, medium_publish_from_devto, medium_extract, medium_fix_draft e medium_open_draft.

Importar um artigo do DEV.to como rascunho

Peça ao cliente MCP para chamar o servidor com uma URL de artigo público e uma instrução explícita de não publicação:

{
  "devto_url": "https://dev.to/your-name/your-tutorial"