API de BulkPublish

La API gratuita de redes sociales creada para la automatización, agentes de IA y LLMs.

Publica mediante programación en 11 plataformas desde una única llamada a la API. Creada para desarrolladores, agentes de IA, LLMs y flujos de trabajo agenticos que necesitan una automatización de redes sociales fiable sin sesiones de navegador ni interacción manual.

from bulkpublish import BulkPublish

bp = BulkPublish("bp_your_key_here")
bp.posts.create(
    content="Launching our new product today!",
    channels=[{"channelId": 1, "platform": "x"}, {"channelId": 2, "platform": "linkedin"}],
    status="scheduled",
    scheduled_at="2026-04-10T09:00:00Z",
)

¿Por qué BulkPublish?

La mayoría de las herramientas de redes sociales están creadas para humanos que hacen clic en botones. BulkPublish está creada para código, ya sea que ese código esté escrito por un desarrollador, un agente de IA, un LLM con uso de herramientas o un flujo de trabajo autónomo.

• Headless por diseño — Sin navegador, sin interfaz de usuario, sin ventanas emergentes de OAuth en tiempo de ejecución. Conecta las cuentas una vez en el panel de control y luego automatiza todo a través de la API.

• Nativa de IA — Servidor MCP para Claude, definiciones de herramientas para GPT y LangChain, respuestas JSON estructuradas que los LLMs analizan de forma fiable.

• Lista para agentes — API determinista con códigos de error claros. Los agentes de IA pueden crear publicaciones, comprobar el estado, reintentar fallos y leer analíticas de forma autónoma.

• 11 plataformas, un endpoint — Facebook, Instagram, X/Twitter, TikTok, YouTube, Threads, Bluesky, Pinterest, Google Business Profile, LinkedIn, Mastodon.

Casos de uso

• Gestores de redes sociales de IA — Permite que Claude, GPT o agentes personalizados programen y publiquen contenido de forma autónoma.

• Canalizaciones de contenido — Automatización de RSS a redes sociales, blog a redes sociales, boletín informativo a redes sociales.

• Programación masiva — Sube un CSV o alimenta un calendario de contenido y programa semanas de publicaciones mediante programación.

• Sindicación multiplataforma — Publica una vez en todas las plataformas con optimización de contenido por plataforma.

• Paneles de analíticas — Extrae datos de interacción a tus propias herramientas, hojas de cálculo o análisis de IA.

• Alternativas a Zapier/n8n/Make — Acceso directo a la API sin middleware, menor latencia, más control.

• Creación de contenido impulsada por LLM — Genera contenido con IA, publícalo con BulkPublish, realiza un seguimiento del rendimiento e itera.

Inicio rápido

1. Regístrate

Crea una cuenta gratuita en app.bulkpublish.com.

2. Obtén tu clave de API

Ve a Settings > Developer en el panel de control y crea una clave de API. Las claves comienzan con bp_ y solo se muestran una vez; guárdala de forma segura.

3. Conecta plataformas

Conecta tus cuentas sociales en el panel de control en Channels. La API utiliza tus canales conectados para publicar.

4. Instala un SDK

Python

pip install bulkpublish

Node.js

npm install bulkpublish

O llama a la API REST directamente con curl, fetch, requests o cualquier cliente HTTP.

5. Realiza tu primera llamada a la API

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

Integración de agentes de IA

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

BulkPublish incluye un servidor MCP para que los asistentes de IA puedan gestionar tus redes sociales directamente:

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

12 herramientas disponibles: create_post, list_channels, upload_media, get_analytics y más. Consulta mcp-server/README.md.

Uso de herramientas / Llamada a funciones de LLM

Definiciones de herramientas listas para usar para agentes de IA autónomos:

• Ejemplo de tool_use de Claude — SDK de Anthropic con definiciones de herramientas para programar publicaciones.

• Ejemplo de llamada a funciones de OpenAI — GPT-4 con funciones para la gestión de publicaciones.

• Ejemplo de herramienta de LangChain — Agente de LangChain con herramientas de BulkPublish.

Todos los ejemplos son scripts completos y ejecutables con gestión de errores.

Ejemplos de código

Crear una publicación

from bulkpublish import BulkPublish

bp = BulkPublish("bp_your_key_here")

post = bp.posts.create(
    content="Check out our latest update!",
    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_your_key_here' });

const post = await bp.posts.create({
  content: 'Check out our latest update!',
  channels: [
    { channelId: 1, platform: 'facebook' },
    { channelId: 2, platform: 'x' },
    { channelId: 3, platform: 'linkedin' },
  ],
  status: 'draft',
});

Programar una publicación

post = bp.posts.create(
    content="This will go out tomorrow morning.",
    channels=[{"channelId": 1, "platform": "instagram"}],
    status="scheduled",
    scheduled_at="2026-04-10T09:00:00Z",
    timezone="America/New_York",
)

Subir contenido multimedia y publicar

media = bp.media.upload("./product-photo.jpg")

post = bp.posts.create(
    content="Our newest product is here.",
    channels=[{"channelId": 1, "platform": "instagram"}],
    media_files=[media["file"]["id"]],
    status="scheduled",
    scheduled_at="2026-04-10T12:00:00Z",
)

Ejemplo de automatización: Programación masiva desde CSV

import csv
from bulkpublish import BulkPublish

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

with open("content-calendar.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",
        )

Más ejemplos en examples/ — incluyendo scripts de automatización en Python, ejemplos en Node.js, referencia de curl e integraciones de agentes de IA.

Características

• 11 plataformas — Facebook, Instagram, X/Twitter, TikTok, YouTube, Threads, Bluesky, Pinterest, Google Business Profile, LinkedIn, Mastodon.

• Programación — Programa publicaciones para cualquier momento futuro con soporte de zona horaria, o deja que los espacios de la cola elijan los momentos óptimos.

• Subidas de contenido multimedia — Imágenes (JPEG, PNG, WebP, GIF) y vídeos (MP4, MOV, WebM) de hasta 100 MB.

• Programaciones recurrentes — Repite publicaciones diaria, semanal, quincenal o mensualmente con expresiones cron.

• Analíticas — Realiza un seguimiento de impresiones, me gusta, comentarios, compartidos e interacción en todas las plataformas.

• Webhooks — Recibe notificaciones cuando las publicaciones se publiquen, fallen o estén programadas.

• Etiquetas — Organiza publicaciones y contenido multimedia con etiquetas codificadas por colores.

• Operaciones masivas — Elimina o reintenta varias publicaciones en una sola solicitud.

• Hilos — Publicaciones de hilos de varias partes para X, Threads, Bluesky y Mastodon.

• Comentario inicial automático — Añade automáticamente un comentario después de publicar en cualquier plataforma.

• Contenido por plataforma — Personaliza el texto y las opciones por plataforma en una sola publicación.

• Opciones específicas de la plataforma — Colaboradores de Instagram, privacidad de TikTok, categorías de YouTube, tableros de Pinterest y más.

Referencia de la API

Documentación interactiva completa de la API: app.bulkpublish.com/docs

URL base

https://app.bulkpublish.com

Autenticación

Authorization: Bearer bp_your_key_here

Endpoints principales

Consulta la especificación OpenAPI para obtener la lista completa de endpoints.

Plataformas compatibles

SDKs

Python

pip install bulkpublish

Soporta sincronización y asincronización. Docstrings enriquecidos en cada método para el consumo de IDE y LLM.

Node.js / TypeScript

npm install bulkpublish

Tipos completos de TypeScript, cero dependencias, fetch nativo (Node 18+).

API REST

No se necesita SDK: cualquier cliente HTTP funciona:

curl https://app.bulkpublish.com/api/channels \
  -H "Authorization: Bearer bp_your_key_here"

Límites de tasa

Consulta la guía de límites de tasa para obtener información sobre encabezados, estrategias de retroceso y mejores prácticas.

Guías

• Autenticación — Claves API, autorización, gestión de claves

• Programación — Publicaciones programadas, espacios de cola, programaciones recurrentes, zonas horarias

• Subidas de contenido multimedia — Subidas de archivos, formatos compatibles, uso de contenido multimedia en publicaciones

• Opciones de plataforma — Configuración y peculiaridades por plataforma

• Webhooks — Notificaciones de eventos en tiempo real, cargas útiles, verificación de firmas

• Límites de tasa — Límites de ráfaga, cuotas diarias, mejores prácticas

Enlaces

Licencia

MIT