Community寫作與編輯github.com

publora/threads-post

透過 Publora MCP 建立並排程 Threads 貼文,支援圖片輪播與回覆控制。當使用者想要在 Meta 的 Threads 上發文時使用。目前平台不支援多段串文,長內容會維持單篇貼文。不適用於 Instagram (請用 instagram-post) 或 X 串文 (請用 x-post)。

threads-post 是什麼?

此技能「publora/threads-post」讓 AI 代理能透過 Publora MCP 伺服器,在 Meta 的 Threads 平台上建立、排程與管理貼文。它支援單篇文字、圖片輪播 (2-20 張) 以及回覆權限控制,並提供完整的 CRUD 工具 (create_post、update_post、delete_post 等) 來管理草稿或已排程的貼文。由於 Threads 平台目前的連線限制,多段串文功能暫時關閉,因此超過 500 字元的內容不會自動分段,使用者需手動處理或改用其他支援串文的平台。技能也包含上傳媒體 (影像/影片)、取得預簽章 URL 以及處理排程時間衝突等能力。此技能適用於 Claude Code、Cursor、Codex、OpenClaw 等支援 MCP 的代理平台,並提供 REST API 備援方案。定價方面,免費的 Starter 方案即可使用,詳細限制與價格請參考官方網站。

相容平台✓Claude Code✓Codex CLI✓Cursor
npx skills add https://github.com/publora/skills/tree/main/skills/threads-post

Installed? Explore more 寫作與編輯 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Threads 貼文

透過 Publora MCP 伺服器在 Meta 的 Threads 上建立並排程貼文。支援單篇貼文、圖片輪播(2-20 張)與回覆控制。目前平台連線暫時不支援多段串文。

先決條件

方案: 免費的 Starter 方案即可使用。當前限制與定價:publora.com/pricing

開始使用

  1. 建立帳戶:至 publora.com/register 註冊(免費)
  2. 連結 Threads:透過 Instagram OAuth 在 Publora 儀表板 中完成
  3. 取得 API 金鑰:於 app.publora.com/dashboard/api 獲取
  4. 連結你的代理:將代理連接到位於 https://mcp.publora.com 的 MCP 伺服器,使用 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:

基礎 URL: 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": ["threads-12345"],
    "content": "你的貼文內容",
    "scheduledTime": "2026-03-25T10:00:00Z"
  }'

平台 ID 格式: threads-{id}(來自 /platform-connections)

📖 文件: docs.publora.com

平台限制

功能限制
每則貼文字元數500
主題標籤每則貼文最多 1 個
連結每則貼文最多 5 個
每組輪播圖片數2-20
圖片大小8 MB
圖片格式JPEG、PNG(WebP 會自動轉換)
影片長度5 分鐘
影片大小1 GB
影片格式MP4、MOV
每日貼文數250
每日回覆數1,000

可用工具

create_post

建立新的 Threads 貼文或串文。

參數:

  • platforms:包含你的 Threads 連線 ID 的陣列(例如 ["threads-12345"])
  • content:貼文文字(超過 500 字元時會自動處理)
  • scheduledTime:ISO 8601 UTC 日期時間。可選:省略則貼文會儲存為草稿。填入未來的時間則進行排程。若填入過去五分鐘以上的時間,會回傳 SCHEDULED_TIME_IN_PAST 錯誤,因此若想立即發文請使用當前時間加上一分鐘。
  • mediaUrls:最多 10 個公開 https 圖片或影片 URL。Publora 會在伺服器端下載這些媒體,並在驗證前附加上去,因此媒體與排程能在一次呼叫中完成。這是草稿流程(先建立草稿再 get_upload_url 後 complete_media)的一次性替代方案。媒體擷取每小時限制 60 個 URL。

get_upload_url

取得用於上傳圖片的預簽章 URL。

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 則可清理已上傳的檔案。

長內容

Threads 貼文限制為 500 個字元,且 Publora 的多段串文功能目前暫時關閉,因為 Threads 應用程式連線正在恢復中。超出限制的內容不會自動分段,因此:

  • 將貼文維持在 500 字元以內,或
  • 自行將各段作為獨立貼文發佈,或
  • 將長內容移至目前支援串文的平台(如 X)並附上連結。

手動加入的 --- 分隔線與 [1/3] 標記會照原樣保留,但目前不會建立連續的回覆鏈。請聯絡 [email protected] 以了解恢復時程。

回覆控制

透過 REST API 的 platformSettings 控制誰可以回覆你的貼文:

值說明
""(空字串)預設平台行為(任何人可回覆)
"everyone"明確允許任何人回覆
"accounts_you_follow"只有你追蹤的帳戶可以回覆
"mentioned_only"只有被提及的帳戶可以回覆

請注意:platformSettings 可透過 MCP 的 create_post 與 update_post 工具以及 REST API 使用。其結構嚴格:打錯的平台或金鑰會被拒絕並回傳驗證錯誤,而非默默忽略。

重要限制

  1. 單一主題標籤限制:Threads 每則貼文最多允許 1 個主題標籤。額外的標籤會被平台忽略。

  2. 發文後無法編輯:一旦發佈,Threads 貼文無法透過 API 編輯。如有需要請刪除後重新發佈。

  3. 不支援影片輪播:Publora 的輪播功能僅支援圖片。獨立影片貼文則正常運作。

  4. 多段串文暫時無法使用:將內容分割成多則連續回覆的功能暫時停用。單篇貼文與圖片輪播則持續正常運作。

範例

純文字貼文

在 Threads 上發佈這則貼文:
「剛剛發現一個超讚的效率技巧,今天省了我 2 小時。關鍵就是把類似的任務批次處理。」

圖片輪播

用這 5 張產品演進截圖建立一個 Threads 輪播。
說明文字:「從概念到上市 - 我們的 6 個月旅程。 #buildinpublic」

注意:需要 2-20 張圖片。輪播中不支援影片。

長內容(分開發佈為獨立貼文)

串文功能已停用,因此請明確要求各段:

在 Threads 上分開發佈以下貼文:
「串文:我作為首次創業者犯的 7 個錯誤

---

1. 招聘過快。我們在 3 個月內從 2 人變成 15 人。公司文化受損。

---

2. 忽略單位經濟學。收入感覺很棒,直到我們計算出 CAC...」

排程貼文

安排在明天上午 10 點發佈:
「週一動力:最佳的開始時間是昨天。次佳的時間就是現在。」

最佳做法

  1. 開頭是關鍵:前兩行決定互動率,務必精心設計
  2. 最佳長度:單篇貼文 100-250 字元表現較佳
  3. 原生內容:平台獎勵原創、對話式的貼文
  4. 單一主題標籤:使用一個高度相關的主題標籤(平台限制)
  5. 無編輯選項:發佈前雙重確認內容

發文時機

  • 最佳時段:目標時區的早上 7-9 點、中午 12-1 點、晚上 7-9 點
  • 頻率:每天 1-3 則貼文有助於成長
  • 穩定性:定期發文表示帳戶活躍

互動

  • 在發文後一小時內回覆留言
  • 交叉引用你的 Instagram(帳戶已連結)
  • 使用相關主題/關鍵字以增加被發現的機會

疑難排解

錯誤原因解決方案
「帳戶未連結」Threads/Instagram OAuth 已過期透過 Publora 儀表板重新連結
「內容過長」貼文超過 500 字元且串文失敗手動加入 --- 分隔段落
「媒體上傳失敗」格式錯誤或大小不符檢查:圖片 < 8 MB,僅限 JPEG/PNG
「輪播需要 2-20 個項目」圖片數量錯誤確保輪播圖片為 2-20 張
「已達每日 250 則貼文上限」達到速率限制等待 24 小時

Individual skills in this repo

This repo contains 8 individual skills — each has its own dedicated page.

publora/bluesky-post

Use when the user wants to post or schedule to Bluesky through Publora. Handles the 300-character cap, auto-detected hashtags and links, up to 4 images, and videos. Alt text cannot be set through the API. Needs a Bluesky app password, never the main password. Not for Mastodon (use social-post).

publora/instagram-post

Use when the user wants to post or schedule to Instagram through Publora: a single image, a 2-10 image carousel, a Reel or a Story. Requires a Business account and an image or video; text-only posts are rejected by the API. Not for Threads (use threads-post).

publora/linkedin-analytics

Analyze LinkedIn performance and manage engagement through Publora. Use when the user asks how a LinkedIn post or account performed (impressions, reach, reactions, comments, reshares, follower growth) or wants to react, comment, reshare or resolve an @mention. Statistics run over the REST API, engagement over MCP tools. Not for creating posts (use linkedin-post).

publora/linkedin-post

Use when the user wants to publish or schedule a LinkedIn post through Publora: text, a multi-image grid, a video, a PDF document, or @mentions. Not for analytics, reactions, comments or reshares (use linkedin-analytics), and not for other platforms.

publora/social-post

Use when the user wants to post or schedule to YouTube, a Facebook Page or Mastodon through Publora. YouTube needs a video on every post, Facebook publishes to Pages only, Mastodon caps at 500 characters. Not for the platforms that have their own skill.

publora/telegram-post

Use when the user wants to post or schedule to a Telegram channel or group through Publora, using a bot. Covers Telegram markdown, silent delivery, link previews and forward protection. Bot API caps media captions at 1,024 characters and videos at 50 MB. Not for other platforms (each has its own skill).

publora/tiktok-post

Use when the user wants to upload or schedule a TikTok video through Publora, with privacy, comment, duet, stitch and commercial-disclosure settings. Video runs 3 seconds to 10 minutes at 23+ FPS; carousels take up to 35 images. Unaudited apps can publish private videos only. Not for Reels (use instagram-post).

publora/x-post

Use when the user wants to post or schedule to X (Twitter) through Publora, including threads auto-split past 280 characters, up to 4 images, or a video up to 140 seconds. X needs a paid Publora plan. Not for Threads or Bluesky (each has its own skill).

相關技能