Publique programaticamente em 15 plataformas com uma única chamada de API. Criado para desenvolvedores, agentes de IA, LLMs e fluxos de trabalho autônomos que precisam de automação confiável de redes sociais sem sessões de navegador ou interação manual.

from bulkpublish import BulkPublish

bp = BulkPublish("bp_sua_chave_aqui")
bp.posts.create(
    content="Lançando nosso novo produto hoje!",
    channels=[{"channelId": 1, "platform": "x"}, {"channelId": 2, "platform": "linkedin"}],
    status="scheduled",
    scheduled_at="2026-04-10T09:00:00Z",
)

Por que BulkPublish?

A maioria das ferramentas de redes sociais é construída para humanos clicando em botões. A BulkPublish é construída para código — seja esse código escrito por um desenvolvedor, um agente de IA, um LLM com uso de ferramentas ou um fluxo de trabalho autônomo.

Headless por design — Sem navegador, sem interface, sem pop-ups de OAuth em tempo de execução. Conecte contas uma vez no painel de controle e automatize tudo via API.
Nativo para IA — Servidor MCP para Claude, definições de ferramentas para GPT e LangChain, respostas JSON estruturadas que LLMs analisam de forma confiável.
Pronto para agentes — API determinística com códigos de erro claros. Agentes de IA podem criar postagens, verificar status, repetir falhas e ler análises de forma autônoma.
15 plataformas, um endpoint — Facebook, Instagram, X/Twitter, TikTok, YouTube, Threads, Bluesky, Pinterest, Google Business Profile, LinkedIn, Mastodon, Discord, Telegram, Tumblr, Snapchat.

Casos de Uso

Gerentes de redes sociais com IA — Deixe o Claude, GPT ou agentes personalizados agendarem e publicarem postagens autonomamente
Pipelines de conteúdo — Automação de RSS-para-redes-sociais, blog-para-redes-sociais, newsletter-para-redes-sociais
Agendamento em lote — Carregue um CSV ou alimente um calendário de conteúdo e agende semanas de postagens programaticamente
Sindicação entre plataformas — Publique uma vez em todas as plataformas com otimização de conteúdo por plataforma
Painéis de análise — Obtenha dados de engajamento em suas próprias ferramentas, planilhas ou análise de IA
Alternativas ao Zapier/n8n/Make — Acesso direto à API sem middleware, menor latência, mais controle
Criação de conteúdo com LLM — Gere conteúdo com IA, publique com BulkPublish, acompanhe o desempenho, itere

Início Rápido

1. Cadastre-se

Crie uma conta gratuita em app.bulkpublish.com.

2. Obtenha sua chave de API

Vá para Configurações > Desenvolvedor no painel de controle e crie uma chave de API. As chaves começam com bp_ e são mostradas apenas uma vez — salve-a com segurança.

3. Conecte as plataformas

Conecte suas contas de redes sociais no painel de controle em Canais. A API usa seus canais conectados para publicar.

4. Instale um SDK

Python

pip install bulkpublish

Node.js

npm install bulkpublish

Homebrew (macOS/Linux)

brew tap azeemkafridi/bulkpublish && brew install bulkpublish

Ou chame a API REST diretamente com curl, fetch, requests ou qualquer cliente HTTP.

5. Faça sua primeira chamada de API

curl -X POST https://app.bulkpublish.com/api/posts \
  -H "Authorization: Bearer bp_sua_chave_aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Olá da API BulkPublish!",
    "channels": [{"channelId": 1, "platform": "linkedin"}],
    "status": "draft"
  }'

Integração com Agentes de IA

Servidor MCP (Claude, Cursor, Windsurf, Claude Code)

A BulkPublish vem com um servidor MCP para que assistentes de IA possam gerenciar suas redes sociais diretamente:

{
  "mcpServers": {
    "bulkpublish": {
      "command": "npx",
      "args": ["-y", "@bulkpublish/mcp-server"],
      "env": {
        "BULKPUBLISH_API_KEY": "bp_sua_chave_aqui"
      }
    }
  }
}

50 ferramentas disponíveis: create_post, list_channels, upload_media, get_analytics, o compositor interativo compose_post (aplicativos MCP) e muito mais. Executa localmente (stdio) ou hospedado via Streamable HTTP em https://mcp.bulkpublish.com/mcp. Veja mcp-server/README.md.

Habilidades de Conteúdo para Redes Sociais

A BulkPublish inclui uma biblioteca de 24 habilidades para agentes de IA planejarem, adaptarem, revisarem, agendarem e publicarem conteúdo de redes sociais: Habilidades de Conteúdo para Redes Sociais.

Uso de Ferramentas LLM / Chamada de Função

Definições de ferramentas prontas para agentes de IA autônomos:

Exemplo de tool_use do Claude — SDK Anthropic com definições de ferramentas para agendamento de postagens
Exemplo de chamada de função OpenAI — GPT-4 com funções para gerenciamento de postagens
Exemplo de ferramenta LangChain — Agente LangChain com ferramentas BulkPublish

Todos os exemplos são scripts completos e executáveis com tratamento de erros.

Exemplos de Código

Criar uma Postagem

from bulkpublish import BulkPublish

bp = BulkPublish("bp_sua_chave_aqui")

post = bp.posts.create(
    content="Confira nossa última atualização!",
    channels=[
        {"channelId": 1, "platform": "facebook"},
        {"channelId": 2, "platform": "x"},
        {"channelId": 3, "platform": "linkedin"},
    ],
    status="draft",
)

import { BulkPublish } from 'bulkpublish';

const bp = new BulkPublish({ apiKey: 'bp_sua_chave_aqui' });

const post = await bp.posts.create({
  content: 'Confira nossa última atualização!',
  channels: [
    { channelId: 1, platform: 'facebook' },
    { channelId: 2, platform: 'x' },
    { channelId: 3, platform: 'linkedin' },
  ],
  status: 'draft',
});

Agendar uma Postagem

post = bp.posts.create(
    content="Isso vai ao ar amanhã de manhã.",
    channels=[{"channelId": 1, "platform": "instagram"}],
    status="scheduled",
    scheduled_at="2026-04-10T09:00:00Z",
    timezone="America/New_York",
)

Enviar Mídia e Publicar

media = bp.media.upload("./foto-do-produto.jpg")

post = bp.posts.create(
    content="Nosso produto mais novo está aqui.",
    channels=[{"channelId": 1, "platform": "instagram"}],
    media_files=[media["file"]["id"]],
    status="scheduled",
    scheduled_at="2026-04-10T12:00:00Z",
)

Exemplo de Automação: Agendamento em Lote a partir de CSV

import csv
from bulkpublish import BulkPublish

bp = BulkPublish("bp_sua_chave_aqui")
channels = bp.channels.list()["channels"]

with open("calendario-de-conteudo.csv") as f:
    for row in csv.DictReader(f):
        bp.posts.create(
            content=row["content"],
            channels=[{"channelId": ch["id"], "platform": ch["platform"]} for ch in channels],
            status="scheduled",
            scheduled_at=row["scheduled_at"],
            timezone="America/New_York",
        )

Mais exemplos em examples/ — incluindo scripts de automação em Python, exemplos em Node.js, referência curl e integrações com agentes de IA.

Recursos

15 plataformas — Facebook, Instagram, X/Twitter, TikTok, YouTube, Threads, Bluesky, Pinterest, Google Business Profile, LinkedIn, Mastodon, Discord, Telegram, Tumblr, Snapchat
Agendamento — Agende postagens para qualquer horário futuro com suporte a fuso horário, ou deixe os slots de fila escolherem horários ideais
Uploads de mídia — Imagens (JPEG, PNG, WebP, GIF) e vídeos (MP4, MOV, WebM) de até 100 MB
Agendas recorrentes — Repita postagens diariamente, semanalmente, quinzenalmente ou mensalmente em um horário definido
Análises — Acompanhe impressões, curtidas, comentários, compartilhamentos e engajamento. Cada plataforma relata um subconjunto diferente de métricas, e a resposta informa quais (supportedMetrics / supportedTotals) para que um 0 nunca seja confundido com uma medição — veja Métricas por Plataforma
Rastreamento de links — Opte por organização, ou por postagem via linkTrackingOverride, para reescrever links através de bulkpubli.sh e contar os cliques. Relatado como linkClicks / totalLinkClicks e medido pela BulkPublish em vez da plataforma, funcionando mesmo onde a plataforma não reporta nada — veja Limites de Caracteres
Rótulos — Organize postagens e mídia com rótulos coloridos
Operações em lote — Exclua ou tente novamente várias postagens em uma única requisição
Tópicos — Postagens multipartes em tópicos para X, Threads, Bluesky e Mastodon
Primeiro comentário automático — Adicione automaticamente um comentário após a publicação em qualquer plataforma
Todos os tipos de postagem — Reels, Stories, Carrosséis, Tópicos, Shorts, Vídeo — defina por plataforma via postTypeOverrides
Conteúdo por plataforma — Personalize texto e opções por plataforma em uma única postagem
Opções específicas da plataforma — Colaboradores do Instagram, privacidade do TikTok, categorias do YouTube, quadros do Pinterest e muito mais

Referência da API

Documentação interativa completa da API: app.bulkpublish.com/docs

URL Base

https://app.bulkpublish.com

Autenticação

Authorization: Bearer bp_sua_chave_aqui

Endpoints Principais

Método	Endpoint	Descrição
`POST`	`/api/posts`	Criar uma postagem (rascunho, agendada ou imediata)
`GET`	`/api/posts`	Listar postagens (paginadas, filtráveis por status/data/canal/rótulo)
`GET`	`/api/posts/:id`	Obter uma postagem com status e métricas das plataformas
`PUT`	`/api/posts/:id`	Atualizar um rascunho ou postagem agendada
`DELETE`	`/api/posts/:id`	Excluir uma postagem
`POST`	`/api/posts/:id/publish`	Publicar um rascunho imediatamente
`POST`	`/api/posts/:id/retry`	Repetir tentativa em plataformas com falha
`POST`	`/api/posts/:id/approve`	Aprovar uma postagem aguardando aprovação da equipe (funções com post:approve)
`POST`	`/api/posts/:id/reject`	Rejeitar uma postagem pendente de volta para rascunho, com um motivo opcional
`POST`	`/api/posts/bulk`	Exclusão ou repetição em lote
`GET`	`/api/channels`	Listar canais de redes sociais conectados
`GET`	`/api/channels/:id/health`	Verificar a saúde do token do canal
`GET`	`/api/channels/:id/options`	Obter opções da plataforma (quadros do Pinterest, playlists do YouTube)
`GET`	`/api/channels/:id/mentions`	Pesquisar usuários para @menção (X, Bluesky)
`GET`/`POST`	`/api/channel-sets`	Grupos de canais salvos para segmentação com um clique (atualizar/excluir via `/api/channel-sets/:id`)
`GET`/`POST`	`/api/rss-feeds`	Feeds RSS/Atom com autopostagem — novos itens se tornam postagens (atualizar/excluir via `/api/rss-feeds/:id`)
`POST`	`/api/media`	Enviar um arquivo de mídia (formulário multipart, até 100MB)
`POST`	`/api/media/multipart/create`	Iniciar um upload fragmentado para mídia grande (vídeos de até 1GB, partes de 10MB)
`POST`	`/api/media/multipart/complete`	Montar as partes enviadas e registrar o arquivo de mídia
`GET`	`/api/media`	Listar mídias enviadas
`GET`	`/api/analytics/summary`	Resumo de análises para um intervalo de datas
`GET`	`/api/analytics/engagement`	Dados de engajamento agrupados por dia/semana/mês
`POST`	`/api/schedules`	Criar uma agenda recorrente
`GET`	`/api/quotas/usage`	Verificar limites e uso do plano atual

Veja a especificação OpenAPI para a lista completa de endpoints.

Plataformas Suportadas

Plataforma	Tipos de Postagem	Mídia
Facebook	Postagem, Story	Imagens, Vídeos
Instagram	Feed, Reel, Story, Carrossel	Imagens (JPEG), Vídeos (MP4, MOV)
X / Twitter	Tweet, Tópico	Imagens, Vídeos, GIFs
TikTok	Vídeo, Apresentação de Fotos	Vídeos (MP4, MOV), Imagens
YouTube	Vídeo, Short	Vídeos (MP4, MOV, WebM, AVI, WMV, FLV)
Threads	Postagem, Tópico, Citação	Imagens, Vídeos
Bluesky	Postagem, Tópico	Imagens
Pinterest	Pin, Pin de Vídeo	Imagens, Vídeos
Google Business Profile	Postagem	Imagens, Vídeos
LinkedIn	Postagem, Documento	Imagens, Vídeos, Documentos
Mastodon	Postagem, Tópico	Imagens, Vídeos
Discord	Mensagem	Imagens, Vídeos
Telegram	Mensagem	Imagens, Vídeos
Tumblr	Postagem, Vídeo, Citação	Imagens, Vídeos
Snapchat	Lente Pública	—

Guias e Referências

Estrutura do Repositório

bulkpublish-api/
├── README.md              # ← você está aqui
├── mcp-server/            # Servidor MCP com Claude
│   └── README.md
├── openapi.json           # Especificação OpenAPI completa
├── guides/                # Guias detalhados de plataformas
│   └── platforms.md
├── skills/                # Habilidades de conteúdo para agentes de IA
│   └── social-media-content-skills/
├── examples/              # Exemplos de código e integrações
│   ├── python/
│   ├── node/
│   ├── curl/
│   └── ai-agents/
├── .github/               # Ativos para GitHub
│   └── assets/
└── SDKs (em repositórios separados):
    ├── https://github.com/azeemkafridi/bulkpublish-python
    └── https://github.com/azeemkafridi/bulkpublish-node

License

Licenciado sob a licença MIT. Veja LICENSE para mais detalhes.

azeemkafridi/bulkpublish-api

O que é bulkpublish-api?

Perguntar na sua IA favorita

Prévia

Documentação