BulkPublish API

专为自动化、AI 智能体和 LLM 构建的免费社交媒体 API。

通过单个 API 调用即可编程发布到 11 个平台。专为开发者、AI 智能体、LLM 以及需要可靠社交媒体自动化（无需浏览器会话或手动交互）的智能工作流而构建。

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",
)

为什么选择 BulkPublish？

大多数社交媒体工具是为人类点击按钮而设计的。BulkPublish 是为代码而构建的——无论这些代码是由开发者、AI 智能体、具备工具使用能力的 LLM 还是自主工作流编写的。

原生无头设计 — 无浏览器、无 UI、运行时无 OAuth 弹窗。在仪表板中连接一次账户，然后通过 API 自动化一切。
AI 原生 — 提供 Claude 的 MCP 服务器、GPT 和 LangChain 的工具定义，以及 LLM 可靠解析的结构化 JSON 响应。
智能体就绪 — 具有明确错误代码的确定性 API。AI 智能体可以自主创建帖子、检查状态、重试失败任务并读取分析数据。
11 个平台，一个端点 — Facebook、Instagram、X/Twitter、TikTok、YouTube、Threads、Bluesky、Pinterest、Google Business Profile、LinkedIn、Mastodon。

使用场景

AI 社交媒体经理 — 让 Claude、GPT 或自定义智能体自主调度和发布帖子
内容流水线 — RSS 转社交、博客转社交、时事通讯转社交自动化
批量调度 — 上传 CSV 或输入内容日历，以编程方式调度数周的帖子
跨平台联合发布 — 一次发布到所有平台，并针对每个平台进行内容优化
分析仪表板 — 将互动数据提取到您自己的工具、电子表格或 AI 分析中
Zapier/n8n/Make 的替代方案 — 无需中间件的直接 API 访问，延迟更低，控制力更强
LLM 驱动的内容创作 — 使用 AI 生成内容，通过 BulkPublish 发布，跟踪表现并进行迭代

快速入门

1. 注册

在 app.bulkpublish.com 创建免费账户。

2. 获取您的 API 密钥

前往仪表板中的 Settings > Developer 并创建一个 API 密钥。密钥以 bp_ 开头，且仅显示一次——请妥善保存。

3. 连接平台

在仪表板的 Channels 下连接您的社交账户。API 将使用您连接的渠道进行发布。

4. 安装 SDK

Python

pip install bulkpublish

Node.js

npm install bulkpublish

或者直接使用 curl、fetch、requests 或任何 HTTP 客户端调用 REST API。

5. 进行您的第一次 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"
  }'

AI 智能体集成

MCP 服务器 (Claude, Cursor, Windsurf, Claude Code)

BulkPublish 提供了一个 MCP 服务器，以便 AI 助手可以直接管理您的社交媒体：

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

提供 12 种工具：create_post、list_channels、upload_media、get_analytics 等。请参阅 mcp-server/README.md。

LLM 工具使用 / 函数调用

为自主 AI 智能体准备的现成工具定义：

Claude tool_use 示例 — 带有用于调度帖子的工具定义的 Anthropic SDK
OpenAI 函数调用示例 — 带有用于帖子管理的函数的 GPT-4
LangChain 工具示例 — 带有 BulkPublish 工具的 LangChain 智能体

所有示例都是完整的、可运行的脚本，并包含错误处理。

代码示例

创建帖子

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',
});

调度帖子

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",
)

上传媒体并发布

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",
)

自动化示例：从 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",
        )

更多示例请见 examples/ — 包括 Python 自动化脚本、Node.js 示例、curl 参考和 AI 智能体集成。

功能特性

11 个平台 — Facebook、Instagram、X/Twitter、TikTok、YouTube、Threads、Bluesky、Pinterest、Google Business Profile、LinkedIn、Mastodon
调度 — 支持时区的未来任意时间调度，或让队列槽位选择最佳发布时间
媒体上传 — 支持最大 100 MB 的图像（JPEG、PNG、WebP、GIF）和视频（MP4、MOV、WebM）
循环调度 — 使用 cron 表达式按日、周、双周或月重复发布帖子
分析 — 跟踪所有平台的展示量、点赞、评论、分享和互动情况
Webhooks — 在帖子发布、失败或被调度时获取通知
标签 — 使用颜色编码的标签组织帖子和媒体
批量操作 — 在单个请求中删除或重试多个帖子
帖子串 (Threads) — 针对 X、Threads、Bluesky 和 Mastodon 的多部分帖子串
自动首条评论 — 在任何平台发布后自动添加评论
平台差异化内容 — 在单个帖子中针对每个平台自定义文本和选项
平台特定选项 — Instagram 合作者、TikTok 隐私设置、YouTube 分类、Pinterest 画板等

API 参考

完整的交互式 API 文档：app.bulkpublish.com/docs

基础 URL

https://app.bulkpublish.com

身份验证

Authorization: Bearer bp_your_key_here

核心端点

方法	端点	描述
`POST`	`/api/posts`	创建帖子（草稿、已调度或立即发布）
`GET`	`/api/posts`	列出帖子（分页，可按状态/日期/渠道/标签过滤）
`GET`	`/api/posts/:id`	获取带有平台状态和指标的帖子
`PUT`	`/api/posts/:id`	更新草稿或已调度的帖子
`DELETE`	`/api/posts/:id`	删除帖子
`POST`	`/api/posts/:id/publish`	立即发布草稿
`POST`	`/api/posts/:id/retry`	重试失败的平台发布
`POST`	`/api/posts/bulk`	批量删除或重试
`GET`	`/api/channels`	列出已连接的社交媒体渠道
`GET`	`/api/channels/:id/health`	检查渠道令牌健康状况
`POST`	`/api/media`	上传媒体文件（多部分）
`GET`	`/api/media`	列出已上传的媒体
`GET`	`/api/analytics/summary`	指定日期范围的分析摘要
`GET`	`/api/analytics/engagement`	按日/周/月分组的互动数据
`POST`	`/api/schedules`	创建循环调度
`POST`	`/api/webhooks`	创建用于事件通知的 Webhook
`GET`	`/api/quotas/usage`	检查当前套餐限制和使用情况

请参阅 OpenAPI 规范获取完整的端点列表。

支持的平台

平台	帖子类型	媒体
Facebook	帖子, 快拍	图像, 视频
Instagram	动态, 视频, 快拍, 轮播	图像 (JPEG), 视频 (MP4, MOV)
X / Twitter	推文, 帖子串	图像, 视频, GIF
TikTok	视频, 照片幻灯片	视频 (MP4, MOV), 图像
YouTube	视频, Short	视频 (MP4, MOV, WebM, AVI, WMV, FLV)
Threads	帖子, 帖子串, 引用帖子	图像, 视频
Bluesky	帖子, 帖子串	图像
Pinterest	图钉	图像, 视频
Google Business Profile	帖子, 活动, 优惠	图像
LinkedIn	帖子	图像, 视频
Mastodon	帖子, 帖子串	图像, 视频

SDK

Python

pip install bulkpublish

支持同步和异步。每个方法都有丰富的文档字符串，供 IDE 和 LLM 使用。

Node.js / TypeScript

npm install bulkpublish

完整的 TypeScript 类型，零依赖，原生 fetch (Node 18+)。

REST API

无需 SDK — 任何 HTTP 客户端均可使用：

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

速率限制

限制	免费版	专业版	商业版
写入/分钟	60	60	60
读取/分钟	300	300	300
每日 API 请求	100	5,000	50,000
API 密钥	1	5	10
Webhooks	—	5	10
循环调度	—	10	无限制

请参阅速率限制指南了解标头、退避策略和最佳实践。

指南

身份验证 — API 密钥、授权、密钥管理
调度 — 已调度帖子、队列槽位、循环调度、时区
媒体上传 — 文件上传、支持的格式、在帖子中使用媒体
平台选项 — 各平台的配置和特性
Webhooks — 实时事件通知、有效载荷、签名验证
速率限制 — 突发限制、每日配额、最佳实践

链接

资源	URL
仪表板	app.bulkpublish.com
API 文档	app.bulkpublish.com/docs
网站	bulkpublish.com
电子邮件	support@bulkpublish.com

许可证

MIT

BulkPublish