Lettiiii/tiktok-analyzer

TikTok 分析器

Claude 无法观看视频或打开 TikTok 链接，但它可以读取图像和文本。此技能将视频转换为两者：带时间戳的转录、均匀间隔的帧以及帖子元数据。然后你读取它们并回答。

步骤

1. 运行提取器（适用于 URL 或本地视频路径）。<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 捆绑，无需系统安装）。