Lettiiii/tiktok-analyzer

TikTok 分析器

Claude 無法觀看影片或開啟 TikTok 連結，但可以讀取圖片與文字。此技能將影片轉換為兩者：時間戳記對齊的逐字稿、均勻間隔的影格，以及貼文的中繼資料。然後你讀取它們並回答問題。

步驟

1. 執行提取器（適用於網址或本機影片路徑）。<skill-dir> 是存放此 SKILL.md 的資料夾，無論技能安裝在何處：

   python "<skill-dir>/scripts/extract.py" "<url-or-file>" "<out_dir>"
   

   如果腳本因缺少套件而失敗，請用 python -m pip install -r "<skill-dir>/requirements.txt" 安裝一次依賴項。使用暫存區或臨時目錄作為 <out_dir>，不要使用使用者的專案目錄。可選參數：最大影格數（預設 24）、Whisper 模型（預設 base；若說話聲嘈雜、有口音或非英語，請使用 small）。首次執行會下載 Whisper 模型，請等待幾分鐘。
2. 讀取 metadata.json（標題、作者、日期、主題標籤、互動數據、音檔），然後讀取 transcript.txt。
3. 使用「讀取」工具依序讀取 frames/ 中的影格。檔名帶有時間戳（例如 t0012.3s.jpg），因此你可以將每個影格與逐字稿對應。影格很重要，因為 TikTok 的資訊多為內嵌文字、產品展示、圖表與示範，這些從未在對話中提及。
4. 回答使用者的實際問題。對於事實提取，請區分 說的（逐字稿）、顯示的（影格，包括畫面上的文字）以及 標題中聲稱的。引用時間戳以便使用者查證來源。

誠實分析規則

• 影格是取樣，大約每 2 秒一張。請勿斷言某內容從影片中缺席，只能說它未出現在取樣的影格或逐字稿中。若需特定時刻，請以更高的最大影格數重新執行。
• Whisper 在名稱、品牌、數字與俚語上會犯錯。對於依賴單一轉寫文字或數字的事實，請標記出來，並與螢幕上的文字交叉比對。
• 創作者說的話不一定是事實。當使用者要求事實查核時，列出聲明，標記哪些可驗證，並以網路搜尋驗證，而非重複聲明當作事實。
• Whisper 常誤聽產品名稱（測試中它每次都把「Claude」聽成「cloud」）。請利用上下文與螢幕上的文字修正這些錯誤，並說明你已修正。
• 互動數據與標題是背景資訊，並非結論。

當失敗時

• 照片輪播 / 幻燈片：yt-dlp 可能無法下載它們。請要求使用者螢幕錄影或儲存影片，然後傳遞檔案路徑。
• 需要登入、私人、地區封鎖或已刪除的影片：下載會出現錯誤。請要求改用已儲存的檔案。
• 「網頁請求出現非預期回應」：TikTok 的機器人檢查需要瀏覽器模擬。執行 python -m pip install -U "yt-dlp[curl-cffi]" 並重試。首次實際測試時需要這樣做。
• HTTP 403 或其他提取器錯誤：TikTok 經常變更。執行 python -m pip install -U yt-dlp 並重試一次。
• 沒有語音：逐字稿空白，請依賴影格與標題，並說明狀況。
• 缺少套件：python -m pip install -r "<skill-dir>/requirements.txt"（ffmpeg 已透過 imageio-ffmpeg 打包，無需系統安裝）。