社群貼文 (YouTube, Facebook, Mastodon)

社群貼文 (YouTube, Facebook, Mastodon) 是做什麼的？

使用 Publora MCP 伺服器建立與排程發布至 YouTube、Facebook 粉絲專頁及 Mastodon 的貼文。此技能涵蓋可透過標準發布流程運作、無需平台專屬複雜設定的社群平台。

先決條件

方案： 免費的 Starter 方案即可使用。目前的限制與定價請參考：publora.com/pricing。

開始使用

1. 建立帳號 在 publora.com/register（免費）
2. 連結平台 透過 Publora 儀表板 的 OAuth 授權：
   • YouTube：Google OAuth（需要 YouTube 頻道）
   • Facebook：Facebook OAuth（僅限粉絲專頁，不支援個人檔案）
   • Mastodon：OAuth（mastodon.social 實例）
3. 取得 API 金鑰 前往 app.publora.com/dashboard/api
4. 將您的代理程式連接到 MCP 伺服器，網址為 https://mcp.publora.com，使用 Authorization: Bearer sk_YOUR_API_KEY 進行驗證。在 Claude Code 中：

claude mcp add publora --transport http https://mcp.publora.com \
  --header "Authorization: Bearer sk_YOUR_API_KEY"

Claude Desktop、Cursor、Codex、OpenClaw 及 claude.ai 連接器各自需要不同的設定檔或流程：請參閱客戶端設定了解確切路徑與程式碼片段。

REST API 備援方案

如果 MCP 無法使用，可直接使用 REST API：

基礎網址： https://api.publora.com/api/v1

驗證方式： x-publora-key 標頭

# 取得已連結的平台
curl -X GET "https://api.publora.com/api/v1/platform-connections" \
  -H "x-publora-key: sk_your_api_key"

# 建立貼文
curl -X POST "https://api.publora.com/api/v1/create-post" \
  -H "x-publora-key: sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "platforms": ["youtube-UCxxx", "facebook-123456", "mastodon-789"],
    "content": "您的貼文內容",
    "scheduledTime": "2026-03-25T10:00:00Z"
  }'

平台 ID 格式：

• YouTube：youtube-{channel_id}（例如 youtube-UCxxx）
• Facebook：facebook-{page_id}（例如 facebook-112233445566）
• Mastodon：mastodon-{id}（例如 mastodon-456）

📖 文件： docs.publora.com

---

YouTube

僅限影片平台 - 每則貼文都需要一個影片檔案。

平台限制

功能	限制
影片標題	100 個字元
影片說明	5,000 個字元
影片長度	12 小時
影片大小	256 GB
影片格式	MP4, MOV, AVI, WebM

平台設定（透過 REST API）

{
  "platformSettings": {
    "youtube": {
      "privacy": "public",
      "title": "我的影片標題"
    }
  }
}

設定	值	預設值
privacy	"public"、"unlisted"、"private"	"public"
title	字串	從內容前 70 個字元衍生

注意：platformSettings 可透過 MCP 的 create_post 和 update_post 工具以及 REST API 使用。此結構體是嚴格的：打錯平台名稱或鍵值會直接回傳驗證錯誤，而非被忽略。

YouTube 範例

將此教學影片上傳至 YouTube：
"如何在 10 分鐘內建立 REST API - 初學者完整指南"

將此影片以不公開清單上傳（供內部共享）：
"內部示範 - Q1 儀表板功能"

YouTube 限制

1. 需要影片：YouTube 不支援純文字或圖片貼文
2. 單一影片：每則貼文只能有一支影片
3. 處理時間：影片上傳後需數秒至數分鐘的處理時間
4. 權杖重新整理：YouTube 權杖約每 6 個月過期，必要時請重新連線

---

Facebook

僅限粉絲專頁 - 貼文會發布到 Facebook 粉絲專頁，而非個人檔案。

平台限制

功能	限制
貼文文字	2,200 個字元（前端）/ 63,206（API）
圖片	每則貼文最多 10 張
圖片大小	10 MB
影片長度	45 分鐘
影片大小	2 GB

多粉絲專頁支援

如果您管理多個 Facebook 粉絲專頁，每個專頁都會有各自的平台 ID：

• facebook-112233445566（粉絲專頁 1）
• facebook-778899001122（粉絲專頁 2）

您可以在單一請求中發布到多個粉絲專頁。

Facebook 範例

將此公告發布到我的 Facebook 粉絲專頁：
"我們非常興奮地宣布推出新產品！請造訪我們的網站了解更多資訊。"

將此內容發布到我的兩個 Facebook 粉絲專頁：
"假期通知：我們辦公室將在週一關閉。"

在 Facebook 上分享這些活動照片：
"公司團隊出遊精彩花絮！優秀的團隊，美好的回憶。"

Facebook 限制

1. 僅限粉絲專頁：無法透過 API 發布到個人檔案
2. WebP 自動轉換：WebP 圖片會自動轉換為 JPEG
3. 59 天權杖：權杖會自動重新整理，但如果失敗可能需要重新連線
4. 不支援混合媒體：一則貼文只能有圖片或影片，不能同時包含兩者

---

Mastodon

聯邦宇宙平台 - 貼文會分散傳播至去中心化的網路。

平台限制

功能	限制
貼文文字	500 個字元
圖片	每則貼文最多 4 張
圖片大小	16 MB
影片大小	~99 MB
圖片格式	JPEG, PNG, GIF, WebP
影片格式	MP4, WebM, MOV

Mastodon 範例

將此內容發布到 Mastodon：
"聯邦宇宙的大家好！我們剛剛為我們的開源專案推出了重大更新。#opensource"

在 Mastodon 上分享這張截圖：
"新功能：深色模式來了！#ui #darkmode"

Mastodon 限制

1. 僅限 mastodon.social：目前只能連接到 mastodon.social 實例
2. 公開可見：所有貼文預設為公開
3. 無自動分篇：與 X/Twitter 不同，Mastodon 不會自動拆分長內容
4. 嚴格 500 字元限制：超過 500 字元的內容將被拒絕

---

可用工具（所有平台）

create_post

在任何平台上建立新貼文。

參數：

• platforms：平台 ID 陣列（例如 ["youtube-UCxxx", "facebook-123", "mastodon-456"]）
• content：貼文文字
• scheduledTime：ISO 8601 UTC 日期時間。選擇性：省略此參數則貼文會建立為草稿。設定未來時間則進行排程。時間若為五分鐘或更早之前，將回傳 SCHEDULED_TIME_IN_PAST 錯誤，因此若要立即發布，請使用當前時間再加一分鐘。
• mediaUrls：最多 10 個公開的 https 圖片或影片網址。Publora 會從伺服器端下載這些檔案並在驗證之前就附加，因此媒體附加和排程可以在一次呼叫中完成。這是取代草稿 -> get_upload_url -> complete_media 流程的一次性替代方案。匯入速率限制為每小時 60 個網址。

get_upload_url

取得用於媒體上傳的預先簽署網址。

參數：

• postGroupId：要附加媒體的貼文 ID
• fileName：檔案名稱
• contentType：MIME 類型
• type："image" 或 "video"

complete_media

在透過 get_upload_url 上傳的檔案完成預先簽署的 PUT 之後，完成最終確認。此步驟為選擇性，因為排程也會自動完成待處理的媒體，但提早呼叫此函式可以在發布前就顯示格式與探測錯誤。對於使用 mediaUrls 附加的媒體則不需要。

參數：

• mediaId：get_upload_url 回傳的媒體 ID

list_connections

列出您已連結的帳號及其平台 ID。請先呼叫此工具，並逐字複製 ID；這些 ID 是無法猜測的。

list_posts / get_post / update_post / delete_post

管理已排程和草稿的貼文。update_post 也可以修補草稿或排程貼文的 content 和 platforms，因此修正錯字或重新鎖定目標受眾不再需要刪除後重建。delete_media 和 prune_media_reference 則用於清理已上傳的檔案。

---

跨平台發布

一次發布到多個平台：

將此影片發布到 YouTube，並將此文字發布到 Facebook 和 Mastodon：
"宣布我們的新功能 - 觀看示範影片！"

Publora 會自動處理各平台的特定需求：

• YouTube 會得到影片（含標題與說明）
• Facebook 會得到文字 + 影片
• Mastodon 會得到文字（適用 500 字元限制）

---

疑難排解

平台	錯誤	解決方案
YouTube	"需要影片"	附加一個影片檔案
YouTube	"帳號已中斷連線"	透過儀表板重新連線
Facebook	"找不到粉絲專頁"	確認粉絲專頁連線狀態
Facebook	"權杖已過期"	在儀表板中重新連線粉絲專頁
Mastodon	"內容太長"	縮短至 500 字元以內
Mastodon	"圖片太多"	減少至 4 張或更少
全部	速率限制錯誤	等待後重試

先前此處出現的 512 MB 數值屬於儀表板 /media/process-video 的多部分端點。API 和 MCP 上傳使用預先簽署網址，並遵循上述的平台上限。