azeemkafridi/bulkpublish-api

透過單一 API 呼叫，以程式方式發佈內容到 15 個平台。專為開發者、AI 代理、大型語言模型以及需要可靠社群媒體自動化、無需瀏覽器會話或手動操作的代理工作流程而設計。

from bulkpublish import BulkPublish

bp = BulkPublish("bp_your_key_here")
bp.posts.create(
    content="今天我們推出新產品！",
    channels=[{"channelId": 1, "platform": "x"}, {"channelId": 2, "platform": "linkedin"}],
    status="scheduled",
    scheduled_at="2026-04-10T09:00:00Z",
)

為什麼選擇 BulkPublish？

大多數社群媒體工具是為人類點擊按鈕而設計的。BulkPublish 是為程式碼而設計的——無論這些程式碼是由開發者、AI 代理、使用工具的大型語言模型還是自動化工作流程撰寫的。

• 原生無頭設計 — 無需瀏覽器、無需 UI、運行時無 OAuth 彈出視窗。在控制台中一次性連接帳戶，然後透過 API 自動化所有操作。
• AI 原生 — 為 Claude 提供 MCP 伺服器，為 GPT 和 LangChain 提供工具定義，以及 LLM 能可靠解析的結構化 JSON 回應。
• 代理就緒 — 具有清晰錯誤碼的確定性 API。AI 代理可以自主建立貼文、檢查狀態、重試失敗並讀取分析數據。
• 15 個平台，單一端點 — Facebook、Instagram、X/Twitter、TikTok、YouTube、Threads、Bluesky、Pinterest、Google Business Profile、LinkedIn、Mastodon、Discord、Telegram、Tumblr、Snapchat。

使用案例

• AI 社群媒體經理 — 讓 Claude、GPT 或自訂代理自主排程和發佈貼文
• 內容管道 — RSS 到社群、部落格到社群、電子報到社群的自動化
• 大量排程 — 上傳 CSV 或提供內容日曆，以程式方式排程數週的貼文
• 跨平台同步發佈 — 一次發佈到所有平台，並針對每個平台進行內容最佳化
• 分析儀表板 — 將互動數據匯入您自己的工具、試算表或 AI 分析中
• Zapier/n8n/Make 替代方案 — 直接 API 存取，無需中介軟體，更低延遲，更多控制
• LLM 驅動的內容創作 — 使用 AI 生成內容，透過 BulkPublish 發佈，追蹤成效，並持續迭代

快速入門

1. 註冊

在 app.bulkpublish.com 建立免費帳戶。

2. 取得您的 API 金鑰

前往控制台的 設定 > 開發者 並建立 API 金鑰。金鑰以 bp_ 開頭，且僅顯示一次——請安全保存。

3. 連接平台

在控制台的 頻道 下連接您的社群帳戶。API 會使用您已連接的頻道來發佈內容。

4. 安裝 SDK

Python

pip install bulkpublish

Node.js

npm install bulkpublish

Homebrew (macOS/Linux)

brew tap azeemkafridi/bulkpublish && brew 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": "來自 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"
      }
    }
  }
}

提供 50 種工具：create_post、list_channels、upload_media、get_analytics、互動式 compose_post 編輯器 (MCP Apps) 等等。在本地執行 (stdio) 或透過 Streamable HTTP 託管於 https://mcp.bulkpublish.com/mcp。請參閱 mcp-server/README.md。

社群媒體內容技能

BulkPublish 包含一個 24 項技能的函式庫，供 AI 代理規劃、改寫、審查、排程和發佈社群媒體內容：社群媒體內容技能。

LLM 工具使用 / 函式呼叫

為自主 AI 代理準備的即用工具定義：

• Claude tool_use 範例 — 使用 Anthropic SDK 搭配用於排程貼文的工具定義
• OpenAI 函式呼叫範例 — 使用 GPT-4 搭配用於貼文管理的函式
• LangChain 工具範例 — 使用 LangChain 代理搭配 BulkPublish 工具

所有範例都是完整可執行的腳本，並包含錯誤處理。

程式碼範例

建立貼文

from bulkpublish import BulkPublish

bp = BulkPublish("bp_your_key_here")

post = bp.posts.create(
    content="快來看看我們的最新更新！",
    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: '快來看看我們的最新更新！',
  channels: [
    { channelId: 1, platform: 'facebook' },
    { channelId: 2, platform: 'x' },
    { channelId: 3, platform: 'linkedin' },
  ],
  status: 'draft',
});

排程貼文

post = bp.posts.create(
    content="這則貼文將在明天早上發布。",
    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="我們的最新產品來了。",
    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 代理整合。

功能特色

• 15 個平台 — Facebook、Instagram、X/Twitter、TikTok、YouTube、Threads、Bluesky、Pinterest、Google Business Profile、LinkedIn、Mastodon、Discord、Telegram、Tumblr、Snapchat
• 排程 — 為貼文排程任何未來時間，支援時區，或讓佇列時段選擇最佳時間
• 媒體上傳 — 圖片 (JPEG、PNG、WebP、GIF) 和影片 (MP4、MOV、WebM) 最大 100 MB
• 重複排程 — 每日、每週、每兩週或每月在一天的固定時間重複貼文
• 分析 — 追蹤曝光次數、讚、留言、分享和互動。每個平台回報不同的指標子集，回應會指出哪些 (supportedMetrics / supportedTotals)，因此 0 不會被誤認為實際測量值 — 請參閱 平台指標
• 連結追蹤 — 可依組織選擇加入，或透過 linkTrackingOverride 針對單篇貼文，將連結改寫為 bulkpubli.sh 並計算點擊次數。回報為 linkClicks / totalLinkClicks，由 BulkPublish 而非平台測量，因此即使平台未回報任何數據也能運作 — 請參閱 字元限制
• 標籤 — 使用彩色標籤整理貼文和媒體
• 大量操作 — 在單一請求中刪除或重試多篇貼文
• 討論串 — 支援 X、Threads、Bluesky 和 Mastodon 的多部分討論串貼文
• 自動首則留言 — 發佈後在任何平台上自動新增留言
• 所有貼文類型 — Reels、Stories、Carousels、Threads、Shorts、Video — 透過 postTypeOverrides 針對每個平台設定
• 依平台自訂內容 — 在單篇貼文中針對每個平台自訂文字和選項
• 平台特定選項 — 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/:id/approve	批准等待團隊審核的貼文 (需要 post:approve 角色)
POST	/api/posts/:id/reject	將待審貼文退回草稿，可附帶原因
POST	/api/posts/bulk	大量刪除或重試
GET	/api/channels	列出已連接的社群媒體頻道
GET	/api/channels/:id/health	檢查頻道權杖健康狀態
GET	/api/channels/:id/options	取得平台選項 (Pinterest 看板、YouTube 播放清單)
GET	/api/channels/:id/mentions	搜尋使用者進行 @提及 (X、Bluesky)
GET/POST	/api/channel-sets	儲存的頻道群組，用於一鍵鎖定目標 (更新/刪除透過 /api/channel-sets/:id)
GET/POST	/api/rss-feeds	RSS/Atom 自動發佈摘要——新項目會變成貼文 (更新/刪除透過 /api/rss-feeds/:id)
POST	/api/media	上傳媒體檔案 (多部分表單，最大 100MB)
POST	/api/media/multipart/create	為大型媒體開始分段上傳 (影片最大 1GB，每個部分 10MB)
POST	/api/media/multipart/complete	組合上傳的部分並記錄媒體檔案
GET	/api/media	列出已上傳的媒體
GET	/api/analytics/summary	指定日期範圍的分析摘要
GET	/api/analytics/engagement	按日/週/月分組的互動數據
POST	/api/schedules	建立重複排程
GET	/api/quotas/usage	檢查目前方案限制和使用量

請參閱 OpenAPI 規範 以取得完整的端點清單。

支援的平台

平台	貼文類型	媒體
Facebook	貼文、限時動態	圖片、影片
Instagram	動態、Reel、限時動態、輪播	圖片 (JPEG)、影片 (MP4、MOV)
X / Twitter	推文、討論串	圖片、影片、GIF
TikTok	影片、照片幻燈片	影片 (MP4、MOV)、圖片
YouTube	影片、Shorts	影片 (MP4、MOV、WebM、AVI、WMV、FLV)
Threads	貼文、討論串、引用貼文	圖片、影片
Bluesky	貼文、討論串	圖片
Pinterest	Pin	圖片、影片
Google Business Profile	貼文	圖片、影片
LinkedIn	貼文	圖片、影片、文件
Mastodon	貼文、討論串	圖片、影片、音訊
Discord	訊息、嵌入	圖片、影片、檔案
Telegram	訊息、嵌入	圖片、影片、檔案
Tumblr	文字、照片、連結、影片	圖片、影片
Snapchat	快照 (Snap)	圖片、影片

限制

限制	免費方案	付費方案
月度貼文配額	500	自訂
頻道數量	15	自訂
媒體儲存空間	500 MB	自訂
排程	未來 30 天	無限制
分析保留	14 天	自訂
API 速率限制	60/分鐘	自訂

免費方案不需要信用卡。請參閱 定價頁面 以取得最新資訊。

社群與支援

• 文件：app.bulkpublish.com/docs
• OpenAPI 規範：openapi.json
• Discord：加入我們的 Discord
• 問題：GitHub Issues
• 電子郵件：[email protected]

貢獻

我們歡迎貢獻！請參閱 CONTRIBUTING.md 以開始。

授權

此專案採用 MIT 授權條款——請參閱 LICENSE 檔案以瞭解詳細資訊。

相關專案

• Homebrew 套件 — macOS/Linux 的 Homebrew 套件
• MCP 伺服器 — AI 代理的 MCP 伺服器
• 社群媒體內容技能 — AI 代理的 24 項技能函式庫
• open-graph-image — 開源 Open Graph 圖片產生器