BulkPublish

BulkPublish API

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

Comenzar » · Documentación de la API · Sitio web · Servidor MCP

Publica programáticamente en 15 plataformas con una sola llamada a la API. Diseñado para desarrolladores, agentes de IA, LLMs y flujos de trabajo agénticos que necesitan automatización confiable de redes sociales 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 hechas para humanos que hacen clic en botones. BulkPublish está hecho para código — ya sea que ese código lo escriba un desarrollador, un agente de IA, un LLM con uso de herramientas o un flujo de trabajo autónomo.

• Sin interfaz por diseño — Sin navegador, sin UI, sin ventanas emergentes de OAuth en tiempo de ejecución. Conecta cuentas una vez en el panel de control y luego automatiza todo mediante la API.
• Nativo para IA — Servidor MCP para Claude, definiciones de herramientas para GPT y LangChain, respuestas JSON estructuradas que los LLMs analizan de manera confiable.
• Listo para agentes — API determinista con códigos de error claros. Los agentes de IA pueden crear publicaciones, verificar estado, reintentar fallos y leer análisis de forma autónoma.
• 15 plataformas, un solo endpoint — Facebook, Instagram, X/Twitter, TikTok, YouTube, Threads, Bluesky, Pinterest, Google Business Profile, LinkedIn, Mastodon, Discord, Telegram, Tumblr, Snapchat.

Casos de uso

• Gestores de redes sociales con IA — Deja que Claude, GPT o agentes personalizados programen y publiquen contenido de forma autónoma
• Pipelines de contenido — Automatización de RSS a redes sociales, blog a redes sociales, boletín a redes sociales
• Programación masiva — Sube un CSV o alimenta un calendario de contenido y programa semanas de publicaciones programáticamente
• Sindicación multiplataforma — Publica una vez en todas las plataformas con optimización de contenido por plataforma
• Paneles de análisis — Lleva los datos de interacción a tus propias herramientas, hojas de cálculo o análisis con IA
• Alternativas a Zapier/n8n/Make — Acceso directo a la API sin middleware, menor latencia, más control
• Creación de contenido con LLM — Genera contenido con IA, publícalo con BulkPublish, rastrea el 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 Configuración > Desarrollador en el panel de control y crea una clave de API. Las claves comienzan con bp_ y se muestran solo una vez — guárdala de forma segura.

3. Conecta plataformas

Conecta tus cuentas de redes sociales en el panel de control bajo Canales. La API usa tus canales conectados para publicar.

4. Instala un SDK

Python

pip install bulkpublish

Node.js

npm install bulkpublish

Homebrew (macOS/Linux)

brew tap azeemkafridi/bulkpublish && brew install bulkpublish

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

5. Haz 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 con 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"
      }
    }
  }
}

50 herramientas disponibles: create_post, list_channels, upload_media, get_analytics, el compositor interactivo compose_post (aplicaciones MCP) y más. Se ejecuta localmente (stdio) o alojado mediante Streamable HTTP en https://mcp.bulkpublish.com/mcp. Consulta mcp-server/README.md.

Habilidades de contenido para redes sociales

BulkPublish incluye una biblioteca de 24 habilidades para que los agentes de IA planifiquen, adapten, revisen, programen y publiquen contenido en redes sociales: Habilidades de contenido para redes sociales.

Uso de herramientas LLM / Llamada de funciones

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

• Ejemplo de uso de herramientas Claude — SDK de Anthropic con definiciones de herramientas para programar publicaciones
• Ejemplo de llamada de funciones OpenAI — GPT-4 con funciones para gestión de publicaciones
• Ejemplo de herramienta LangChain — Agente LangChain con herramientas de BulkPublish

Todos los ejemplos son scripts completos y ejecutables con manejo 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 medios 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/ — incluidos scripts de automatización en Python, ejemplos de Node.js, referencia de curl e integraciones con agentes de IA.

Características

• 15 plataformas — Facebook, Instagram, X/Twitter, TikTok, YouTube, Threads, Bluesky, Pinterest, Google Business Profile, LinkedIn, Mastodon, Discord, Telegram, Tumblr, Snapchat
• Programación — Programa publicaciones para cualquier momento futuro con soporte de zonas horarias, o deja que los espacios de cola elijan horarios óptimos
• Subida de medios — Imágenes (JPEG, PNG, WebP, GIF) y videos (MP4, MOV, WebM) de hasta 100 MB
• Programaciones recurrentes — Repite publicaciones diariamente, semanalmente, quincenalmente o mensualmente a una hora fija del día
• Análisis — Rastrea impresiones, me gusta, comentarios, compartidos e interacción. Cada plataforma reporta un subconjunto diferente de métricas, y la respuesta indica cuáles (supportedMetrics / supportedTotals) para que un 0 nunca se confunda con una medición — consulta Métricas por plataforma
• Seguimiento de enlaces — Actívalo por organización o por publicación mediante linkTrackingOverride para reescribir enlaces a través de bulkpubli.sh y contar los clics. Se reporta como linkClicks / totalLinkClicks y lo mide BulkPublish en lugar de la plataforma, por lo que funciona incluso donde la plataforma no reporta nada — consulta Límites de caracteres
• Etiquetas — Organiza publicaciones y medios con etiquetas de colores
• Operaciones masivas — Elimina o reintenta múltiples publicaciones en una sola solicitud
• Hilos — Publicaciones multiparte para X, Threads, Bluesky y Mastodon
• Primer comentario automático — Agrega automáticamente un comentario después de publicar en cualquier plataforma
• Todos los tipos de publicación — Reels, Historias, Carruseles, Hilos, Shorts, Video — configúralos por plataforma mediante postTypeOverrides
• Contenido por plataforma — Personaliza texto y opciones por plataforma en una sola publicación
• Opciones específicas de 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 la lista completa de endpoints.

Plataformas compatibles

SDKs

Python

pip install bulkpublish

Soporta síncrono y asíncrono. Docstrings completos en cada método para consumo por IDE y LLM.

Node.js / TypeScript

npm install bulkpublish

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

Homebrew (macOS/Linux)

brew tap azeemkafridi/bulkpublish && brew install bulkpublish

Instala el SDK de Node mediante Homebrew.

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 velocidad

| Programaciones recurrentes | — | 10 | Ilimitadas |

Consulta la guía de límites de velocidad para encabezados, estrategias de retroceso y mejores prácticas.

Guías

• Autenticación — Claves de API, autorización, gestión de claves
• Programación — Publicaciones programadas, espacios de cola, programaciones recurrentes, zonas horarias
• Subida de medios — Subida de archivos, formatos compatibles, uso de medios en publicaciones
• Opciones de plataforma — Configuración y peculiaridades por plataforma
• Límites de velocidad — Límites de ráfaga, cuotas diarias, mejores prácticas

Integraciones

Enlaces

Licencia

MIT