用途：通过 Frevana 搜索抖音公开帖子，包含视频和图文结果，不返回热搜榜单；热搜词可作为关键词使用。结果字段与筛选条件以上游 Douyin Search Scraper 文档为准。
主要能力：支持关键词与筛选选项；默认每个关键词 10 条结果；要求提供 1 到 50 个关键词，且“唯一关键词数 × max_results_per_query”不得超过 1999。上游 Actor 的可选 MP4、封面与幻灯片下载开关未被该脚本暴露，因此媒体下载相关能力有限，脚本本身仅获取 JSON。
使用方式：需 bash、curl、jq，以及 uuidgen 或 openssl 生成客户端任务 ID。用捆绑脚本执行，{baseDir} 指技能目录。完整任务示例：bash {baseDir}/scripts/douyin_task.sh run --keyword '露营'；多关键词带筛选示例：bash {baseDir}/scripts/douyin_task.sh run --keyword '露营' --keyword '户外' --sort latest --publish-time one_week --duration under_1m --max-results-per-query 100 --output ./out/search.json。也可分阶段执行 create、status、wait、result；create --wait 等同于 run。省略 --max-results-per-query 时脚本会显式发送 10，覆盖可用该参数调整。create 视为计费操作，需记录 client_task_id；若创建超时或结果不明，应使用同一 ID 与相同选项重试，不得自动生成新任务。轮询至 status=READY 且 billing_status=BILLED，遇 FAILED、TIMED_OUT、ABORTED、RESULT_EXPIRED 或 TRIGGER_UNKNOWN 则停止。结果 JSON 必须原样返回，服务器会把识别到的媒体归档到 Frevana S3，不要改写或重排。
结果字段：播放视频用 videoMeta.playUrl（勿与 musicMeta.playUrl 音频混淆）；下载视频用 videoMeta.downloadUrl；打开或引用原帖用 url。仅在字段存在时使用；图文帖可能没有播放或下载 URL。上游抖音 CDN 链接可能数小时内过期，videoMeta.cdnUrlExpiresAt 记录过期时间；Frevana 可能用归档 URL 替换临时媒体 URL，因此应使用返回值而非自行拼接链接。
认证与输出：使用 FREVANA_TOKEN 或一次性 --token，切勿打印 token。默认 API 地址为 https://ai-factory.frevana.com，可用 FREVANA_API_BASE_URL 或 --api-base-url 覆盖。create 和 status 打印 API 响应；result、run、wait 打印原始 JSON，run 与 wait 默认保存到 ./out/，可用 --output 指定路径。脚本仅发送 Authorization: Bearer。
限制与平台：Windows 下需在 Git Bash 或 WSL 运行 .sh；缺少 jq 需安装，Git for Windows 含 Bash，winget install jqlang.jq 可安装 jq，装后重启终端并用 command -v jq 验证。Git Bash 接受带引号的 Windows 输出路径，WSL 在可用 wslpath 时接受，脚本也支持 POSIX 路径；复制脚本到 Git 外时保持 LF 换行。