使用 Sendcove
Sendcove 是一個社交媒體排程工具。它的 MCP 伺服器為您提供管理使用者貼文、媒體、分析數據和收件匣的工具。如果沒有可用的 Sendcove 工具,請告知使用者連線 Sendcove(設定指南:https://www.sendcove.app/features/mcp)。
從帳戶開始
- 在建立或變更貼文之前,請先呼叫
list_accounts。將回傳的id作為accountIds傳入;Sendcove 會據此判斷平台。 - 如果使用者有多個帳戶但未指定要用哪一個,請提問。預設不要發布到所有帳戶。
- 標記為
needsReconnect: true的帳戶將無法發布。請告知使用者在 Sendcove 中重新連線該帳戶。
建立貼文
- 除非您設定
status,否則create_post會建立草稿。草稿是安全預設:先建立草稿,向使用者展示您製作的內容,然後讓他們排程或發布。 content是每個平台的預設文字。使用platformContent為特定平台設定專屬文字,例如為twitter提供 280 字元版本,為instagram提供較長說明。鍵值為:twitter、instagram、tiktok、threads、bluesky、facebook、linkedin(字串)以及youtube({ title, description })。- 每個平台的選項(Instagram 貼文類型、YouTube 影片類型和可見性、TikTok 隱私設定、Bluesky 回覆設定、X 社群等)請放在
platformSettings中。請從工具的輸入 schema 及其說明中取得允許的欄位和值,不要自行猜測。在設定platformSettings.tiktok之前,請先呼叫get_tiktok_creator_info以取得該帳號允許的隱私層級與互動設定。 - 字元限制在貼文發布時檢查:X 280 字元、Bluesky 300 字元、Threads 500 字元、Instagram 和 TikTok 2200 字元、LinkedIn 3000 字元、YouTube 標題 100 字元與說明 5000 字元。請確保每個平台的文字都在其限制內(使用
platformContent),以免貼文後續發布失敗。 - Instagram 和 TikTok 貼文需要媒體;YouTube 需要一個影片。
- Threads:將後續貼文作為
threadItems傳入(每個為{ content, mediaUrls? })。這些貼文在 X、Bluesky 和 Threads(Pro 和 Max 方案)上會以串接形式發布;其他平台僅顯示content。使用update_post並傳入threadItems: []可停止串接。 - 標籤:
list_hashtag_sets會回傳使用者儲存的標籤組合(儲存時不含#)。 - 為
create_post、duplicate_post和reply_to_inbox_item傳入idempotencyKey(任何唯一的字串,8 到 200 個字元)。如果呼叫逾時或不確定是否已執行,請使用相同的金鑰重試:您會取得第一次的結果,而非建立重複的貼文或回覆。 update_post只會變更您傳入的欄位,但platformContent、platformSettings和threadItems各自會取代整個儲存的值。請先呼叫get_post再傳送完整的物件。
媒體
- 媒體必須先存在於使用者的 Sendcove 媒體庫中,才能放入
mediaUrls。list_media會顯示已存在的媒體。 - 公開的 https URL:使用
upload_media_from_url,然後使用回傳的url。 - 本機檔案:呼叫
create_media_upload_url,然後使用真實的檔案路徑執行回傳的 curl 命令(例如curl -s -X POST '<uploadUrl>' -F 'file=@/path/to/photo.jpg')。JSON 回應中會有可用的url。上傳 URL 有效期為 10 分鐘,無需 API 金鑰。對於超過 4 MB 的檔案,請傳入contentType並依序執行回傳的兩個命令(PUT 到儲存空間,然後是 finalize POST)。加入-F convertForInstagram=true可將圖片轉換為 Instagram 適用的 JPEG 格式。 - 允許的類型:JPEG、PNG、GIF、WebP、MP4、MOV、AVI。
排程與發布
僅在使用者於本次對話中要求時,才進行排程、發布或回覆。撰寫貼文不表示獲得發布許可。
- 排程:
status: "scheduled"搭配scheduledFor使用 ISO 8601 格式並包含時區偏移(例如2026-11-20T15:00:00Z)。請轉換使用者的本地時間,若不清楚時區則加以確認。或者傳入nextOpenSlot: true以使用使用者為這些帳戶設定的下一個空閒發布時段。 - 立即發布:在
create_post中設定status: "pending",或對現有貼文使用publish_post。 - 發布後,請呼叫
get_post:每個帳戶都有自己的status(published、failed、pending)和error。發布失敗通常表示某個帳戶失敗。對該貼文再次使用publish_post只會重試失敗的帳戶;絕不會重新發布已成功的貼文。 delete_post無法復原。刪除前請先確認。
僅限草稿的連線(403)
排程、發布與回覆需要 Pro 或 Max 方案並且連線允許發布。在 Basic 方案下,或使用設定為僅限草稿的 API 金鑰或已連線的應用程式時,這些呼叫會回傳 403「此 API 金鑰或已連線的應用程式只能建立草稿」。
發生此情況時,請勿重試也勿嘗試繞過。將貼文儲存為草稿並告知使用者:
我已將此內容儲存為 Sendcove 中的草稿。此連線僅限草稿,因此我無法為您排程或發布。若要讓我發布,您需要 Pro 或 Max 方案,然後在此處重新連線 Sendcove 並選擇「允許發布」(或在 Sendcove 的「帳戶 > API 金鑰」中建立已啟用「允許發布」的 API 金鑰)。您也可以自行在 Sendcove 中排程此草稿。
分析與收件匣
get_engagement:總數、各平台細分、熱門貼文,以及每個帳戶近期最佳貼文與其自身中位數的比較(timesMedian顯示貼文表現好的程度,而非原因)。get_post_analytics:單一已發布貼文在每個帳戶中的指標;傳入refresh: true可取得最新數據(數據會快取一小時)。並非每個平台都會回報所有指標。get_best_times:根據使用者自身的互動數據,顯示最佳發布日期和時段。list_inbox/get_inbox_item:回覆、提及和留言。reply_to_inbox_item會發布公開回覆,因此請先向使用者顯示回覆內容並取得同意。update_inbox_item可將項目標記為已讀、未讀或封存。