技能介绍

要解决的问题

短视频素材采集常卡在三件事：人工搜索、复制链接、跨平台去重，既慢又容易遗漏互动指标；更常见的是分析链路只有标题和封面，缺少可审计的原视频与标准元数据。这个技能把发现、获取、校验和断点复用拆成可重复的工程步骤，让后续分析不必在各平台 UI 之间来回切换。

核心能力与工作方式

技能区分 search 与 links 两类入口：前者通过内置 RedFox 抖音适配器执行 searchWork，只取公开元数据；后者通过 downie4-mcp 的 download_video 拉取原视频。配置 REDFOX_API_KEY 后，默认 fetch_metadata=true；即便已用 Downie 下载，仍会用 queryWork 补播放、点赞、评论与收藏，拿不到的字段保留为 null，不填猜测值。

mixed 模式合并两个来源时，先按 platform + video_id 去重，再按规范 URL 去重，避免同一视频以多条链接重复入库。候选搜索阶段只返回元数据；用户选定候选或直接给链接后，立即发起下载，不额外询问授权。require_video_media: true 时，只有 Downie 下载失败才要求通过 local_media 上传原视频。

输出与边界

展示搜索或筛选结果时使用 Markdown 表格，并固定包含“视频链接”列，优先取 canonical_url，缺失时回退 source_url，链接文本为 预览视频，让用户直接点击预览。若已查到 metrics，同时列出播放、点赞、评论、收藏；未知写“未知”。数值字符串可安全转换时转成数字，可解析时间统一为 ISO-8601。

需要明确的边界是：RedFox 负责搜索与元数据，不是媒体下载协议；queryWork 不用于重试下载。accessible_url 只表示提供方返回了地址，不代表一定可下载。同一规范 URL 使用稳定任务目录，完整性检查通过的下载直接复用；每成功一条写入断点，失败重跑不重复下载已完成视频。关键帧、全片音频、ASR 和 OCR 由总编排的 prepare-evidence 从本地原视频提取，因此 media.keyframes=[] 不代表媒体未就绪。技能不自动化登录、不破解 CAPTCHA、不绕过签名，也不访问私有端点；需要交互时由用户在 Downie 4 完成。