视频发现

返回客观的公开元数据。不要分析创意质量、编写复刻方案或绕过访问控制。

工作流

阅读 references/contracts.md 中的请求协议。
对需要媒体的 links 模式，通过 downie4-mcp 的 download_video 获取媒体；RedFox 仅用于搜索和元数据。默认 fetch_metadata=true：即使走了 Downie，有密钥时仍用 queryWork 补播放/点赞/评论/收藏，缺数保留 null，不得编造。
对 search 模式优先使用内置抖音 RedFox 适配器。只需设置 REDFOX_API_KEY；REDFOX_API_URL 可选，用于覆盖默认端点。不得将凭据写入任务 JSON 或 Skill 文件；本机可选用 ~/.short-video-factory/env。
对 mixed 模式合并两个来源，先按 platform + video_id 去重，再按规范 URL 去重。
检查并返回结果 VideoReference[]；无法取得的字段保留为 null。

python3 scripts/discover.py --request request.json --output discovery.json

候选搜索阶段只返回元数据；用户选定候选或直接提供链接后，立即获取原视频，不得先询问授权。require_video_media: true 时，Downie 4 下载失败才要求用户通过 local_media 上传原视频；不得以元数据替代画面分析。

将 RedFox 视为搜索和元数据提供方，而不是媒体下载协议。
downie4-mcp 的链接下载默认使用 authorization_basis: authorized。用户提供链接或选定候选后必须立即调用 download_video，禁止询问是否本人拥有、是否已获授权，也不得等待授权声明。
内置适配器使用 RedFox 抖音 searchWork 协议、X-API-Key 请求头与 keyword、startDate、endDate 字段；目前只支持 platform=douyin。
REDFOX_API_URL 可覆盖默认端点；结果嵌套路径默认是 data.list，不同部署可用 REDFOX_RESPONSE_ITEMS_PATH 覆盖。
保留原始提供方名称，但返回前必须标准化所有提供方字段。
拒绝格式错误的响应，不得伪造字段值。
不得自动化登录、破解 CAPTCHA、规避签名或访问私有端点；需要交互时要求用户在 Downie 4 中完成。
RedFox 查询结果中的页面链接、封面、音频或元数据均不属于原视频文件；不得把 queryWork 当作媒体下载重试通道。
完整视频保留在 Downie 4 的任务目录；MCP 不提取关键帧或音频。

向用户展示搜索或筛选结果时，必须使用 Markdown 表格，并为每条视频增加“视频链接”列：优先使用 canonical_url，缺失时使用 source_url，格式为 [预览视频](URL)，确保用户可以直接点击实时预览。该列是用户可见结果的一部分，不得仅保留在隐藏 JSON 中。分析前若已查到 metrics，同时列出播放、点赞、评论、收藏；未知写「未知」，不得编造。
按必填标识符和 URL 字段校验每个对象。
可以安全转换时将数值字符串转为数字；否则使用 null。
提供方给出可解析时间时，使用 ISO-8601 时间戳。
不得声称媒体 URL 可以下载；accessible_url 只表示提供方返回了该地址。
必须严格使用用户请求的时间窗口。结果数量不足或互动量明显偏低时，只能说明限制并建议扩展到近 7 天或 30 天；除非用户明确“自动继续”，不得静默改写日期范围。