跳到主要內容
maxstudioNews
AI 自動化DEV Community (Claude Code)約 14 分鐘

使用 Claude Code 跨平台發布短影音:自動檢查、撰寫文案、一鍵發送

這篇文章介紹了一項名為「跨平台影片發布技能」(Cross Post Video Skill)的免費工具,它能讓 AI 代理(如 Claude Code)自動將影片發布到 TikTok、Reels 和 Shorts。此技能會預先檢查影片檔案是否符合各平台規範,並為每個平台獨立撰寫文案,大幅簡化社群媒體內容發布流程。使用者只需透過簡單的提示詞,即可完成影片上傳前的所有準備工作,並在確認後一次性發送至多個平台。

使用 Claude Code 跨平台發布短影音:自動檢查、撰寫文案、一鍵發送
圖片來源:DEV Community (Claude Code)

透過您的 AI 代理將影片跨平台發布到 TikTok、Reels 和 Shorts:「跨平台影片發布技能」是一項適用於 Claude Code 的免費 MIT 授權技能,它能將一支完成的影片準備好,以便在所有三個平台發布。

在上傳任何內容之前,它會根據每個平台檢查檔案,協助您選擇封面,讓 AI 代理為每個平台撰寫獨立的文案,並詢問只有帳戶擁有者才能選擇的設定。所有發布內容都會顯示在一個計畫頁面上,在您明確確認後,它會以每個帳戶一個子請求的方式,一次性將所有內容發送出去。此技能也支援 Codex、Cursor 和 OpenClaw。

上傳前的所有操作都在您的本機電腦上執行,使用 Python 和 ffmpeg,無需註冊任何服務。本文將逐步介紹儲存庫中的 NASA 範例,一次一個指令。您可以透過指令 npx skills add social-media-skills/cross-post-video-skill -g -a claude-code -y 安裝此技能。

範例中的計畫頁面顯示了一個 14 秒的 NASA 影片片段,內容關於太空人為何要在太空運動,計畫發布到 TikTok、Reels 和 Shorts(NASA 影片素材,不代表認可)。

為何一支影片在 TikTok、Reels 或 Shorts 上會出問題?一支垂直的 MP4 影片可能在三個平台都有效,但不同之處在於其周邊的所有設定,而這些差異通常只有在上傳後才容易發現。

例如,影片長度:TikTok 的最大長度取決於帳戶,而非平台本身。YouTube Shorts 影片可以是方形或垂直的,最長 3 分鐘,若更長則會變成一般影片。檔案本身:Instagram 的要求最嚴格,限制為 300 MB、寬度不超過 1920 像素、23 到 60 fps、AAC 音訊、索引位於檔案開頭,且不支援 HDR。

文案方面:TikTok 和 Instagram 使用說明文字。YouTube 需要一個最長 100 字元的標題,並以位元組計算說明文字長度。Instagram 的主題標籤上限為 5 個。設定方面:TikTok 要求帳戶擁有者選擇誰可以看到每個貼文,以及是否開啟留言、合拍和拼貼功能,且沒有預設值。YouTube 則會詢問影片是否為兒童製作。

這項技能將所有這些檢查和設定步驟提前到上傳之前完成。腳本負責檢查和計數,AI 代理則負責撰寫文案和提問。

提示詞範例:「在紐約時間 1 月 12 日下午 6 點,將 clips/microgravity.mp4 發布到我的 TikTok、Reels 和 Shorts。這是我的原創影片,使用原始音訊,非 AI 生成,也非宣傳內容。TikTok 設定:所有人可見、留言開啟、合拍和拼貼關閉。非兒童製作。」

這個提示詞已經回答了 AI 代理在第一個訊息中會詢問的問題,例如這是否是您有權發布的原始匯出檔案、音訊來源、是否為 AI 生成或宣傳內容,以及每個帳戶的設定。

步驟 1:檢查檔案。執行 python3 <skill>/scripts/check_video.py clips/microgravity.mp4 指令,會顯示影片的詳細資訊,例如 clips/microgravity.mp4: 720x1280, 13.9 s, 29.97 fps, h264 yuv420p, aac 48000 Hz, 3.1 MB, 1.82 Mbps,並檢查是否符合各平台要求:TikTok: ok、Instagram Reels: ok、YouTube Shorts: ok。此影片通過檢查。

當檔案不符合要求時(例如 4K、120 fps、5.1 聲道、相機的 MOV 檔案、較新 iPhone 的 HDR 影片),--fix 選項會在其旁邊寫入一個重新編碼的副本,命名為 <name>.crosspost.mp4,並保留原始檔案。

它會保持圖片尺寸,只會將寬度超過 1920 像素的影片縮小。如果您的 ffmpeg 具有 zscale 濾鏡,HDR 會轉換為標準色彩;如果沒有,--fix 不會寫入任何內容,並會告訴您如何匯出標準色彩的檔案。它絕不會裁剪、修剪、填充或加速影片,影片的長度和形狀由您決定。

步驟 2:選擇封面。如果沒有封面,TikTok 和 Instagram 會顯示影片的第一幀。cover.py 會生成一個包含 12 幀及其時間的預覽圖,每幀上都有一個虛線框,標示出中間 3:4 的區域,這是 Instagram 個人資料網格會顯示的部分。您可以執行 python3 <skill>/scripts/cover.py clips/microgravity.mp4 來生成預覽圖。

在範例中,8.7 秒的畫面在全螢幕下看起來不錯,但在網格裁剪中會切掉太空人的頭部。而 12.2 秒的畫面則不會,您可以透過 python3 <skill>/scripts/cover.py clips/microgravity.mp4 --at 12.2 指定封面時間。

封面會隨貼文發送到 TikTok 和 Instagram。YouTube 的封面是在 YouTube 應用程式中設定的,因此計畫頁面和手動發布頁面都會顯示「封面幀:12.2 秒」,您可以在應用程式中選擇相同的幀。

步驟 3:為每個平台撰寫文案,並儲存到一個工作檔案中。AI 代理會根據影片內容,而非其他文案,為每個平台撰寫文案,並將所有內容儲存到 crosspost.json 檔案中,包括帳戶設定、四個問題的答案和文案。以下是簡化的 JSON 內容:

`{ "timezone" : "America/New_York" , "accounts" : [ { "name" : "TikTok" , "platform" : "TIKTOK" , "privacyLevel" : "PUBLIC_TO_EVERYONE" , "allowComment" : true , "allowDuet" : false , "allowStitch" : false , "max_video_s" : 600 } , { "name" : "Reels" , "platform" : "INSTAGRAM" } , { "name" : "Shorts" , "platform" : "YOUTUBE" , "privacy" : "public" , "madeForKids" : false } ] , "videos" : [ { "id" : "microgravity" , "file" : "clips/microgravity.mp4" , "when" : "2027-01-12 18:00" , "own_video" : true , "audio" : "original" , "ai_generated" : false , "promotional" : "no" , "text" : { "TIKTOK" : "Why astronauts work out for hours every day

..." , "INSTAGRAM" : "Astronauts on the space station exercise for hours every day.

..." , "YOUTUBE" : { "title" : "Why astronauts exercise for hours every day in space" , "description" : "..." , "tags" : [ "space station" , "ISS" , "microgravity" ] } } } ] }`

設定和四個問題的答案由帳戶擁有者提供。如果缺少任何一項,plan.py 會列出並由 AI 代理詢問,它絕不會自動填寫。max_video_s 來自已連接的 TikTok 帳戶本身,因為 TikTok 是按帳戶設定此值。

步驟 4:計畫頁面。執行 python3 <skill>/scripts/plan.py crosspost.json 指令,會顯示「3 posts planned -> plan.md, plan.html (0 errors, 0 warnings, 0 notes)」,並生成手動發布頁面和請求檔案。接下來,您需要顯示 plan.html(或貼上 plan.md)並等待明確的確認。

plan.py 會檢查每個帳戶的檔案、所有文案和所有設定,並以每個平台自己的方式計算文案長度。例如,TikTok 說明文字為 2,200 字元中的 198 字元,包含 3 個主題標籤;Reels 說明文字為 2,200 字元中的 329 字元,包含 4 個主題標籤;YouTube 標題為 100 字元中的 52 字元,說明文字為 5,000 位元組中的 227 位元組。

它還會標記那些不是錯誤但值得注意的事項,例如不可點擊的連結、在其他平台重複使用的 @handle、過長而無法獨立顯示的第一行,或與影片內容無關的主題標籤。結果會生成 plan.html(頂部的截圖)和 plan.md,其中包含每個帳戶、其文案、設定、封面和時間,以及影片上線後在應用程式中需要執行的操作列表。

AI 代理會顯示這些內容,並等待一個涵蓋這些貼文、這些帳戶和這些時間的「是」來確認。在範例中,只有 TikTok 和 Instagram 已連接,因此 Shorts 是手動計畫的。by-hand/microgravity/shorts.md 包含標題、說明、標籤、設定、封面幀以及 YouTube 工作室或應用程式的編號步驟。

步驟 5:一個請求,每個帳戶一個子請求。在確認後,AI 代理會上傳每個檔案一次,plan.py --media media.json 會填入媒體 ID。該請求是一個包含每個已連接帳戶子請求的貼文,每個子請求在 contentOverride 中都有自己的文案。以下是 requests/microgravity.json 的簡化內容:

`{ "schedule" : { "type" : "SCHEDULE_FOR_LATER" , "scheduledFor" : "2027-01-12T23:00:00Z" } , "socialAccounts" : [ { "platform" : "TIKTOK" , "postMode" : "DIRECT_POST" , "privacyLevel" : "PUBLIC_TO_EVERYONE" , "allowComment" : true , "allowDuet" : false , "allowStitch" : false , "isYourBrand" : false , "isBrandedContent" : false , "isAiGeneratedContent" : false , "cover" : { "type" : "MEDIA_LIBRARY" , "mediaId" : "<cover>" } , "contentOverride" : [ { "text" : "Why astronauts work out for hours every day

..." , "media" : [ { "type" : "MEDIA_LIBRARY" , "mediaId" : "<video>" } ] } ] } , { "platform" : "INSTAGRAM" , "postType" : "REEL" , "isAiGeneratedContent" : false , "cover" : { "type" : "MEDIA_LIBRARY" , "mediaId" : "<cover>" } , "contentOverride" : [ { "text" : "Astronauts on the space station exercise for hours every day.

..." , "media" : [ { "type" : "MEDIA_LIBRARY" , "mediaId" : "<video>" } ] } ] } ] }`

紐約時間下午 6 點變成了 23:00Z,plan.py 會在時鐘時間沒有時區時停止,絕不會假設為 UTC。順序是固定的:確認、上傳、使用確切請求進行 posts_validate、posts_create,然後使用貼文 ID 進行 plan.py --posted,最後使用 posts_get 獲取每個帳戶的狀態。

請求會作為一個整體進行驗證:如果其中一個子請求無效,則不會創建任何內容。如果驗證強制更改,AI 代理會重新計畫並要求新的確認。沒有任何內容會被發送兩次。

--posted 會將影片和該請求中的每個帳戶寫入 posted.json。從那時起,plan.py 會將這些帳戶從該影片的每個新請求中排除,並將它們顯示為「已發布」。這對於最常見的下一步很重要:您下週連接第三個帳戶,再次計畫,新的請求將只包含 Shorts。

失敗的情況也一樣,如果一個帳戶失敗,plan.py --failed 只會釋放該帳戶,而已經成功的帳戶則不會再次發送。排程的貼文無法在其時間之前檢查。之後,「檢查我的跨平台貼文」會讓 AI 代理讀取 posted.json,為每個記錄的貼文呼叫 posts_get,並為每個帳戶報告一行狀態:已上線並附帶連結、仍在處理中,或失敗及原因。

免費方案說明:此技能由 WoopSocial 團隊開發,發布過程透過 WoopSocial 進行。它透過每個平台自己的 API 和 WoopSocial 批准的應用程式發布,因此您無需自己的開發者應用程式或應用程式審核。免費方案涵蓋 2 個社群帳戶,無需信用卡。

由於 TikTok、Reels 和 Shorts 共有 3 個平台,因此在 AI 代理的第一個訊息中,它會詢問您想要選擇哪些平台:它可以發布 2 個並為第三個提供手動發布頁面,或者在付費方案下發布所有平台,或者準備好所有內容讓您手動發布,無需註冊任何服務。

您的 AI 代理的連接步驟位於 WoopSocial 針對 AI 代理的設定頁面。

WoopSocial 負責發布影片和文案。它不會撰寫說明文字或更改影片:AI 代理撰寫文案,而技能本身的腳本負責任何重新編碼。有些內容無法透過它設定,計畫頁面會在「上線後」列出這些內容:YouTube 封面、YouTube 的更改內容和付費推廣答案,以及 Instagram 的付費合作標籤。

也無法添加從應用程式庫中選擇的音訊;對於 TikTok,AI 代理可以將影片作為草稿發送到您的收件匣,您可以在那裡添加音訊並發布。

每個平台多個帳戶:工作檔案可以包含您擁有的任意數量的帳戶,包括在一個平台上的兩個帳戶(例如,一個荷蘭語和一個英語的 TikTok 帳戶)。每個帳戶都會有自己的文案,格式為 "text": {"<account name>": ...},並寫明其受眾。

計畫頁面會針對在多個帳戶上發布相同影片的情況,根據該平台自己的規則發出一次警告。此技能絕不提供加速、裁剪或濾鏡副本以使其看起來不同,它只發布原始匯出檔案:不發布從其他應用程式保存的副本,也不在圖片中添加任何內容。它也不承諾觸及率。

沒有任何平台表示發布順序、平台之間的間隔、一天中的時間或主題標籤數量會改變影片的顯示方式,因此計畫頁面不會建議任何這些內容,也不會添加 YouTube 不需要的主題標籤 #Shorts。

試用此技能:執行 npx skills add social-media-skills/cross-post-video-skill -g -a claude-code -y。然後告訴您的 AI 代理「將此影片發布到 TikTok、Reels 和 Shorts」或「明天下午 6 點將 clip.mp4 跨平台發布到所有地方」。

它需要 Python 3.9+、ffmpeg 和 Pillow;scripts/check_setup.py 會列印出任何缺少項目的安裝指令。包含技能生成的所有檔案的完整範例位於 examples/microgravity/ 中。歡迎提出問題和拉取請求,同一個團隊還有更多免費的社群媒體技能。

Share

覺得值得一看?分享給朋友。

以上為 AI 自動翻譯導讀。原文版權歸 DEV Community (Claude Code) 所有, 建議透過「閱讀原文」前往原始網站,以取得最完整資訊並支持原作者。

Newsletter

不用每天追,AI 重點每週寄給你

43 個來源、每 2 小時更新,太多看不完。電子報每週挑最值得看的幾則,附上 Max 的看法。

每週一封。Email 只用來寄電子報,每封信都能一鍵退訂。