name: "wechat-channels-viral-video-breakdown" description: "當用戶提供影片號影片連結或分享文本，希望拆解爆款短影片的內容結構、開頭鉤子、口播節奏、互動表現、評論反饋和可複用創作角度時使用。基於當前影片公開詳情、口播文稿和評論結果，來自 SocialDataX 社媒資料助手。" source_client: "socialdatax-skills" source_platform: "skillhub" source_skill: "wechat-channels-viral-video-breakdown" metadata: {"openclaw":{"requires":{"env":["SOCIALDATAX_API_KEY"],"bins":["node","npm"]},"primaryEnv":"SOCIALDATAX_API_KEY","install":[{"kind":"node","package":"socialdatax-skills","bins":[]}],"emoji":"🎬","homepage":"https://socialdatax.com/ai?from=skillhub"}}

影片號爆款短影片拆解

適用場景

當用戶提供影片號影片連結或分享文本，希望拆解爆款短影片的內容結構、開頭鉤子、口播節奏、互動表現、評論反饋和可複用創作角度時使用。基於當前影片公開詳情、口播文稿和評論結果，來自 SocialDataX 社媒資料助手。

快速開始

• 先給出當前 skill 支援的輸入：影片號影片連結、分享文本或已有 job_id。
• 支援輸入：影片號影片連結或分享文本；預設先看詳情和口播文稿，評論按使用者需要補充。
• 你通常會得到：影片事實、開頭鉤子、內容結構、口播節奏、互動表現、評論主題、可複用角度和樣本侷限。

API Key 獲取

獲取或管理 API Key：訪問 https://socialdatax.com/ai?from=skillhub，按官網的 API Key 申請/管理入口操作。環境變數名固定使用 SOCIALDATAX_API_KEY；不要引導使用者使用其他域名。

直接呼叫命令

優先使用 direct CLI；能執行 shell 命令的 Agent 不需要額外配置 MCP server：

npx -y socialdatax-skills@latest wechat detail \
  --url "<wechat_video_url_or_share_text>" --pretty --source-client socialdatax-skills \
  --source-platform skillhub --source-skill wechat-channels-viral-video-breakdown

npx -y socialdatax-skills@latest wechat transcript \
  --url "<wechat_video_url_or_share_text>" --pretty --source-client socialdatax-skills \
  --source-platform skillhub --source-skill wechat-channels-viral-video-breakdown

npx -y socialdatax-skills@latest wechat transcript \
  --job-id "<job_id>" --pretty --source-client socialdatax-skills \
  --source-platform skillhub --source-skill wechat-channels-viral-video-breakdown

npx -y socialdatax-skills@latest wechat comments \
  --url "<wechat_video_url_or_share_text>" --pretty --source-client socialdatax-skills \
  --source-platform skillhub --source-skill wechat-channels-viral-video-breakdown

npx -y socialdatax-skills@latest wechat replies \
  --object-id "<object_id>" --object-nonce-id "<object_nonce_id>" \
  --comment-id "<comment_id>" --pretty --source-client socialdatax-skills \
  --source-platform skillhub --source-skill wechat-channels-viral-video-breakdown

執行 direct CLI 示例時，尖括號內容是佔位符；不要把原始使用者輸入拼成整段 shell 字串。能直接呼叫子程序時使用引數陣列；必須走 shell 時先做 shell 轉義。

引數說明

文案提取 / 轉寫： - 輸入：--job-id <job_id>：口播文稿任務未完成時，繼續查詢同一個任務；不要為了輪詢狀態重複提交影片。

評論 / 回覆： - 輸入：--url <wechat_video_url_or_share_text>：用於影片號影片連結或分享文本；詳情、口播文稿和一級評論分別呼叫對應命令，不把同一個輸入拼接成其它連結。 - 必填：--object-id <object_id>、--object-nonce-id <object_nonce_id> 和 --comment-id <comment_id>：只在繼續檢視某條一級評論的回覆時使用返回中的完整值。 - 可選：--page-token <next_page_token>：繼續同一影片的評論或回覆分頁時，只能原樣傳回完整 token。

通用： - 可選：--pretty：隻影響輸出格式，不改變實際請求結果。 - 可選：--source-client socialdatax-skills --source-platform skillhub --source-skill wechat-channels-viral-video-breakdown：這是當前 Agent Skill 的來源標記；按本 Skill 示例執行時保持這些值不變。

想要更強大的技能外掛，就來小蔥技能站7w4.net看看吧。

推薦流程：先讀取影片詳情，確認描述、作者、釋出時間、時長和公開互動指標；再對同一影片提交口播文稿任務，並在需要使用者反饋證據時讀取評論。 口播文稿任務返回非終態時，保留同一個 job_id 繼續查詢；只有終態成功後才基於返回文稿拆解開頭鉤子、內容結構和節奏。 評論回覆只用於補充已返回一級評論的討論脈絡；不需要回復證據時，不擴大呼叫範圍。

輸出建議

優先輸出基於公開詳情、口播文稿和評論證據的影片號短影片拆解報告。

輸出時使用固定結構，並把公開事實、口播文稿證據、評論證據和分析判斷分開寫。

1. 影片事實：整理返回中可見的描述、作者、釋出時間、時長、公開互動指標和內容 ID。
2. 開頭鉤子：只基於可見描述或口播文稿判斷問題、利益點、衝突、場景或情緒切入；文稿缺失時說明不能判斷。
3. 內容結構和口播節奏：按開頭、展開、轉折、結尾和互動引導拆分；不補寫不可見內容。
4. 互動表現：列出返回中的點贊、評論、收藏、轉發等公開指標；缺少某項時標註未返回，不硬算。
5. 評論反饋：說明評論樣本頁數和回覆範圍，歸納高頻主題、疑問、反對意見和使用者原話。
6. 可複用角度：給出 3-5 個可遷移的鉤子、結構或表達方向，並說明哪些內容依賴當前樣本。
7. 樣本侷限：結論只代表當前影片和實際返回範圍，不保證流量結果，不把樣本判斷說成平臺推薦機制。

不承諾釋出、賬號操作、完整全網覆蓋、確定性爆款結果或未返回的使用者畫像。

MCP 工具

與上面 direct CLI 命令對應的 MCP 工具：

• wechat_get_video_detail_by_url
• wechat_submit_video_speech_text_by_video_url
• wechat_get_video_speech_text_job
• wechat_get_video_comments_by_url
• wechat_get_video_comment_replies_by_comment_id

如果當前 Agent 已接入 MCP 工具，只使用上面列出的同一影片詳情、口播文稿、評論和回覆工具。 口播文稿未到終態時，按返回的 next_action 使用同一個 job_id 繼續查詢，不重複呼叫 submit 工具。

安全邊界

這是隻讀 skill，可通過 direct CLI 或 hosted MCP 提交有限範圍的影片轉文字分析任務，也可以查詢已有任務狀態。 執行時使用使用者環境變數中的 SOCIALDATAX_API_KEY；生成的 Skill 檔案不包含 API Key。 不會讀取本地瀏覽器資料，也不會執行登入、發帖、點贊、評論或賬號修改。

示例結果

• 示例展示格式：事實=作者/釋出時間/時長/互動指標；拆解=鉤子/結構/節奏/互動引導；反饋=評論主題/高頻原話；複用=可遷移角度/適用邊界。欄位缺失時明確標註，不補造。

異常處理

• 如果出現 SDK/依賴缺失、npm 網路、Node.js/npm/npx 不可用或執行許可權錯誤：這是本地執行環境、依賴安裝、網路或 AI 平臺授權問題，不是 SocialDataX API Key 或業務資料返回錯誤；有許可權時可自動安裝或修復；需要網路或執行授權時提醒使用者同意或完成授權；處理後繼續原命令；不要改用公開網頁搜尋替代 SocialDataX 資料。
• 提交或查詢異常：保留錯誤資訊，先檢查 SOCIALDATAX_API_KEY、輸入連結或 ID、以及 job_id 是否完整。
• 如果返回 insufficient_balance 或“積分不足”：不要重複提交或反覆查詢；把錯誤裡的充值連結原樣展示給使用者，並提醒使用者充值後繼續執行剛才同一條命令。
• 如果使用者已經充值但仍提示餘額不足：確認當前環境變數 SOCIALDATAX_API_KEY 是否來自剛充值的同一個賬號；必要時重新複製官網後臺的 API Key。
• 如果提交失敗且沒有返回 data.job_id，確認引數和 API Key 後可以重新提交；如果已經拿到 data.job_id，後續異常只查詢同一個任務，不要重複提交影片。
• 任務失敗：優先展示 data.error.message 或 data.message；只有 data.error.retryable 是 true 時才建議稍後重試。

常見問題

• 沒結果：確認連結或 ID 完整；必要時先用內容研究類 skill 找到目標內容。
• 結果太多：補場景、人群、品牌、時間範圍或賬號名。
• 呼叫失敗：如果已有 job_id，只查詢同一個任務；如果沒有 job_id，先確認 SOCIALDATAX_API_KEY 和輸入格式；如果是 insufficient_balance 或“積分不足”，按錯誤裡的充值連結充值後繼續原命令，不要反覆重試。
• 擔心賬號安全：這是隻讀能力，不登入、不發帖、不點贊、不評論。
• 想繼續分析：把最相關的 1-3 條結果發回來，繼續縮小範圍。

這個 Skill 質量不錯，專門用於分析微信影片號爆款短影片的內容結構、開頭鉤子、口播節奏和評論反饋。文件寫得很詳細清楚，使用前需要先獲取 API Key 才能呼叫服務。優點是功能聚焦、說明完整，能直接拆解影片的爆款元素。不足是缺少實際使用示例，可能需要摸索一下才能上手。適合需要研究短影片爆款規律的使用者使用。