API e MCP
Docs da API e do MCP
Crie uma chave em Painel > API, depois publique um post em todas as contas com uma chamada. Chaves começam com pt_live_. Limite: 60 requisições por minuto.
1. Publicar agora
curl -X POST https://api.publishum.com/v1/posts \
-H "Authorization: Bearer pt_live_SUA_CHAVE" \
-H "Content-Type: application/json" \
-d '{"texto": "Lançamos o Publishum hoje. Poste em todas as redes de uma vez. Link na bio.", "contas": "todas"}'2. Agendar com texto por rede e mídia
{
"texto": "Lançamos o Publishum hoje. Poste em todas as redes de uma vez. Link na bio.",
"por_rede": {
"x": {
"texto": "Lançamos o Publishum hoje. Poste em todas as redes de uma vez. Link na bio.",
"primeira_resposta": "https://publishum.com"
},
"linkedin": {
"texto": "Três erros que cometi contratando o primeiro funcionário, e o que faria diferente hoje. Fio completo nos comentários."
}
},
"contas": [
"acc_x",
"acc_th",
"acc_bs",
"acc_li"
],
"midia": [
{
"id": "med_8f2k1",
"alt": "Publishum"
}
],
"agendar_para": "2026-10-13T09:00:00-03:00"
}3. Conectar ao Claude pelo MCP
claude mcp add --transport http publishum https://api.publishum.com/mcpRotas
| Rota | O que faz |
|---|---|
POST /v1/posts | Cria, agenda ou publica um post |
GET /v1/posts | Lista posts com filtros de status e conta |
GET /v1/posts/{id} | Detalhe com resultado por rede |
PATCH /v1/posts/{id} | Edita post agendado ou rascunho |
DELETE /v1/posts/{id} | Exclui agendado ou rascunho |
GET /v1/contas | Contas conectadas e validade do token |
POST /v1/midia | Devolve URL assinada para upload |
Limites e erros
Posts com link no X contam na cota do plano (10 no Solo, 50 no Criador, 150 no Estúdio). A API devolve erro 402 com a mensagem quando a cota acaba.
Ferramentas do MCP
listar_contascriar_postlistar_postsver_posteditar_postexcluir_postenviar_midiapedir_link_de_uploadresultados_do_post